@acteo/api 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -27,10 +27,15 @@ type StatusDocument = typeof StatusDocument.Type;
27
27
  * - `INVALID_IDENTIFIER`: sursa oficiala a respins identificatorul ca invalid.
28
28
  *
29
29
  * Restul tin de un produs anume: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`,
30
- * `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS`
31
- * (numarul de masini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
30
+ * `INDISPONIBIL`, `VIN_NEDECODAT`, `CULOARE_NECUNOSCUTA`, `VIN_INVALID`, `ARR_NECESITA_PLAN`,
31
+ * `LIMIT_ATINS` (numarul de masini din plan sau clientii noi invitati azi), `VEHICUL_EXISTENT`,
32
+ * `NEGASIT`, `LIMITA_FLOTA_ATINSA`, plus cele de la programari:
33
+ * - `PROFIL_EXPEDITOR_LIPSA`: completeaza in cont datele afacerii care apar in remindere;
34
+ * - `ADRESA_AFACERII_LIPSA`: completeaza in cont adresa afacerii sau trimite `locatie` in programare;
35
+ * - `CLIENT_INDISPONIBIL`: clientul nu mai primeste programari de la tine;
36
+ * - `PREA_MULTE_CERERI`: prea multe cereri intr-un interval scurt; reia dupa `Retry-After`.
32
37
  */
33
- declare const CODURI_EROARE: readonly ["UPSTREAM_UNAVAILABLE", "UPSTREAM_TIMEOUT", "UPSTREAM_BLOCKED", "UPSTREAM_CHANGED", "DAILY_LIMIT_REACHED", "PLAN_LIMIT_REACHED", "NOT_FOUND", "INVALID_IDENTIFIER", "SOLD_INSUFICIENT", "PLAFON_NETAXAT", "OCUPAT", "INDISPONIBIL", "VIN_NEDECODAT", "VIN_INVALID", "ARR_NECESITA_PLAN", "LIMIT_ATINS", "VEHICUL_EXISTENT", "NEGASIT", "LIMITA_FLOTA_ATINSA"];
38
+ declare const CODURI_EROARE: readonly ["UPSTREAM_UNAVAILABLE", "UPSTREAM_TIMEOUT", "UPSTREAM_BLOCKED", "UPSTREAM_CHANGED", "DAILY_LIMIT_REACHED", "PLAN_LIMIT_REACHED", "NOT_FOUND", "INVALID_IDENTIFIER", "SOLD_INSUFICIENT", "PLAFON_NETAXAT", "OCUPAT", "INDISPONIBIL", "VIN_NEDECODAT", "CULOARE_NECUNOSCUTA", "VIN_INVALID", "ARR_NECESITA_PLAN", "LIMIT_ATINS", "VEHICUL_EXISTENT", "NEGASIT", "LIMITA_FLOTA_ATINSA", "PROFIL_EXPEDITOR_LIPSA", "ADRESA_AFACERII_LIPSA", "CLIENT_INDISPONIBIL", "PREA_MULTE_CERERI"];
34
39
  /**
35
40
  * Un cod din {@link CODURI_EROARE}. Tipul accepta si alte valori, ca un cod adaugat
36
41
  * ulterior de API sa nu strice compilarea.
@@ -406,7 +411,7 @@ declare const WebhookAsigurareSchimbareSchema: Schema.Struct<{
406
411
  }>;
407
412
  /** S-a schimbat statutul de asigurat la CNAS al unei persoane monitorizate. */
408
413
  type WebhookAsigurareSchimbare = typeof WebhookAsigurareSchimbareSchema.Type;
409
- /** Evenimentul `termen.expira`: un termen din cont intra in pragul de 30 sau de 3 zile. */
414
+ /** Evenimentul `termen.expira`: un termen din cont intra in pragul de 30 (sau 7) ori de 3 zile. */
410
415
  declare const WebhookTermenExpiraSchema: Schema.Struct<{
411
416
  /** Numele evenimentului. */
412
417
  event: Schema.Literal<["termen.expira"]>;
@@ -418,24 +423,92 @@ declare const WebhookTermenExpiraSchema: Schema.Struct<{
418
423
  termen: Schema.Struct<{
419
424
  /** ID-ul termenului in cont. */
420
425
  id: typeof Schema.String;
421
- /** `auto`, `personale`, `sanatate`, `afaceri` sau `casa`. */
426
+ /** `auto`, `personale`, `sanatate`, `afaceri`, `casa` sau `animale`. */
422
427
  categorie: typeof Schema.String;
423
428
  /** Tipul termenului. */
424
429
  tip: typeof Schema.String;
425
430
  /** Numele termenului, ex: Pasaport sau numele dat de tine. */
426
431
  eticheta: typeof Schema.String;
427
- /** Al cui e termenul: numarul masinii, firma sau persoana. */
432
+ /** Al cui e termenul: numarul masinii, firma, persoana sau animalul. */
428
433
  al: Schema.NullOr<typeof Schema.String>;
429
434
  /** Data scadentei, `yyyy-mm-dd`. */
430
435
  expiraLa: typeof Schema.String;
431
436
  }>;
432
437
  /** Zile intregi ramase pana la scadenta. */
433
438
  zileRamase: typeof Schema.Number;
434
- /** Pragul atins, in zile. */
435
- prag: Schema.Literal<[30, 3]>;
439
+ /** Pragul atins, in zile: 30 sau 3; 7 in loc de 30 la termenele care se repeta la cel mult 3 luni. */
440
+ prag: Schema.Literal<[30, 7, 3]>;
436
441
  }>;
437
- /** Un termen adaugat in cont intra in pragul de 30 sau de 3 zile. */
442
+ /** Un termen adaugat in cont intra in pragul de 30 (sau 7) ori de 3 zile. */
438
443
  type WebhookTermenExpira = typeof WebhookTermenExpiraSchema.Type;
444
+ /** Evenimentul `programare.confirmata`: clientul a confirmat programarea din emailul primit. */
445
+ declare const WebhookProgramareConfirmataSchema: Schema.Struct<{
446
+ /** Numele evenimentului. */
447
+ event: Schema.Literal<["programare.confirmata"]>;
448
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
449
+ id: typeof Schema.String;
450
+ /** Cand a fost trimisa notificarea. */
451
+ trimisLa: typeof Schema.Date;
452
+ /** Programarea confirmata. */
453
+ programare: Schema.Struct<{
454
+ /** ID-ul programarii la Acteo. */
455
+ id: typeof Schema.String;
456
+ /** ID-ul programarii in programul tau, daca l-ai trimis. */
457
+ idExtern: Schema.NullOr<typeof Schema.String>;
458
+ }>;
459
+ /** Clientul programarii. */
460
+ client: Schema.Struct<{
461
+ /** Emailul clientului din programare, scris cu litere mici si fara spatii la capete. */
462
+ email: typeof Schema.String;
463
+ }>;
464
+ /** Momentul in care clientul a apasat pe linkul de confirmare. */
465
+ confirmatLa: typeof Schema.Date;
466
+ }>;
467
+ /** Clientul a confirmat o programare. */
468
+ type WebhookProgramareConfirmata = typeof WebhookProgramareConfirmataSchema.Type;
469
+ /** Evenimentul `programare.client_dezabonat`: clientul nu mai primeste mesaje de la tine. */
470
+ declare const WebhookProgramareClientDezabonatSchema: Schema.Struct<{
471
+ /** Numele evenimentului. */
472
+ event: Schema.Literal<["programare.client_dezabonat"]>;
473
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
474
+ id: typeof Schema.String;
475
+ /** Cand a fost trimisa notificarea. */
476
+ trimisLa: typeof Schema.Date;
477
+ /** Clientul care nu mai primeste mesaje. */
478
+ client: Schema.Struct<{
479
+ /** Emailul clientului din programare, scris cu litere mici si fara spatii la capete. */
480
+ email: typeof Schema.String;
481
+ }>;
482
+ /** Momentul dezabonarii. */
483
+ la: typeof Schema.Date;
484
+ }>;
485
+ /** Clientul nu mai primeste mesaje de la tine. Nu mai poti programa reminderele lui. */
486
+ type WebhookProgramareClientDezabonat = typeof WebhookProgramareClientDezabonatSchema.Type;
487
+ /** Evenimentul `programare.confirmare_expirata`: clientul nu a confirmat pana la termenul ales de tine. */
488
+ declare const WebhookProgramareConfirmareExpirataSchema: Schema.Struct<{
489
+ /** Numele evenimentului. */
490
+ event: Schema.Literal<["programare.confirmare_expirata"]>;
491
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
492
+ id: typeof Schema.String;
493
+ /** Cand a fost trimisa notificarea. */
494
+ trimisLa: typeof Schema.Date;
495
+ /** Programarea neconfirmata. */
496
+ programare: Schema.Struct<{
497
+ /** ID-ul programarii la Acteo. */
498
+ id: typeof Schema.String;
499
+ /** ID-ul programarii in programul tau, daca l-ai trimis. */
500
+ idExtern: Schema.NullOr<typeof Schema.String>;
501
+ }>;
502
+ /** Clientul programarii. */
503
+ client: Schema.Struct<{
504
+ /** Emailul clientului din programare, scris cu litere mici si fara spatii la capete. */
505
+ email: typeof Schema.String;
506
+ }>;
507
+ /** Momentul in care a trecut termenul de confirmare. */
508
+ confirmareExpirataLa: typeof Schema.Date;
509
+ }>;
510
+ /** Clientul nu a confirmat programarea pana la termen. Programarea ramane activa: tu decizi daca o anulezi. */
511
+ type WebhookProgramareConfirmareExpirata = typeof WebhookProgramareConfirmareExpirataSchema.Type;
439
512
  declare const WebhookNotificareSchema: Schema.Union<[Schema.Struct<{
440
513
  /** Numele evenimentului. */
441
514
  event: Schema.Literal<["document.expira"]>;
@@ -657,21 +730,77 @@ declare const WebhookNotificareSchema: Schema.Union<[Schema.Struct<{
657
730
  termen: Schema.Struct<{
658
731
  /** ID-ul termenului in cont. */
659
732
  id: typeof Schema.String;
660
- /** `auto`, `personale`, `sanatate`, `afaceri` sau `casa`. */
733
+ /** `auto`, `personale`, `sanatate`, `afaceri`, `casa` sau `animale`. */
661
734
  categorie: typeof Schema.String;
662
735
  /** Tipul termenului. */
663
736
  tip: typeof Schema.String;
664
737
  /** Numele termenului, ex: Pasaport sau numele dat de tine. */
665
738
  eticheta: typeof Schema.String;
666
- /** Al cui e termenul: numarul masinii, firma sau persoana. */
739
+ /** Al cui e termenul: numarul masinii, firma, persoana sau animalul. */
667
740
  al: Schema.NullOr<typeof Schema.String>;
668
741
  /** Data scadentei, `yyyy-mm-dd`. */
669
742
  expiraLa: typeof Schema.String;
670
743
  }>;
671
744
  /** Zile intregi ramase pana la scadenta. */
672
745
  zileRamase: typeof Schema.Number;
673
- /** Pragul atins, in zile. */
674
- prag: Schema.Literal<[30, 3]>;
746
+ /** Pragul atins, in zile: 30 sau 3; 7 in loc de 30 la termenele care se repeta la cel mult 3 luni. */
747
+ prag: Schema.Literal<[30, 7, 3]>;
748
+ }>, Schema.Struct<{
749
+ /** Numele evenimentului. */
750
+ event: Schema.Literal<["programare.confirmata"]>;
751
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
752
+ id: typeof Schema.String;
753
+ /** Cand a fost trimisa notificarea. */
754
+ trimisLa: typeof Schema.Date;
755
+ /** Programarea confirmata. */
756
+ programare: Schema.Struct<{
757
+ /** ID-ul programarii la Acteo. */
758
+ id: typeof Schema.String;
759
+ /** ID-ul programarii in programul tau, daca l-ai trimis. */
760
+ idExtern: Schema.NullOr<typeof Schema.String>;
761
+ }>;
762
+ /** Clientul programarii. */
763
+ client: Schema.Struct<{
764
+ /** Emailul clientului din programare, scris cu litere mici si fara spatii la capete. */
765
+ email: typeof Schema.String;
766
+ }>;
767
+ /** Momentul in care clientul a apasat pe linkul de confirmare. */
768
+ confirmatLa: typeof Schema.Date;
769
+ }>, Schema.Struct<{
770
+ /** Numele evenimentului. */
771
+ event: Schema.Literal<["programare.client_dezabonat"]>;
772
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
773
+ id: typeof Schema.String;
774
+ /** Cand a fost trimisa notificarea. */
775
+ trimisLa: typeof Schema.Date;
776
+ /** Clientul care nu mai primeste mesaje. */
777
+ client: Schema.Struct<{
778
+ /** Emailul clientului din programare, scris cu litere mici si fara spatii la capete. */
779
+ email: typeof Schema.String;
780
+ }>;
781
+ /** Momentul dezabonarii. */
782
+ la: typeof Schema.Date;
783
+ }>, Schema.Struct<{
784
+ /** Numele evenimentului. */
785
+ event: Schema.Literal<["programare.confirmare_expirata"]>;
786
+ /** ID unic al livrarii. Foloseste-l pentru deduplicare. */
787
+ id: typeof Schema.String;
788
+ /** Cand a fost trimisa notificarea. */
789
+ trimisLa: typeof Schema.Date;
790
+ /** Programarea neconfirmata. */
791
+ programare: Schema.Struct<{
792
+ /** ID-ul programarii la Acteo. */
793
+ id: typeof Schema.String;
794
+ /** ID-ul programarii in programul tau, daca l-ai trimis. */
795
+ idExtern: Schema.NullOr<typeof Schema.String>;
796
+ }>;
797
+ /** Clientul programarii. */
798
+ client: Schema.Struct<{
799
+ /** Emailul clientului din programare, scris cu litere mici si fara spatii la capete. */
800
+ email: typeof Schema.String;
801
+ }>;
802
+ /** Momentul in care a trecut termenul de confirmare. */
803
+ confirmareExpirataLa: typeof Schema.Date;
675
804
  }>, Schema.Struct<{
676
805
  /** Numele evenimentului. */
677
806
  event: Schema.Literal<["webhook.test"]>;
@@ -780,6 +909,255 @@ declare const ImagineMasinaSchema: Schema.Struct<{
780
909
  caroserie: typeof Schema.String;
781
910
  }>>;
782
911
  }>;
912
+ declare const PolitaPadPornitaSchema: Schema.Struct<{
913
+ /** Mereu `"processing"`: PADROM e interogat acum. */
914
+ status: Schema.Literal<["processing"]>;
915
+ /** Cand a pornit verificarea. */
916
+ queuedAt: typeof Schema.Date;
917
+ /** Cererea GET de polling, cu id-ul deja completat. */
918
+ pollUrl: typeof Schema.String;
919
+ /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
920
+ requestId: typeof Schema.String;
921
+ /** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
922
+ cnpMascat: typeof Schema.String;
923
+ /** Judetul, cum apare in nomenclatorul PADROM. */
924
+ judet: typeof Schema.String;
925
+ /** Localitatea, cum apare in nomenclatorul PADROM. */
926
+ localitate: typeof Schema.String;
927
+ /** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
928
+ laData: typeof Schema.String;
929
+ }>;
930
+ declare const PolitaPadInCursSchema: Schema.Struct<{
931
+ /** Mereu `"processing"`: PADROM nu a raspuns inca. */
932
+ status: Schema.Literal<["processing"]>;
933
+ /** Cand a pornit verificarea. */
934
+ queuedAt: typeof Schema.Date;
935
+ /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
936
+ requestId: typeof Schema.String;
937
+ /** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
938
+ cnpMascat: typeof Schema.String;
939
+ /** Judetul, cum apare in nomenclatorul PADROM. */
940
+ judet: typeof Schema.String;
941
+ /** Localitatea, cum apare in nomenclatorul PADROM. */
942
+ localitate: typeof Schema.String;
943
+ /** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
944
+ laData: typeof Schema.String;
945
+ }>;
946
+ declare const PolitaPadGataSchema: Schema.Struct<{
947
+ /** Mereu `"done"`: PADROM a raspuns. */
948
+ status: Schema.Literal<["done"]>;
949
+ /** `true`: PADROM a gasit o polita valabila la data ceruta. `false`: nu a gasit una. */
950
+ valabila: typeof Schema.Boolean;
951
+ /** Seria si numarul politei, cand PADROM le arata. */
952
+ serieNumar: Schema.NullOr<typeof Schema.String>;
953
+ /** Asiguratorul care a emis polita, cand PADROM il arata. */
954
+ distribuitor: Schema.NullOr<typeof Schema.String>;
955
+ /** Cand a raspuns PADROM. */
956
+ verificatLa: typeof Schema.Date;
957
+ /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
958
+ requestId: typeof Schema.String;
959
+ /** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
960
+ cnpMascat: typeof Schema.String;
961
+ /** Judetul, cum apare in nomenclatorul PADROM. */
962
+ judet: typeof Schema.String;
963
+ /** Localitatea, cum apare in nomenclatorul PADROM. */
964
+ localitate: typeof Schema.String;
965
+ /** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
966
+ laData: typeof Schema.String;
967
+ }>;
968
+ declare const WebhookRezultatPadSchema: Schema.Union<[Schema.Struct<{
969
+ /** Mereu `"done"`: PADROM a raspuns. */
970
+ status: Schema.Literal<["done"]>;
971
+ /** `true`: PADROM a gasit o polita valabila la data ceruta. `false`: nu a gasit una. */
972
+ valabila: typeof Schema.Boolean;
973
+ /** Seria si numarul politei, cand PADROM le arata. */
974
+ serieNumar: Schema.NullOr<typeof Schema.String>;
975
+ /** Asiguratorul care a emis polita, cand PADROM il arata. */
976
+ distribuitor: Schema.NullOr<typeof Schema.String>;
977
+ /** Cand a raspuns PADROM. */
978
+ verificatLa: typeof Schema.Date;
979
+ /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
980
+ requestId: typeof Schema.String;
981
+ /** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
982
+ cnpMascat: typeof Schema.String;
983
+ /** Judetul, cum apare in nomenclatorul PADROM. */
984
+ judet: typeof Schema.String;
985
+ /** Localitatea, cum apare in nomenclatorul PADROM. */
986
+ localitate: typeof Schema.String;
987
+ /** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
988
+ laData: typeof Schema.String;
989
+ }>, Schema.Struct<{
990
+ /** Mereu `"error"`. */
991
+ status: Schema.Literal<["error"]>;
992
+ /** Motivul. Vezi {@link CodEsecVerificare}. `INVALID_IDENTIFIER` = PADROM a refuzat datele (taxat). */
993
+ code: Schema.optional<typeof Schema.String>;
994
+ /** Motivul, in romana. */
995
+ error: typeof Schema.String;
996
+ /** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
997
+ requestId: typeof Schema.String;
998
+ /** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
999
+ cnpMascat: typeof Schema.String;
1000
+ /** Judetul, cum apare in nomenclatorul PADROM. */
1001
+ judet: typeof Schema.String;
1002
+ /** Localitatea, cum apare in nomenclatorul PADROM. */
1003
+ localitate: typeof Schema.String;
1004
+ /** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
1005
+ laData: typeof Schema.String;
1006
+ }>]>;
1007
+ /**
1008
+ * Payloadul POST trimis la `callbackUrl` cand verificarea unei polite PAD se
1009
+ * termina: `status: "done"` cu verdictul sau `status: "error"` cu `code`.
1010
+ */
1011
+ type WebhookRezultatPad = typeof WebhookRezultatPadSchema.Type;
1012
+ /** Cand pleaca un reminder: `7z` cu 7 zile inainte, `1z` cu o zi inainte, `3h` cu 3 ore inainte. */
1013
+ declare const MomentReminder: Schema.Literal<["7z", "1z", "3h"]>;
1014
+ /** Momentul unui reminder: `"7z"`, `"1z"` sau `"3h"`. Vezi {@link MomentReminder}. */
1015
+ type MomentReminder = typeof MomentReminder.Type;
1016
+ declare const ProgramareSchema: Schema.Struct<{
1017
+ /** ID-ul programarii la Acteo, folosit la `obtine()`, `actualizeaza()` si `anuleaza()`. */
1018
+ id: typeof Schema.String;
1019
+ /** ID-ul din programul tau, daca l-ai trimis. */
1020
+ idExtern: Schema.NullOr<typeof Schema.String>;
1021
+ /** `programata`: urmeaza; `anulata`: ai anulat-o; `trecuta`: ora de inceput a trecut. */
1022
+ status: Schema.Literal<["programata", "anulata", "trecuta"]>;
1023
+ /** Clientul programat. */
1024
+ client: Schema.Struct<{
1025
+ /** Emailul clientului, cum l-ai trimis. */
1026
+ email: typeof Schema.String;
1027
+ /** Numele clientului. */
1028
+ nume: Schema.NullOr<typeof Schema.String>;
1029
+ /**
1030
+ * `cont`: are cont Acteo si vede programarea acolo; `invitat`: nu are cont si
1031
+ * primeste remindere pe email; `dezabonat`: nu mai primeste programari de la tine.
1032
+ */
1033
+ stare: Schema.Literal<["cont", "invitat", "dezabonat"]>;
1034
+ }>;
1035
+ /** Data si ora programarii. */
1036
+ incepeLa: typeof Schema.Date;
1037
+ /** Cat dureaza programarea, in minute. */
1038
+ durataMinute: Schema.NullOr<typeof Schema.Number>;
1039
+ /** Ce fel de programare e, cum o vede clientul in remindere. */
1040
+ titlu: typeof Schema.String;
1041
+ /** Unde are loc programarea, daca difera de adresa afacerii. */
1042
+ locatie: Schema.NullOr<typeof Schema.String>;
1043
+ /** La cine e programarea; `null` daca nu l-ai trimis. */
1044
+ cuCine: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
1045
+ default: () => null;
1046
+ }>;
1047
+ /** Ce trebuie sa stie clientul inainte. */
1048
+ note: Schema.NullOr<typeof Schema.String>;
1049
+ /** Linkul primit de client in remindere. */
1050
+ url: Schema.NullOr<typeof Schema.String>;
1051
+ /** Clientul e rugat sa confirme ca vine. */
1052
+ necesitaConfirmare: typeof Schema.Boolean;
1053
+ /** Cand a confirmat clientul ca vine; `null` pana atunci. */
1054
+ confirmatLa: Schema.NullOr<typeof Schema.Date>;
1055
+ /** Cate ore are clientul de la primirea programarii ca sa confirme; `null` fara acest termen. */
1056
+ confirmareInMaximOre: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
1057
+ default: () => null;
1058
+ }>;
1059
+ /** Cu cate ore inainte de programare trebuie sa confirme clientul cel tarziu; `null` fara acest termen. */
1060
+ confirmareCuMinimOreInainte: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
1061
+ default: () => null;
1062
+ }>;
1063
+ /** Pana cand poate confirma clientul; `null` cand nu e un termen. */
1064
+ confirmareExpiraLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
1065
+ default: () => null;
1066
+ }>;
1067
+ /** Cand a trecut termenul fara confirmare; `null` pana atunci. Programarea ramane activa. */
1068
+ confirmareExpirataLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
1069
+ default: () => null;
1070
+ }>;
1071
+ /** Cand a deschis clientul programarea; `null` pana atunci sau dupa ce modifici ce vede clientul. */
1072
+ vazutLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
1073
+ default: () => null;
1074
+ }>;
1075
+ /** Ce remindere primeste clientul. */
1076
+ remindere: Schema.Array$<Schema.Literal<["7z", "1z", "3h"]>>;
1077
+ /** `false`: fara SMS; `true`: SMS daca planul il include; `null`: urmeaza setarea din cont. */
1078
+ sms: Schema.NullOr<typeof Schema.Boolean>;
1079
+ /** Cand a fost creata programarea. */
1080
+ creatLa: typeof Schema.Date;
1081
+ /** Ultima modificare. */
1082
+ actualizatLa: typeof Schema.Date;
1083
+ }>;
1084
+ /** O programare trimisa de afacerea ta. */
1085
+ type Programare = typeof ProgramareSchema.Type;
1086
+ declare const ListaProgramariSchema: Schema.Struct<{
1087
+ /** Programarile din pagina, inclusiv cele anulate sau trecute (vezi `status`). */
1088
+ programari: Schema.Array$<Schema.Struct<{
1089
+ /** ID-ul programarii la Acteo, folosit la `obtine()`, `actualizeaza()` si `anuleaza()`. */
1090
+ id: typeof Schema.String;
1091
+ /** ID-ul din programul tau, daca l-ai trimis. */
1092
+ idExtern: Schema.NullOr<typeof Schema.String>;
1093
+ /** `programata`: urmeaza; `anulata`: ai anulat-o; `trecuta`: ora de inceput a trecut. */
1094
+ status: Schema.Literal<["programata", "anulata", "trecuta"]>;
1095
+ /** Clientul programat. */
1096
+ client: Schema.Struct<{
1097
+ /** Emailul clientului, cum l-ai trimis. */
1098
+ email: typeof Schema.String;
1099
+ /** Numele clientului. */
1100
+ nume: Schema.NullOr<typeof Schema.String>;
1101
+ /**
1102
+ * `cont`: are cont Acteo si vede programarea acolo; `invitat`: nu are cont si
1103
+ * primeste remindere pe email; `dezabonat`: nu mai primeste programari de la tine.
1104
+ */
1105
+ stare: Schema.Literal<["cont", "invitat", "dezabonat"]>;
1106
+ }>;
1107
+ /** Data si ora programarii. */
1108
+ incepeLa: typeof Schema.Date;
1109
+ /** Cat dureaza programarea, in minute. */
1110
+ durataMinute: Schema.NullOr<typeof Schema.Number>;
1111
+ /** Ce fel de programare e, cum o vede clientul in remindere. */
1112
+ titlu: typeof Schema.String;
1113
+ /** Unde are loc programarea, daca difera de adresa afacerii. */
1114
+ locatie: Schema.NullOr<typeof Schema.String>;
1115
+ /** La cine e programarea; `null` daca nu l-ai trimis. */
1116
+ cuCine: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
1117
+ default: () => null;
1118
+ }>;
1119
+ /** Ce trebuie sa stie clientul inainte. */
1120
+ note: Schema.NullOr<typeof Schema.String>;
1121
+ /** Linkul primit de client in remindere. */
1122
+ url: Schema.NullOr<typeof Schema.String>;
1123
+ /** Clientul e rugat sa confirme ca vine. */
1124
+ necesitaConfirmare: typeof Schema.Boolean;
1125
+ /** Cand a confirmat clientul ca vine; `null` pana atunci. */
1126
+ confirmatLa: Schema.NullOr<typeof Schema.Date>;
1127
+ /** Cate ore are clientul de la primirea programarii ca sa confirme; `null` fara acest termen. */
1128
+ confirmareInMaximOre: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
1129
+ default: () => null;
1130
+ }>;
1131
+ /** Cu cate ore inainte de programare trebuie sa confirme clientul cel tarziu; `null` fara acest termen. */
1132
+ confirmareCuMinimOreInainte: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
1133
+ default: () => null;
1134
+ }>;
1135
+ /** Pana cand poate confirma clientul; `null` cand nu e un termen. */
1136
+ confirmareExpiraLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
1137
+ default: () => null;
1138
+ }>;
1139
+ /** Cand a trecut termenul fara confirmare; `null` pana atunci. Programarea ramane activa. */
1140
+ confirmareExpirataLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
1141
+ default: () => null;
1142
+ }>;
1143
+ /** Cand a deschis clientul programarea; `null` pana atunci sau dupa ce modifici ce vede clientul. */
1144
+ vazutLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
1145
+ default: () => null;
1146
+ }>;
1147
+ /** Ce remindere primeste clientul. */
1148
+ remindere: Schema.Array$<Schema.Literal<["7z", "1z", "3h"]>>;
1149
+ /** `false`: fara SMS; `true`: SMS daca planul il include; `null`: urmeaza setarea din cont. */
1150
+ sms: Schema.NullOr<typeof Schema.Boolean>;
1151
+ /** Cand a fost creata programarea. */
1152
+ creatLa: typeof Schema.Date;
1153
+ /** Ultima modificare. */
1154
+ actualizatLa: typeof Schema.Date;
1155
+ }>>;
1156
+ /** Trimite-l ca `cursor` pentru pagina urmatoare; `null` cand nu mai sunt programari. */
1157
+ urmatorulCursor: Schema.NullOr<typeof Schema.String>;
1158
+ }>;
1159
+ /** O pagina de programari, in ordinea datei de inceput. */
1160
+ type ListaProgramari = typeof ListaProgramariSchema.Type;
783
1161
 
784
1162
  /** Campurile comune tuturor erorilor SDK-ului. */
785
1163
  interface DateEroare {
@@ -819,8 +1197,10 @@ declare class EroareConfigurare extends VerificRcaError {
819
1197
  }
820
1198
  /**
821
1199
  * Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
822
- * consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand sursa
823
- * oficiala refuza valoarea (`INVALID_IDENTIFIER` la numerele disponibile).
1200
+ * consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand datele
1201
+ * nu pot fi folosite: sursa oficiala refuza valoarea (`INVALID_IDENTIFIER` la
1202
+ * numerele disponibile) sau, la programari, emailul, data sau linkul nu merg ori
1203
+ * lipsesc datele afacerii din cont (`PROFIL_EXPEDITOR_LIPSA`, `ADRESA_AFACERII_LIPSA`).
824
1204
  */
825
1205
  declare class EroareValidare extends VerificRcaError {
826
1206
  /** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
@@ -855,7 +1235,10 @@ declare class EroarePlanInactiv extends VerificRcaError {
855
1235
  /** Numele clasei, afisat in loguri si in stack trace. */
856
1236
  readonly name = "EroarePlanInactiv";
857
1237
  }
858
- /** 403: operatia nu e permisa pe planul curent (`LIMIT_ATINS`, `ARR_NECESITA_PLAN`). */
1238
+ /**
1239
+ * 403: operatia nu e permisa: pe planul curent (`LIMIT_ATINS`, `ARR_NECESITA_PLAN`)
1240
+ * sau, la programari, trimiterea de programari e oprita pentru acest cont.
1241
+ */
859
1242
  declare class EroareInterzis extends VerificRcaError {
860
1243
  /** Discriminantul erorii: `"EroareInterzis"`. Util in `switch (err._tag)`. */
861
1244
  readonly _tag = "EroareInterzis";
@@ -879,7 +1262,12 @@ declare class EroareNegasit extends VerificRcaError {
879
1262
  /** Numele clasei, afisat in loguri si in stack trace. */
880
1263
  readonly name = "EroareNegasit";
881
1264
  }
882
- /** 409: vehiculul exista deja in cont (`VEHICUL_EXISTENT`). */
1265
+ /**
1266
+ * 409: conflict cu ce exista deja in cont:
1267
+ * - `VEHICUL_EXISTENT`: vehiculul exista deja in cont;
1268
+ * - `CLIENT_INDISPONIBIL`: clientul nu mai primeste programari de la tine;
1269
+ * - fara cod: programarea e anulata si nu se mai poate modifica.
1270
+ */
883
1271
  declare class EroareConflict extends VerificRcaError {
884
1272
  /** Discriminantul erorii: `"EroareConflict"`. Util in `switch (err._tag)`. */
885
1273
  readonly _tag = "EroareConflict";
@@ -894,7 +1282,9 @@ declare class EroareConflict extends VerificRcaError {
894
1282
  * - `SOLD_INSUFICIENT`: soldul preplatit nu acopera cererile peste plan;
895
1283
  * - `PLAFON_NETAXAT`: prea multe raspunsuri netaxate azi (decodari, poze generice);
896
1284
  * - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
897
- * - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur);
1285
+ * - `LIMIT_ATINS`: la programari, prea multi clienti noi fara cont azi; `limita` spune cati poti invita pe zi;
1286
+ * - `PREA_MULTE_CERERI`: prea multe cereri intr-un interval scurt; SDK-ul reincearca
1287
+ * singur cererile sigure (GET, DELETE) dupa `retryAfterMs`, nu si POST sau PUT;
898
1288
  * - `COTA_ATINSA`: cota atinsa, de la un server mai vechi care nu trimite cod.
899
1289
  */
900
1290
  declare class EroareLimita extends VerificRcaError {
@@ -908,6 +1298,8 @@ declare class EroareLimita extends VerificRcaError {
908
1298
  readonly utilizareZi?: string;
909
1299
  /** Consumul lunar, ex: `"4120/10000"`. */
910
1300
  readonly utilizareLuna?: string;
1301
+ /** La `LIMIT_ATINS` (programari): numarul de clienti noi pe care ii poti invita pe zi. */
1302
+ readonly limita?: number;
911
1303
  /**
912
1304
  * Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
913
1305
  *
@@ -917,6 +1309,7 @@ declare class EroareLimita extends VerificRcaError {
917
1309
  readonly retryAfterMs?: number;
918
1310
  readonly utilizareZi?: string;
919
1311
  readonly utilizareLuna?: string;
1312
+ readonly limita?: number;
920
1313
  });
921
1314
  }
922
1315
  /**
@@ -1159,6 +1552,40 @@ interface CerereImagine {
1159
1552
  /** Umbra sub masina. Implicit `true`. */
1160
1553
  readonly umbra?: boolean;
1161
1554
  }
1555
+ /**
1556
+ * Verifica un CNP romanesc: 13 cifre, o data de nastere reala si cifra de
1557
+ * control. Spatiile si liniutele sunt ignorate. Nu spune daca CNP-ul exista.
1558
+ *
1559
+ * @param cnp CNP-ul de verificat.
1560
+ * @returns `true` daca CNP-ul are o forma valida.
1561
+ * @example
1562
+ * esteCnpValid(cnpDinFormular) // true daca forma e corecta
1563
+ * esteCnpValid("1900101400013") // false: cifra de control nu se potriveste
1564
+ */
1565
+ declare function esteCnpValid(cnp: string): boolean;
1566
+ /**
1567
+ * Datele unei verificari de polita PAD. Locuinta se da prin `judet` si
1568
+ * `localitate` (cu sau fara diacritice), ori prin `judetId` si `localitateId`
1569
+ * din nomenclatorul PADROM.
1570
+ */
1571
+ interface CererePolitaPad {
1572
+ /** CNP-ul proprietarului, 13 cifre. Spatiile si liniutele sunt acceptate. API-ul nu il pastreaza. */
1573
+ readonly cnp: string;
1574
+ /** Judetul locuintei: numele (`"Cluj"`) sau indicativul (`"CJ"`, `"B"`). La Bucuresti trimite si `sector`. */
1575
+ readonly judet?: string;
1576
+ /** Localitatea locuintei, ex: `"Cluj-Napoca"`. La Bucuresti poate lipsi. */
1577
+ readonly localitate?: string;
1578
+ /** Doar la Bucuresti: sectorul, de la 1 la 6. */
1579
+ readonly sector?: number;
1580
+ /** Alternativa la `judet`: id-ul judetului din nomenclatorul PADROM. Cere si `localitateId`. */
1581
+ readonly judetId?: string;
1582
+ /** Alternativa la `localitate`: id-ul localitatii din nomenclatorul PADROM. */
1583
+ readonly localitateId?: string;
1584
+ /** Data la care verifici polita, `AAAA-LL-ZZ`, cel mult 365 de zile inainte sau dupa azi. Implicit azi. */
1585
+ readonly data?: string;
1586
+ /** Confirmi ca ai acordul proprietarului sau ca esti chiar proprietarul. Obligatoriu `true`. */
1587
+ readonly acord: true;
1588
+ }
1162
1589
 
1163
1590
  /** Cat mai ai din cota planului, din headerele `X-RateLimit-*`. */
1164
1591
  interface Limite {
@@ -1234,7 +1661,7 @@ interface OptiuniAsteptare {
1234
1661
  }
1235
1662
 
1236
1663
  /** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
1237
- declare const VERSIUNE_SDK = "0.5.0";
1664
+ declare const VERSIUNE_SDK = "0.6.0";
1238
1665
  /** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
1239
1666
  declare const URL_IMPLICIT = "https://api.acteo.ro";
1240
1667
  /** Adresa implicita a clientului legacy {@link VerificRca}. */
@@ -1467,6 +1894,24 @@ declare class VerificRca {
1467
1894
  constructor(optiuni?: OptiuniClient);
1468
1895
  }
1469
1896
 
1897
+ /** Verificarea PAD a pornit. Paseaz-o la `rezultat()` sau `asteapta()`. */
1898
+ type PolitaPadPornita = typeof PolitaPadPornitaSchema.Type & {
1899
+ /** Cota ramasa dupa cererea POST, cand API-ul o trimite. */
1900
+ readonly limite?: Limite;
1901
+ };
1902
+ /** PADROM a raspuns: `valabila` spune daca exista o polita valabila la `laData`. */
1903
+ type PolitaPadGata = typeof PolitaPadGataSchema.Type;
1904
+ /** Verificarea PAD e inca in curs: mai intreaba peste cateva secunde. */
1905
+ type PolitaPadInCurs = typeof PolitaPadInCursSchema.Type;
1906
+ /**
1907
+ * Raspunsul la `rezultat()`: verdictul PADROM (`status: "done"`) sau cererea
1908
+ * inca in curs (`status: "processing"`). `status: "error"` devine
1909
+ * {@link EroareVerificare}.
1910
+ */
1911
+ type RezultatPolitaPad = PolitaPadGata | PolitaPadInCurs;
1912
+ /** Ce primeste `rezultat()`: raspunsul de la `porneste()` sau doar `requestId`. */
1913
+ type ReferintaPolitaPad = PolitaPadPornita | string;
1914
+
1470
1915
  /** Decodarea unui VIN, cu cota ramasa. */
1471
1916
  type DecodareVin = typeof DecodareVinSchema.Type & {
1472
1917
  /** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
@@ -1490,6 +1935,87 @@ interface OptiuniAsteptareImagine {
1490
1935
  readonly timeoutMs?: number;
1491
1936
  }
1492
1937
 
1938
+ /** O data cu ora si fusul orar: text ISO 8601 (`2027-05-12T10:00:00+03:00`) sau `Date`. */
1939
+ type DataProgramare = string | Date;
1940
+ /** Campurile optionale comune la creare si la modificare. */
1941
+ interface CampuriProgramare {
1942
+ /** Cat dureaza programarea, in minute, intre 5 si 1.440. */
1943
+ readonly durataMinute?: number | null;
1944
+ /** Unde are loc programarea, daca difera de adresa afacerii. */
1945
+ readonly locatie?: string | null;
1946
+ /** La cine e programarea, daca afacerea are mai multi oameni: medicul, frizerul, consultantul. Maxim 120 de caractere. */
1947
+ readonly cuCine?: string | null;
1948
+ /** Ce trebuie sa stie clientul inainte, de exemplu ce sa aduca. */
1949
+ readonly note?: string | null;
1950
+ /** Link https pe care clientul il primeste in remindere, de exemplu pentru o intalnire online. */
1951
+ readonly url?: string | null;
1952
+ /** `true`: clientul e rugat sa confirme ca vine. Implicit `false`. */
1953
+ readonly necesitaConfirmare?: boolean;
1954
+ /**
1955
+ * Clientul are cel mult atatea ore de la primirea programarii ca sa confirme. Intre 1 si 720
1956
+ * (3 zile = 72). Doar cu `necesitaConfirmare: true`. `null` il sterge la modificare.
1957
+ */
1958
+ readonly confirmareInMaximOre?: number | null;
1959
+ /**
1960
+ * Clientul trebuie sa confirme cu cel putin atatea ore inainte de programare. Intre 1 si 720.
1961
+ * Doar cu `necesitaConfirmare: true`. Cu ambele campuri trimise, conteaza cel care vine primul.
1962
+ * `null` il sterge la modificare.
1963
+ */
1964
+ readonly confirmareCuMinimOreInainte?: number | null;
1965
+ /** Ce remindere primeste clientul. Implicit toate trei; o lista goala inseamna doar mesajul la primire. */
1966
+ readonly remindere?: readonly MomentReminder[];
1967
+ /** `false`: fara SMS pentru aceasta programare. `true`, lipsa sau `null`: SMS doar daca planul il include si e pornit din cont. */
1968
+ readonly sms?: boolean | null;
1969
+ }
1970
+ /** O programare noua sau, cu un `idExtern` deja trimis, actualizarea ei. */
1971
+ interface CerereProgramare extends CampuriProgramare {
1972
+ /**
1973
+ * ID-ul programarii in programul tau (litere, cifre si `._:-`). Un POST nou cu
1974
+ * acelasi id actualizeaza programarea, nu creeaza una noua. Clientul nu se
1975
+ * schimba: acelasi id cu alt email e refuzat.
1976
+ */
1977
+ readonly idExtern?: string;
1978
+ /** Clientul programat. Dupa email il recunoastem. */
1979
+ readonly client: {
1980
+ /** Emailul clientului. */
1981
+ readonly email: string;
1982
+ /** Numele clientului, cum apare in remindere. */
1983
+ readonly nume?: string | null;
1984
+ };
1985
+ /** Data si ora programarii, cu fusul orar, in viitor. */
1986
+ readonly incepeLa: DataProgramare;
1987
+ /** Ce fel de programare e, cum o vede clientul in remindere. */
1988
+ readonly titlu: string;
1989
+ }
1990
+ /** Modificarea unei programari: se schimba doar campurile trimise, `null` goleste un camp optional. */
1991
+ interface ModificareProgramare extends CampuriProgramare {
1992
+ /** Doar numele se poate schimba; `null` il sterge. Pentru alt client, anuleaza si creeaza o programare noua. */
1993
+ readonly client?: {
1994
+ /** Numele clientului. */
1995
+ readonly nume?: string | null;
1996
+ };
1997
+ /** Data si ora noua, cu fusul orar, in viitor. Mutarea datei cere o confirmare noua. */
1998
+ readonly incepeLa?: DataProgramare;
1999
+ /** Titlul nou. */
2000
+ readonly titlu?: string;
2001
+ }
2002
+ /** Filtrele si paginarea pentru `lista()`. */
2003
+ interface OptiuniListaProgramari {
2004
+ /** Doar programarile care incep de la aceasta data, cu ora si fusul orar. */
2005
+ readonly din?: DataProgramare;
2006
+ /** Doar programarile care incep inainte de aceasta data, cu ora si fusul orar. */
2007
+ readonly pana?: DataProgramare;
2008
+ /** `urmatorulCursor` din pagina anterioara. */
2009
+ readonly cursor?: string;
2010
+ /** Cate programari vin pe pagina, intre 1 si 100. Implicit 50. */
2011
+ readonly limita?: number;
2012
+ }
2013
+ /** Raspunsul la `creeaza()`: programarea, plus daca e noua sau una existenta actualizata. */
2014
+ type ProgramareTrimisa = Programare & {
2015
+ /** `true` la o programare noua (HTTP 201); `false` cand `idExtern` exista si programarea a fost actualizata (HTTP 200). */
2016
+ readonly creata: boolean;
2017
+ };
2018
+
1493
2019
  /** Headerul cu cheia de webhook a contului. */
1494
2020
  declare const HEADER_CHEIE_WEBHOOK = "x-acteo-key";
1495
2021
  /** Headerul cu numele evenimentului (`document.expira`, `webhook.test` etc.). */
@@ -1514,6 +2040,21 @@ type HeadereCerere = Headers | Readonly<Record<string, string | readonly string[
1514
2040
  * })
1515
2041
  */
1516
2042
  declare function parseazaWebhookRezultat(corp: unknown): WebhookRezultat;
2043
+ /**
2044
+ * Citeste rezultatul trimis la `callbackUrl` dupa o verificare de polita PAD.
2045
+ * Corpul nu contine CNP-ul, doar `cnpMascat`.
2046
+ *
2047
+ * Foloseste un `callbackUrl` pe HTTPS, greu de ghicit, si potriveste
2048
+ * `requestId` cu cel primit la `casa.pad.porneste()` inainte sa ai incredere in continut.
2049
+ *
2050
+ * @param corp corpul cererii: string, Buffer/Uint8Array sau obiect deja parsat.
2051
+ * @returns verdictul (`status: "done"`) sau eroarea (`status: "error"`), cu datele ca `Date`.
2052
+ * @throws {@link EroareWebhook} corpul nu e JSON (`JSON_INVALID`) sau nu e un rezultat PAD valid (`PAYLOAD_INVALID`).
2053
+ * @example
2054
+ * const r = parseazaWebhookRezultatPad(req.body)
2055
+ * if (r.status === "done") salveaza(r.requestId, r.valabila)
2056
+ */
2057
+ declare function parseazaWebhookRezultatPad(corp: unknown): WebhookRezultatPad;
1517
2058
  /** Optiunile pentru {@link verificaWebhookNotificare}. */
1518
2059
  interface OptiuniWebhookNotificare {
1519
2060
  /** Cheia de webhook din dashboard (`whsec_...`). */
@@ -1523,7 +2064,9 @@ interface OptiuniWebhookNotificare {
1523
2064
  * Verifica si citeste o notificare trimisa la URL-ul de webhook al contului:
1524
2065
  * expirarea unui document (`document.expira`), evenimentele celorlalte
1525
2066
  * servicii (`dosar.*`, `firma.*`, `marca.*`, `asigurare.schimbare`,
1526
- * `termen.expira`) sau testul din dashboard (`webhook.test`).
2067
+ * `termen.expira`), raspunsurile clientilor la programari (`programare.confirmata`,
2068
+ * `programare.confirmare_expirata`, `programare.client_dezabonat`) sau testul din
2069
+ * dashboard (`webhook.test`).
1527
2070
  *
1528
2071
  * Cheia vine in clar in headerul `X-Acteo-Key` si e comparata in timp
1529
2072
  * constant cu cea din dashboard. Pastreaza URL-ul pe HTTPS.
@@ -1744,6 +2287,180 @@ declare class ClientAuto {
1744
2287
  /** @internal */
1745
2288
  constructor(ruleaza: Rulare);
1746
2289
  }
2290
+ /**
2291
+ * Verificarea unei polite PAD (asigurarea obligatorie a locuintei) dupa CNP-ul
2292
+ * proprietarului si localitatea locuintei, la PADROM. Cere abonamentul API
2293
+ * Verificare polita PAD si acordul proprietarului (`acord: true`).
2294
+ *
2295
+ * Verificarea e asincrona si poate dura cateva minute. `verifica()` si
2296
+ * `porneste()` se taxeaza doar cand PADROM raspunde; `rezultat()` si
2297
+ * `asteapta()` sunt gratuite. CNP-ul nu apare in raspunsuri, doar `cnpMascat`.
2298
+ */
2299
+ declare class ClientPad {
2300
+ #private;
2301
+ /** @internal */
2302
+ constructor(ruleaza: Rulare);
2303
+ /**
2304
+ * Verifica polita si asteapta raspunsul PADROM.
2305
+ *
2306
+ * @param cerere `cnp`, locuinta (`judet` si `localitate`, ori `judetId` si `localitateId`), `data` optionala si `acord: true`.
2307
+ * @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
2308
+ * @returns verdictul: `valabila`, plus `serieNumar` si `distribuitor` cand PADROM le arata.
2309
+ * @throws {@link EroareValidare} CNP, acord sau data invalide (local), ori judet sau localitate negasite (HTTP 422, netaxat).
2310
+ * @throws {@link EroarePlanInactiv} lipseste abonamentul de verificare PAD.
2311
+ * @throws {@link EroareLimita} cota atinsa sau prea multe verificari in curs (`OCUPAT`).
2312
+ * @throws {@link EroareVerificare} PADROM a refuzat datele (`INVALID_IDENTIFIER`) sau nu a raspuns; motivul e in `cod`.
2313
+ * @throws {@link EroareTimeoutVerificare} raspunsul nu a venit in `timeoutMs`.
2314
+ * @example
2315
+ * const r = await acteo.casa.pad.verifica({ cnp, judet: "Cluj", localitate: "Cluj-Napoca", acord: true })
2316
+ * console.log(r.valabila ? "Are polita PAD" : "Fara polita PAD valabila")
2317
+ */
2318
+ verifica(cerere: CererePolitaPad, optiuni?: OptiuniVerifica): Promise<PolitaPadGata>;
2319
+ /**
2320
+ * Porneste verificarea fara sa astepte. Afli raspunsul cu
2321
+ * {@link ClientPad.asteapta}, {@link ClientPad.rezultat} sau prin webhook la `callbackUrl`.
2322
+ *
2323
+ * @param cerere ca la {@link ClientPad.verifica}, plus `callbackUrl` optional.
2324
+ * @param optiuni `signal` pentru anulare.
2325
+ * @returns verificarea in curs, cu `requestId`.
2326
+ * @throws {@link EroareValidare} date invalide, local sau HTTP 400/422.
2327
+ * @throws {@link EroareLimita} cota atinsa sau prea multe verificari in curs (`OCUPAT`).
2328
+ * @throws {@link EroareServer} PADROM e oprit temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`) sau `INDISPONIBIL`; netaxat.
2329
+ */
2330
+ porneste(cerere: CererePolitaPad & {
2331
+ readonly callbackUrl?: string;
2332
+ }, optiuni?: OptiuniCerere): Promise<PolitaPadPornita>;
2333
+ /**
2334
+ * Interogheaza o singura data rezultatul. Nu consuma din cota.
2335
+ *
2336
+ * @param referinta raspunsul de la `porneste()` sau `requestId`.
2337
+ * @param optiuni `signal` pentru anulare.
2338
+ * @returns verdictul sau cererea inca in curs (`status: "processing"`).
2339
+ * @throws {@link EroareVerificare} verificarea s-a incheiat cu eroare; motivul e in `cod`.
2340
+ * @throws {@link EroareNegasit} cererea nu exista in contul cheii sau a trecut de 30 de zile (`NEGASIT`).
2341
+ */
2342
+ rezultat(referinta: ReferintaPolitaPad, optiuni?: OptiuniCerere): Promise<RezultatPolitaPad>;
2343
+ /**
2344
+ * Interogheaza periodic pana la raspunsul PADROM. Nu consuma din cota.
2345
+ *
2346
+ * @param referinta raspunsul de la `porneste()` sau `requestId`.
2347
+ * @param optiuni `timeoutMs`, `intervalMs` si `signal`.
2348
+ * @returns verdictul.
2349
+ * @throws {@link EroareVerificare} verificarea s-a incheiat cu eroare; motivul e in `cod`.
2350
+ * @throws {@link EroareTimeoutVerificare} raspunsul nu a venit in `timeoutMs`.
2351
+ */
2352
+ asteapta(referinta: ReferintaPolitaPad, optiuni?: OptiuniVerifica): Promise<PolitaPadGata>;
2353
+ }
2354
+ /** Domeniul casa: polita PAD a unei locuinte. */
2355
+ declare class ClientCasa {
2356
+ /** Polita PAD: `acteo.casa.pad.verifica({ cnp, judet, localitate, acord: true })`. */
2357
+ readonly pad: ClientPad;
2358
+ /** @internal */
2359
+ constructor(ruleaza: Rulare);
2360
+ }
2361
+ /**
2362
+ * Programarile trimise clientilor tai. Afacerea ta trimite programarea, iar Acteo
2363
+ * ii trimite clientului remindere: la primire si cu 7 zile, cu o zi si cu 3 ore
2364
+ * inainte. Clientul se recunoaste dupa email.
2365
+ *
2366
+ * API-ul de programari e gratuit: nu cere abonament si nu are limita de clienti.
2367
+ * O cerere refuzata nu scrie nimic.
2368
+ */
2369
+ declare class ClientProgramari {
2370
+ #private;
2371
+ /** @internal */
2372
+ constructor(ruleaza: Rulare);
2373
+ /**
2374
+ * Trimite o programare. Cu un `idExtern` deja trimis, programarea existenta se
2375
+ * actualizeaza (`creata: false`), iar clientul ei ramane acelasi. Nu se repeta
2376
+ * automat dupa un raspuns de la API, ca o programare sa nu plece de doua ori.
2377
+ *
2378
+ * @param cerere `client.email`, `incepeLa`, `titlu` si, optional, `idExtern`, `durataMinute`, `locatie`, `cuCine`, `note`, `url`, `necesitaConfirmare`, `confirmareInMaximOre`, `confirmareCuMinimOreInainte`, `remindere`, `sms`.
2379
+ * @param optiuni `signal` pentru anulare.
2380
+ * @returns programarea, cu `creata: true` cand e noua.
2381
+ * @throws {@link EroareValidare} date lipsa (local) sau invalide (400); 422 pentru email invalid, data in trecut, link fara https, un `idExtern` folosit pentru alt client, `PROFIL_EXPEDITOR_LIPSA` sau `ADRESA_AFACERII_LIPSA`.
2382
+ * @throws {@link EroareConflict} clientul nu mai primeste programari de la tine (`CLIENT_INDISPONIBIL`).
2383
+ * @throws {@link EroareLimita} `LIMIT_ATINS` (prea multi clienti noi fara cont azi, vezi `limita`) sau `PREA_MULTE_CERERI` (reia dupa `retryAfterMs`).
2384
+ * @throws {@link EroareInterzis} trimiterea de programari e oprita pentru acest cont.
2385
+ * @example
2386
+ * const p = await acteo.programari.creeaza({
2387
+ * idExtern: "rez-2027-0042",
2388
+ * client: { email: "ana@example.com", nume: "Ana Pop" },
2389
+ * incepeLa: "2027-05-12T10:00:00+03:00",
2390
+ * titlu: "Consultație",
2391
+ * necesitaConfirmare: true,
2392
+ * confirmareInMaximOre: 48, // clientul are 48 de ore sa confirme
2393
+ * })
2394
+ * console.log(p.id, p.creata, p.client.stare, p.confirmareExpiraLa)
2395
+ */
2396
+ creeaza(cerere: CerereProgramare, optiuni?: OptiuniCerere): Promise<ProgramareTrimisa>;
2397
+ /**
2398
+ * Listeaza o pagina de programari, in ordinea datei de inceput, inclusiv cele
2399
+ * anulate sau trecute. Pentru pagina urmatoare trimite `urmatorulCursor` ca `cursor`.
2400
+ *
2401
+ * @param filtre `din`, `pana`, `cursor` si `limita` (1 - 100, implicit 50), toate optionale.
2402
+ * @param optiuni `signal` pentru anulare.
2403
+ * @returns programarile din pagina si `urmatorulCursor`, `null` la ultima pagina.
2404
+ * @throws {@link EroareValidare} `limita` in afara intervalului (local) sau `din` / `pana` fara ora si fus orar (400).
2405
+ * @throws {@link EroareLimita} `PREA_MULTE_CERERI`, dupa reincercarile automate.
2406
+ * @example
2407
+ * const din = new Date()
2408
+ * let cursor: string | undefined
2409
+ * do {
2410
+ * const pagina = await acteo.programari.lista({ din, cursor })
2411
+ * for (const p of pagina.programari) console.log(p.incepeLa, p.titlu)
2412
+ * cursor = pagina.urmatorulCursor ?? undefined
2413
+ * } while (cursor)
2414
+ */
2415
+ lista(filtre?: OptiuniListaProgramari, optiuni?: OptiuniCerere): Promise<ListaProgramari>;
2416
+ /**
2417
+ * Citeste o programare.
2418
+ *
2419
+ * @param id `id`-ul programarii, din raspunsul la {@link ClientProgramari.creeaza} sau din {@link ClientProgramari.lista}.
2420
+ * @param optiuni `signal` pentru anulare.
2421
+ * @returns programarea.
2422
+ * @throws {@link EroareValidare} `id` gol (local) sau invalid (400).
2423
+ * @throws {@link EroareNegasit} programarea nu exista in contul cheii (`NEGASIT`).
2424
+ * @throws {@link EroareLimita} `PREA_MULTE_CERERI`, dupa reincercarile automate.
2425
+ * @example
2426
+ * const p = await acteo.programari.obtine(id)
2427
+ * if (p.confirmatLa) console.log("Clientul a confirmat")
2428
+ */
2429
+ obtine(id: string, optiuni?: OptiuniCerere): Promise<Programare>;
2430
+ /**
2431
+ * Modifica o programare. Se schimba doar campurile trimise, iar `null` goleste
2432
+ * un camp optional. Mutarea datei cere o confirmare noua. Emailul clientului nu
2433
+ * se schimba: anuleaza programarea si creeaza una noua. Nu se repeta automat
2434
+ * dupa un raspuns de la API.
2435
+ *
2436
+ * @param id `id`-ul programarii.
2437
+ * @param modificare campurile de schimbat.
2438
+ * @param optiuni `signal` pentru anulare.
2439
+ * @returns programarea dupa modificare.
2440
+ * @throws {@link EroareValidare} `id` sau `titlu` gol (local), date invalide (400) sau care nu pot fi folosite (422: data in trecut, link fara https).
2441
+ * @throws {@link EroareNegasit} programarea nu exista in contul cheii (`NEGASIT`).
2442
+ * @throws {@link EroareConflict} programarea e anulata si nu se mai poate muta.
2443
+ * @throws {@link EroareLimita} `PREA_MULTE_CERERI`; reia dupa `retryAfterMs`.
2444
+ * @example
2445
+ * await acteo.programari.actualizeaza(id, { incepeLa: "2027-05-13T10:00:00+03:00", locatie: null })
2446
+ */
2447
+ actualizeaza(id: string, modificare: ModificareProgramare, optiuni?: OptiuniCerere): Promise<Programare>;
2448
+ /**
2449
+ * Anuleaza o programare: reminderele nu mai pleaca. A doua anulare intoarce
2450
+ * aceeasi programare, fara alte efecte, deci cererea se reincearca sigur.
2451
+ *
2452
+ * @param id `id`-ul programarii.
2453
+ * @param optiuni `signal` pentru anulare.
2454
+ * @returns programarea anulata (`status: "anulata"`).
2455
+ * @throws {@link EroareValidare} `id` gol (local) sau invalid (400).
2456
+ * @throws {@link EroareNegasit} programarea nu exista in contul cheii (`NEGASIT`).
2457
+ * @throws {@link EroareLimita} `PREA_MULTE_CERERI`, dupa reincercarile automate.
2458
+ * @example
2459
+ * const p = await acteo.programari.anuleaza(id)
2460
+ * console.log(p.status) // "anulata"
2461
+ */
2462
+ anuleaza(id: string, optiuni?: OptiuniCerere): Promise<Programare>;
2463
+ }
1747
2464
  /** Citirea webhook-urilor trimise de API. Nu face cereri pe retea. */
