@acteo/api 0.5.0 → 0.7.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/CHANGELOG.md +25 -0
- package/README.md +209 -17
- package/dist/index.cjs +636 -26
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +831 -35
- package/dist/index.d.ts +831 -35
- package/dist/index.js +632 -28
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/index.d.cts
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`,
|
|
31
|
-
* (numarul de masini din plan), `VEHICUL_EXISTENT`,
|
|
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 `
|
|
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
|
|
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 `
|
|
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
|
|
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"]>;
|
|
@@ -733,6 +862,10 @@ declare const NumarDisponibilSchema: Schema.Struct<{
|
|
|
733
862
|
declare const UnghiImagine: Schema.Literal<["trei-sferturi", "fata", "profil", "spate", "trei-sferturi-dreapta", "profil-dreapta"]>;
|
|
734
863
|
/** Unghiul pozei: `"trei-sferturi"` (implicit), `"fata"`, `"profil"`, `"spate"`, `"trei-sferturi-dreapta"`, `"profil-dreapta"`. */
|
|
735
864
|
type UnghiImagine = typeof UnghiImagine.Type;
|
|
865
|
+
/** Finisajele vopselei. */
|
|
866
|
+
declare const FinisajImagine: Schema.Literal<["matte", "satin", "gloss", "metallic"]>;
|
|
867
|
+
/** Finisajul vopselei: `"matte"`, `"satin"`, `"gloss"` (implicit) sau `"metallic"`. */
|
|
868
|
+
type FinisajImagine = typeof FinisajImagine.Type;
|
|
736
869
|
/**
|
|
737
870
|
* Starea pozei:
|
|
738
871
|
* - `gata`: poza masinii cerute (se taxeaza);
|
|
@@ -764,11 +897,19 @@ declare const ImagineMasinaSchema: Schema.Struct<{
|
|
|
764
897
|
latime: typeof Schema.Number;
|
|
765
898
|
/** Inaltimea pozei, in pixeli. */
|
|
766
899
|
inaltime: typeof Schema.Number;
|
|
767
|
-
/** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. */
|
|
900
|
+
/** Marca canonica, sau cea trimisa daca inca nu e cunoscuta. Goala la cererile cu `vin` cat timp poza nu e gata. */
|
|
768
901
|
marca: typeof Schema.String;
|
|
769
|
-
/** Modelul canonic, sau cel trimis daca inca nu e cunoscut. */
|
|
902
|
+
/** Modelul canonic, sau cel trimis daca inca nu e cunoscut. Gol la cererile cu `vin` cat timp poza nu e gata. */
|
|
770
903
|
model: typeof Schema.String;
|
|
771
|
-
/**
|
|
904
|
+
/** Culoarea pozei (slug din paleta); `null` cand nu ai cerut nici culoare, nici finisaj. */
|
|
905
|
+
culoare: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
|
|
906
|
+
default: () => null;
|
|
907
|
+
}>;
|
|
908
|
+
/** Finisajul pozei; `null` cand nu ai cerut nici culoare, nici finisaj. */
|
|
909
|
+
finisaj: Schema.optionalWith<Schema.NullOr<Schema.Literal<["matte", "satin", "gloss", "metallic"]>>, {
|
|
910
|
+
default: () => null;
|
|
911
|
+
}>;
|
|
912
|
+
/** Generatia aleasa dupa an; `null` cand nu e aleasa inca si la cererile cu `vin` cat timp poza nu e gata. */
|
|
772
913
|
generatie: Schema.NullOr<Schema.Struct<{
|
|
773
914
|
/** Numele generatiei, ex: `Volkswagen Golf VII`. */
|
|
774
915
|
eticheta: typeof Schema.String;
|
|
@@ -780,6 +921,270 @@ declare const ImagineMasinaSchema: Schema.Struct<{
|
|
|
780
921
|
caroserie: typeof Schema.String;
|
|
781
922
|
}>>;
|
|
782
923
|
}>;
|
|
924
|
+
declare const CuloriImaginiSchema: Schema.Struct<{
|
|
925
|
+
/** Culorile din paleta, in ordinea ei. */
|
|
926
|
+
culori: Schema.Array$<Schema.Struct<{
|
|
927
|
+
/** Valoarea pe care o trimiti in `culoare`, ex: `rosu`. */
|
|
928
|
+
slug: typeof Schema.String;
|
|
929
|
+
/** Numele culorii, de afisat. */
|
|
930
|
+
nume: typeof Schema.String;
|
|
931
|
+
/** Culoarea ca hex, ex: `#c1121f`, pentru un selector de culori. */
|
|
932
|
+
hex: typeof Schema.String;
|
|
933
|
+
}>>;
|
|
934
|
+
/** Finisajele acceptate in `finisaj`. Text simplu, ca un finisaj nou sa nu strice citirea paletei. */
|
|
935
|
+
finisaje: Schema.Array$<typeof Schema.String>;
|
|
936
|
+
}>;
|
|
937
|
+
/** Paleta de culori si finisajele pozelor. */
|
|
938
|
+
type CuloriImagini = typeof CuloriImaginiSchema.Type;
|
|
939
|
+
declare const PolitaPadPornitaSchema: Schema.Struct<{
|
|
940
|
+
/** Mereu `"processing"`: PADROM e interogat acum. */
|
|
941
|
+
status: Schema.Literal<["processing"]>;
|
|
942
|
+
/** Cand a pornit verificarea. */
|
|
943
|
+
queuedAt: typeof Schema.Date;
|
|
944
|
+
/** Cererea GET de polling, cu id-ul deja completat. */
|
|
945
|
+
pollUrl: typeof Schema.String;
|
|
946
|
+
/** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
|
|
947
|
+
requestId: typeof Schema.String;
|
|
948
|
+
/** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
|
|
949
|
+
cnpMascat: typeof Schema.String;
|
|
950
|
+
/** Judetul, cum apare in nomenclatorul PADROM. */
|
|
951
|
+
judet: typeof Schema.String;
|
|
952
|
+
/** Localitatea, cum apare in nomenclatorul PADROM. */
|
|
953
|
+
localitate: typeof Schema.String;
|
|
954
|
+
/** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
|
|
955
|
+
laData: typeof Schema.String;
|
|
956
|
+
}>;
|
|
957
|
+
declare const PolitaPadInCursSchema: Schema.Struct<{
|
|
958
|
+
/** Mereu `"processing"`: PADROM nu a raspuns inca. */
|
|
959
|
+
status: Schema.Literal<["processing"]>;
|
|
960
|
+
/** Cand a pornit verificarea. */
|
|
961
|
+
queuedAt: typeof Schema.Date;
|
|
962
|
+
/** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
|
|
963
|
+
requestId: typeof Schema.String;
|
|
964
|
+
/** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
|
|
965
|
+
cnpMascat: typeof Schema.String;
|
|
966
|
+
/** Judetul, cum apare in nomenclatorul PADROM. */
|
|
967
|
+
judet: typeof Schema.String;
|
|
968
|
+
/** Localitatea, cum apare in nomenclatorul PADROM. */
|
|
969
|
+
localitate: typeof Schema.String;
|
|
970
|
+
/** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
|
|
971
|
+
laData: typeof Schema.String;
|
|
972
|
+
}>;
|
|
973
|
+
declare const PolitaPadGataSchema: Schema.Struct<{
|
|
974
|
+
/** Mereu `"done"`: PADROM a raspuns. */
|
|
975
|
+
status: Schema.Literal<["done"]>;
|
|
976
|
+
/** `true`: PADROM a gasit o polita valabila la data ceruta. `false`: nu a gasit una. */
|
|
977
|
+
valabila: typeof Schema.Boolean;
|
|
978
|
+
/** Seria si numarul politei, cand PADROM le arata. */
|
|
979
|
+
serieNumar: Schema.NullOr<typeof Schema.String>;
|
|
980
|
+
/** Asiguratorul care a emis polita, cand PADROM il arata. */
|
|
981
|
+
distribuitor: Schema.NullOr<typeof Schema.String>;
|
|
982
|
+
/** Cand a raspuns PADROM. */
|
|
983
|
+
verificatLa: typeof Schema.Date;
|
|
984
|
+
/** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
|
|
985
|
+
requestId: typeof Schema.String;
|
|
986
|
+
/** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
|
|
987
|
+
cnpMascat: typeof Schema.String;
|
|
988
|
+
/** Judetul, cum apare in nomenclatorul PADROM. */
|
|
989
|
+
judet: typeof Schema.String;
|
|
990
|
+
/** Localitatea, cum apare in nomenclatorul PADROM. */
|
|
991
|
+
localitate: typeof Schema.String;
|
|
992
|
+
/** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
|
|
993
|
+
laData: typeof Schema.String;
|
|
994
|
+
}>;
|
|
995
|
+
declare const WebhookRezultatPadSchema: Schema.Union<[Schema.Struct<{
|
|
996
|
+
/** Mereu `"done"`: PADROM a raspuns. */
|
|
997
|
+
status: Schema.Literal<["done"]>;
|
|
998
|
+
/** `true`: PADROM a gasit o polita valabila la data ceruta. `false`: nu a gasit una. */
|
|
999
|
+
valabila: typeof Schema.Boolean;
|
|
1000
|
+
/** Seria si numarul politei, cand PADROM le arata. */
|
|
1001
|
+
serieNumar: Schema.NullOr<typeof Schema.String>;
|
|
1002
|
+
/** Asiguratorul care a emis polita, cand PADROM il arata. */
|
|
1003
|
+
distribuitor: Schema.NullOr<typeof Schema.String>;
|
|
1004
|
+
/** Cand a raspuns PADROM. */
|
|
1005
|
+
verificatLa: typeof Schema.Date;
|
|
1006
|
+
/** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
|
|
1007
|
+
requestId: typeof Schema.String;
|
|
1008
|
+
/** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
|
|
1009
|
+
cnpMascat: typeof Schema.String;
|
|
1010
|
+
/** Judetul, cum apare in nomenclatorul PADROM. */
|
|
1011
|
+
judet: typeof Schema.String;
|
|
1012
|
+
/** Localitatea, cum apare in nomenclatorul PADROM. */
|
|
1013
|
+
localitate: typeof Schema.String;
|
|
1014
|
+
/** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
|
|
1015
|
+
laData: typeof Schema.String;
|
|
1016
|
+
}>, Schema.Struct<{
|
|
1017
|
+
/** Mereu `"error"`. */
|
|
1018
|
+
status: Schema.Literal<["error"]>;
|
|
1019
|
+
/** Motivul. Vezi {@link CodEsecVerificare}. `INVALID_IDENTIFIER` = PADROM a refuzat datele (taxat). */
|
|
1020
|
+
code: Schema.optional<typeof Schema.String>;
|
|
1021
|
+
/** Motivul, in romana. */
|
|
1022
|
+
error: typeof Schema.String;
|
|
1023
|
+
/** ID-ul cererii. Il folosesti la `rezultat()` si apare si in webhook. */
|
|
1024
|
+
requestId: typeof Schema.String;
|
|
1025
|
+
/** CNP-ul cu cifrele din mijloc ascunse, ex: `1*********012`. */
|
|
1026
|
+
cnpMascat: typeof Schema.String;
|
|
1027
|
+
/** Judetul, cum apare in nomenclatorul PADROM. */
|
|
1028
|
+
judet: typeof Schema.String;
|
|
1029
|
+
/** Localitatea, cum apare in nomenclatorul PADROM. */
|
|
1030
|
+
localitate: typeof Schema.String;
|
|
1031
|
+
/** Data la care s-a verificat polita, `AAAA-LL-ZZ`. */
|
|
1032
|
+
laData: typeof Schema.String;
|
|
1033
|
+
}>]>;
|
|
1034
|
+
/**
|
|
1035
|
+
* Payloadul POST trimis la `callbackUrl` cand verificarea unei polite PAD se
|
|
1036
|
+
* termina: `status: "done"` cu verdictul sau `status: "error"` cu `code`.
|
|
1037
|
+
*/
|
|
1038
|
+
type WebhookRezultatPad = typeof WebhookRezultatPadSchema.Type;
|
|
1039
|
+
/** Cand pleaca un reminder: `7z` cu 7 zile inainte, `1z` cu o zi inainte, `3h` cu 3 ore inainte. */
|
|
1040
|
+
declare const MomentReminder: Schema.Literal<["7z", "1z", "3h"]>;
|
|
1041
|
+
/** Momentul unui reminder: `"7z"`, `"1z"` sau `"3h"`. Vezi {@link MomentReminder}. */
|
|
1042
|
+
type MomentReminder = typeof MomentReminder.Type;
|
|
1043
|
+
declare const ProgramareSchema: Schema.Struct<{
|
|
1044
|
+
/** ID-ul programarii la Acteo, folosit la `obtine()`, `actualizeaza()` si `anuleaza()`. */
|
|
1045
|
+
id: typeof Schema.String;
|
|
1046
|
+
/** ID-ul din programul tau, daca l-ai trimis. */
|
|
1047
|
+
idExtern: Schema.NullOr<typeof Schema.String>;
|
|
1048
|
+
/** `programata`: urmeaza; `anulata`: ai anulat-o; `trecuta`: ora de inceput a trecut. */
|
|
1049
|
+
status: Schema.Literal<["programata", "anulata", "trecuta"]>;
|
|
1050
|
+
/** Clientul programat. */
|
|
1051
|
+
client: Schema.Struct<{
|
|
1052
|
+
/** Emailul clientului, cum l-ai trimis. */
|
|
1053
|
+
email: typeof Schema.String;
|
|
1054
|
+
/** Numele clientului. */
|
|
1055
|
+
nume: Schema.NullOr<typeof Schema.String>;
|
|
1056
|
+
/**
|
|
1057
|
+
* `cont`: are cont Acteo si vede programarea acolo; `invitat`: nu are cont si
|
|
1058
|
+
* primeste remindere pe email; `dezabonat`: nu mai primeste programari de la tine.
|
|
1059
|
+
*/
|
|
1060
|
+
stare: Schema.Literal<["cont", "invitat", "dezabonat"]>;
|
|
1061
|
+
}>;
|
|
1062
|
+
/** Data si ora programarii. */
|
|
1063
|
+
incepeLa: typeof Schema.Date;
|
|
1064
|
+
/** Cat dureaza programarea, in minute. */
|
|
1065
|
+
durataMinute: Schema.NullOr<typeof Schema.Number>;
|
|
1066
|
+
/** Ce fel de programare e, cum o vede clientul in remindere. */
|
|
1067
|
+
titlu: typeof Schema.String;
|
|
1068
|
+
/** Unde are loc programarea, daca difera de adresa afacerii. */
|
|
1069
|
+
locatie: Schema.NullOr<typeof Schema.String>;
|
|
1070
|
+
/** La cine e programarea; `null` daca nu l-ai trimis. */
|
|
1071
|
+
cuCine: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
|
|
1072
|
+
default: () => null;
|
|
1073
|
+
}>;
|
|
1074
|
+
/** Ce trebuie sa stie clientul inainte. */
|
|
1075
|
+
note: Schema.NullOr<typeof Schema.String>;
|
|
1076
|
+
/** Linkul primit de client in remindere. */
|
|
1077
|
+
url: Schema.NullOr<typeof Schema.String>;
|
|
1078
|
+
/** Clientul e rugat sa confirme ca vine. */
|
|
1079
|
+
necesitaConfirmare: typeof Schema.Boolean;
|
|
1080
|
+
/** Cand a confirmat clientul ca vine; `null` pana atunci. */
|
|
1081
|
+
confirmatLa: Schema.NullOr<typeof Schema.Date>;
|
|
1082
|
+
/** Cate ore are clientul de la primirea programarii ca sa confirme; `null` fara acest termen. */
|
|
1083
|
+
confirmareInMaximOre: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
|
|
1084
|
+
default: () => null;
|
|
1085
|
+
}>;
|
|
1086
|
+
/** Cu cate ore inainte de programare trebuie sa confirme clientul cel tarziu; `null` fara acest termen. */
|
|
1087
|
+
confirmareCuMinimOreInainte: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
|
|
1088
|
+
default: () => null;
|
|
1089
|
+
}>;
|
|
1090
|
+
/** Pana cand poate confirma clientul; `null` cand nu e un termen. */
|
|
1091
|
+
confirmareExpiraLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
|
|
1092
|
+
default: () => null;
|
|
1093
|
+
}>;
|
|
1094
|
+
/** Cand a trecut termenul fara confirmare; `null` pana atunci. Programarea ramane activa. */
|
|
1095
|
+
confirmareExpirataLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
|
|
1096
|
+
default: () => null;
|
|
1097
|
+
}>;
|
|
1098
|
+
/** Cand a deschis clientul programarea; `null` pana atunci sau dupa ce modifici ce vede clientul. */
|
|
1099
|
+
vazutLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
|
|
1100
|
+
default: () => null;
|
|
1101
|
+
}>;
|
|
1102
|
+
/** Ce remindere primeste clientul. */
|
|
1103
|
+
remindere: Schema.Array$<Schema.Literal<["7z", "1z", "3h"]>>;
|
|
1104
|
+
/** `false`: fara SMS; `true`: SMS daca planul il include; `null`: urmeaza setarea din cont. */
|
|
1105
|
+
sms: Schema.NullOr<typeof Schema.Boolean>;
|
|
1106
|
+
/** Cand a fost creata programarea. */
|
|
1107
|
+
creatLa: typeof Schema.Date;
|
|
1108
|
+
/** Ultima modificare. */
|
|
1109
|
+
actualizatLa: typeof Schema.Date;
|
|
1110
|
+
}>;
|
|
1111
|
+
/** O programare trimisa de afacerea ta. */
|
|
1112
|
+
type Programare = typeof ProgramareSchema.Type;
|
|
1113
|
+
declare const ListaProgramariSchema: Schema.Struct<{
|
|
1114
|
+
/** Programarile din pagina, inclusiv cele anulate sau trecute (vezi `status`). */
|
|
1115
|
+
programari: Schema.Array$<Schema.Struct<{
|
|
1116
|
+
/** ID-ul programarii la Acteo, folosit la `obtine()`, `actualizeaza()` si `anuleaza()`. */
|
|
1117
|
+
id: typeof Schema.String;
|
|
1118
|
+
/** ID-ul din programul tau, daca l-ai trimis. */
|
|
1119
|
+
idExtern: Schema.NullOr<typeof Schema.String>;
|
|
1120
|
+
/** `programata`: urmeaza; `anulata`: ai anulat-o; `trecuta`: ora de inceput a trecut. */
|
|
1121
|
+
status: Schema.Literal<["programata", "anulata", "trecuta"]>;
|
|
1122
|
+
/** Clientul programat. */
|
|
1123
|
+
client: Schema.Struct<{
|
|
1124
|
+
/** Emailul clientului, cum l-ai trimis. */
|
|
1125
|
+
email: typeof Schema.String;
|
|
1126
|
+
/** Numele clientului. */
|
|
1127
|
+
nume: Schema.NullOr<typeof Schema.String>;
|
|
1128
|
+
/**
|
|
1129
|
+
* `cont`: are cont Acteo si vede programarea acolo; `invitat`: nu are cont si
|
|
1130
|
+
* primeste remindere pe email; `dezabonat`: nu mai primeste programari de la tine.
|
|
1131
|
+
*/
|
|
1132
|
+
stare: Schema.Literal<["cont", "invitat", "dezabonat"]>;
|
|
1133
|
+
}>;
|
|
1134
|
+
/** Data si ora programarii. */
|
|
1135
|
+
incepeLa: typeof Schema.Date;
|
|
1136
|
+
/** Cat dureaza programarea, in minute. */
|
|
1137
|
+
durataMinute: Schema.NullOr<typeof Schema.Number>;
|
|
1138
|
+
/** Ce fel de programare e, cum o vede clientul in remindere. */
|
|
1139
|
+
titlu: typeof Schema.String;
|
|
1140
|
+
/** Unde are loc programarea, daca difera de adresa afacerii. */
|
|
1141
|
+
locatie: Schema.NullOr<typeof Schema.String>;
|
|
1142
|
+
/** La cine e programarea; `null` daca nu l-ai trimis. */
|
|
1143
|
+
cuCine: Schema.optionalWith<Schema.NullOr<typeof Schema.String>, {
|
|
1144
|
+
default: () => null;
|
|
1145
|
+
}>;
|
|
1146
|
+
/** Ce trebuie sa stie clientul inainte. */
|
|
1147
|
+
note: Schema.NullOr<typeof Schema.String>;
|
|
1148
|
+
/** Linkul primit de client in remindere. */
|
|
1149
|
+
url: Schema.NullOr<typeof Schema.String>;
|
|
1150
|
+
/** Clientul e rugat sa confirme ca vine. */
|
|
1151
|
+
necesitaConfirmare: typeof Schema.Boolean;
|
|
1152
|
+
/** Cand a confirmat clientul ca vine; `null` pana atunci. */
|
|
1153
|
+
confirmatLa: Schema.NullOr<typeof Schema.Date>;
|
|
1154
|
+
/** Cate ore are clientul de la primirea programarii ca sa confirme; `null` fara acest termen. */
|
|
1155
|
+
confirmareInMaximOre: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
|
|
1156
|
+
default: () => null;
|
|
1157
|
+
}>;
|
|
1158
|
+
/** Cu cate ore inainte de programare trebuie sa confirme clientul cel tarziu; `null` fara acest termen. */
|
|
1159
|
+
confirmareCuMinimOreInainte: Schema.optionalWith<Schema.NullOr<typeof Schema.Number>, {
|
|
1160
|
+
default: () => null;
|
|
1161
|
+
}>;
|
|
1162
|
+
/** Pana cand poate confirma clientul; `null` cand nu e un termen. */
|
|
1163
|
+
confirmareExpiraLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
|
|
1164
|
+
default: () => null;
|
|
1165
|
+
}>;
|
|
1166
|
+
/** Cand a trecut termenul fara confirmare; `null` pana atunci. Programarea ramane activa. */
|
|
1167
|
+
confirmareExpirataLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
|
|
1168
|
+
default: () => null;
|
|
1169
|
+
}>;
|
|
1170
|
+
/** Cand a deschis clientul programarea; `null` pana atunci sau dupa ce modifici ce vede clientul. */
|
|
1171
|
+
vazutLa: Schema.optionalWith<Schema.NullOr<typeof Schema.Date>, {
|
|
1172
|
+
default: () => null;
|
|
1173
|
+
}>;
|
|
1174
|
+
/** Ce remindere primeste clientul. */
|
|
1175
|
+
remindere: Schema.Array$<Schema.Literal<["7z", "1z", "3h"]>>;
|
|
1176
|
+
/** `false`: fara SMS; `true`: SMS daca planul il include; `null`: urmeaza setarea din cont. */
|
|
1177
|
+
sms: Schema.NullOr<typeof Schema.Boolean>;
|
|
1178
|
+
/** Cand a fost creata programarea. */
|
|
1179
|
+
creatLa: typeof Schema.Date;
|
|
1180
|
+
/** Ultima modificare. */
|
|
1181
|
+
actualizatLa: typeof Schema.Date;
|
|
1182
|
+
}>>;
|
|
1183
|
+
/** Trimite-l ca `cursor` pentru pagina urmatoare; `null` cand nu mai sunt programari. */
|
|
1184
|
+
urmatorulCursor: Schema.NullOr<typeof Schema.String>;
|
|
1185
|
+
}>;
|
|
1186
|
+
/** O pagina de programari, in ordinea datei de inceput. */
|
|
1187
|
+
type ListaProgramari = typeof ListaProgramariSchema.Type;
|
|
783
1188
|
|
|
784
1189
|
/** Campurile comune tuturor erorilor SDK-ului. */
|
|
785
1190
|
interface DateEroare {
|
|
@@ -819,8 +1224,10 @@ declare class EroareConfigurare extends VerificRcaError {
|
|
|
819
1224
|
}
|
|
820
1225
|
/**
|
|
821
1226
|
* 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
|
|
823
|
-
* oficiala refuza valoarea (`INVALID_IDENTIFIER` la
|
|
1227
|
+
* consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand datele
|
|
1228
|
+
* nu pot fi folosite: sursa oficiala refuza valoarea (`INVALID_IDENTIFIER` la
|
|
1229
|
+
* numerele disponibile) sau, la programari, emailul, data sau linkul nu merg ori
|
|
1230
|
+
* lipsesc datele afacerii din cont (`PROFIL_EXPEDITOR_LIPSA`, `ADRESA_AFACERII_LIPSA`).
|
|
824
1231
|
*/
|
|
825
1232
|
declare class EroareValidare extends VerificRcaError {
|
|
826
1233
|
/** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
|
|
@@ -855,7 +1262,10 @@ declare class EroarePlanInactiv extends VerificRcaError {
|
|
|
855
1262
|
/** Numele clasei, afisat in loguri si in stack trace. */
|
|
856
1263
|
readonly name = "EroarePlanInactiv";
|
|
857
1264
|
}
|
|
858
|
-
/**
|
|
1265
|
+
/**
|
|
1266
|
+
* 403: operatia nu e permisa: pe planul curent (`LIMIT_ATINS`, `ARR_NECESITA_PLAN`)
|
|
1267
|
+
* sau, la programari, trimiterea de programari e oprita pentru acest cont.
|
|
1268
|
+
*/
|
|
859
1269
|
declare class EroareInterzis extends VerificRcaError {
|
|
860
1270
|
/** Discriminantul erorii: `"EroareInterzis"`. Util in `switch (err._tag)`. */
|
|
861
1271
|
readonly _tag = "EroareInterzis";
|
|
@@ -879,7 +1289,12 @@ declare class EroareNegasit extends VerificRcaError {
|
|
|
879
1289
|
/** Numele clasei, afisat in loguri si in stack trace. */
|
|
880
1290
|
readonly name = "EroareNegasit";
|
|
881
1291
|
}
|
|
882
|
-
/**
|
|
1292
|
+
/**
|
|
1293
|
+
* 409: conflict cu ce exista deja in cont:
|
|
1294
|
+
* - `VEHICUL_EXISTENT`: vehiculul exista deja in cont;
|
|
1295
|
+
* - `CLIENT_INDISPONIBIL`: clientul nu mai primeste programari de la tine;
|
|
1296
|
+
* - fara cod: programarea e anulata si nu se mai poate modifica.
|
|
1297
|
+
*/
|
|
883
1298
|
declare class EroareConflict extends VerificRcaError {
|
|
884
1299
|
/** Discriminantul erorii: `"EroareConflict"`. Util in `switch (err._tag)`. */
|
|
885
1300
|
readonly _tag = "EroareConflict";
|
|
@@ -894,7 +1309,9 @@ declare class EroareConflict extends VerificRcaError {
|
|
|
894
1309
|
* - `SOLD_INSUFICIENT`: soldul preplatit nu acopera cererile peste plan;
|
|
895
1310
|
* - `PLAFON_NETAXAT`: prea multe raspunsuri netaxate azi (decodari, poze generice);
|
|
896
1311
|
* - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
|
|
897
|
-
* - `
|
|
1312
|
+
* - `LIMIT_ATINS`: la programari, prea multi clienti noi fara cont azi; `limita` spune cati poti invita pe zi;
|
|
1313
|
+
* - `PREA_MULTE_CERERI`: prea multe cereri intr-un interval scurt; SDK-ul reincearca
|
|
1314
|
+
* singur cererile sigure (GET, DELETE) dupa `retryAfterMs`, nu si POST sau PUT;
|
|
898
1315
|
* - `COTA_ATINSA`: cota atinsa, de la un server mai vechi care nu trimite cod.
|
|
899
1316
|
*/
|
|
900
1317
|
declare class EroareLimita extends VerificRcaError {
|
|
@@ -908,6 +1325,8 @@ declare class EroareLimita extends VerificRcaError {
|
|
|
908
1325
|
readonly utilizareZi?: string;
|
|
909
1326
|
/** Consumul lunar, ex: `"4120/10000"`. */
|
|
910
1327
|
readonly utilizareLuna?: string;
|
|
1328
|
+
/** La `LIMIT_ATINS` (programari): numarul de clienti noi pe care ii poti invita pe zi. */
|
|
1329
|
+
readonly limita?: number;
|
|
911
1330
|
/**
|
|
912
1331
|
* Creeaza eroarea. SDK-ul o construieste singur; o creezi manual doar in teste.
|
|
913
1332
|
*
|
|
@@ -917,6 +1336,7 @@ declare class EroareLimita extends VerificRcaError {
|
|
|
917
1336
|
readonly retryAfterMs?: number;
|
|
918
1337
|
readonly utilizareZi?: string;
|
|
919
1338
|
readonly utilizareLuna?: string;
|
|
1339
|
+
readonly limita?: number;
|
|
920
1340
|
});
|
|
921
1341
|
}
|
|
922
1342
|
/**
|
|
@@ -1146,18 +1566,76 @@ interface VehiculNou {
|
|
|
1146
1566
|
}
|
|
1147
1567
|
/** Unghiurile acceptate pentru poza unei masini. */
|
|
1148
1568
|
declare const UNGHIURI_IMAGINE: readonly UnghiImagine[];
|
|
1149
|
-
/**
|
|
1150
|
-
|
|
1569
|
+
/** Finisajele acceptate pentru vopseaua din poza. */
|
|
1570
|
+
declare const FINISAJE_IMAGINE: readonly FinisajImagine[];
|
|
1571
|
+
/** Cum arata poza: aceleasi optiuni, oricum ai numi masina. */
|
|
1572
|
+
interface OptiuniImagine {
|
|
1573
|
+
/** Unghiul pozei. Implicit `"trei-sferturi"`. */
|
|
1574
|
+
readonly unghi?: UnghiImagine;
|
|
1575
|
+
/** Umbra sub masina. Implicit `true`. */
|
|
1576
|
+
readonly umbra?: boolean;
|
|
1577
|
+
/** Culoarea vopselei, slug din paleta (`acteo.auto.imagini.culori()`), ex: `"rosu"`. Fara ea, griul implicit. */
|
|
1578
|
+
readonly culoare?: string;
|
|
1579
|
+
/** Finisajul vopselei. Implicit `"gloss"`. */
|
|
1580
|
+
readonly finisaj?: FinisajImagine;
|
|
1581
|
+
}
|
|
1582
|
+
/** Masina numita prin marca, model si an. */
|
|
1583
|
+
interface CerereImagineMasina extends OptiuniImagine {
|
|
1151
1584
|
/** Marca, ca in talon sau RAR, ex: `Volkswagen`. */
|
|
1152
1585
|
readonly marca: string;
|
|
1153
1586
|
/** Modelul, ex: `Golf`. */
|
|
1154
1587
|
readonly model: string;
|
|
1155
1588
|
/** Anul fabricatiei (1950 - anul viitor); alege generatia. */
|
|
1156
1589
|
readonly an: number;
|
|
1157
|
-
/**
|
|
1158
|
-
readonly
|
|
1159
|
-
|
|
1160
|
-
|
|
1590
|
+
/** Nu se trimite impreuna cu `marca`, `model` si `an`. */
|
|
1591
|
+
readonly vin?: undefined;
|
|
1592
|
+
}
|
|
1593
|
+
/** Masina numita prin seria de sasiu: marca, modelul si anul se afla din VIN. */
|
|
1594
|
+
interface CerereImagineVin extends OptiuniImagine {
|
|
1595
|
+
/** Seria de sasiu (VIN), 17 caractere. Spatiile si literele mici sunt acceptate. */
|
|
1596
|
+
readonly vin: string;
|
|
1597
|
+
/** Nu se trimite impreuna cu `vin`. */
|
|
1598
|
+
readonly marca?: undefined;
|
|
1599
|
+
/** Nu se trimite impreuna cu `vin`. */
|
|
1600
|
+
readonly model?: undefined;
|
|
1601
|
+
/** Nu se trimite impreuna cu `vin`. */
|
|
1602
|
+
readonly an?: undefined;
|
|
1603
|
+
}
|
|
1604
|
+
/** Masina pentru care ceri poza: `{ marca, model, an }` sau `{ vin }`. */
|
|
1605
|
+
type CerereImagine = CerereImagineMasina | CerereImagineVin;
|
|
1606
|
+
/**
|
|
1607
|
+
* Verifica un CNP romanesc: 13 cifre, o data de nastere reala si cifra de
|
|
1608
|
+
* control. Spatiile si liniutele sunt ignorate. Nu spune daca CNP-ul exista.
|
|
1609
|
+
*
|
|
1610
|
+
* @param cnp CNP-ul de verificat.
|
|
1611
|
+
* @returns `true` daca CNP-ul are o forma valida.
|
|
1612
|
+
* @example
|
|
1613
|
+
* esteCnpValid(cnpDinFormular) // true daca forma e corecta
|
|
1614
|
+
* esteCnpValid("1900101400013") // false: cifra de control nu se potriveste
|
|
1615
|
+
*/
|
|
1616
|
+
declare function esteCnpValid(cnp: string): boolean;
|
|
1617
|
+
/**
|
|
1618
|
+
* Datele unei verificari de polita PAD. Locuinta se da prin `judet` si
|
|
1619
|
+
* `localitate` (cu sau fara diacritice), ori prin `judetId` si `localitateId`
|
|
1620
|
+
* din nomenclatorul PADROM.
|
|
1621
|
+
*/
|
|
1622
|
+
interface CererePolitaPad {
|
|
1623
|
+
/** CNP-ul proprietarului, 13 cifre. Spatiile si liniutele sunt acceptate. API-ul nu il pastreaza. */
|
|
1624
|
+
readonly cnp: string;
|
|
1625
|
+
/** Judetul locuintei: numele (`"Cluj"`) sau indicativul (`"CJ"`, `"B"`). La Bucuresti trimite si `sector`. */
|
|
1626
|
+
readonly judet?: string;
|
|
1627
|
+
/** Localitatea locuintei, ex: `"Cluj-Napoca"`. La Bucuresti poate lipsi. */
|
|
1628
|
+
readonly localitate?: string;
|
|
1629
|
+
/** Doar la Bucuresti: sectorul, de la 1 la 6. */
|
|
1630
|
+
readonly sector?: number;
|
|
1631
|
+
/** Alternativa la `judet`: id-ul judetului din nomenclatorul PADROM. Cere si `localitateId`. */
|
|
1632
|
+
readonly judetId?: string;
|
|
1633
|
+
/** Alternativa la `localitate`: id-ul localitatii din nomenclatorul PADROM. */
|
|
1634
|
+
readonly localitateId?: string;
|
|
1635
|
+
/** Data la care verifici polita, `AAAA-LL-ZZ`, cel mult 365 de zile inainte sau dupa azi. Implicit azi. */
|
|
1636
|
+
readonly data?: string;
|
|
1637
|
+
/** Confirmi ca ai acordul proprietarului sau ca esti chiar proprietarul. Obligatoriu `true`. */
|
|
1638
|
+
readonly acord: true;
|
|
1161
1639
|
}
|
|
1162
1640
|
|
|
1163
1641
|
/** Cat mai ai din cota planului, din headerele `X-RateLimit-*`. */
|
|
@@ -1234,7 +1712,7 @@ interface OptiuniAsteptare {
|
|
|
1234
1712
|
}
|
|
1235
1713
|
|
|
1236
1714
|
/** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
|
|
1237
|
-
declare const VERSIUNE_SDK = "0.
|
|
1715
|
+
declare const VERSIUNE_SDK = "0.7.0";
|
|
1238
1716
|
/** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
|
|
1239
1717
|
declare const URL_IMPLICIT = "https://api.acteo.ro";
|
|
1240
1718
|
/** Adresa implicita a clientului legacy {@link VerificRca}. */
|
|
@@ -1467,6 +1945,24 @@ declare class VerificRca {
|
|
|
1467
1945
|
constructor(optiuni?: OptiuniClient);
|
|
1468
1946
|
}
|
|
1469
1947
|
|
|
1948
|
+
/** Verificarea PAD a pornit. Paseaz-o la `rezultat()` sau `asteapta()`. */
|
|
1949
|
+
type PolitaPadPornita = typeof PolitaPadPornitaSchema.Type & {
|
|
1950
|
+
/** Cota ramasa dupa cererea POST, cand API-ul o trimite. */
|
|
1951
|
+
readonly limite?: Limite;
|
|
1952
|
+
};
|
|
1953
|
+
/** PADROM a raspuns: `valabila` spune daca exista o polita valabila la `laData`. */
|
|
1954
|
+
type PolitaPadGata = typeof PolitaPadGataSchema.Type;
|
|
1955
|
+
/** Verificarea PAD e inca in curs: mai intreaba peste cateva secunde. */
|
|
1956
|
+
type PolitaPadInCurs = typeof PolitaPadInCursSchema.Type;
|
|
1957
|
+
/**
|
|
1958
|
+
* Raspunsul la `rezultat()`: verdictul PADROM (`status: "done"`) sau cererea
|
|
1959
|
+
* inca in curs (`status: "processing"`). `status: "error"` devine
|
|
1960
|
+
* {@link EroareVerificare}.
|
|
1961
|
+
*/
|
|
1962
|
+
type RezultatPolitaPad = PolitaPadGata | PolitaPadInCurs;
|
|
1963
|
+
/** Ce primeste `rezultat()`: raspunsul de la `porneste()` sau doar `requestId`. */
|
|
1964
|
+
type ReferintaPolitaPad = PolitaPadPornita | string;
|
|
1965
|
+
|
|
1470
1966
|
/** Decodarea unui VIN, cu cota ramasa. */
|
|
1471
1967
|
type DecodareVin = typeof DecodareVinSchema.Type & {
|
|
1472
1968
|
/** Cota ramasa dupa aceasta cerere, cand API-ul o trimite. */
|
|
@@ -1490,6 +1986,87 @@ interface OptiuniAsteptareImagine {
|
|
|
1490
1986
|
readonly timeoutMs?: number;
|
|
1491
1987
|
}
|
|
1492
1988
|
|
|
1989
|
+
/** O data cu ora si fusul orar: text ISO 8601 (`2027-05-12T10:00:00+03:00`) sau `Date`. */
|
|
1990
|
+
type DataProgramare = string | Date;
|
|
1991
|
+
/** Campurile optionale comune la creare si la modificare. */
|
|
1992
|
+
interface CampuriProgramare {
|
|
1993
|
+
/** Cat dureaza programarea, in minute, intre 5 si 1.440. */
|
|
1994
|
+
readonly durataMinute?: number | null;
|
|
1995
|
+
/** Unde are loc programarea, daca difera de adresa afacerii. */
|
|
1996
|
+
readonly locatie?: string | null;
|
|
1997
|
+
/** La cine e programarea, daca afacerea are mai multi oameni: medicul, frizerul, consultantul. Maxim 120 de caractere. */
|
|
1998
|
+
readonly cuCine?: string | null;
|
|
1999
|
+
/** Ce trebuie sa stie clientul inainte, de exemplu ce sa aduca. */
|
|
2000
|
+
readonly note?: string | null;
|
|
2001
|
+
/** Link https pe care clientul il primeste in remindere, de exemplu pentru o intalnire online. */
|
|
2002
|
+
readonly url?: string | null;
|
|
2003
|
+
/** `true`: clientul e rugat sa confirme ca vine. Implicit `false`. */
|
|
2004
|
+
readonly necesitaConfirmare?: boolean;
|
|
2005
|
+
/**
|
|
2006
|
+
* Clientul are cel mult atatea ore de la primirea programarii ca sa confirme. Intre 1 si 720
|
|
2007
|
+
* (3 zile = 72). Doar cu `necesitaConfirmare: true`. `null` il sterge la modificare.
|
|
2008
|
+
*/
|
|
2009
|
+
readonly confirmareInMaximOre?: number | null;
|
|
2010
|
+
/**
|
|
2011
|
+
* Clientul trebuie sa confirme cu cel putin atatea ore inainte de programare. Intre 1 si 720.
|
|
2012
|
+
* Doar cu `necesitaConfirmare: true`. Cu ambele campuri trimise, conteaza cel care vine primul.
|
|
2013
|
+
* `null` il sterge la modificare.
|
|
2014
|
+
*/
|
|
2015
|
+
readonly confirmareCuMinimOreInainte?: number | null;
|
|
2016
|
+
/** Ce remindere primeste clientul. Implicit toate trei; o lista goala inseamna doar mesajul la primire. */
|
|
2017
|
+
readonly remindere?: readonly MomentReminder[];
|
|
2018
|
+
/** `false`: fara SMS pentru aceasta programare. `true`, lipsa sau `null`: SMS doar daca planul il include si e pornit din cont. */
|
|
2019
|
+
readonly sms?: boolean | null;
|
|
2020
|
+
}
|
|
2021
|
+
/** O programare noua sau, cu un `idExtern` deja trimis, actualizarea ei. */
|
|
2022
|
+
interface CerereProgramare extends CampuriProgramare {
|
|
2023
|
+
/**
|
|
2024
|
+
* ID-ul programarii in programul tau (litere, cifre si `._:-`). Un POST nou cu
|
|
2025
|
+
* acelasi id actualizeaza programarea, nu creeaza una noua. Clientul nu se
|
|
2026
|
+
* schimba: acelasi id cu alt email e refuzat.
|
|
2027
|
+
*/
|
|
2028
|
+
readonly idExtern?: string;
|
|
2029
|
+
/** Clientul programat. Dupa email il recunoastem. */
|
|
2030
|
+
readonly client: {
|
|
2031
|
+
/** Emailul clientului. */
|
|
2032
|
+
readonly email: string;
|
|
2033
|
+
/** Numele clientului, cum apare in remindere. */
|
|
2034
|
+
readonly nume?: string | null;
|
|
2035
|
+
};
|
|
2036
|
+
/** Data si ora programarii, cu fusul orar, in viitor. */
|
|
2037
|
+
readonly incepeLa: DataProgramare;
|
|
2038
|
+
/** Ce fel de programare e, cum o vede clientul in remindere. */
|
|
2039
|
+
readonly titlu: string;
|
|
2040
|
+
}
|
|
2041
|
+
/** Modificarea unei programari: se schimba doar campurile trimise, `null` goleste un camp optional. */
|
|
2042
|
+
interface ModificareProgramare extends CampuriProgramare {
|
|
2043
|
+
/** Doar numele se poate schimba; `null` il sterge. Pentru alt client, anuleaza si creeaza o programare noua. */
|
|
2044
|
+
readonly client?: {
|
|
2045
|
+
/** Numele clientului. */
|
|
2046
|
+
readonly nume?: string | null;
|
|
2047
|
+
};
|
|
2048
|
+
/** Data si ora noua, cu fusul orar, in viitor. Mutarea datei cere o confirmare noua. */
|
|
2049
|
+
readonly incepeLa?: DataProgramare;
|
|
2050
|
+
/** Titlul nou. */
|
|
2051
|
+
readonly titlu?: string;
|
|
2052
|
+
}
|
|
2053
|
+
/** Filtrele si paginarea pentru `lista()`. */
|
|
2054
|
+
interface OptiuniListaProgramari {
|
|
2055
|
+
/** Doar programarile care incep de la aceasta data, cu ora si fusul orar. */
|
|
2056
|
+
readonly din?: DataProgramare;
|
|
2057
|
+
/** Doar programarile care incep inainte de aceasta data, cu ora si fusul orar. */
|
|
2058
|
+
readonly pana?: DataProgramare;
|
|
2059
|
+
/** `urmatorulCursor` din pagina anterioara. */
|
|
2060
|
+
readonly cursor?: string;
|
|
2061
|
+
/** Cate programari vin pe pagina, intre 1 si 100. Implicit 50. */
|
|
2062
|
+
readonly limita?: number;
|
|
2063
|
+
}
|
|
2064
|
+
/** Raspunsul la `creeaza()`: programarea, plus daca e noua sau una existenta actualizata. */
|
|
2065
|
+
type ProgramareTrimisa = Programare & {
|
|
2066
|
+
/** `true` la o programare noua (HTTP 201); `false` cand `idExtern` exista si programarea a fost actualizata (HTTP 200). */
|
|
2067
|
+
readonly creata: boolean;
|
|
2068
|
+
};
|
|
2069
|
+
|
|
1493
2070
|
/** Headerul cu cheia de webhook a contului. */
|
|
1494
2071
|
declare const HEADER_CHEIE_WEBHOOK = "x-acteo-key";
|
|
1495
2072
|
/** Headerul cu numele evenimentului (`document.expira`, `webhook.test` etc.). */
|
|
@@ -1514,6 +2091,21 @@ type HeadereCerere = Headers | Readonly<Record<string, string | readonly string[
|
|
|
1514
2091
|
* })
|
|
1515
2092
|
*/
|
|
1516
2093
|
declare function parseazaWebhookRezultat(corp: unknown): WebhookRezultat;
|
|
2094
|
+
/**
|
|
2095
|
+
* Citeste rezultatul trimis la `callbackUrl` dupa o verificare de polita PAD.
|
|
2096
|
+
* Corpul nu contine CNP-ul, doar `cnpMascat`.
|
|
2097
|
+
*
|
|
2098
|
+
* Foloseste un `callbackUrl` pe HTTPS, greu de ghicit, si potriveste
|
|
2099
|
+
* `requestId` cu cel primit la `casa.pad.porneste()` inainte sa ai incredere in continut.
|
|
2100
|
+
*
|
|
2101
|
+
* @param corp corpul cererii: string, Buffer/Uint8Array sau obiect deja parsat.
|
|
2102
|
+
* @returns verdictul (`status: "done"`) sau eroarea (`status: "error"`), cu datele ca `Date`.
|
|
2103
|
+
* @throws {@link EroareWebhook} corpul nu e JSON (`JSON_INVALID`) sau nu e un rezultat PAD valid (`PAYLOAD_INVALID`).
|
|
2104
|
+
* @example
|
|
2105
|
+
* const r = parseazaWebhookRezultatPad(req.body)
|
|
2106
|
+
* if (r.status === "done") salveaza(r.requestId, r.valabila)
|
|
2107
|
+
*/
|
|
2108
|
+
declare function parseazaWebhookRezultatPad(corp: unknown): WebhookRezultatPad;
|
|
1517
2109
|
/** Optiunile pentru {@link verificaWebhookNotificare}. */
|
|
1518
2110
|
interface OptiuniWebhookNotificare {
|
|
1519
2111
|
/** Cheia de webhook din dashboard (`whsec_...`). */
|
|
@@ -1523,7 +2115,9 @@ interface OptiuniWebhookNotificare {
|
|
|
1523
2115
|
* Verifica si citeste o notificare trimisa la URL-ul de webhook al contului:
|
|
1524
2116
|
* expirarea unui document (`document.expira`), evenimentele celorlalte
|
|
1525
2117
|
* servicii (`dosar.*`, `firma.*`, `marca.*`, `asigurare.schimbare`,
|
|
1526
|
-
* `termen.expira`)
|
|
2118
|
+
* `termen.expira`), raspunsurile clientilor la programari (`programare.confirmata`,
|
|
2119
|
+
* `programare.confirmare_expirata`, `programare.client_dezabonat`) sau testul din
|
|
2120
|
+
* dashboard (`webhook.test`).
|
|
1527
2121
|
*
|
|
1528
2122
|
* Cheia vine in clar in headerul `X-Acteo-Key` si e comparata in timp
|
|
1529
2123
|
* constant cu cea din dashboard. Pastreaza URL-ul pe HTTPS.
|
|
@@ -1700,15 +2294,17 @@ declare class ClientImagini {
|
|
|
1700
2294
|
* netaxata. La `"in-lucru"`, cere din nou dupa `retryAfterMs` sau foloseste
|
|
1701
2295
|
* {@link ClientImagini.asteapta}. Linkul din `url` expira la `expiraLa`.
|
|
1702
2296
|
*
|
|
1703
|
-
* @param cerere `marca
|
|
2297
|
+
* @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
|
|
1704
2298
|
* @param optiuni `signal` pentru anulare.
|
|
1705
2299
|
* @returns poza masinii sau poza generica.
|
|
1706
|
-
* @throws {@link EroareValidare}
|
|
2300
|
+
* @throws {@link EroareValidare} un camp invalid, culoare din afara paletei (`CULOARE_NECUNOSCUTA`) sau VIN din care nu se afla masina (`VIN_NEDECODAT`, netaxat).
|
|
1707
2301
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
|
|
1708
2302
|
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
|
|
1709
2303
|
* @example
|
|
1710
2304
|
* const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
|
|
1711
2305
|
* if (p.status === "gata") afiseaza(p.url)
|
|
2306
|
+
* @example
|
|
2307
|
+
* const rosie = await acteo.auto.imagini.obtine({ vin: "WVWZZZ1KZBW000000", culoare: "rosu", finisaj: "metallic" })
|
|
1712
2308
|
*/
|
|
1713
2309
|
obtine(cerere: CerereImagine, optiuni?: OptiuniCerere): Promise<ImagineMasina>;
|
|
1714
2310
|
/**
|
|
@@ -1716,12 +2312,24 @@ declare class ClientImagini {
|
|
|
1716
2312
|
* nou, cu pauzele din `Retry-After`. Fiecare cerere intermediara e netaxata,
|
|
1717
2313
|
* dar intra in plafonul zilnic de poze generice.
|
|
1718
2314
|
*
|
|
1719
|
-
* @param cerere `marca
|
|
2315
|
+
* @param cerere `{ marca, model, an }` sau `{ vin }`, si optional `unghi`, `umbra`, `culoare`, `finisaj`.
|
|
1720
2316
|
* @param optiuni `timeoutMs` (implicit 2 minute) si `signal`.
|
|
1721
2317
|
* @returns poza cu orice status in afara de `"in-lucru"`.
|
|
1722
2318
|
* @throws {@link EroareTimeoutVerificare} poza nu a fost gata in `timeoutMs`.
|
|
1723
2319
|
*/
|
|
1724
2320
|
asteapta(cerere: CerereImagine, optiuni?: OptiuniAsteptareImagine & OptiuniCerere): Promise<ImagineMasina>;
|
|
2321
|
+
/**
|
|
2322
|
+
* Paleta de culori si finisajele pe care le poti cere in `culoare` si
|
|
2323
|
+
* `finisaj`. Nu consuma din cota. Lista se schimba rar: o poti pastra o ora.
|
|
2324
|
+
*
|
|
2325
|
+
* @param optiuni `signal` pentru anulare.
|
|
2326
|
+
* @returns `culori` (`slug`, `nume`, `hex`) si `finisaje`.
|
|
2327
|
+
* @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
|
|
2328
|
+
* @example
|
|
2329
|
+
* const { culori } = await acteo.auto.imagini.culori()
|
|
2330
|
+
* const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015, culoare: culori[0].slug })
|
|
2331
|
+
*/
|
|
2332
|
+
culori(optiuni?: OptiuniCerere): Promise<CuloriImagini>;
|
|
1725
2333
|
}
|
|
1726
2334
|
/** Domeniul auto: documentele unei masini, flota monitorizata, VIN, numere si poze. */
|
|
1727
2335
|
declare class ClientAuto {
|
|
@@ -1744,6 +2352,180 @@ declare class ClientAuto {
|
|
|
1744
2352
|
/** @internal */
|
|
1745
2353
|
constructor(ruleaza: Rulare);
|
|
1746
2354
|
}
|
|
2355
|
+
/**
|
|
2356
|
+
* Verificarea unei polite PAD (asigurarea obligatorie a locuintei) dupa CNP-ul
|
|
2357
|
+
* proprietarului si localitatea locuintei, la PADROM. Cere abonamentul API
|
|
2358
|
+
* Verificare polita PAD si acordul proprietarului (`acord: true`).
|
|
2359
|
+
*
|
|
2360
|
+
* Verificarea e asincrona si poate dura cateva minute. `verifica()` si
|
|
2361
|
+
* `porneste()` se taxeaza doar cand PADROM raspunde; `rezultat()` si
|
|
2362
|
+
* `asteapta()` sunt gratuite. CNP-ul nu apare in raspunsuri, doar `cnpMascat`.
|
|
2363
|
+
*/
|
|
2364
|
+
declare class ClientPad {
|
|
2365
|
+
#private;
|
|
2366
|
+
/** @internal */
|
|
2367
|
+
constructor(ruleaza: Rulare);
|
|
2368
|
+
/**
|
|
2369
|
+
* Verifica polita si asteapta raspunsul PADROM.
|
|
2370
|
+
*
|
|
2371
|
+
* @param cerere `cnp`, locuinta (`judet` si `localitate`, ori `judetId` si `localitateId`), `data` optionala si `acord: true`.
|
|
2372
|
+
* @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
|
|
2373
|
+
* @returns verdictul: `valabila`, plus `serieNumar` si `distribuitor` cand PADROM le arata.
|
|
2374
|
+
* @throws {@link EroareValidare} CNP, acord sau data invalide (local), ori judet sau localitate negasite (HTTP 422, netaxat).
|
|
2375
|
+
* @throws {@link EroarePlanInactiv} lipseste abonamentul de verificare PAD.
|
|
2376
|
+
* @throws {@link EroareLimita} cota atinsa sau prea multe verificari in curs (`OCUPAT`).
|
|
2377
|
+
* @throws {@link EroareVerificare} PADROM a refuzat datele (`INVALID_IDENTIFIER`) sau nu a raspuns; motivul e in `cod`.
|
|
2378
|
+
* @throws {@link EroareTimeoutVerificare} raspunsul nu a venit in `timeoutMs`.
|
|
2379
|
+
* @example
|
|
2380
|
+
* const r = await acteo.casa.pad.verifica({ cnp, judet: "Cluj", localitate: "Cluj-Napoca", acord: true })
|
|
2381
|
+
* console.log(r.valabila ? "Are polita PAD" : "Fara polita PAD valabila")
|
|
2382
|
+
*/
|
|
2383
|
+
verifica(cerere: CererePolitaPad, optiuni?: OptiuniVerifica): Promise<PolitaPadGata>;
|
|
2384
|
+
/**
|
|
2385
|
+
* Porneste verificarea fara sa astepte. Afli raspunsul cu
|
|
2386
|
+
* {@link ClientPad.asteapta}, {@link ClientPad.rezultat} sau prin webhook la `callbackUrl`.
|
|
2387
|
+
*
|
|
2388
|
+
* @param cerere ca la {@link ClientPad.verifica}, plus `callbackUrl` optional.
|
|
2389
|
+
* @param optiuni `signal` pentru anulare.
|
|
2390
|
+
* @returns verificarea in curs, cu `requestId`.
|
|
2391
|
+
* @throws {@link EroareValidare} date invalide, local sau HTTP 400/422.
|
|
2392
|
+
* @throws {@link EroareLimita} cota atinsa sau prea multe verificari in curs (`OCUPAT`).
|
|
2393
|
+
* @throws {@link EroareServer} PADROM e oprit temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`) sau `INDISPONIBIL`; netaxat.
|
|
2394
|
+
*/
|
|
2395
|
+
porneste(cerere: CererePolitaPad & {
|
|
2396
|
+
readonly callbackUrl?: string;
|
|
2397
|
+
}, optiuni?: OptiuniCerere): Promise<PolitaPadPornita>;
|
|
2398
|
+
/**
|
|
2399
|
+
* Interogheaza o singura data rezultatul. Nu consuma din cota.
|
|
2400
|
+
*
|
|
2401
|
+
* @param referinta raspunsul de la `porneste()` sau `requestId`.
|
|
2402
|
+
* @param optiuni `signal` pentru anulare.
|
|
2403
|
+
* @returns verdictul sau cererea inca in curs (`status: "processing"`).
|
|
2404
|
+
* @throws {@link EroareVerificare} verificarea s-a incheiat cu eroare; motivul e in `cod`.
|
|
2405
|
+
* @throws {@link EroareNegasit} cererea nu exista in contul cheii sau a trecut de 30 de zile (`NEGASIT`).
|
|
2406
|
+
*/
|
|
2407
|
+
rezultat(referinta: ReferintaPolitaPad, optiuni?: OptiuniCerere): Promise<RezultatPolitaPad>;
|
|
2408
|
+
/**
|
|
2409
|
+
* Interogheaza periodic pana la raspunsul PADROM. Nu consuma din cota.
|
|
2410
|
+
*
|
|
2411
|
+
* @param referinta raspunsul de la `porneste()` sau `requestId`.
|
|
2412
|
+
* @param optiuni `timeoutMs`, `intervalMs` si `signal`.
|
|
2413
|
+
* @returns verdictul.
|
|
2414
|
+
* @throws {@link EroareVerificare} verificarea s-a incheiat cu eroare; motivul e in `cod`.
|
|
2415
|
+
* @throws {@link EroareTimeoutVerificare} raspunsul nu a venit in `timeoutMs`.
|
|
2416
|
+
*/
|
|
2417
|
+
asteapta(referinta: ReferintaPolitaPad, optiuni?: OptiuniVerifica): Promise<PolitaPadGata>;
|
|
2418
|
+
}
|
|
2419
|
+
/** Domeniul casa: polita PAD a unei locuinte. */
|
|
2420
|
+
declare class ClientCasa {
|
|
2421
|
+
/** Polita PAD: `acteo.casa.pad.verifica({ cnp, judet, localitate, acord: true })`. */
|
|
2422
|
+
readonly pad: ClientPad;
|
|
2423
|
+
/** @internal */
|
|
2424
|
+
constructor(ruleaza: Rulare);
|
|
2425
|
+
}
|
|
2426
|
+
/**
|
|
2427
|
+
* Programarile trimise clientilor tai. Afacerea ta trimite programarea, iar Acteo
|
|
2428
|
+
* ii trimite clientului remindere: la primire si cu 7 zile, cu o zi si cu 3 ore
|
|
2429
|
+
* inainte. Clientul se recunoaste dupa email.
|
|
2430
|
+
*
|
|
2431
|
+
* API-ul de programari e gratuit: nu cere abonament si nu are limita de clienti.
|
|
2432
|
+
* O cerere refuzata nu scrie nimic.
|
|
2433
|
+
*/
|
|
2434
|
+
declare class ClientProgramari {
|
|
2435
|
+
#private;
|
|
2436
|
+
/** @internal */
|
|
2437
|
+
constructor(ruleaza: Rulare);
|
|
2438
|
+
/**
|
|
2439
|
+
* Trimite o programare. Cu un `idExtern` deja trimis, programarea existenta se
|
|
2440
|
+
* actualizeaza (`creata: false`), iar clientul ei ramane acelasi. Nu se repeta
|
|
2441
|
+
* automat dupa un raspuns de la API, ca o programare sa nu plece de doua ori.
|
|
2442
|
+
*
|
|
2443
|
+
* @param cerere `client.email`, `incepeLa`, `titlu` si, optional, `idExtern`, `durataMinute`, `locatie`, `cuCine`, `note`, `url`, `necesitaConfirmare`, `confirmareInMaximOre`, `confirmareCuMinimOreInainte`, `remindere`, `sms`.
|
|
2444
|
+
* @param optiuni `signal` pentru anulare.
|
|
2445
|
+
* @returns programarea, cu `creata: true` cand e noua.
|
|
2446
|
+
* @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`.
|
|
2447
|
+
* @throws {@link EroareConflict} clientul nu mai primeste programari de la tine (`CLIENT_INDISPONIBIL`).
|
|
2448
|
+
* @throws {@link EroareLimita} `LIMIT_ATINS` (prea multi clienti noi fara cont azi, vezi `limita`) sau `PREA_MULTE_CERERI` (reia dupa `retryAfterMs`).
|
|
2449
|
+
* @throws {@link EroareInterzis} trimiterea de programari e oprita pentru acest cont.
|
|
2450
|
+
* @example
|
|
2451
|
+
* const p = await acteo.programari.creeaza({
|
|
2452
|
+
* idExtern: "rez-2027-0042",
|
|
2453
|
+
* client: { email: "ana@example.com", nume: "Ana Pop" },
|
|
2454
|
+
* incepeLa: "2027-05-12T10:00:00+03:00",
|
|
2455
|
+
* titlu: "Consultație",
|
|
2456
|
+
* necesitaConfirmare: true,
|
|
2457
|
+
* confirmareInMaximOre: 48, // clientul are 48 de ore sa confirme
|
|
2458
|
+
* })
|
|
2459
|
+
* console.log(p.id, p.creata, p.client.stare, p.confirmareExpiraLa)
|
|
2460
|
+
*/
|
|
2461
|
+
creeaza(cerere: CerereProgramare, optiuni?: OptiuniCerere): Promise<ProgramareTrimisa>;
|
|
2462
|
+
/**
|
|
2463
|
+
* Listeaza o pagina de programari, in ordinea datei de inceput, inclusiv cele
|
|
2464
|
+
* anulate sau trecute. Pentru pagina urmatoare trimite `urmatorulCursor` ca `cursor`.
|
|
2465
|
+
*
|
|
2466
|
+
* @param filtre `din`, `pana`, `cursor` si `limita` (1 - 100, implicit 50), toate optionale.
|
|
2467
|
+
* @param optiuni `signal` pentru anulare.
|
|
2468
|
+
* @returns programarile din pagina si `urmatorulCursor`, `null` la ultima pagina.
|
|
2469
|
+
* @throws {@link EroareValidare} `limita` in afara intervalului (local) sau `din` / `pana` fara ora si fus orar (400).
|
|
2470
|
+
* @throws {@link EroareLimita} `PREA_MULTE_CERERI`, dupa reincercarile automate.
|
|
2471
|
+
* @example
|
|
2472
|
+
* const din = new Date()
|
|
2473
|
+
* let cursor: string | undefined
|
|
2474
|
+
* do {
|
|
2475
|
+
* const pagina = await acteo.programari.lista({ din, cursor })
|
|
2476
|
+
* for (const p of pagina.programari) console.log(p.incepeLa, p.titlu)
|
|
2477
|
+
* cursor = pagina.urmatorulCursor ?? undefined
|
|
2478
|
+
* } while (cursor)
|
|
2479
|
+
*/
|
|
2480
|
+
lista(filtre?: OptiuniListaProgramari, optiuni?: OptiuniCerere): Promise<ListaProgramari>;
|
|
2481
|
+
/**
|
|
2482
|
+
* Citeste o programare.
|
|
2483
|
+
*
|
|
2484
|
+
* @param id `id`-ul programarii, din raspunsul la {@link ClientProgramari.creeaza} sau din {@link ClientProgramari.lista}.
|
|
2485
|
+
* @param optiuni `signal` pentru anulare.
|
|
2486
|
+
* @returns programarea.
|
|
2487
|
+
* @throws {@link EroareValidare} `id` gol (local) sau invalid (400).
|
|
2488
|
+
* @throws {@link EroareNegasit} programarea nu exista in contul cheii (`NEGASIT`).
|
|
2489
|
+
* @throws {@link EroareLimita} `PREA_MULTE_CERERI`, dupa reincercarile automate.
|
|
2490
|
+
* @example
|
|
2491
|
+
* const p = await acteo.programari.obtine(id)
|
|
2492
|
+
* if (p.confirmatLa) console.log("Clientul a confirmat")
|
|
2493
|
+
*/
|
|
2494
|
+
obtine(id: string, optiuni?: OptiuniCerere): Promise<Programare>;
|
|
2495
|
+
/**
|
|
2496
|
+
* Modifica o programare. Se schimba doar campurile trimise, iar `null` goleste
|
|
2497
|
+
* un camp optional. Mutarea datei cere o confirmare noua. Emailul clientului nu
|
|
2498
|
+
* se schimba: anuleaza programarea si creeaza una noua. Nu se repeta automat
|
|
2499
|
+
* dupa un raspuns de la API.
|
|
2500
|
+
*
|
|
2501
|
+
* @param id `id`-ul programarii.
|
|
2502
|
+
* @param modificare campurile de schimbat.
|
|
2503
|
+
* @param optiuni `signal` pentru anulare.
|
|
2504
|
+
* @returns programarea dupa modificare.
|
|
2505
|
+
* @throws {@link EroareValidare} `id` sau `titlu` gol (local), date invalide (400) sau care nu pot fi folosite (422: data in trecut, link fara https).
|
|
2506
|
+
* @throws {@link EroareNegasit} programarea nu exista in contul cheii (`NEGASIT`).
|
|
2507
|
+
* @throws {@link EroareConflict} programarea e anulata si nu se mai poate muta.
|
|
2508
|
+
* @throws {@link EroareLimita} `PREA_MULTE_CERERI`; reia dupa `retryAfterMs`.
|
|
2509
|
+
* @example
|
|
2510
|
+
* await acteo.programari.actualizeaza(id, { incepeLa: "2027-05-13T10:00:00+03:00", locatie: null })
|
|
2511
|
+
*/
|
|
2512
|
+
actualizeaza(id: string, modificare: ModificareProgramare, optiuni?: OptiuniCerere): Promise<Programare>;
|
|
2513
|
+
/**
|
|
2514
|
+
* Anuleaza o programare: reminderele nu mai pleaca. A doua anulare intoarce
|
|
2515
|
+
* aceeasi programare, fara alte efecte, deci cererea se reincearca sigur.
|
|
2516
|
+
*
|
|
2517
|
+
* @param id `id`-ul programarii.
|
|
2518
|
+
* @param optiuni `signal` pentru anulare.
|
|
2519
|
+
* @returns programarea anulata (`status: "anulata"`).
|
|
2520
|
+
* @throws {@link EroareValidare} `id` gol (local) sau invalid (400).
|
|
2521
|
+
* @throws {@link EroareNegasit} programarea nu exista in contul cheii (`NEGASIT`).
|
|
2522
|
+
* @throws {@link EroareLimita} `PREA_MULTE_CERERI`, dupa reincercarile automate.
|
|
2523
|
+
* @example
|
|
2524
|
+
* const p = await acteo.programari.anuleaza(id)
|
|
2525
|
+
* console.log(p.status) // "anulata"
|
|
2526
|
+
*/
|
|
2527
|
+
anuleaza(id: string, optiuni?: OptiuniCerere): Promise<Programare>;
|
|
2528
|
+
}
|
|
1747
2529
|
/** Citirea webhook-urilor trimise de API. Nu face cereri pe retea. */
|
|
1748
2530
|
declare class ClientWebhooks {
|
|
1749
2531
|
/**
|
|
@@ -1754,9 +2536,18 @@ declare class ClientWebhooks {
|
|
|
1754
2536
|
* @throws {@link EroareWebhook} corp invalid.
|
|
1755
2537
|
*/
|
|
1756
2538
|
parseazaRezultat(corp: unknown): WebhookRezultat;
|
|
2539
|
+
/**
|
|
2540
|
+
* Valideaza corpul unui webhook de rezultat al unei verificari de polita PAD
|
|
2541
|
+
* (trimis la `callbackUrl`).
|
|
2542
|
+
*
|
|
2543
|
+
* @param corp corpul cererii, ca string sau obiect deja parsat.
|
|
2544
|
+
* @returns verdictul sau eroarea verificarii.
|
|
2545
|
+
* @throws {@link EroareWebhook} corp invalid.
|
|
2546
|
+
*/
|
|
2547
|
+
parseazaRezultatPad(corp: unknown): WebhookRezultatPad;
|
|
1757
2548
|
/**
|
|
1758
2549
|
* Verifica cheia si corpul unui webhook de notificare (`document.expira`,
|
|
1759
|
-
* evenimentele celorlalte servicii sau `webhook.test`).
|
|
2550
|
+
* evenimentele celorlalte servicii, cele ale programarilor sau `webhook.test`).
|
|
1760
2551
|
*
|
|
1761
2552
|
* @param corp corpul cererii.
|
|
1762
2553
|
* @param headers headerele cererii.
|
|
@@ -1769,7 +2560,8 @@ declare class ClientWebhooks {
|
|
|
1769
2560
|
/**
|
|
1770
2561
|
* Clientul API-ului Acteo, organizat pe domenii: `acteo.auto.rca`,
|
|
1771
2562
|
* `acteo.auto.itp`, `acteo.auto.rovinieta`, `acteo.auto.arr`, `acteo.auto.flota`,
|
|
1772
|
-
* `acteo.auto.vin`, `acteo.auto.numere`, `acteo.auto.imagini
|
|
2563
|
+
* `acteo.auto.vin`, `acteo.auto.numere`, `acteo.auto.imagini`, `acteo.casa.pad`,
|
|
2564
|
+
* `acteo.programari` si `acteo.webhooks`.
|
|
1773
2565
|
*
|
|
1774
2566
|
* Toate metodele intorc `Promise` si arunca subclase de {@link VerificRcaError}.
|
|
1775
2567
|
* Erorile trecatoare sunt reincercate automat, fara sa repete vreodata o
|
|
@@ -1785,6 +2577,10 @@ declare class ClientWebhooks {
|
|
|
1785
2577
|
declare class Acteo {
|
|
1786
2578
|
/** Documentele unei masini (RCA, ITP, rovinieta, ARR), flota, VIN, numere si poze. */
|
|
1787
2579
|
readonly auto: ClientAuto;
|
|
2580
|
+
/** Locuinta: verificarea politei PAD. */
|
|
2581
|
+
readonly casa: ClientCasa;
|
|
2582
|
+
/** Programarile trimise clientilor tai, cu remindere: `creeaza()`, `lista()`, `obtine()`, `actualizeaza()`, `anuleaza()`. */
|
|
2583
|
+
readonly programari: ClientProgramari;
|
|
1788
2584
|
/** Citirea webhook-urilor. */
|
|
1789
2585
|
readonly webhooks: ClientWebhooks;
|
|
1790
2586
|
/**
|
|
@@ -1797,4 +2593,4 @@ declare class Acteo {
|
|
|
1797
2593
|
constructor(optiuni?: OptiuniClient);
|
|
1798
2594
|
}
|
|
1799
2595
|
|
|
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 };
|
|
2596
|
+
export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereImagineMasina, type CerereImagineVin, 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 CuloriImagini, type DataProgramare, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, FINISAJE_IMAGINE, FinisajImagine, 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 OptiuniImagine, 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 };
|