intifact 1.0.0 → 1.1.1

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/types.d.ts CHANGED
@@ -37,6 +37,78 @@ export interface paths {
37
37
  patch?: never;
38
38
  trace?: never;
39
39
  };
40
+ "/internal/certificates/expiring": {
41
+ parameters: {
42
+ query?: never;
43
+ header?: never;
44
+ path?: never;
45
+ cookie?: never;
46
+ };
47
+ /** List certificates expiring within N days (internal) */
48
+ get: {
49
+ parameters: {
50
+ query?: {
51
+ days?: number;
52
+ };
53
+ header?: never;
54
+ path?: never;
55
+ cookie?: never;
56
+ };
57
+ requestBody?: never;
58
+ responses: {
59
+ /** @description Default Response */
60
+ 200: {
61
+ headers: {
62
+ [name: string]: unknown;
63
+ };
64
+ content?: never;
65
+ };
66
+ };
67
+ };
68
+ put?: never;
69
+ post?: never;
70
+ delete?: never;
71
+ options?: never;
72
+ head?: never;
73
+ patch?: never;
74
+ trace?: never;
75
+ };
76
+ "/internal/webhooks/stats": {
77
+ parameters: {
78
+ query?: never;
79
+ header?: never;
80
+ path?: never;
81
+ cookie?: never;
82
+ };
83
+ /** Webhook delivery statistics (internal) */
84
+ get: {
85
+ parameters: {
86
+ query?: {
87
+ days?: number;
88
+ };
89
+ header?: never;
90
+ path?: never;
91
+ cookie?: never;
92
+ };
93
+ requestBody?: never;
94
+ responses: {
95
+ /** @description Default Response */
96
+ 200: {
97
+ headers: {
98
+ [name: string]: unknown;
99
+ };
100
+ content?: never;
101
+ };
102
+ };
103
+ };
104
+ put?: never;
105
+ post?: never;
106
+ delete?: never;
107
+ options?: never;
108
+ head?: never;
109
+ patch?: never;
110
+ trace?: never;
111
+ };
40
112
  "/api/v1/invoice/send": {
41
113
  parameters: {
42
114
  query?: never;
@@ -76,6 +148,9 @@ export interface paths {
76
148
  clienteNumDoc: string;
77
149
  clienteRazonSocial: string;
78
150
  clienteDireccion?: string;
151
+ clienteDistrito?: string;
152
+ clienteProvincia?: string;
153
+ clienteDepartamento?: string;
79
154
  /** @default 0 */
80
155
  montoOperGravadas?: number;
81
156
  /** @default 0 */
@@ -89,11 +164,14 @@ export interface paths {
89
164
  valorVenta: number;
90
165
  subTotal: number;
91
166
  montoImpVenta: number;
167
+ descuentoGlobal?: number;
168
+ descuentoGlobalBase?: number;
92
169
  detalle: {
93
170
  unidad: string;
94
171
  cantidad: number;
95
172
  codProducto: string;
96
173
  descripcion: string;
174
+ marca?: string;
97
175
  montoValorUnitario: number;
98
176
  montoBaseIgv: number;
99
177
  /** @default 18 */
@@ -104,6 +182,8 @@ export interface paths {
104
182
  totalImpuestos: number;
105
183
  montoPrecioUnitario: number;
106
184
  montoValorVenta: number;
185
+ descuento?: number;
186
+ descuentoItem?: number;
107
187
  /** @default 0 */
108
188
  factorIcbper?: number;
109
189
  codProdSunat?: string;
@@ -120,6 +200,14 @@ export interface paths {
120
200
  legendCode: string;
121
201
  legendValue: string;
122
202
  }[];
203
+ detraccion?: {
204
+ codBienServicio: string;
205
+ cuentaBanco: string;
206
+ porcentaje: number;
207
+ monto: number;
208
+ /** @default 001 */
209
+ medioPago?: string;
210
+ };
123
211
  };
124
212
  };
125
213
  };
@@ -188,6 +276,120 @@ export interface paths {
188
276
  patch?: never;
189
277
  trace?: never;
190
278
  };
279
+ "/api/v1/invoice/compute": {
280
+ parameters: {
281
+ query?: never;
282
+ header?: never;
283
+ path?: never;
284
+ cookie?: never;
285
+ };
286
+ get?: never;
287
+ put?: never;
288
+ /**
289
+ * Calcular importes (IGV, descuentos, totales) sin emitir
290
+ * @description Motor de cálculo: recibe ítems crudos (cantidad, valorUnitario sin IGV, afectación, descuento) y un descuento global opcional, y devuelve TODOS los importes fiscales calculados (bases, IGV, descuentos, totales, monto en letras). No emite ni persiste nada — úsalo para previsualizar o para alimentar POST /invoice/send.
291
+ */
292
+ post: {
293
+ parameters: {
294
+ query?: never;
295
+ header?: never;
296
+ path?: never;
297
+ cookie?: never;
298
+ };
299
+ requestBody: {
300
+ content: {
301
+ "application/json": {
302
+ /** @default PEN */
303
+ tipoMoneda?: string;
304
+ items: {
305
+ descripcion: string;
306
+ cantidad: number;
307
+ valorUnitario: number;
308
+ /** @default NIU */
309
+ unidad?: string;
310
+ codProducto?: string;
311
+ /** @default 10 */
312
+ afectacion?: string;
313
+ /** @default 18 */
314
+ igvPorcentaje?: number;
315
+ descuento?: {
316
+ porcentaje?: number;
317
+ monto?: number;
318
+ };
319
+ /** @default 0 */
320
+ factorIcbper?: number;
321
+ marca?: string;
322
+ codProdSunat?: string;
323
+ }[];
324
+ descuentoGlobal?: {
325
+ porcentaje?: number;
326
+ monto?: number;
327
+ };
328
+ /** @default false */
329
+ preciosIncluyenIgv?: boolean;
330
+ };
331
+ };
332
+ };
333
+ responses: {
334
+ /** @description Default Response */
335
+ 200: {
336
+ headers: {
337
+ [name: string]: unknown;
338
+ };
339
+ content: {
340
+ "application/json": {
341
+ success: boolean;
342
+ message: string;
343
+ data: {
344
+ tipoMoneda: string;
345
+ items: {
346
+ unidad: string;
347
+ cantidad: number;
348
+ codProducto: string;
349
+ descripcion: string;
350
+ marca?: string;
351
+ tipAfeIgv: string;
352
+ porcentajeIgv: number;
353
+ montoValorUnitario: number;
354
+ descuento: number;
355
+ descuentoItem: number;
356
+ descuentoGlobalLinea: number;
357
+ montoBruto: number;
358
+ montoValorVenta: number;
359
+ montoBaseIgv: number;
360
+ igv: number;
361
+ totalImpuestos: number;
362
+ montoPrecioUnitario: number;
363
+ factorIcbper: number;
364
+ codProdSunat?: string;
365
+ }[];
366
+ montoOperGravadas: number;
367
+ montoOperExoneradas: number;
368
+ montoOperInafectas: number;
369
+ montoOperGratuitas: number;
370
+ montoOperExportacion: number;
371
+ montoIgv: number;
372
+ montoIcbper: number;
373
+ descuentoGlobal: number;
374
+ descuentoGlobalBase: number;
375
+ totalDescuentos: number;
376
+ totalImpuestos: number;
377
+ valorVenta: number;
378
+ subTotal: number;
379
+ montoImpVenta: number;
380
+ montoEnLetras: string;
381
+ };
382
+ };
383
+ };
384
+ };
385
+ };
386
+ };
387
+ delete?: never;
388
+ options?: never;
389
+ head?: never;
390
+ patch?: never;
391
+ trace?: never;
392
+ };
191
393
  "/api/v1/invoice/{id}/pdf": {
192
394
  parameters: {
193
395
  query?: never;
@@ -337,6 +539,9 @@ export interface paths {
337
539
  clienteNumDoc: string;
338
540
  clienteRazonSocial: string;
339
541
  clienteDireccion?: string;
542
+ clienteDistrito?: string;
543
+ clienteProvincia?: string;
544
+ clienteDepartamento?: string;
340
545
  /** @enum {string} */
341
546
  afectadoTipoDoc: "01" | "03";
342
547
  afectadoNumDoc: string;
@@ -353,11 +558,14 @@ export interface paths {
353
558
  valorVenta: number;
354
559
  subTotal: number;
355
560
  montoImpVenta: number;
561
+ descuentoGlobal?: number;
562
+ descuentoGlobalBase?: number;
356
563
  detalle: {
357
564
  unidad: string;
358
565
  cantidad: number;
359
566
  codProducto: string;
360
567
  descripcion: string;
568
+ marca?: string;
361
569
  montoValorUnitario: number;
362
570
  montoBaseIgv: number;
363
571
  /** @default 18 */
@@ -368,6 +576,8 @@ export interface paths {
368
576
  totalImpuestos: number;
369
577
  montoPrecioUnitario: number;
370
578
  montoValorVenta: number;
579
+ descuento?: number;
580
+ descuentoItem?: number;
371
581
  /** @default 0 */
372
582
  factorIcbper?: number;
373
583
  codProdSunat?: string;
@@ -445,6 +655,120 @@ export interface paths {
445
655
  patch?: never;
446
656
  trace?: never;
447
657
  };
658
+ "/api/v1/note/compute": {
659
+ parameters: {
660
+ query?: never;
661
+ header?: never;
662
+ path?: never;
663
+ cookie?: never;
664
+ };
665
+ get?: never;
666
+ put?: never;
667
+ /**
668
+ * Calcular importes (IGV, descuentos, totales) sin emitir
669
+ * @description Motor de cálculo para notas: recibe ítems crudos (cantidad, valorUnitario sin IGV, afectación, descuento) y un descuento global opcional, y devuelve TODOS los importes fiscales calculados. No emite ni persiste nada — úsalo para previsualizar o para alimentar POST /note/send (agrega tú el documento afectado y el motivo).
670
+ */
671
+ post: {
672
+ parameters: {
673
+ query?: never;
674
+ header?: never;
675
+ path?: never;
676
+ cookie?: never;
677
+ };
678
+ requestBody: {
679
+ content: {
680
+ "application/json": {
681
+ /** @default PEN */
682
+ tipoMoneda?: string;
683
+ items: {
684
+ descripcion: string;
685
+ cantidad: number;
686
+ valorUnitario: number;
687
+ /** @default NIU */
688
+ unidad?: string;
689
+ codProducto?: string;
690
+ /** @default 10 */
691
+ afectacion?: string;
692
+ /** @default 18 */
693
+ igvPorcentaje?: number;
694
+ descuento?: {
695
+ porcentaje?: number;
696
+ monto?: number;
697
+ };
698
+ /** @default 0 */
699
+ factorIcbper?: number;
700
+ marca?: string;
701
+ codProdSunat?: string;
702
+ }[];
703
+ descuentoGlobal?: {
704
+ porcentaje?: number;
705
+ monto?: number;
706
+ };
707
+ /** @default false */
708
+ preciosIncluyenIgv?: boolean;
709
+ };
710
+ };
711
+ };
712
+ responses: {
713
+ /** @description Default Response */
714
+ 200: {
715
+ headers: {
716
+ [name: string]: unknown;
717
+ };
718
+ content: {
719
+ "application/json": {
720
+ success: boolean;
721
+ message: string;
722
+ data: {
723
+ tipoMoneda: string;
724
+ items: {
725
+ unidad: string;
726
+ cantidad: number;
727
+ codProducto: string;
728
+ descripcion: string;
729
+ marca?: string;
730
+ tipAfeIgv: string;
731
+ porcentajeIgv: number;
732
+ montoValorUnitario: number;
733
+ descuento: number;
734
+ descuentoItem: number;
735
+ descuentoGlobalLinea: number;
736
+ montoBruto: number;
737
+ montoValorVenta: number;
738
+ montoBaseIgv: number;
739
+ igv: number;
740
+ totalImpuestos: number;
741
+ montoPrecioUnitario: number;
742
+ factorIcbper: number;
743
+ codProdSunat?: string;
744
+ }[];
745
+ montoOperGravadas: number;
746
+ montoOperExoneradas: number;
747
+ montoOperInafectas: number;
748
+ montoOperGratuitas: number;
749
+ montoOperExportacion: number;
750
+ montoIgv: number;
751
+ montoIcbper: number;
752
+ descuentoGlobal: number;
753
+ descuentoGlobalBase: number;
754
+ totalDescuentos: number;
755
+ totalImpuestos: number;
756
+ valorVenta: number;
757
+ subTotal: number;
758
+ montoImpVenta: number;
759
+ montoEnLetras: string;
760
+ };
761
+ };
762
+ };
763
+ };
764
+ };
765
+ };
766
+ delete?: never;
767
+ options?: never;
768
+ head?: never;
769
+ patch?: never;
770
+ trace?: never;
771
+ };
448
772
  "/api/v1/note/{id}/pdf": {
449
773
  parameters: {
450
774
  query?: never;
@@ -553,6 +877,13 @@ export interface paths {
553
877
  clienteNumDoc: string;
554
878
  clienteRazonSocial: string;
555
879
  clienteDireccion?: string;
880
+ clienteDistrito?: string;
881
+ clienteProvincia?: string;
882
+ clienteDepartamento?: string;
883
+ destinatarioContacto?: string;
884
+ destinatarioTelefono?: string;
885
+ destinatarioEmail?: string;
886
+ entregaReferencia?: string;
556
887
  guiaCodTraslado: string;
557
888
  /** @enum {string} */
558
889
  guiaModTraslado: "01" | "02";
@@ -564,6 +895,7 @@ export interface paths {
564
895
  transportistaTipoDoc?: string;
565
896
  transportistaNumDoc?: string;
566
897
  transportistaRazonSocial?: string;
898
+ transportistaNroMtc?: string;
567
899
  guiaPartidaUbigeo: string;
568
900
  guiaPartidaDireccion: string;
569
901
  guiaLlegadaUbigeo: string;
@@ -577,6 +909,64 @@ export interface paths {
577
909
  nombres: string;
578
910
  apellidos: string;
579
911
  }[];
912
+ guiaFecEntrega?: string;
913
+ guiaDesTraslado?: string;
914
+ guiaPesoNeto?: number;
915
+ guiaSustentoPeso?: string;
916
+ guiaNumBultos?: number;
917
+ indicadores?: {
918
+ transbordoProgramado?: boolean;
919
+ vehiculoM1L?: boolean;
920
+ retornoVehiculoEnvaseVacio?: boolean;
921
+ retornoVehiculoVacio?: boolean;
922
+ trasladoTotalDamDs?: boolean;
923
+ registroTransportista?: boolean;
924
+ trasladoContenedorManifiesto?: boolean;
925
+ };
926
+ contenedores?: {
927
+ numero: string;
928
+ precinto?: string;
929
+ }[];
930
+ guiaVehiculoTuc?: string;
931
+ guiaVehiculoAutorizacion?: string;
932
+ guiaVehiculoAutorizacionEntidad?: string;
933
+ vehiculosSecundarios?: {
934
+ placa: string;
935
+ tuc?: string;
936
+ autorizacion?: string;
937
+ autorizacionEntidad?: string;
938
+ }[];
939
+ transportistaAutorizacion?: string;
940
+ transportistaAutorizacionEntidad?: string;
941
+ guiaPartidaRuc?: string;
942
+ guiaPartidaCodLocal?: string;
943
+ guiaPartidaGeo?: {
944
+ lat: string;
945
+ lon: string;
946
+ };
947
+ guiaLlegadaRuc?: string;
948
+ guiaLlegadaCodLocal?: string;
949
+ guiaLlegadaGeo?: {
950
+ lat: string;
951
+ lon: string;
952
+ };
953
+ documentosRelacionados?: {
954
+ codTipo: string;
955
+ numero: string;
956
+ tipoDesc?: string;
957
+ emisorRuc?: string;
958
+ }[];
959
+ remitenteAutorizacion?: string;
960
+ remitenteAutorizacionEntidad?: string;
961
+ proveedorTipoDoc?: string;
962
+ proveedorNumDoc?: string;
963
+ proveedorRazonSocial?: string;
964
+ compradorTipoDoc?: string;
965
+ compradorNumDoc?: string;
966
+ compradorRazonSocial?: string;
967
+ puertoCodigo?: string;
968
+ puertoNombre?: string;
969
+ puertoTipo?: string;
580
970
  detalle: {
581
971
  unidad: string;
582
972
  cantidad: number;
@@ -651,34 +1041,381 @@ export interface paths {
651
1041
  patch?: never;
652
1042
  trace?: never;
653
1043
  };
654
- "/api/v1/despatch/{id}/xml": {
1044
+ "/api/v1/despatch/send-multi": {
655
1045
  parameters: {
656
1046
  query?: never;
657
1047
  header?: never;
658
1048
  path?: never;
659
1049
  cookie?: never;
660
1050
  };
661
- /** Descargar XML firmado de la guía */
662
- get: {
1051
+ get?: never;
1052
+ put?: never;
1053
+ /**
1054
+ * Enviar múltiples guías de remisión por destino
1055
+ * @description Recibe datos comunes de transporte + array de destinos. Genera una guía por cada destino con correlativo auto-asignado. Cada guía se encola independientemente para envío a SUNAT GRE.
1056
+ */
1057
+ post: {
663
1058
  parameters: {
664
1059
  query?: never;
665
1060
  header?: never;
666
- path: {
667
- id: string;
668
- };
1061
+ path?: never;
669
1062
  cookie?: never;
670
1063
  };
671
- requestBody?: never;
1064
+ requestBody: {
1065
+ content: {
1066
+ "application/json": {
1067
+ /** @enum {string} */
1068
+ tipoDoc: "09";
1069
+ serie: string;
1070
+ observacion?: string;
1071
+ fechaEmision: string;
1072
+ empresaRuc: string;
1073
+ /** @default 0000 */
1074
+ establecimientoCodigo?: string;
1075
+ guiaCodTraslado: string;
1076
+ /** @enum {string} */
1077
+ guiaModTraslado: "01" | "02";
1078
+ guiaFecTraslado: string;
1079
+ guiaVehiculoPlaca?: string;
1080
+ transportistaTipoDoc?: string;
1081
+ transportistaNumDoc?: string;
1082
+ transportistaRazonSocial?: string;
1083
+ transportistaNroMtc?: string;
1084
+ guiaPartidaUbigeo: string;
1085
+ guiaPartidaDireccion: string;
1086
+ chofer?: {
1087
+ /** @enum {string} */
1088
+ tipo: "Principal" | "Secundario";
1089
+ tipoDoc: string;
1090
+ nroDoc: string;
1091
+ licencia: string;
1092
+ nombres: string;
1093
+ apellidos: string;
1094
+ }[];
1095
+ guiaFecEntrega?: string;
1096
+ guiaDesTraslado?: string;
1097
+ guiaPesoNeto?: number;
1098
+ guiaSustentoPeso?: string;
1099
+ guiaNumBultos?: number;
1100
+ indicadores?: {
1101
+ transbordoProgramado?: boolean;
1102
+ vehiculoM1L?: boolean;
1103
+ retornoVehiculoEnvaseVacio?: boolean;
1104
+ retornoVehiculoVacio?: boolean;
1105
+ trasladoTotalDamDs?: boolean;
1106
+ registroTransportista?: boolean;
1107
+ trasladoContenedorManifiesto?: boolean;
1108
+ };
1109
+ contenedores?: {
1110
+ numero: string;
1111
+ precinto?: string;
1112
+ }[];
1113
+ guiaVehiculoTuc?: string;
1114
+ guiaVehiculoAutorizacion?: string;
1115
+ guiaVehiculoAutorizacionEntidad?: string;
1116
+ vehiculosSecundarios?: {
1117
+ placa: string;
1118
+ tuc?: string;
1119
+ autorizacion?: string;
1120
+ autorizacionEntidad?: string;
1121
+ }[];
1122
+ transportistaAutorizacion?: string;
1123
+ transportistaAutorizacionEntidad?: string;
1124
+ guiaPartidaRuc?: string;
1125
+ guiaPartidaCodLocal?: string;
1126
+ guiaPartidaGeo?: {
1127
+ lat: string;
1128
+ lon: string;
1129
+ };
1130
+ guiaLlegadaRuc?: string;
1131
+ guiaLlegadaCodLocal?: string;
1132
+ guiaLlegadaGeo?: {
1133
+ lat: string;
1134
+ lon: string;
1135
+ };
1136
+ documentosRelacionados?: {
1137
+ codTipo: string;
1138
+ numero: string;
1139
+ tipoDesc?: string;
1140
+ emisorRuc?: string;
1141
+ }[];
1142
+ remitenteAutorizacion?: string;
1143
+ remitenteAutorizacionEntidad?: string;
1144
+ proveedorTipoDoc?: string;
1145
+ proveedorNumDoc?: string;
1146
+ proveedorRazonSocial?: string;
1147
+ compradorTipoDoc?: string;
1148
+ compradorNumDoc?: string;
1149
+ compradorRazonSocial?: string;
1150
+ puertoCodigo?: string;
1151
+ puertoNombre?: string;
1152
+ puertoTipo?: string;
1153
+ destinos: {
1154
+ clienteTipoDoc: string;
1155
+ clienteNumDoc: string;
1156
+ clienteRazonSocial: string;
1157
+ clienteDireccion?: string;
1158
+ clienteDistrito?: string;
1159
+ clienteProvincia?: string;
1160
+ clienteDepartamento?: string;
1161
+ destinatarioContacto?: string;
1162
+ destinatarioTelefono?: string;
1163
+ destinatarioEmail?: string;
1164
+ entregaReferencia?: string;
1165
+ guiaLlegadaUbigeo: string;
1166
+ guiaLlegadaDireccion: string;
1167
+ guiaPesoTotal: number;
1168
+ /** @default KGM */
1169
+ guiaUndPesoTotal?: string;
1170
+ detalle: {
1171
+ unidad: string;
1172
+ cantidad: number;
1173
+ codProducto: string;
1174
+ descripcion: string;
1175
+ }[];
1176
+ }[];
1177
+ };
1178
+ };
1179
+ };
672
1180
  responses: {
673
1181
  /** @description Default Response */
674
- 200: {
1182
+ 202: {
675
1183
  headers: {
676
1184
  [name: string]: unknown;
677
1185
  };
678
- content?: never;
679
- };
680
- };
681
- };
1186
+ content: {
1187
+ "application/json": {
1188
+ success: boolean;
1189
+ message: string;
1190
+ data?: {
1191
+ total: number;
1192
+ emitidas: number;
1193
+ fallidas: number;
1194
+ guias: {
1195
+ success: boolean;
1196
+ message: string;
1197
+ code?: string;
1198
+ destino: number;
1199
+ data?: {
1200
+ /** Format: uuid */
1201
+ id: string;
1202
+ estado: string;
1203
+ hash: string | null;
1204
+ signatureValue: string | null;
1205
+ jobId?: string;
1206
+ };
1207
+ }[];
1208
+ };
1209
+ };
1210
+ };
1211
+ };
1212
+ /** @description Default Response */
1213
+ 400: {
1214
+ headers: {
1215
+ [name: string]: unknown;
1216
+ };
1217
+ content: {
1218
+ "application/json": {
1219
+ /** @enum {boolean} */
1220
+ success: false;
1221
+ message: string;
1222
+ code?: string;
1223
+ errors?: {
1224
+ path: string;
1225
+ message: string;
1226
+ }[];
1227
+ };
1228
+ };
1229
+ };
1230
+ };
1231
+ };
1232
+ delete?: never;
1233
+ options?: never;
1234
+ head?: never;
1235
+ patch?: never;
1236
+ trace?: never;
1237
+ };
1238
+ "/api/v1/despatch-transportista/send": {
1239
+ parameters: {
1240
+ query?: never;
1241
+ header?: never;
1242
+ path?: never;
1243
+ cookie?: never;
1244
+ };
1245
+ get?: never;
1246
+ put?: never;
1247
+ /**
1248
+ * Enviar guía de remisión TRANSPORTISTA (31) via API GRE REST
1249
+ * @description Guía emitida por la empresa de transporte (emisor=transportista). Incluye remitente (dueño de los bienes) y destinatario. Genera XML UBL 2.1, firma y encola para envío a SUNAT GRE.
1250
+ */
1251
+ post: {
1252
+ parameters: {
1253
+ query?: never;
1254
+ header?: never;
1255
+ path?: never;
1256
+ cookie?: never;
1257
+ };
1258
+ requestBody: {
1259
+ content: {
1260
+ "application/json": {
1261
+ /** @enum {string} */
1262
+ tipoDoc: "31";
1263
+ serie: string;
1264
+ correlativo: string;
1265
+ observacion?: string;
1266
+ fechaEmision: string;
1267
+ empresaRuc: string;
1268
+ /** @default 0000 */
1269
+ establecimientoCodigo?: string;
1270
+ transportistaNroMtc?: string;
1271
+ destinatarioTipoDoc: string;
1272
+ destinatarioNumDoc: string;
1273
+ destinatarioRazonSocial: string;
1274
+ destinatarioDireccion?: string;
1275
+ destinatarioDistrito?: string;
1276
+ destinatarioProvincia?: string;
1277
+ destinatarioDepartamento?: string;
1278
+ destinatarioContacto?: string;
1279
+ destinatarioTelefono?: string;
1280
+ destinatarioEmail?: string;
1281
+ entregaReferencia?: string;
1282
+ remitenteTipoDoc: string;
1283
+ remitenteNumDoc: string;
1284
+ remitenteRazonSocial: string;
1285
+ guiaCodTraslado: string;
1286
+ guiaDesTraslado?: string;
1287
+ guiaPesoTotal: number;
1288
+ /** @default KGM */
1289
+ guiaUndPesoTotal?: string;
1290
+ guiaNumBultos?: number;
1291
+ guiaFecTraslado: string;
1292
+ chofer: {
1293
+ /** @enum {string} */
1294
+ tipo: "Principal" | "Secundario";
1295
+ tipoDoc: string;
1296
+ nroDoc: string;
1297
+ licencia: string;
1298
+ nombres: string;
1299
+ apellidos: string;
1300
+ }[];
1301
+ guiaVehiculoPlaca: string;
1302
+ guiaVehiculoTuc?: string;
1303
+ vehiculosSecundarios?: {
1304
+ placa: string;
1305
+ tuc?: string;
1306
+ }[];
1307
+ guiaPartidaUbigeo: string;
1308
+ guiaPartidaDireccion: string;
1309
+ guiaLlegadaUbigeo: string;
1310
+ guiaLlegadaDireccion: string;
1311
+ documentosRelacionados?: {
1312
+ codTipo: string;
1313
+ numero: string;
1314
+ tipoDesc?: string;
1315
+ emisorRuc?: string;
1316
+ }[];
1317
+ detalle: {
1318
+ unidad: string;
1319
+ cantidad: number;
1320
+ codProducto: string;
1321
+ descripcion: string;
1322
+ }[];
1323
+ };
1324
+ };
1325
+ };
1326
+ responses: {
1327
+ /** @description Default Response */
1328
+ 202: {
1329
+ headers: {
1330
+ [name: string]: unknown;
1331
+ };
1332
+ content: {
1333
+ "application/json": {
1334
+ success: boolean;
1335
+ message: string;
1336
+ data?: {
1337
+ /** Format: uuid */
1338
+ id: string;
1339
+ estado: string;
1340
+ hash: string | null;
1341
+ signatureValue: string | null;
1342
+ jobId?: string;
1343
+ };
1344
+ };
1345
+ };
1346
+ };
1347
+ /** @description Default Response */
1348
+ 400: {
1349
+ headers: {
1350
+ [name: string]: unknown;
1351
+ };
1352
+ content: {
1353
+ "application/json": {
1354
+ /** @enum {boolean} */
1355
+ success: false;
1356
+ message: string;
1357
+ code?: string;
1358
+ errors?: {
1359
+ path: string;
1360
+ message: string;
1361
+ }[];
1362
+ };
1363
+ };
1364
+ };
1365
+ /** @description Default Response */
1366
+ 409: {
1367
+ headers: {
1368
+ [name: string]: unknown;
1369
+ };
1370
+ content: {
1371
+ "application/json": {
1372
+ /** @enum {boolean} */
1373
+ success: false;
1374
+ message: string;
1375
+ code?: string;
1376
+ errors?: {
1377
+ path: string;
1378
+ message: string;
1379
+ }[];
1380
+ };
1381
+ };
1382
+ };
1383
+ };
1384
+ };
1385
+ delete?: never;
1386
+ options?: never;
1387
+ head?: never;
1388
+ patch?: never;
1389
+ trace?: never;
1390
+ };
1391
+ "/api/v1/despatch/{id}/xml": {
1392
+ parameters: {
1393
+ query?: never;
1394
+ header?: never;
1395
+ path?: never;
1396
+ cookie?: never;
1397
+ };
1398
+ /** Descargar XML firmado de la guía */
1399
+ get: {
1400
+ parameters: {
1401
+ query?: never;
1402
+ header?: never;
1403
+ path: {
1404
+ id: string;
1405
+ };
1406
+ cookie?: never;
1407
+ };
1408
+ requestBody?: never;
1409
+ responses: {
1410
+ /** @description Default Response */
1411
+ 200: {
1412
+ headers: {
1413
+ [name: string]: unknown;
1414
+ };
1415
+ content?: never;
1416
+ };
1417
+ };
1418
+ };
682
1419
  put?: never;
683
1420
  post?: never;
684
1421
  delete?: never;
@@ -694,10 +1431,12 @@ export interface paths {
694
1431
  path?: never;
695
1432
  cookie?: never;
696
1433
  };
697
- /** Obtener PDF de la guía de remisión */
1434
+ /** Obtener PDF de la guía (A4 oficina, ticket 80mm o 58mm POS) */
698
1435
  get: {
699
1436
  parameters: {
700
- query?: never;
1437
+ query?: {
1438
+ format?: "a4" | "ticket" | "ticket80" | "ticket58";
1439
+ };
701
1440
  header?: never;
702
1441
  path: {
703
1442
  id: string;
@@ -778,7 +1517,7 @@ export interface paths {
778
1517
  };
779
1518
  responses: {
780
1519
  /** @description Default Response */
781
- 200: {
1520
+ 202: {
782
1521
  headers: {
783
1522
  [name: string]: unknown;
784
1523
  };
@@ -787,6 +1526,8 @@ export interface paths {
787
1526
  success: boolean;
788
1527
  message: string;
789
1528
  data?: {
1529
+ id?: string;
1530
+ estado?: string;
790
1531
  ticket?: string;
791
1532
  hash?: string | null;
792
1533
  };
@@ -854,7 +1595,7 @@ export interface paths {
854
1595
  };
855
1596
  responses: {
856
1597
  /** @description Default Response */
857
- 200: {
1598
+ 202: {
858
1599
  headers: {
859
1600
  [name: string]: unknown;
860
1601
  };
@@ -863,6 +1604,8 @@ export interface paths {
863
1604
  success: boolean;
864
1605
  message: string;
865
1606
  data?: {
1607
+ id?: string;
1608
+ estado?: string;
866
1609
  ticket?: string;
867
1610
  hash?: string | null;
868
1611
  };
@@ -996,7 +1739,7 @@ export interface paths {
996
1739
  };
997
1740
  responses: {
998
1741
  /** @description Default Response */
999
- 200: {
1742
+ 202: {
1000
1743
  headers: {
1001
1744
  [name: string]: unknown;
1002
1745
  };
@@ -1005,6 +1748,8 @@ export interface paths {
1005
1748
  success: boolean;
1006
1749
  message: string;
1007
1750
  data?: {
1751
+ id?: string;
1752
+ estado?: string;
1008
1753
  ticket?: string;
1009
1754
  hash?: string | null;
1010
1755
  };
@@ -1067,7 +1812,7 @@ export interface paths {
1067
1812
  };
1068
1813
  responses: {
1069
1814
  /** @description Default Response */
1070
- 200: {
1815
+ 202: {
1071
1816
  headers: {
1072
1817
  [name: string]: unknown;
1073
1818
  };
@@ -1076,6 +1821,8 @@ export interface paths {
1076
1821
  success: boolean;
1077
1822
  message: string;
1078
1823
  data?: {
1824
+ id?: string;
1825
+ estado?: string;
1079
1826
  ticket?: string;
1080
1827
  hash?: string | null;
1081
1828
  };
@@ -1450,45 +2197,7 @@ export interface paths {
1450
2197
  };
1451
2198
  };
1452
2199
  put?: never;
1453
- /** Crear empresa emisora */
1454
- post: {
1455
- parameters: {
1456
- query?: never;
1457
- header?: never;
1458
- path?: never;
1459
- cookie?: never;
1460
- };
1461
- requestBody: {
1462
- content: {
1463
- "application/json": {
1464
- ruc: string;
1465
- razonSocial: string;
1466
- nombreComercial?: string;
1467
- ubigeo?: string;
1468
- direccion?: string;
1469
- departamento?: string;
1470
- provincia?: string;
1471
- distrito?: string;
1472
- urbanizacion?: string;
1473
- solUser?: string;
1474
- solPassword?: string;
1475
- /** Format: uuid */
1476
- tenantId?: string;
1477
- greClientId?: string;
1478
- greClientSecret?: string;
1479
- };
1480
- };
1481
- };
1482
- responses: {
1483
- /** @description Default Response */
1484
- 200: {
1485
- headers: {
1486
- [name: string]: unknown;
1487
- };
1488
- content?: never;
1489
- };
1490
- };
1491
- };
2200
+ post?: never;
1492
2201
  delete?: never;
1493
2202
  options?: never;
1494
2203
  head?: never;
@@ -1523,8 +2232,23 @@ export interface paths {
1523
2232
  };
1524
2233
  };
1525
2234
  };
1526
- /** Actualizar empresa */
1527
- put: {
2235
+ put?: never;
2236
+ post?: never;
2237
+ delete?: never;
2238
+ options?: never;
2239
+ head?: never;
2240
+ patch?: never;
2241
+ trace?: never;
2242
+ };
2243
+ "/api/v1/companies/{id}/logo": {
2244
+ parameters: {
2245
+ query?: never;
2246
+ header?: never;
2247
+ path?: never;
2248
+ cookie?: never;
2249
+ };
2250
+ /** Obtener logo de la empresa (PNG/JPG) */
2251
+ get: {
1528
2252
  parameters: {
1529
2253
  query?: never;
1530
2254
  header?: never;
@@ -1533,27 +2257,7 @@ export interface paths {
1533
2257
  };
1534
2258
  cookie?: never;
1535
2259
  };
1536
- requestBody: {
1537
- content: {
1538
- "application/json": {
1539
- ruc?: string;
1540
- razonSocial?: string;
1541
- nombreComercial?: string;
1542
- ubigeo?: string;
1543
- direccion?: string;
1544
- departamento?: string;
1545
- provincia?: string;
1546
- distrito?: string;
1547
- urbanizacion?: string;
1548
- solUser?: string;
1549
- solPassword?: string;
1550
- /** Format: uuid */
1551
- tenantId?: string;
1552
- greClientId?: string;
1553
- greClientSecret?: string;
1554
- };
1555
- };
1556
- };
2260
+ requestBody?: never;
1557
2261
  responses: {
1558
2262
  /** @description Default Response */
1559
2263
  200: {
@@ -1564,6 +2268,7 @@ export interface paths {
1564
2268
  };
1565
2269
  };
1566
2270
  };
2271
+ put?: never;
1567
2272
  post?: never;
1568
2273
  delete?: never;
1569
2274
  options?: never;
@@ -1571,542 +2276,24 @@ export interface paths {
1571
2276
  patch?: never;
1572
2277
  trace?: never;
1573
2278
  };
1574
- "/api/v1/companies/{id}/certificate": {
2279
+ "/api/v1/webhooks": {
1575
2280
  parameters: {
1576
2281
  query?: never;
1577
2282
  header?: never;
1578
2283
  path?: never;
1579
2284
  cookie?: never;
1580
2285
  };
1581
- get?: never;
1582
- put?: never;
1583
- /** Subir certificado digital (.p12/.pfx en base64) */
1584
- post: {
2286
+ /** Listar webhooks (filtra por RUC opcional) */
2287
+ get: {
1585
2288
  parameters: {
1586
- query?: never;
1587
- header?: never;
1588
- path: {
1589
- id: string;
1590
- };
1591
- cookie?: never;
1592
- };
1593
- requestBody: {
1594
- content: {
1595
- "application/json": {
1596
- name: string;
1597
- password: string;
1598
- /** @description Base64 del .p12/.pfx */
1599
- content: string;
1600
- };
1601
- };
1602
- };
1603
- responses: {
1604
- /** @description Default Response */
1605
- 200: {
1606
- headers: {
1607
- [name: string]: unknown;
1608
- };
1609
- content?: never;
1610
- };
1611
- };
1612
- };
1613
- delete?: never;
1614
- options?: never;
1615
- head?: never;
1616
- patch?: never;
1617
- trace?: never;
1618
- };
1619
- "/api/v1/companies/{id}/logo": {
1620
- parameters: {
1621
- query?: never;
1622
- header?: never;
1623
- path?: never;
1624
- cookie?: never;
1625
- };
1626
- /** Obtener logo de la empresa (PNG/JPG) */
1627
- get: {
1628
- parameters: {
1629
- query?: never;
1630
- header?: never;
1631
- path: {
1632
- id: string;
1633
- };
1634
- cookie?: never;
1635
- };
1636
- requestBody?: never;
1637
- responses: {
1638
- /** @description Default Response */
1639
- 200: {
1640
- headers: {
1641
- [name: string]: unknown;
1642
- };
1643
- content?: never;
1644
- };
1645
- };
1646
- };
1647
- put?: never;
1648
- /**
1649
- * Subir logo de la empresa (PNG/JPG, max 200KB)
1650
- * @description El logo aparecerá en los PDFs (A4 y ticket). Reemplaza el anterior.
1651
- */
1652
- post: {
1653
- parameters: {
1654
- query?: never;
1655
- header?: never;
1656
- path: {
1657
- id: string;
1658
- };
1659
- cookie?: never;
1660
- };
1661
- requestBody?: never;
1662
- responses: {
1663
- /** @description Default Response */
1664
- 200: {
1665
- headers: {
1666
- [name: string]: unknown;
1667
- };
1668
- content?: never;
1669
- };
1670
- };
1671
- };
1672
- /** Eliminar logo de la empresa */
1673
- delete: {
1674
- parameters: {
1675
- query?: never;
1676
- header?: never;
1677
- path: {
1678
- id: string;
1679
- };
1680
- cookie?: never;
1681
- };
1682
- requestBody?: never;
1683
- responses: {
1684
- /** @description Default Response */
1685
- 200: {
1686
- headers: {
1687
- [name: string]: unknown;
1688
- };
1689
- content?: never;
1690
- };
1691
- };
1692
- };
1693
- options?: never;
1694
- head?: never;
1695
- patch?: never;
1696
- trace?: never;
1697
- };
1698
- "/api/v1/webhooks": {
1699
- parameters: {
1700
- query?: never;
1701
- header?: never;
1702
- path?: never;
1703
- cookie?: never;
1704
- };
1705
- /** Listar webhooks (filtra por RUC opcional) */
1706
- get: {
1707
- parameters: {
1708
- query?: {
1709
- ruc?: string;
1710
- };
1711
- header?: never;
1712
- path?: never;
1713
- cookie?: never;
1714
- };
1715
- requestBody?: never;
1716
- responses: {
1717
- /** @description Default Response */
1718
- 200: {
1719
- headers: {
1720
- [name: string]: unknown;
1721
- };
1722
- content?: never;
1723
- };
1724
- };
1725
- };
1726
- put?: never;
1727
- /**
1728
- * Crear endpoint webhook
1729
- * @description Registra una URL que recibirá POSTs cuando ocurran los eventos suscritos. La respuesta incluye el `secret` (mostrado UNA sola vez) — guárdalo para verificar las firmas HMAC-SHA256.
1730
- */
1731
- post: {
1732
- parameters: {
1733
- query?: never;
1734
- header?: never;
1735
- path?: never;
1736
- cookie?: never;
1737
- };
1738
- requestBody: {
1739
- content: {
1740
- "application/json": {
1741
- empresaRuc: string;
1742
- /** Format: uri */
1743
- url: string;
1744
- events: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
1745
- description?: string;
1746
- };
1747
- };
1748
- };
1749
- responses: {
1750
- /** @description Default Response */
1751
- 200: {
1752
- headers: {
1753
- [name: string]: unknown;
1754
- };
1755
- content?: never;
1756
- };
1757
- };
1758
- };
1759
- delete?: never;
1760
- options?: never;
1761
- head?: never;
1762
- patch?: never;
1763
- trace?: never;
1764
- };
1765
- "/api/v1/webhooks/{id}": {
1766
- parameters: {
1767
- query?: never;
1768
- header?: never;
1769
- path?: never;
1770
- cookie?: never;
1771
- };
1772
- /** Detalle de webhook (sin secret) */
1773
- get: {
1774
- parameters: {
1775
- query?: never;
1776
- header?: never;
1777
- path: {
1778
- id: string;
1779
- };
1780
- cookie?: never;
1781
- };
1782
- requestBody?: never;
1783
- responses: {
1784
- /** @description Default Response */
1785
- 200: {
1786
- headers: {
1787
- [name: string]: unknown;
1788
- };
1789
- content?: never;
1790
- };
1791
- };
1792
- };
1793
- /** Actualizar webhook (url, eventos, activación) */
1794
- put: {
1795
- parameters: {
1796
- query?: never;
1797
- header?: never;
1798
- path: {
1799
- id: string;
1800
- };
1801
- cookie?: never;
1802
- };
1803
- requestBody: {
1804
- content: {
1805
- "application/json": {
1806
- /** Format: uri */
1807
- url?: string;
1808
- events?: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
1809
- description?: string;
1810
- isActive?: boolean;
1811
- };
1812
- };
1813
- };
1814
- responses: {
1815
- /** @description Default Response */
1816
- 200: {
1817
- headers: {
1818
- [name: string]: unknown;
1819
- };
1820
- content?: never;
1821
- };
1822
- };
1823
- };
1824
- post?: never;
1825
- /** Eliminar webhook (también elimina su historial de deliveries) */
1826
- delete: {
1827
- parameters: {
1828
- query?: never;
1829
- header?: never;
1830
- path: {
1831
- id: string;
1832
- };
1833
- cookie?: never;
1834
- };
1835
- requestBody?: never;
1836
- responses: {
1837
- /** @description Default Response */
1838
- 200: {
1839
- headers: {
1840
- [name: string]: unknown;
1841
- };
1842
- content?: never;
1843
- };
1844
- };
1845
- };
1846
- options?: never;
1847
- head?: never;
1848
- patch?: never;
1849
- trace?: never;
1850
- };
1851
- "/api/v1/webhooks/{id}/deliveries": {
1852
- parameters: {
1853
- query?: never;
1854
- header?: never;
1855
- path?: never;
1856
- cookie?: never;
1857
- };
1858
- /** Log de entregas del webhook */
1859
- get: {
1860
- parameters: {
1861
- query?: {
1862
- limit?: number;
1863
- success?: "true" | "false";
1864
- };
1865
- header?: never;
1866
- path: {
1867
- id: string;
1868
- };
1869
- cookie?: never;
1870
- };
1871
- requestBody?: never;
1872
- responses: {
1873
- /** @description Default Response */
1874
- 200: {
1875
- headers: {
1876
- [name: string]: unknown;
1877
- };
1878
- content?: never;
1879
- };
1880
- };
1881
- };
1882
- put?: never;
1883
- post?: never;
1884
- delete?: never;
1885
- options?: never;
1886
- head?: never;
1887
- patch?: never;
1888
- trace?: never;
1889
- };
1890
- "/api/v1/webhooks/{id}/deliveries/{deliveryId}/redeliver": {
1891
- parameters: {
1892
- query?: never;
1893
- header?: never;
1894
- path?: never;
1895
- cookie?: never;
1896
- };
1897
- get?: never;
1898
- put?: never;
1899
- /** Reintentar manualmente una entrega */
1900
- post: {
1901
- parameters: {
1902
- query?: never;
1903
- header?: never;
1904
- path: {
1905
- id: string;
1906
- deliveryId: string;
1907
- };
1908
- cookie?: never;
1909
- };
1910
- requestBody?: never;
1911
- responses: {
1912
- /** @description Default Response */
1913
- 200: {
1914
- headers: {
1915
- [name: string]: unknown;
1916
- };
1917
- content?: never;
1918
- };
1919
- };
1920
- };
1921
- delete?: never;
1922
- options?: never;
1923
- head?: never;
1924
- patch?: never;
1925
- trace?: never;
1926
- };
1927
- "/api/v1/webhooks/{id}/test": {
1928
- parameters: {
1929
- query?: never;
1930
- header?: never;
1931
- path?: never;
1932
- cookie?: never;
1933
- };
1934
- get?: never;
1935
- put?: never;
1936
- /** Enviar un evento de prueba (webhook.test) */
1937
- post: {
1938
- parameters: {
1939
- query?: never;
1940
- header?: never;
1941
- path: {
1942
- id: string;
1943
- };
1944
- cookie?: never;
1945
- };
1946
- requestBody?: never;
1947
- responses: {
1948
- /** @description Default Response */
1949
- 200: {
1950
- headers: {
1951
- [name: string]: unknown;
1952
- };
1953
- content?: never;
1954
- };
1955
- };
1956
- };
1957
- delete?: never;
1958
- options?: never;
1959
- head?: never;
1960
- patch?: never;
1961
- trace?: never;
1962
- };
1963
- "/api/v1/webhooks/{id}/rotate-secret": {
1964
- parameters: {
1965
- query?: never;
1966
- header?: never;
1967
- path?: never;
1968
- cookie?: never;
1969
- };
1970
- get?: never;
1971
- put?: never;
1972
- /**
1973
- * Rotar el secret de firma (devuelto UNA sola vez)
1974
- * @description Genera un nuevo secret HMAC y lo devuelve una única vez. Las firmas de entregas posteriores usarán el nuevo secret; actualiza tu receptor antes de rotar.
1975
- */
1976
- post: {
1977
- parameters: {
1978
- query?: never;
1979
- header?: never;
1980
- path: {
1981
- id: string;
1982
- };
1983
- cookie?: never;
1984
- };
1985
- requestBody?: never;
1986
- responses: {
1987
- /** @description Default Response */
1988
- 200: {
1989
- headers: {
1990
- [name: string]: unknown;
1991
- };
1992
- content?: never;
1993
- };
1994
- };
1995
- };
1996
- delete?: never;
1997
- options?: never;
1998
- head?: never;
1999
- patch?: never;
2000
- trace?: never;
2001
- };
2002
- "/api/v1/companies/{id}/branches": {
2003
- parameters: {
2004
- query?: never;
2005
- header?: never;
2006
- path?: never;
2007
- cookie?: never;
2008
- };
2009
- /** Listar establecimientos (sucursales) de una empresa */
2010
- get: {
2011
- parameters: {
2012
- query?: never;
2013
- header?: never;
2014
- path: {
2015
- id: string;
2016
- };
2017
- cookie?: never;
2018
- };
2019
- requestBody?: never;
2020
- responses: {
2021
- /** @description Default Response */
2022
- 200: {
2023
- headers: {
2024
- [name: string]: unknown;
2025
- };
2026
- content?: never;
2027
- };
2028
- };
2029
- };
2030
- put?: never;
2031
- /**
2032
- * Crear establecimiento (sucursal)
2033
- * @description El código debe coincidir con el que SUNAT asignó a la sucursal al registrarla en el portal SOL (Mis Trámites > Establecimientos Anexos).
2034
- */
2035
- post: {
2036
- parameters: {
2037
- query?: never;
2038
- header?: never;
2039
- path: {
2040
- id: string;
2041
- };
2042
- cookie?: never;
2043
- };
2044
- requestBody: {
2045
- content: {
2046
- "application/json": {
2047
- codigo: string;
2048
- nombre?: string;
2049
- ubigeo?: string;
2050
- direccion?: string;
2051
- departamento?: string;
2052
- provincia?: string;
2053
- distrito?: string;
2054
- urbanizacion?: string;
2055
- /** @default true */
2056
- isActive?: boolean;
2057
- };
2058
- };
2059
- };
2060
- responses: {
2061
- /** @description Default Response */
2062
- 200: {
2063
- headers: {
2064
- [name: string]: unknown;
2065
- };
2066
- content?: never;
2067
- };
2068
- };
2069
- };
2070
- delete?: never;
2071
- options?: never;
2072
- head?: never;
2073
- patch?: never;
2074
- trace?: never;
2075
- };
2076
- "/api/v1/companies/{id}/branches/{branchId}": {
2077
- parameters: {
2078
- query?: never;
2079
- header?: never;
2080
- path?: never;
2081
- cookie?: never;
2082
- };
2083
- get?: never;
2084
- /** Actualizar establecimiento */
2085
- put: {
2086
- parameters: {
2087
- query?: never;
2088
- header?: never;
2089
- path: {
2090
- id: string;
2091
- branchId: string;
2092
- };
2093
- cookie?: never;
2094
- };
2095
- requestBody: {
2096
- content: {
2097
- "application/json": {
2098
- nombre?: string;
2099
- ubigeo?: string;
2100
- direccion?: string;
2101
- departamento?: string;
2102
- provincia?: string;
2103
- distrito?: string;
2104
- urbanizacion?: string;
2105
- /** @default true */
2106
- isActive?: boolean;
2107
- };
2289
+ query?: {
2290
+ ruc?: string;
2108
2291
  };
2292
+ header?: never;
2293
+ path?: never;
2294
+ cookie?: never;
2109
2295
  };
2296
+ requestBody?: never;
2110
2297
  responses: {
2111
2298
  /** @description Default Response */
2112
2299
  200: {
@@ -2117,22 +2304,30 @@ export interface paths {
2117
2304
  };
2118
2305
  };
2119
2306
  };
2120
- post?: never;
2307
+ put?: never;
2121
2308
  /**
2122
- * Desactivar establecimiento (soft-delete)
2123
- * @description No se elimina físicamente porque puede haber documentos emitidos desde ahí. Solo se desactiva (isActive=false).
2309
+ * Crear endpoint webhook
2310
+ * @description Registra una URL que recibirá POSTs cuando ocurran los eventos suscritos. La respuesta incluye el `secret` (mostrado UNA sola vez) — guárdalo para verificar las firmas HMAC-SHA256.
2124
2311
  */
2125
- delete: {
2312
+ post: {
2126
2313
  parameters: {
2127
2314
  query?: never;
2128
2315
  header?: never;
2129
- path: {
2130
- id: string;
2131
- branchId: string;
2132
- };
2316
+ path?: never;
2133
2317
  cookie?: never;
2134
2318
  };
2135
- requestBody?: never;
2319
+ requestBody: {
2320
+ content: {
2321
+ "application/json": {
2322
+ empresaRuc: string;
2323
+ /** Format: uri */
2324
+ url: string;
2325
+ events: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
2326
+ description?: string;
2327
+ secret?: string;
2328
+ };
2329
+ };
2330
+ };
2136
2331
  responses: {
2137
2332
  /** @description Default Response */
2138
2333
  200: {
@@ -2143,24 +2338,27 @@ export interface paths {
2143
2338
  };
2144
2339
  };
2145
2340
  };
2341
+ delete?: never;
2146
2342
  options?: never;
2147
2343
  head?: never;
2148
2344
  patch?: never;
2149
2345
  trace?: never;
2150
2346
  };
2151
- "/api/v1/api-keys": {
2347
+ "/api/v1/webhooks/{id}": {
2152
2348
  parameters: {
2153
2349
  query?: never;
2154
2350
  header?: never;
2155
2351
  path?: never;
2156
2352
  cookie?: never;
2157
2353
  };
2158
- /** Listar API keys (solo master, sin mostrar el secret) */
2354
+ /** Detalle de webhook (sin secret) */
2159
2355
  get: {
2160
2356
  parameters: {
2161
2357
  query?: never;
2162
2358
  header?: never;
2163
- path?: never;
2359
+ path: {
2360
+ id: string;
2361
+ };
2164
2362
  cookie?: never;
2165
2363
  };
2166
2364
  requestBody?: never;
@@ -2174,30 +2372,24 @@ export interface paths {
2174
2372
  };
2175
2373
  };
2176
2374
  };
2177
- put?: never;
2178
- /**
2179
- * Crear API key (solo master)
2180
- * @description El campo `key` (fact_live_...) se muestra UNA sola vez. Guárdalo. No se puede recuperar.
2181
- */
2182
- post: {
2375
+ /** Actualizar webhook (url, eventos, activación) */
2376
+ put: {
2183
2377
  parameters: {
2184
2378
  query?: never;
2185
2379
  header?: never;
2186
- path?: never;
2380
+ path: {
2381
+ id: string;
2382
+ };
2187
2383
  cookie?: never;
2188
2384
  };
2189
2385
  requestBody: {
2190
2386
  content: {
2191
2387
  "application/json": {
2192
- name: string;
2193
- empresaRuc?: string;
2194
- /** Format: date-time */
2195
- expiresAt?: string;
2196
- /**
2197
- * @default live
2198
- * @enum {string}
2199
- */
2200
- env?: "live" | "test";
2388
+ /** Format: uri */
2389
+ url?: string;
2390
+ events?: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
2391
+ description?: string;
2392
+ isActive?: boolean;
2201
2393
  };
2202
2394
  };
2203
2395
  };
@@ -2211,23 +2403,8 @@ export interface paths {
2211
2403
  };
2212
2404
  };
2213
2405
  };
2214
- delete?: never;
2215
- options?: never;
2216
- head?: never;
2217
- patch?: never;
2218
- trace?: never;
2219
- };
2220
- "/api/v1/api-keys/{id}": {
2221
- parameters: {
2222
- query?: never;
2223
- header?: never;
2224
- path?: never;
2225
- cookie?: never;
2226
- };
2227
- get?: never;
2228
- put?: never;
2229
2406
  post?: never;
2230
- /** Revocar API key (soft delete) */
2407
+ /** Eliminar webhook (también elimina su historial de deliveries) */
2231
2408
  delete: {
2232
2409
  parameters: {
2233
2410
  query?: never;
@@ -2253,29 +2430,24 @@ export interface paths {
2253
2430
  patch?: never;
2254
2431
  trace?: never;
2255
2432
  };
2256
- "/api/v1/audit-logs": {
2433
+ "/api/v1/webhooks/{id}/deliveries": {
2257
2434
  parameters: {
2258
2435
  query?: never;
2259
2436
  header?: never;
2260
2437
  path?: never;
2261
2438
  cookie?: never;
2262
2439
  };
2263
- /**
2264
- * Consultar audit log (solo master)
2265
- * @description Lista de acciones mutantes (POST/PUT/PATCH/DELETE) ejecutadas en la API.
2266
- */
2440
+ /** Log de entregas del webhook */
2267
2441
  get: {
2268
2442
  parameters: {
2269
2443
  query?: {
2270
- actor?: string;
2271
- resourceId?: string;
2272
- method?: "POST" | "PUT" | "PATCH" | "DELETE";
2273
- fechaDesde?: string;
2274
- fechaHasta?: string;
2275
2444
  limit?: number;
2445
+ success?: "true" | "false";
2276
2446
  };
2277
2447
  header?: never;
2278
- path?: never;
2448
+ path: {
2449
+ id: string;
2450
+ };
2279
2451
  cookie?: never;
2280
2452
  };
2281
2453
  requestBody?: never;
@@ -2297,55 +2469,27 @@ export interface paths {
2297
2469
  patch?: never;
2298
2470
  trace?: never;
2299
2471
  };
2300
- "/api/v1/tenants": {
2472
+ "/api/v1/webhooks/{id}/deliveries/{deliveryId}/redeliver": {
2301
2473
  parameters: {
2302
2474
  query?: never;
2303
2475
  header?: never;
2304
2476
  path?: never;
2305
2477
  cookie?: never;
2306
2478
  };
2307
- /** Listar tenants (solo master) */
2308
- get: {
2309
- parameters: {
2310
- query?: never;
2311
- header?: never;
2312
- path?: never;
2313
- cookie?: never;
2314
- };
2315
- requestBody?: never;
2316
- responses: {
2317
- /** @description Default Response */
2318
- 200: {
2319
- headers: {
2320
- [name: string]: unknown;
2321
- };
2322
- content?: never;
2323
- };
2324
- };
2325
- };
2479
+ get?: never;
2326
2480
  put?: never;
2327
- /** Crear tenant (cuenta cliente) */
2481
+ /** Reintentar manualmente una entrega */
2328
2482
  post: {
2329
2483
  parameters: {
2330
2484
  query?: never;
2331
2485
  header?: never;
2332
- path?: never;
2333
- cookie?: never;
2334
- };
2335
- requestBody: {
2336
- content: {
2337
- "application/json": {
2338
- name: string;
2339
- /** Format: email */
2340
- email?: string;
2341
- /**
2342
- * @default free
2343
- * @enum {string}
2344
- */
2345
- plan?: "free" | "starter" | "pro" | "enterprise";
2346
- };
2486
+ path: {
2487
+ id: string;
2488
+ deliveryId: string;
2347
2489
  };
2490
+ cookie?: never;
2348
2491
  };
2492
+ requestBody?: never;
2349
2493
  responses: {
2350
2494
  /** @description Default Response */
2351
2495
  200: {
@@ -2362,15 +2506,17 @@ export interface paths {
2362
2506
  patch?: never;
2363
2507
  trace?: never;
2364
2508
  };
2365
- "/api/v1/tenants/{id}": {
2509
+ "/api/v1/webhooks/{id}/test": {
2366
2510
  parameters: {
2367
2511
  query?: never;
2368
2512
  header?: never;
2369
2513
  path?: never;
2370
2514
  cookie?: never;
2371
2515
  };
2372
- /** Detalle de tenant */
2373
- get: {
2516
+ get?: never;
2517
+ put?: never;
2518
+ /** Enviar un evento de prueba (webhook.test) */
2519
+ post: {
2374
2520
  parameters: {
2375
2521
  query?: never;
2376
2522
  header?: never;
@@ -2390,8 +2536,26 @@ export interface paths {
2390
2536
  };
2391
2537
  };
2392
2538
  };
2393
- /** Actualizar tenant */
2394
- put: {
2539
+ delete?: never;
2540
+ options?: never;
2541
+ head?: never;
2542
+ patch?: never;
2543
+ trace?: never;
2544
+ };
2545
+ "/api/v1/webhooks/{id}/rotate-secret": {
2546
+ parameters: {
2547
+ query?: never;
2548
+ header?: never;
2549
+ path?: never;
2550
+ cookie?: never;
2551
+ };
2552
+ get?: never;
2553
+ put?: never;
2554
+ /**
2555
+ * Rotar el secret de firma (devuelto UNA sola vez)
2556
+ * @description Genera un nuevo secret HMAC y lo devuelve una única vez. Las firmas de entregas posteriores usarán el nuevo secret; actualiza tu receptor antes de rotar.
2557
+ */
2558
+ post: {
2395
2559
  parameters: {
2396
2560
  query?: never;
2397
2561
  header?: never;
@@ -2400,18 +2564,7 @@ export interface paths {
2400
2564
  };
2401
2565
  cookie?: never;
2402
2566
  };
2403
- requestBody: {
2404
- content: {
2405
- "application/json": {
2406
- name?: string;
2407
- /** Format: email */
2408
- email?: string;
2409
- /** @enum {string} */
2410
- plan?: "free" | "starter" | "pro" | "enterprise";
2411
- isActive?: boolean;
2412
- };
2413
- };
2414
- };
2567
+ requestBody?: never;
2415
2568
  responses: {
2416
2569
  /** @description Default Response */
2417
2570
  200: {
@@ -2422,7 +2575,6 @@ export interface paths {
2422
2575
  };
2423
2576
  };
2424
2577
  };
2425
- post?: never;
2426
2578
  delete?: never;
2427
2579
  options?: never;
2428
2580
  head?: never;
@@ -2570,40 +2722,6 @@ export interface paths {
2570
2722
  patch?: never;
2571
2723
  trace?: never;
2572
2724
  };
2573
- "/api/v1/usage": {
2574
- parameters: {
2575
- query?: never;
2576
- header?: never;
2577
- path?: never;
2578
- cookie?: never;
2579
- };
2580
- /** Consumo del tenant actual (docs emitidos / límite del plan) */
2581
- get: {
2582
- parameters: {
2583
- query?: never;
2584
- header?: never;
2585
- path?: never;
2586
- cookie?: never;
2587
- };
2588
- requestBody?: never;
2589
- responses: {
2590
- /** @description Default Response */
2591
- 200: {
2592
- headers: {
2593
- [name: string]: unknown;
2594
- };
2595
- content?: never;
2596
- };
2597
- };
2598
- };
2599
- put?: never;
2600
- post?: never;
2601
- delete?: never;
2602
- options?: never;
2603
- head?: never;
2604
- patch?: never;
2605
- trace?: never;
2606
- };
2607
2725
  "/api/v1/auth/signup": {
2608
2726
  parameters: {
2609
2727
  query?: never;
@@ -3056,6 +3174,91 @@ export interface paths {
3056
3174
  patch?: never;
3057
3175
  trace?: never;
3058
3176
  };
3177
+ "/api/v1/catalogs": {
3178
+ parameters: {
3179
+ query?: never;
3180
+ header?: never;
3181
+ path?: never;
3182
+ cookie?: never;
3183
+ };
3184
+ /**
3185
+ * Listar catálogos SUNAT (código → descripción)
3186
+ * @description Devuelve los catálogos SUNAT más usados y los específicos de guías de remisión (01 tipo doc, 06 doc identidad, 18 modalidad, 20 motivo traslado, 61 doc relacionado, 07 afectación IGV, 25 unidad, etc.).
3187
+ */
3188
+ get: {
3189
+ parameters: {
3190
+ query?: never;
3191
+ header?: never;
3192
+ path?: never;
3193
+ cookie?: never;
3194
+ };
3195
+ requestBody?: never;
3196
+ responses: {
3197
+ /** @description Default Response */
3198
+ 200: {
3199
+ headers: {
3200
+ [name: string]: unknown;
3201
+ };
3202
+ content: {
3203
+ "application/json": {
3204
+ success: boolean;
3205
+ data: {
3206
+ key: string;
3207
+ name: string;
3208
+ items: {
3209
+ code: string;
3210
+ label: string;
3211
+ }[];
3212
+ }[];
3213
+ };
3214
+ };
3215
+ };
3216
+ };
3217
+ };
3218
+ put?: never;
3219
+ post?: never;
3220
+ delete?: never;
3221
+ options?: never;
3222
+ head?: never;
3223
+ patch?: never;
3224
+ trace?: never;
3225
+ };
3226
+ "/api/v1/catalogs/{key}": {
3227
+ parameters: {
3228
+ query?: never;
3229
+ header?: never;
3230
+ path?: never;
3231
+ cookie?: never;
3232
+ };
3233
+ /** Obtener un catálogo por clave */
3234
+ get: {
3235
+ parameters: {
3236
+ query?: never;
3237
+ header?: never;
3238
+ path: {
3239
+ key: string;
3240
+ };
3241
+ cookie?: never;
3242
+ };
3243
+ requestBody?: never;
3244
+ responses: {
3245
+ /** @description Default Response */
3246
+ 200: {
3247
+ headers: {
3248
+ [name: string]: unknown;
3249
+ };
3250
+ content?: never;
3251
+ };
3252
+ };
3253
+ };
3254
+ put?: never;
3255
+ post?: never;
3256
+ delete?: never;
3257
+ options?: never;
3258
+ head?: never;
3259
+ patch?: never;
3260
+ trace?: never;
3261
+ };
3059
3262
  }
3060
3263
  export type webhooks = Record<string, never>;
3061
3264
  export interface components {
@@ -3068,3 +3271,4 @@ export interface components {
3068
3271
  }
3069
3272
  export type $defs = Record<string, never>;
3070
3273
  export type operations = Record<string, never>;
3274
+ //# sourceMappingURL=types.d.ts.map