1748
2465
  declare class ClientWebhooks {
1749
2466
  /**
@@ -1754,9 +2471,18 @@ declare class ClientWebhooks {
1754
2471
  * @throws {@link EroareWebhook} corp invalid.
1755
2472
  */
1756
2473
  parseazaRezultat(corp: unknown): WebhookRezultat;
2474
+ /**
2475
+ * Valideaza corpul unui webhook de rezultat al unei verificari de polita PAD
2476
+ * (trimis la `callbackUrl`).
2477
+ *
2478
+ * @param corp corpul cererii, ca string sau obiect deja parsat.
2479
+ * @returns verdictul sau eroarea verificarii.
2480
+ * @throws {@link EroareWebhook} corp invalid.
2481
+ */
2482
+ parseazaRezultatPad(corp: unknown): WebhookRezultatPad;
1757
2483
  /**
1758
2484
  * Verifica cheia si corpul unui webhook de notificare (`document.expira`,
1759
- * evenimentele celorlalte servicii sau `webhook.test`).
2485
+ * evenimentele celorlalte servicii, cele ale programarilor sau `webhook.test`).
1760
2486
  *
1761
2487
  * @param corp corpul cererii.
1762
2488
  * @param headers headerele cererii.
@@ -1769,7 +2495,8 @@ declare class ClientWebhooks {
1769
2495
  /**
1770
2496
  * Clientul API-ului Acteo, organizat pe domenii: `acteo.auto.rca`,
1771
2497
  * `acteo.auto.itp`, `acteo.auto.rovinieta`, `acteo.auto.arr`, `acteo.auto.flota`,
1772
- * `acteo.auto.vin`, `acteo.auto.numere`, `acteo.auto.imagini` si `acteo.webhooks`.
2498
+ * `acteo.auto.vin`, `acteo.auto.numere`, `acteo.auto.imagini`, `acteo.casa.pad`,
2499
+ * `acteo.programari` si `acteo.webhooks`.
1773
2500
  *
1774
2501
  * Toate metodele intorc `Promise` si arunca subclase de {@link VerificRcaError}.
1775
2502
  * Erorile trecatoare sunt reincercate automat, fara sa repete vreodata o
@@ -1785,6 +2512,10 @@ declare class ClientWebhooks {
1785
2512
  declare class Acteo {
1786
2513
  /** Documentele unei masini (RCA, ITP, rovinieta, ARR), flota, VIN, numere si poze. */
1787
2514
  readonly auto: ClientAuto;
2515
+ /** Locuinta: verificarea politei PAD. */
2516
+ readonly casa: ClientCasa;
2517
+ /** Programarile trimise clientilor tai, cu remindere: `creeaza()`, `lista()`, `obtine()`, `actualizeaza()`, `anuleaza()`. */
2518
+ readonly programari: ClientProgramari;
1788
2519
  /** Citirea webhook-urilor. */
1789
2520
  readonly webhooks: ClientWebhooks;
1790
2521
  /**
@@ -1797,4 +2528,4 @@ declare class Acteo {
1797
2528
  constructor(optiuni?: OptiuniClient);
1798
2529
  }
1799
2530
 
1800
- export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
2531
+ export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CererePolitaPad, type CerereProgramare, type CerereVerificare, type ClientArr, ClientAuto, ClientCasa, ClientDocument, ClientImagini, type ClientItp, ClientNumere, ClientPad, ClientProgramari, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DataProgramare, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type ListaProgramari, type ModificareProgramare, MomentReminder, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniListaProgramari, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type PolitaPadGata, type PolitaPadInCurs, type PolitaPadPornita, type Programare, type ProgramareTrimisa, type RaspunsDocument, type RaspunsVerificare, type ReferintaPolitaPad, type ReferintaVerificare, type RezultatDocument, type RezultatPolitaPad, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookProgramareClientDezabonat, type WebhookProgramareConfirmareExpirata, type WebhookProgramareConfirmata, type WebhookRezultat, type WebhookRezultatPad, type WebhookTermenExpira, type WebhookTest, esteCnpValid, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, parseazaWebhookRezultatPad, verificaWebhookNotificare };