intifact 1.1.1 → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -3,10 +3,30 @@ import type { paths } from "./types.js";
3
3
  export type { paths, components } from "./types.js";
4
4
  /** Body de POST /api/v1/invoice/send */
5
5
  export type SendInvoiceInput = paths["/api/v1/invoice/send"]["post"]["requestBody"]["content"]["application/json"];
6
+ /** Body de POST /api/v1/invoice/compute */
7
+ export type ComputeInvoiceInput = paths["/api/v1/invoice/compute"]["post"]["requestBody"]["content"]["application/json"];
6
8
  /** Body de POST /api/v1/note/send */
7
9
  export type SendNoteInput = paths["/api/v1/note/send"]["post"]["requestBody"]["content"]["application/json"];
8
- /** Body de POST /api/v1/despatch/send */
10
+ /** Body de POST /api/v1/note/compute */
11
+ export type ComputeNoteInput = paths["/api/v1/note/compute"]["post"]["requestBody"]["content"]["application/json"];
12
+ /** Body de POST /api/v1/despatch/send (Guía Remitente 09) */
9
13
  export type SendDespatchInput = paths["/api/v1/despatch/send"]["post"]["requestBody"]["content"]["application/json"];
14
+ /** Body de POST /api/v1/despatch/send-multi */
15
+ export type SendDespatchMultiInput = paths["/api/v1/despatch/send-multi"]["post"]["requestBody"]["content"]["application/json"];
16
+ /** Body de POST /api/v1/despatch-transportista/send (Guía Transportista 31) */
17
+ export type SendDespatchTransportistaInput = paths["/api/v1/despatch-transportista/send"]["post"]["requestBody"]["content"]["application/json"];
18
+ /** Body de POST /api/v1/summary/send (Resumen Diario) */
19
+ export type SendSummaryInput = paths["/api/v1/summary/send"]["post"]["requestBody"]["content"]["application/json"];
20
+ /** Body de POST /api/v1/voided/send (Comunicación de Baja) */
21
+ export type SendVoidedInput = paths["/api/v1/voided/send"]["post"]["requestBody"]["content"]["application/json"];
22
+ /** Body de POST /api/v1/invoice/cancel (anular factura) */
23
+ export type CancelInvoiceInput = paths["/api/v1/invoice/cancel"]["post"]["requestBody"]["content"]["application/json"];
24
+ /** Body de POST /api/v1/boleta/cancel (anular boleta) */
25
+ export type CancelBoletaInput = paths["/api/v1/boleta/cancel"]["post"]["requestBody"]["content"]["application/json"];
26
+ /** Body de POST /api/v1/webhooks */
27
+ export type CreateWebhookInput = paths["/api/v1/webhooks"]["post"]["requestBody"]["content"]["application/json"];
28
+ /** Body de PUT /api/v1/webhooks/{id} */
29
+ export type UpdateWebhookInput = paths["/api/v1/webhooks/{id}"]["put"]["requestBody"]["content"]["application/json"];
10
30
  /** Respuesta 202 de cualquier /send (documento encolado) */
11
31
  export type EnqueueResponse = paths["/api/v1/invoice/send"]["post"]["responses"]["202"]["content"]["application/json"];
12
32
  /** Respuesta de GET /api/v1/queues/stats */
@@ -22,7 +42,7 @@ export interface FacturacionClientOptions extends ClientOptions {
22
42
  *
23
43
  * @example
24
44
  * ```ts
25
- * const fact = new FacturacionClient({ baseUrl: "http://localhost:3000" });
45
+ * const fact = new FacturacionClient({ baseUrl: "http://localhost:3000", apiKey: "fact_test_..." });
26
46
  * const { data, error } = await fact.sendInvoice({ ...payload });
27
47
  * if (data) console.log("encolado:", data.data.id);
28
48
  * ```
@@ -30,7 +50,7 @@ export interface FacturacionClientOptions extends ClientOptions {
30
50
  export declare class FacturacionClient {
31
51
  private readonly api;
32
52
  constructor(opts: FacturacionClientOptions);
33
- /** Envía factura o boleta. Encolada para procesamiento asíncrono. */
53
+ /** Envía factura (01) o boleta (03). Encolada para procesamiento asíncrono → 202. */
34
54
  sendInvoice(body: SendInvoiceInput): Promise<import("openapi-fetch").FetchResponse<{
35
55
  parameters: {
36
56
  query?: never;
@@ -65,7 +85,9 @@ export declare class FacturacionClient {
65
85
  valorVenta: number;
66
86
  subTotal: number;
67
87
  montoImpVenta: number;
68
- descuentoGlobal?: number;
88
+ descuentoGlobal
89
+ /** Anula una factura (comunicación de baja). */
90
+ ?: number;
69
91
  descuentoGlobalBase?: number;
70
92
  detalle: {
71
93
  unidad: string;
@@ -82,7 +104,9 @@ export declare class FacturacionClient {
82
104
  montoPrecioUnitario: number;
83
105
  montoValorVenta: number;
84
106
  descuento?: number;
85
- descuentoItem?: number;
107
+ descuentoItem
108
+ /** Lista documentos con filtros y paginación. */
109
+ ?: number;
86
110
  factorIcbper?: number;
87
111
  codProdSunat?: string;
88
112
  }[];
@@ -201,7 +225,9 @@ export declare class FacturacionClient {
201
225
  montoPrecioUnitario: number;
202
226
  montoValorVenta: number;
203
227
  descuento?: number;
204
- descuentoItem?: number;
228
+ descuentoItem
229
+ /** Lista documentos con filtros y paginación. */
230
+ ?: number;
205
231
  factorIcbper?: number;
206
232
  codProdSunat?: string;
207
233
  }[];
@@ -224,6 +250,122 @@ export declare class FacturacionClient {
224
250
  };
225
251
  };
226
252
  }, `${string}/${string}`>>;
253
+ /** Calcula importes (Modelo B) de una factura/boleta SIN emitir. */
254
+ computeInvoice(body: ComputeInvoiceInput): Promise<import("openapi-fetch").FetchResponse<{
255
+ parameters: {
256
+ query?: never;
257
+ header?: never;
258
+ path?: never;
259
+ cookie?: never;
260
+ };
261
+ requestBody: {
262
+ content: {
263
+ "application/json": {
264
+ tipoMoneda?: string;
265
+ items: {
266
+ descripcion: string;
267
+ cantidad: number;
268
+ valorUnitario: number;
269
+ unidad?: string;
270
+ codProducto?: string;
271
+ afectacion?: string;
272
+ igvPorcentaje?: number;
273
+ descuento?: {
274
+ porcentaje?: number;
275
+ monto?: number;
276
+ };
277
+ factorIcbper?: number;
278
+ marca?: string;
279
+ codProdSunat?: string;
280
+ }[];
281
+ descuentoGlobal
282
+ /** Lista los catálogos SUNAT disponibles. */
283
+ ?: {
284
+ porcentaje? /** Lista los catálogos SUNAT disponibles. */: number;
285
+ monto?: number;
286
+ };
287
+ preciosIncluyenIgv?: boolean;
288
+ };
289
+ };
290
+ };
291
+ responses: {
292
+ 200: {
293
+ headers: {
294
+ [name: string]: unknown;
295
+ };
296
+ content: {
297
+ "application/json": {
298
+ success: boolean;
299
+ message: string;
300
+ data: {
301
+ tipoMoneda: string;
302
+ items: {
303
+ unidad: string;
304
+ cantidad: number;
305
+ codProducto: string;
306
+ descripcion: string;
307
+ marca?: string;
308
+ tipAfeIgv: string;
309
+ porcentajeIgv: number;
310
+ montoValorUnitario: number;
311
+ descuento: number;
312
+ descuentoItem: number;
313
+ descuentoGlobalLinea: number;
314
+ montoBruto: number;
315
+ montoValorVenta: number;
316
+ montoBaseIgv: number;
317
+ igv: number;
318
+ totalImpuestos: number;
319
+ montoPrecioUnitario: number;
320
+ factorIcbper: number;
321
+ codProdSunat? /** Estado de las colas BullMQ (jobs en cada estado). */: string;
322
+ }[];
323
+ montoOperGravadas: number;
324
+ montoOperExoneradas: number;
325
+ montoOperInafectas: number;
326
+ montoOperGratuitas: number;
327
+ montoOperExportacion: number;
328
+ montoIgv: number;
329
+ montoIcbper: number;
330
+ descuentoGlobal: number;
331
+ descuentoGlobalBase: number;
332
+ totalDescuentos: number;
333
+ totalImpuestos: number;
334
+ valorVenta: number;
335
+ subTotal: number;
336
+ montoImpVenta: number;
337
+ montoEnLetras: string;
338
+ };
339
+ };
340
+ };
341
+ };
342
+ };
343
+ }, {
344
+ body: {
345
+ tipoMoneda?: string;
346
+ items: {
347
+ descripcion: string;
348
+ cantidad: number;
349
+ valorUnitario: number;
350
+ unidad?: string;
351
+ codProducto?: string;
352
+ afectacion?: string;
353
+ igvPorcentaje?: number;
354
+ descuento?: {
355
+ porcentaje?: number;
356
+ monto?: number;
357
+ };
358
+ factorIcbper?: number;
359
+ marca?: string;
360
+ codProdSunat?: string;
361
+ }[];
362
+ descuentoGlobal?: {
363
+ porcentaje? /** Lista los catálogos SUNAT disponibles. */: number;
364
+ monto?: number;
365
+ };
366
+ preciosIncluyenIgv?: boolean;
367
+ };
368
+ }, `${string}/${string}`>>;
227
369
  /** Envía nota de crédito (07) o débito (08). */
228
370
  sendNote(body: SendNoteInput): Promise<import("openapi-fetch").FetchResponse<{
229
371
  parameters: {
@@ -400,7 +542,121 @@ export declare class FacturacionClient {
400
542
  observacion?: string;
401
543
  };
402
544
  }, `${string}/${string}`>>;
403
- /** Envía guía de remisión (GRE REST). */
545
+ /** Calcula importes (Modelo B) de una nota SIN emitir. */
546
+ computeNote(body: ComputeNoteInput): Promise<import("openapi-fetch").FetchResponse<{
547
+ parameters: {
548
+ query?: never;
549
+ header?: never;
550
+ path?: never;
551
+ cookie?: never;
552
+ };
553
+ requestBody: {
554
+ content: {
555
+ "application/json": {
556
+ tipoMoneda?: string;
557
+ items: {
558
+ descripcion: string;
559
+ cantidad: number;
560
+ valorUnitario: number;
561
+ unidad?: string;
562
+ codProducto?: string;
563
+ afectacion?: string;
564
+ igvPorcentaje?: number;
565
+ descuento?: {
566
+ porcentaje?: number;
567
+ monto?: number;
568
+ };
569
+ factorIcbper?: number;
570
+ marca?: string;
571
+ codProdSunat?: string;
572
+ }[];
573
+ descuentoGlobal?: {
574
+ porcentaje?: number;
575
+ monto?: number;
576
+ };
577
+ preciosIncluyenIgv?: boolean;
578
+ };
579
+ };
580
+ };
581
+ responses: {
582
+ 200: {
583
+ headers: {
584
+ [name: string]: unknown;
585
+ };
586
+ content: {
587
+ "application/json": {
588
+ success: boolean;
589
+ message: string;
590
+ data: {
591
+ tipoMoneda: string;
592
+ items: {
593
+ unidad: string;
594
+ cantidad: number;
595
+ codProducto: string;
596
+ descripcion: string;
597
+ marca?: string;
598
+ tipAfeIgv: string;
599
+ porcentajeIgv: number;
600
+ montoValorUnitario: number;
601
+ descuento: number;
602
+ descuentoItem: number;
603
+ descuentoGlobalLinea: number;
604
+ montoBruto: number;
605
+ montoValorVenta: number;
606
+ montoBaseIgv: number;
607
+ igv: number;
608
+ totalImpuestos: number;
609
+ montoPrecioUnitario: number;
610
+ factorIcbper: number;
611
+ codProdSunat?: string;
612
+ }[];
613
+ montoOperGravadas: number;
614
+ montoOperExoneradas: number;
615
+ montoOperInafectas: number;
616
+ montoOperGratuitas: number;
617
+ montoOperExportacion: number;
618
+ montoIgv: number;
619
+ montoIcbper: number;
620
+ descuentoGlobal: number;
621
+ descuentoGlobalBase: number;
622
+ totalDescuentos: number;
623
+ totalImpuestos: number;
624
+ valorVenta: number;
625
+ subTotal: number;
626
+ montoImpVenta: number;
627
+ montoEnLetras: string;
628
+ };
629
+ };
630
+ };
631
+ };
632
+ };
633
+ }, {
634
+ body: {
635
+ tipoMoneda?: string;
636
+ items: {
637
+ descripcion: string;
638
+ cantidad: number;
639
+ valorUnitario: number;
640
+ unidad?: string;
641
+ codProducto?: string;
642
+ afectacion?: string;
643
+ igvPorcentaje?: number;
644
+ descuento?: {
645
+ porcentaje?: number;
646
+ monto?: number;
647
+ };
648
+ factorIcbper?: number;
649
+ marca?: string;
650
+ codProdSunat?: string;
651
+ }[];
652
+ descuentoGlobal?: {
653
+ porcentaje?: number;
654
+ monto?: number;
655
+ };
656
+ preciosIncluyenIgv?: boolean;
657
+ };
658
+ }, `${string}/${string}`>>;
659
+ /** Envía guía de remisión remitente (09). */
404
660
  sendDespatch(body: SendDespatchInput): Promise<import("openapi-fetch").FetchResponse<{
405
661
  parameters: {
406
662
  query?: never;
@@ -678,87 +934,1271 @@ export declare class FacturacionClient {
678
934
  }[];
679
935
  };
680
936
  }, `${string}/${string}`>>;
681
- /** Lista documentos con filtros y paginación. */
682
- listDocuments(query?: paths["/api/v1/documents"]["get"]["parameters"]["query"]): Promise<import("openapi-fetch").FetchResponse<{
937
+ /** Envía varias guías de remisión en un solo request. */
938
+ sendDespatchMulti(body: SendDespatchMultiInput): Promise<import("openapi-fetch").FetchResponse<{
683
939
  parameters: {
684
- query?: {
685
- ruc?: string;
686
- tipoDoc?: string;
687
- serie?: string;
688
- estado?: string;
689
- env?: "live" | "test";
690
- fechaDesde?: string;
691
- fechaHasta?: string;
692
- clienteNumDoc?: string;
693
- page?: number;
694
- limit?: number;
695
- };
940
+ query?: never;
696
941
  header?: never;
697
942
  path?: never;
698
943
  cookie?: never;
699
944
  };
700
- requestBody?: never;
945
+ requestBody: {
946
+ content: {
947
+ "application/json": {
948
+ tipoDoc: "09";
949
+ serie: string;
950
+ observacion?: string;
951
+ fechaEmision: string;
952
+ empresaRuc: string;
953
+ establecimientoCodigo?: string;
954
+ guiaCodTraslado: string;
955
+ guiaModTraslado: "01" | "02";
956
+ guiaFecTraslado: string;
957
+ guiaVehiculoPlaca?: string;
958
+ transportistaTipoDoc?: string;
959
+ transportistaNumDoc?: string;
960
+ transportistaRazonSocial?: string;
961
+ transportistaNroMtc?: string;
962
+ guiaPartidaUbigeo: string;
963
+ guiaPartidaDireccion: string;
964
+ chofer?: {
965
+ tipo: "Principal" | "Secundario";
966
+ tipoDoc: string;
967
+ nroDoc: string;
968
+ licencia: string;
969
+ nombres: string;
970
+ apellidos: string;
971
+ }[];
972
+ guiaFecEntrega?: string;
973
+ guiaDesTraslado?: string;
974
+ guiaPesoNeto?: number;
975
+ guiaSustentoPeso?: string;
976
+ guiaNumBultos?: number;
977
+ indicadores?: {
978
+ transbordoProgramado?: boolean;
979
+ vehiculoM1L?: boolean;
980
+ retornoVehiculoEnvaseVacio?: boolean;
981
+ retornoVehiculoVacio?: boolean;
982
+ trasladoTotalDamDs?: boolean;
983
+ registroTransportista?: boolean;
984
+ trasladoContenedorManifiesto?: boolean;
985
+ };
986
+ contenedores?: {
987
+ numero: string;
988
+ precinto?: string;
989
+ }[];
990
+ guiaVehiculoTuc?: string;
991
+ guiaVehiculoAutorizacion?: string;
992
+ guiaVehiculoAutorizacionEntidad?: string;
993
+ vehiculosSecundarios?: {
994
+ placa: string;
995
+ tuc?: string;
996
+ autorizacion?: string;
997
+ autorizacionEntidad?: string;
998
+ }[];
999
+ transportistaAutorizacion?: string;
1000
+ transportistaAutorizacionEntidad?: string;
1001
+ guiaPartidaRuc?: string;
1002
+ guiaPartidaCodLocal?: string;
1003
+ guiaPartidaGeo?: {
1004
+ lat: string;
1005
+ lon: string;
1006
+ };
1007
+ guiaLlegadaRuc?: string;
1008
+ guiaLlegadaCodLocal?: string;
1009
+ guiaLlegadaGeo?: {
1010
+ lat: string;
1011
+ lon: string;
1012
+ };
1013
+ documentosRelacionados?: {
1014
+ codTipo: string;
1015
+ numero: string;
1016
+ tipoDesc?: string;
1017
+ emisorRuc?: string;
1018
+ }[];
1019
+ remitenteAutorizacion?: string;
1020
+ remitenteAutorizacionEntidad?: string;
1021
+ proveedorTipoDoc?: string;
1022
+ proveedorNumDoc?: string;
1023
+ proveedorRazonSocial?: string;
1024
+ compradorTipoDoc?: string;
1025
+ compradorNumDoc?: string;
1026
+ compradorRazonSocial?: string;
1027
+ puertoCodigo?: string;
1028
+ puertoNombre?: string;
1029
+ puertoTipo?: string;
1030
+ destinos: {
1031
+ clienteTipoDoc: string;
1032
+ clienteNumDoc: string;
1033
+ clienteRazonSocial: string;
1034
+ clienteDireccion?: string;
1035
+ clienteDistrito?: string;
1036
+ clienteProvincia?: string;
1037
+ clienteDepartamento?: string;
1038
+ destinatarioContacto?: string;
1039
+ destinatarioTelefono?: string;
1040
+ destinatarioEmail?: string;
1041
+ entregaReferencia?: string;
1042
+ guiaLlegadaUbigeo: string;
1043
+ guiaLlegadaDireccion: string;
1044
+ guiaPesoTotal: number;
1045
+ guiaUndPesoTotal?: string;
1046
+ detalle: {
1047
+ unidad: string;
1048
+ cantidad: number;
1049
+ codProducto: string;
1050
+ descripcion: string;
1051
+ }[];
1052
+ }[];
1053
+ };
1054
+ };
1055
+ };
701
1056
  responses: {
702
- 200: {
1057
+ 202: {
703
1058
  headers: {
704
1059
  [name: string]: unknown;
705
1060
  };
706
1061
  content: {
707
1062
  "application/json": {
708
1063
  success: boolean;
709
- data: {
710
- id: string;
711
- env: "live" | "test";
712
- tipoDoc: string;
713
- serie: string;
714
- correlativo: string;
715
- fechaEmision: string;
716
- tipoMoneda: string;
717
- clienteNumDoc: string;
718
- clienteRazonSocial: string;
719
- montoImpVenta: string;
720
- estadoSunat: string;
721
- codigoRespuesta: string | null;
722
- hashCdr: string | null;
723
- createdAt: string;
724
- company: {
725
- ruc: string;
726
- razonSocial: string;
727
- };
728
- }[];
729
- pagination: {
730
- page: number;
731
- limit: number;
1064
+ message: string;
1065
+ data?: {
732
1066
  total: number;
733
- totalPages: number;
1067
+ emitidas: number;
1068
+ fallidas: number;
1069
+ guias: {
1070
+ success: boolean;
1071
+ message: string;
1072
+ code?: string;
1073
+ destino: number;
1074
+ data?: {
1075
+ id: string;
1076
+ estado: string;
1077
+ hash: string | null;
1078
+ signatureValue: string | null;
1079
+ jobId?: string;
1080
+ };
1081
+ }[];
734
1082
  };
735
1083
  };
736
1084
  };
737
1085
  };
738
- };
739
- }, {
740
- params: {
741
- query: {
742
- ruc?: string;
743
- tipoDoc?: string;
744
- serie?: string;
745
- estado?: string;
746
- env?: "live" | "test";
747
- fechaDesde?: string;
748
- fechaHasta?: string;
749
- clienteNumDoc?: string;
750
- page?: number;
1086
+ 400: {
1087
+ headers: {
1088
+ [name: string]: unknown;
1089
+ };
1090
+ content: {
1091
+ "application/json": {
1092
+ success: false;
1093
+ message: string;
1094
+ code?: string;
1095
+ errors?: {
1096
+ path: string;
1097
+ message: string;
1098
+ }[];
1099
+ };
1100
+ };
1101
+ };
1102
+ };
1103
+ }, {
1104
+ body: {
1105
+ tipoDoc: "09";
1106
+ serie: string;
1107
+ observacion?: string;
1108
+ fechaEmision: string;
1109
+ empresaRuc: string;
1110
+ establecimientoCodigo?: string;
1111
+ guiaCodTraslado: string;
1112
+ guiaModTraslado: "01" | "02";
1113
+ guiaFecTraslado: string;
1114
+ guiaVehiculoPlaca?: string;
1115
+ transportistaTipoDoc?: string;
1116
+ transportistaNumDoc?: string;
1117
+ transportistaRazonSocial?: string;
1118
+ transportistaNroMtc?: string;
1119
+ guiaPartidaUbigeo: string;
1120
+ guiaPartidaDireccion: string;
1121
+ chofer?: {
1122
+ tipo: "Principal" | "Secundario";
1123
+ tipoDoc: string;
1124
+ nroDoc: string;
1125
+ licencia: string;
1126
+ nombres: string;
1127
+ apellidos: string;
1128
+ }[];
1129
+ guiaFecEntrega?: string;
1130
+ guiaDesTraslado?: string;
1131
+ guiaPesoNeto?: number;
1132
+ guiaSustentoPeso?: string;
1133
+ guiaNumBultos?: number;
1134
+ indicadores?: {
1135
+ transbordoProgramado?: boolean;
1136
+ vehiculoM1L?: boolean;
1137
+ retornoVehiculoEnvaseVacio?: boolean;
1138
+ retornoVehiculoVacio?: boolean;
1139
+ trasladoTotalDamDs?: boolean;
1140
+ registroTransportista?: boolean;
1141
+ trasladoContenedorManifiesto?: boolean;
1142
+ };
1143
+ contenedores?: {
1144
+ numero: string;
1145
+ precinto?: string;
1146
+ }[];
1147
+ guiaVehiculoTuc?: string;
1148
+ guiaVehiculoAutorizacion?: string;
1149
+ guiaVehiculoAutorizacionEntidad?: string;
1150
+ vehiculosSecundarios?: {
1151
+ placa: string;
1152
+ tuc?: string;
1153
+ autorizacion?: string;
1154
+ autorizacionEntidad?: string;
1155
+ }[];
1156
+ transportistaAutorizacion?: string;
1157
+ transportistaAutorizacionEntidad?: string;
1158
+ guiaPartidaRuc?: string;
1159
+ guiaPartidaCodLocal?: string;
1160
+ guiaPartidaGeo?: {
1161
+ lat: string;
1162
+ lon: string;
1163
+ };
1164
+ guiaLlegadaRuc?: string;
1165
+ guiaLlegadaCodLocal?: string;
1166
+ guiaLlegadaGeo?: {
1167
+ lat: string;
1168
+ lon: string;
1169
+ };
1170
+ documentosRelacionados?: {
1171
+ codTipo: string;
1172
+ numero: string;
1173
+ tipoDesc?: string;
1174
+ emisorRuc?: string;
1175
+ }[];
1176
+ remitenteAutorizacion?: string;
1177
+ remitenteAutorizacionEntidad?: string;
1178
+ proveedorTipoDoc?: string;
1179
+ proveedorNumDoc?: string;
1180
+ proveedorRazonSocial?: string;
1181
+ compradorTipoDoc?: string;
1182
+ compradorNumDoc?: string;
1183
+ compradorRazonSocial?: string;
1184
+ puertoCodigo?: string;
1185
+ puertoNombre?: string;
1186
+ puertoTipo?: string;
1187
+ destinos: {
1188
+ clienteTipoDoc: string;
1189
+ clienteNumDoc: string;
1190
+ clienteRazonSocial: string;
1191
+ clienteDireccion?: string;
1192
+ clienteDistrito?: string;
1193
+ clienteProvincia?: string;
1194
+ clienteDepartamento?: string;
1195
+ destinatarioContacto?: string;
1196
+ destinatarioTelefono?: string;
1197
+ destinatarioEmail?: string;
1198
+ entregaReferencia?: string;
1199
+ guiaLlegadaUbigeo: string;
1200
+ guiaLlegadaDireccion: string;
1201
+ guiaPesoTotal: number;
1202
+ guiaUndPesoTotal?: string;
1203
+ detalle: {
1204
+ unidad: string;
1205
+ cantidad: number;
1206
+ codProducto: string;
1207
+ descripcion: string;
1208
+ }[];
1209
+ }[];
1210
+ };
1211
+ }, `${string}/${string}`>>;
1212
+ /** Envía guía de remisión transportista (31). */
1213
+ sendDespatchTransportista(body: SendDespatchTransportistaInput): Promise<import("openapi-fetch").FetchResponse<{
1214
+ parameters: {
1215
+ query?: never;
1216
+ header?: never;
1217
+ path?: never;
1218
+ cookie?: never;
1219
+ };
1220
+ requestBody: {
1221
+ content: {
1222
+ "application/json": {
1223
+ tipoDoc: "31";
1224
+ serie: string;
1225
+ correlativo: string;
1226
+ observacion?: string;
1227
+ fechaEmision: string;
1228
+ empresaRuc: string;
1229
+ establecimientoCodigo?: string;
1230
+ transportistaNroMtc?: string;
1231
+ destinatarioTipoDoc: string;
1232
+ destinatarioNumDoc: string;
1233
+ destinatarioRazonSocial: string;
1234
+ destinatarioDireccion?: string;
1235
+ destinatarioDistrito?: string;
1236
+ destinatarioProvincia?: string;
1237
+ destinatarioDepartamento?: string;
1238
+ destinatarioContacto?: string;
1239
+ destinatarioTelefono?: string;
1240
+ destinatarioEmail?: string;
1241
+ entregaReferencia?: string;
1242
+ remitenteTipoDoc: string;
1243
+ remitenteNumDoc: string;
1244
+ remitenteRazonSocial: string;
1245
+ guiaCodTraslado: string;
1246
+ guiaDesTraslado?: string;
1247
+ guiaPesoTotal: number;
1248
+ guiaUndPesoTotal?: string;
1249
+ guiaNumBultos?: number;
1250
+ guiaFecTraslado: string;
1251
+ chofer: {
1252
+ tipo: "Principal" | "Secundario";
1253
+ tipoDoc: string;
1254
+ nroDoc: string;
1255
+ licencia: string;
1256
+ nombres: string;
1257
+ apellidos: string;
1258
+ }[];
1259
+ guiaVehiculoPlaca: string;
1260
+ guiaVehiculoTuc?: string;
1261
+ vehiculosSecundarios?: {
1262
+ placa: string;
1263
+ tuc?: string;
1264
+ }[];
1265
+ guiaPartidaUbigeo: string;
1266
+ guiaPartidaDireccion: string;
1267
+ guiaLlegadaUbigeo: string;
1268
+ guiaLlegadaDireccion: string;
1269
+ documentosRelacionados?: {
1270
+ codTipo: string;
1271
+ numero: string;
1272
+ tipoDesc?: string;
1273
+ emisorRuc?: string;
1274
+ }[];
1275
+ detalle: {
1276
+ unidad: string;
1277
+ cantidad: number;
1278
+ codProducto: string;
1279
+ descripcion: string;
1280
+ }[];
1281
+ };
1282
+ };
1283
+ };
1284
+ responses: {
1285
+ 202: {
1286
+ headers: {
1287
+ [name: string]: unknown;
1288
+ };
1289
+ content: {
1290
+ "application/json": {
1291
+ success: boolean;
1292
+ message: string;
1293
+ data?: {
1294
+ id: string;
1295
+ estado: string;
1296
+ hash: string | null;
1297
+ signatureValue: string | null;
1298
+ jobId?: string;
1299
+ };
1300
+ };
1301
+ };
1302
+ };
1303
+ 400: {
1304
+ headers: {
1305
+ [name: string]: unknown;
1306
+ };
1307
+ content: {
1308
+ "application/json": {
1309
+ success: false;
1310
+ message: string;
1311
+ code?: string;
1312
+ errors?: {
1313
+ path: string;
1314
+ message: string;
1315
+ }[];
1316
+ };
1317
+ };
1318
+ };
1319
+ 409: {
1320
+ headers: {
1321
+ [name: string]: unknown;
1322
+ };
1323
+ content: {
1324
+ "application/json": {
1325
+ success: false;
1326
+ message: string;
1327
+ code?: string;
1328
+ errors?: {
1329
+ path: string;
1330
+ message: string;
1331
+ }[];
1332
+ };
1333
+ };
1334
+ };
1335
+ };
1336
+ }, {
1337
+ body: {
1338
+ tipoDoc: "31";
1339
+ serie: string;
1340
+ correlativo: string;
1341
+ observacion?: string;
1342
+ fechaEmision: string;
1343
+ empresaRuc: string;
1344
+ establecimientoCodigo?: string;
1345
+ transportistaNroMtc?: string;
1346
+ destinatarioTipoDoc: string;
1347
+ destinatarioNumDoc: string;
1348
+ destinatarioRazonSocial: string;
1349
+ destinatarioDireccion?: string;
1350
+ destinatarioDistrito?: string;
1351
+ destinatarioProvincia?: string;
1352
+ destinatarioDepartamento?: string;
1353
+ destinatarioContacto?: string;
1354
+ destinatarioTelefono?: string;
1355
+ destinatarioEmail?: string;
1356
+ entregaReferencia?: string;
1357
+ remitenteTipoDoc: string;
1358
+ remitenteNumDoc: string;
1359
+ remitenteRazonSocial: string;
1360
+ guiaCodTraslado: string;
1361
+ guiaDesTraslado?: string;
1362
+ guiaPesoTotal: number;
1363
+ guiaUndPesoTotal?: string;
1364
+ guiaNumBultos?: number;
1365
+ guiaFecTraslado: string;
1366
+ chofer: {
1367
+ tipo: "Principal" | "Secundario";
1368
+ tipoDoc: string;
1369
+ nroDoc: string;
1370
+ licencia: string;
1371
+ nombres: string;
1372
+ apellidos: string;
1373
+ }[];
1374
+ guiaVehiculoPlaca: string;
1375
+ guiaVehiculoTuc?: string;
1376
+ vehiculosSecundarios?: {
1377
+ placa: string;
1378
+ tuc?: string;
1379
+ }[];
1380
+ guiaPartidaUbigeo: string;
1381
+ guiaPartidaDireccion: string;
1382
+ guiaLlegadaUbigeo: string;
1383
+ guiaLlegadaDireccion: string;
1384
+ documentosRelacionados?: {
1385
+ codTipo: string;
1386
+ numero: string;
1387
+ tipoDesc?: string;
1388
+ emisorRuc?: string;
1389
+ }[];
1390
+ detalle: {
1391
+ unidad: string;
1392
+ cantidad: number;
1393
+ codProducto: string;
1394
+ descripcion: string;
1395
+ }[];
1396
+ };
1397
+ }, `${string}/${string}`>>;
1398
+ /** Anula una factura (comunicación de baja). */
1399
+ cancelInvoice(body: CancelInvoiceInput): Promise<import("openapi-fetch").FetchResponse<{
1400
+ parameters: {
1401
+ query?: never;
1402
+ header?: never;
1403
+ path?: never;
1404
+ cookie?: never;
1405
+ };
1406
+ requestBody: {
1407
+ content: {
1408
+ "application/json": {
1409
+ empresaRuc: string;
1410
+ tipoDoc: "01" | "07" | "08";
1411
+ serie: string;
1412
+ correlativo: string;
1413
+ motivoBaja: string;
1414
+ raCorrelativo?: string;
1415
+ };
1416
+ };
1417
+ };
1418
+ responses: {
1419
+ 202: {
1420
+ headers: {
1421
+ [name: string]: unknown;
1422
+ };
1423
+ content: {
1424
+ "application/json": {
1425
+ success: boolean;
1426
+ message: string;
1427
+ data?: {
1428
+ id?: string;
1429
+ estado?: string;
1430
+ ticket?: string;
1431
+ hash?: string | null;
1432
+ };
1433
+ };
1434
+ };
1435
+ };
1436
+ 400: {
1437
+ headers: {
1438
+ [name: string]: unknown;
1439
+ };
1440
+ content: {
1441
+ "application/json": {
1442
+ success: false;
1443
+ message: string;
1444
+ code?: string;
1445
+ errors?: {
1446
+ path: string;
1447
+ message: string;
1448
+ }[];
1449
+ };
1450
+ };
1451
+ };
1452
+ };
1453
+ }, {
1454
+ body: {
1455
+ empresaRuc: string;
1456
+ tipoDoc: "01" | "07" | "08";
1457
+ serie: string;
1458
+ correlativo: string;
1459
+ motivoBaja: string;
1460
+ raCorrelativo?: string;
1461
+ };
1462
+ }, `${string}/${string}`>>;
1463
+ /** Anula una boleta (resumen diario de baja). */
1464
+ cancelBoleta(body: CancelBoletaInput): Promise<import("openapi-fetch").FetchResponse<{
1465
+ parameters: {
1466
+ query?: never;
1467
+ header?: never;
1468
+ path?: never;
1469
+ cookie?: never;
1470
+ };
1471
+ requestBody: {
1472
+ content: {
1473
+ "application/json": {
1474
+ empresaRuc: string;
1475
+ serie: string;
1476
+ correlativo: string;
1477
+ motivoBaja: string;
1478
+ rcCorrelativo?: string;
1479
+ };
1480
+ };
1481
+ };
1482
+ responses: {
1483
+ 202: {
1484
+ headers: {
1485
+ [name: string]: unknown;
1486
+ };
1487
+ content: {
1488
+ "application/json": {
1489
+ success: boolean;
1490
+ message: string;
1491
+ data?: {
1492
+ id?: string;
1493
+ estado?: string;
1494
+ ticket?: string;
1495
+ hash?: string | null;
1496
+ };
1497
+ };
1498
+ };
1499
+ };
1500
+ 400: {
1501
+ headers: {
1502
+ [name: string]: unknown;
1503
+ };
1504
+ content: {
1505
+ "application/json": {
1506
+ success: false;
1507
+ message: string;
1508
+ code?: string;
1509
+ errors?: {
1510
+ path: string;
1511
+ message: string;
1512
+ }[];
1513
+ };
1514
+ };
1515
+ };
1516
+ };
1517
+ }, {
1518
+ body: {
1519
+ empresaRuc: string;
1520
+ serie: string;
1521
+ correlativo: string;
1522
+ motivoBaja: string;
1523
+ rcCorrelativo?: string;
1524
+ };
1525
+ }, `${string}/${string}`>>;
1526
+ /** Envía un Resumen Diario (RC). */
1527
+ sendSummary(body: SendSummaryInput): Promise<import("openapi-fetch").FetchResponse<{
1528
+ parameters: {
1529
+ query?: never;
1530
+ header?: never;
1531
+ path?: never;
1532
+ cookie?: never;
1533
+ };
1534
+ requestBody: {
1535
+ content: {
1536
+ "application/json": {
1537
+ empresaRuc: string;
1538
+ correlativo: string;
1539
+ fechaEmision: string;
1540
+ fechaReferencia: string;
1541
+ items: {
1542
+ tipoDoc: string;
1543
+ serie: string;
1544
+ correlativo: string;
1545
+ clienteTipoDoc: string;
1546
+ clienteNumDoc: string;
1547
+ estadoItem: "1" | "2" | "3";
1548
+ tipoMoneda?: string;
1549
+ montoOperGravadas?: number;
1550
+ montoOperExoneradas?: number;
1551
+ montoOperInafectas?: number;
1552
+ montoOperGratuitas?: number;
1553
+ montoIgv?: number;
1554
+ montoIsc?: number;
1555
+ montoOtrosCargos?: number;
1556
+ montoTotal: number;
1557
+ }[];
1558
+ };
1559
+ };
1560
+ };
1561
+ responses: {
1562
+ 202: {
1563
+ headers: {
1564
+ [name: string]: unknown;
1565
+ };
1566
+ content: {
1567
+ "application/json": {
1568
+ success: boolean;
1569
+ message: string;
1570
+ data?: {
1571
+ id?: string;
1572
+ estado?: string;
1573
+ ticket?: string;
1574
+ hash?: string | null;
1575
+ };
1576
+ };
1577
+ };
1578
+ };
1579
+ 400: {
1580
+ headers: {
1581
+ [name: string]: unknown;
1582
+ };
1583
+ content: {
1584
+ "application/json": {
1585
+ success: false;
1586
+ message: string;
1587
+ code?: string;
1588
+ errors?: {
1589
+ path: string;
1590
+ message: string;
1591
+ }[];
1592
+ };
1593
+ };
1594
+ };
1595
+ };
1596
+ }, {
1597
+ body: {
1598
+ empresaRuc: string;
1599
+ correlativo: string;
1600
+ fechaEmision: string;
1601
+ fechaReferencia: string;
1602
+ items: {
1603
+ tipoDoc: string;
1604
+ serie: string;
1605
+ correlativo: string;
1606
+ clienteTipoDoc: string;
1607
+ clienteNumDoc: string;
1608
+ estadoItem: "1" | "2" | "3";
1609
+ tipoMoneda?: string;
1610
+ montoOperGravadas?: number;
1611
+ montoOperExoneradas?: number;
1612
+ montoOperInafectas?: number;
1613
+ montoOperGratuitas?: number;
1614
+ montoIgv?: number;
1615
+ montoIsc?: number;
1616
+ montoOtrosCargos?: number;
1617
+ montoTotal: number;
1618
+ }[];
1619
+ };
1620
+ }, `${string}/${string}`>>;
1621
+ /** Envía una Comunicación de Baja (RA). */
1622
+ sendVoided(body: SendVoidedInput): Promise<import("openapi-fetch").FetchResponse<{
1623
+ parameters: {
1624
+ query?: never;
1625
+ header?: never;
1626
+ path?: never;
1627
+ cookie?: never;
1628
+ };
1629
+ requestBody: {
1630
+ content: {
1631
+ "application/json": {
1632
+ empresaRuc: string;
1633
+ correlativo: string;
1634
+ fechaEmision: string;
1635
+ fechaReferencia: string;
1636
+ items: {
1637
+ tipoDoc: string;
1638
+ serie: string;
1639
+ correlativo: string;
1640
+ motivoBaja: string;
1641
+ }[];
1642
+ };
1643
+ };
1644
+ };
1645
+ responses: {
1646
+ 202: {
1647
+ headers: {
1648
+ [name: string]: unknown;
1649
+ };
1650
+ content: {
1651
+ "application/json": {
1652
+ success: boolean;
1653
+ message: string;
1654
+ data?: {
1655
+ id?: string;
1656
+ estado?: string;
1657
+ ticket?: string;
1658
+ hash?: string | null;
1659
+ };
1660
+ };
1661
+ };
1662
+ };
1663
+ 400: {
1664
+ headers: {
1665
+ [name: string]: unknown;
1666
+ };
1667
+ content: {
1668
+ "application/json": {
1669
+ success: false;
1670
+ message: string;
1671
+ code?: string;
1672
+ errors?: {
1673
+ path: string;
1674
+ message: string;
1675
+ }[];
1676
+ };
1677
+ };
1678
+ };
1679
+ };
1680
+ }, {
1681
+ body: {
1682
+ empresaRuc: string;
1683
+ correlativo: string;
1684
+ fechaEmision: string;
1685
+ fechaReferencia: string;
1686
+ items: {
1687
+ tipoDoc: string;
1688
+ serie: string;
1689
+ correlativo: string;
1690
+ motivoBaja: string;
1691
+ }[];
1692
+ };
1693
+ }, `${string}/${string}`>>;
1694
+ /** Consulta el estado de un ticket asíncrono (sendSummary). */
1695
+ getTicketStatus(ticket: string, ruc: string): Promise<import("openapi-fetch").FetchResponse<{
1696
+ parameters: {
1697
+ query: {
1698
+ ruc: string;
1699
+ };
1700
+ header?: never;
1701
+ path: {
1702
+ ticket: string;
1703
+ };
1704
+ cookie?: never;
1705
+ };
1706
+ requestBody?: never;
1707
+ responses: {
1708
+ 200: {
1709
+ headers: {
1710
+ [name: string]: unknown;
1711
+ };
1712
+ content: {
1713
+ "application/json": {
1714
+ success: boolean;
1715
+ message: string;
1716
+ statusCode: string;
1717
+ cdrResponse?: {
1718
+ id: string;
1719
+ code: string;
1720
+ description: string;
1721
+ notes: string[];
1722
+ };
1723
+ };
1724
+ };
1725
+ };
1726
+ 202: {
1727
+ headers: {
1728
+ [name: string]: unknown;
1729
+ };
1730
+ content: {
1731
+ "application/json": {
1732
+ success: boolean;
1733
+ message: string;
1734
+ statusCode: string;
1735
+ cdrResponse?: {
1736
+ id: string;
1737
+ code: string;
1738
+ description: string;
1739
+ notes: string[];
1740
+ };
1741
+ };
1742
+ };
1743
+ };
1744
+ };
1745
+ }, {
1746
+ params: {
1747
+ path: {
1748
+ ticket: string;
1749
+ };
1750
+ query: {
1751
+ ruc: string;
1752
+ };
1753
+ };
1754
+ }, `${string}/${string}`>>;
1755
+ /** Lista documentos con filtros y paginación. */
1756
+ listDocuments(query?: paths["/api/v1/documents"]["get"]["parameters"]["query"]): Promise<import("openapi-fetch").FetchResponse<{
1757
+ parameters: {
1758
+ query?: {
1759
+ ruc?: string;
1760
+ tipoDoc?: string;
1761
+ serie?: string;
1762
+ estado?: string;
1763
+ env?: "live" | "test";
1764
+ fechaDesde?: string;
1765
+ fechaHasta?: string;
1766
+ clienteNumDoc?: string;
1767
+ page?: number;
1768
+ limit?: number;
1769
+ };
1770
+ header?: never;
1771
+ path?: never;
1772
+ cookie?: never;
1773
+ };
1774
+ requestBody?: never;
1775
+ responses: {
1776
+ 200: {
1777
+ headers: {
1778
+ [name: string]: unknown;
1779
+ };
1780
+ content: {
1781
+ "application/json": {
1782
+ success: boolean;
1783
+ data: {
1784
+ id: string;
1785
+ env: "live" | "test";
1786
+ tipoDoc: string;
1787
+ serie: string;
1788
+ correlativo: string;
1789
+ fechaEmision: string;
1790
+ tipoMoneda: string;
1791
+ clienteNumDoc: string;
1792
+ clienteRazonSocial: string;
1793
+ montoImpVenta: string;
1794
+ estadoSunat: string;
1795
+ codigoRespuesta: string | null;
1796
+ hashCdr: string | null;
1797
+ createdAt: string;
1798
+ company: {
1799
+ ruc: string;
1800
+ razonSocial: string;
1801
+ };
1802
+ }[];
1803
+ pagination: {
1804
+ page: number;
1805
+ limit: number;
1806
+ total: number;
1807
+ totalPages: number;
1808
+ };
1809
+ };
1810
+ };
1811
+ };
1812
+ };
1813
+ }, {
1814
+ params: {
1815
+ query: {
1816
+ ruc?: string;
1817
+ tipoDoc?: string;
1818
+ serie?: string;
1819
+ estado?: string;
1820
+ env?: "live" | "test";
1821
+ fechaDesde?: string;
1822
+ fechaHasta?: string;
1823
+ clienteNumDoc?: string;
1824
+ page?: number;
1825
+ limit?: number;
1826
+ } | undefined;
1827
+ };
1828
+ }, `${string}/${string}`>>;
1829
+ /** Detalle de un documento por ID. */
1830
+ getDocument(id: string): Promise<import("openapi-fetch").FetchResponse<{
1831
+ parameters: {
1832
+ query?: never;
1833
+ header?: never;
1834
+ path: {
1835
+ id: string;
1836
+ };
1837
+ cookie?: never;
1838
+ };
1839
+ requestBody?: never;
1840
+ responses: {
1841
+ 200: {
1842
+ headers: {
1843
+ [name: string]: unknown;
1844
+ };
1845
+ content?: never;
1846
+ };
1847
+ };
1848
+ }, {
1849
+ params: {
1850
+ path: {
1851
+ id: string;
1852
+ };
1853
+ };
1854
+ }, `${string}/${string}`>>;
1855
+ /** Re-encola un documento fallido (COLA_FALLIDA). */
1856
+ retryDocument(id: string): Promise<import("openapi-fetch").FetchResponse<{
1857
+ parameters: {
1858
+ query?: never;
1859
+ header?: never;
1860
+ path: {
1861
+ id: string;
1862
+ };
1863
+ cookie?: never;
1864
+ };
1865
+ requestBody?: never;
1866
+ responses: {
1867
+ 202: {
1868
+ headers: {
1869
+ [name: string]: unknown;
1870
+ };
1871
+ content: {
1872
+ "application/json": {
1873
+ success: boolean;
1874
+ message: string;
1875
+ jobId?: string;
1876
+ };
1877
+ };
1878
+ };
1879
+ 400: {
1880
+ headers: {
1881
+ [name: string]: unknown;
1882
+ };
1883
+ content: {
1884
+ "application/json": {
1885
+ success: false;
1886
+ message: string;
1887
+ code?: string;
1888
+ errors?: {
1889
+ path: string;
1890
+ message: string;
1891
+ }[];
1892
+ };
1893
+ };
1894
+ };
1895
+ };
1896
+ }, {
1897
+ params: {
1898
+ path: {
1899
+ id: string;
1900
+ };
1901
+ };
1902
+ }, `${string}/${string}`>>;
1903
+ /** Siguiente correlativo disponible para una serie (por ambiente). */
1904
+ getNextCorrelativo(query: paths["/api/v1/documents/next-correlativo"]["get"]["parameters"]["query"]): Promise<import("openapi-fetch").FetchResponse<{
1905
+ parameters: {
1906
+ query: {
1907
+ companyRuc: string;
1908
+ tipoDoc: string;
1909
+ serie: string;
1910
+ };
1911
+ header?: never;
1912
+ path?: never;
1913
+ cookie?: never;
1914
+ };
1915
+ requestBody?: never;
1916
+ responses: {
1917
+ 200: {
1918
+ headers: {
1919
+ [name: string]: unknown;
1920
+ };
1921
+ content: {
1922
+ "application/json": {
1923
+ success: true;
1924
+ data: {
1925
+ next: string;
1926
+ };
1927
+ };
1928
+ };
1929
+ };
1930
+ 404: {
1931
+ headers: {
1932
+ [name: string]: unknown;
1933
+ };
1934
+ content: {
1935
+ "application/json": {
1936
+ success: false;
1937
+ message: string;
1938
+ code?: string;
1939
+ errors?: {
1940
+ path: string;
1941
+ message: string;
1942
+ }[];
1943
+ };
1944
+ };
1945
+ };
1946
+ };
1947
+ }, {
1948
+ params: {
1949
+ query: {
1950
+ companyRuc: string;
1951
+ tipoDoc: string;
1952
+ serie: string;
1953
+ };
1954
+ };
1955
+ }, `${string}/${string}`>>;
1956
+ /** XML firmado de una factura/boleta. */
1957
+ getInvoiceXml(id: string): Promise<ArrayBuffer>;
1958
+ /** CDR (constancia SUNAT) de una factura/boleta. */
1959
+ getInvoiceCdr(id: string): Promise<ArrayBuffer>;
1960
+ /** PDF de una factura/boleta. */
1961
+ getInvoicePdf(id: string): Promise<ArrayBuffer>;
1962
+ /** XML firmado de una nota (07/08). */
1963
+ getNoteXml(id: string): Promise<ArrayBuffer>;
1964
+ /** PDF de una nota (07/08). */
1965
+ getNotePdf(id: string): Promise<ArrayBuffer>;
1966
+ /** XML firmado de una guía de remisión (09/31). */
1967
+ getDespatchXml(id: string): Promise<ArrayBuffer>;
1968
+ /** PDF de una guía de remisión (09/31). `format`: a4 | ticket80 | ticket58. */
1969
+ getDespatchPdf(id: string, format?: NonNullable<paths["/api/v1/despatch/{id}/pdf"]["get"]["parameters"]["query"]>["format"]): Promise<ArrayBuffer>;
1970
+ /** Lista las empresas accesibles por la key. */
1971
+ listCompanies(): Promise<import("openapi-fetch").FetchResponse<{
1972
+ parameters: {
1973
+ query?: never;
1974
+ header?: never;
1975
+ path?: never;
1976
+ cookie?: never;
1977
+ };
1978
+ requestBody?: never;
1979
+ responses: {
1980
+ 200: {
1981
+ headers: {
1982
+ [name: string]: unknown;
1983
+ };
1984
+ content?: never;
1985
+ };
1986
+ };
1987
+ }, {}, `${string}/${string}`>>;
1988
+ /** Detalle de una empresa por ID. */
1989
+ getCompany(id: string): Promise<import("openapi-fetch").FetchResponse<{
1990
+ parameters: {
1991
+ query?: never;
1992
+ header?: never;
1993
+ path: {
1994
+ id: string;
1995
+ };
1996
+ cookie?: never;
1997
+ };
1998
+ requestBody?: never;
1999
+ responses: {
2000
+ 200: {
2001
+ headers: {
2002
+ [name: string]: unknown;
2003
+ };
2004
+ content?: never;
2005
+ };
2006
+ };
2007
+ }, {
2008
+ params: {
2009
+ path: {
2010
+ id: string;
2011
+ };
2012
+ };
2013
+ }, `${string}/${string}`>>;
2014
+ /** Logo de la empresa (imagen). */
2015
+ getCompanyLogo(id: string): Promise<ArrayBuffer>;
2016
+ /** Crea una suscripción a webhooks. El secret se devuelve UNA sola vez. */
2017
+ createWebhook(body: CreateWebhookInput): Promise<import("openapi-fetch").FetchResponse<{
2018
+ parameters: {
2019
+ query?: never;
2020
+ header?: never;
2021
+ path?: never;
2022
+ cookie?: never;
2023
+ };
2024
+ requestBody: {
2025
+ content: {
2026
+ "application/json": {
2027
+ empresaRuc: string;
2028
+ url: string;
2029
+ events: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
2030
+ description?: string;
2031
+ secret?: string;
2032
+ };
2033
+ };
2034
+ };
2035
+ responses: {
2036
+ 200: {
2037
+ headers: {
2038
+ [name: string]: unknown;
2039
+ };
2040
+ content?: never;
2041
+ };
2042
+ };
2043
+ }, {
2044
+ body: {
2045
+ empresaRuc: string;
2046
+ url: string;
2047
+ events: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
2048
+ description?: string;
2049
+ secret?: string;
2050
+ };
2051
+ }, `${string}/${string}`>>;
2052
+ /** Lista las suscripciones de webhooks. */
2053
+ listWebhooks(): Promise<import("openapi-fetch").FetchResponse<{
2054
+ parameters: {
2055
+ query?: {
2056
+ ruc?: string;
2057
+ };
2058
+ header?: never;
2059
+ path?: never;
2060
+ cookie?: never;
2061
+ };
2062
+ requestBody?: never;
2063
+ responses: {
2064
+ 200: {
2065
+ headers: {
2066
+ [name: string]: unknown;
2067
+ };
2068
+ content?: never;
2069
+ };
2070
+ };
2071
+ }, {}, `${string}/${string}`>>;
2072
+ /** Detalle de una suscripción de webhook. */
2073
+ getWebhook(id: string): Promise<import("openapi-fetch").FetchResponse<{
2074
+ parameters: {
2075
+ query?: never;
2076
+ header?: never;
2077
+ path: {
2078
+ id: string;
2079
+ };
2080
+ cookie?: never;
2081
+ };
2082
+ requestBody?: never;
2083
+ responses: {
2084
+ 200: {
2085
+ headers: {
2086
+ [name: string]: unknown;
2087
+ };
2088
+ content?: never;
2089
+ };
2090
+ };
2091
+ }, {
2092
+ params: {
2093
+ path: {
2094
+ id: string;
2095
+ };
2096
+ };
2097
+ }, `${string}/${string}`>>;
2098
+ /** Actualiza una suscripción de webhook (url, eventos, isActive). */
2099
+ updateWebhook(id: string, body: UpdateWebhookInput): Promise<import("openapi-fetch").FetchResponse<{
2100
+ parameters: {
2101
+ query?: never;
2102
+ header?: never;
2103
+ path: {
2104
+ id: string;
2105
+ };
2106
+ cookie?: never;
2107
+ };
2108
+ requestBody: {
2109
+ content: {
2110
+ "application/json": {
2111
+ url?: string;
2112
+ events?: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
2113
+ description?: string;
2114
+ isActive?: boolean;
2115
+ };
2116
+ };
2117
+ };
2118
+ responses: {
2119
+ 200: {
2120
+ headers: {
2121
+ [name: string]: unknown;
2122
+ };
2123
+ content?: never;
2124
+ };
2125
+ };
2126
+ }, {
2127
+ params: {
2128
+ path: {
2129
+ id: string;
2130
+ };
2131
+ };
2132
+ body: {
2133
+ url?: string;
2134
+ events?: ("document.accepted" | "document.rejected" | "document.queue_failed" | "document.retried" | "ticket.resolved")[];
2135
+ description?: string;
2136
+ isActive?: boolean;
2137
+ };
2138
+ }, `${string}/${string}`>>;
2139
+ /** Elimina una suscripción de webhook. */
2140
+ deleteWebhook(id: string): Promise<import("openapi-fetch").FetchResponse<{
2141
+ parameters: {
2142
+ query?: never;
2143
+ header?: never;
2144
+ path: {
2145
+ id: string;
2146
+ };
2147
+ cookie?: never;
2148
+ };
2149
+ requestBody?: never;
2150
+ responses: {
2151
+ 200: {
2152
+ headers: {
2153
+ [name: string]: unknown;
2154
+ };
2155
+ content?: never;
2156
+ };
2157
+ };
2158
+ }, {
2159
+ params: {
2160
+ path: {
2161
+ id: string;
2162
+ };
2163
+ };
2164
+ }, `${string}/${string}`>>;
2165
+ /** Lista los intentos de entrega de un webhook. */
2166
+ listWebhookDeliveries(id: string): Promise<import("openapi-fetch").FetchResponse<{
2167
+ parameters: {
2168
+ query?: {
751
2169
  limit?: number;
752
- } | undefined;
2170
+ success?: "true" | "false";
2171
+ };
2172
+ header?: never;
2173
+ path: {
2174
+ id: string;
2175
+ };
2176
+ cookie?: never;
2177
+ };
2178
+ requestBody?: never;
2179
+ responses: {
2180
+ 200: {
2181
+ headers: {
2182
+ [name: string]: unknown;
2183
+ };
2184
+ content?: never;
2185
+ };
2186
+ };
2187
+ }, {
2188
+ params: {
2189
+ path: {
2190
+ id: string;
2191
+ };
753
2192
  };
754
2193
  }, `${string}/${string}`>>;
755
- /** Detalle de un documento por ID. */
756
- getDocument(id: string): Promise<import("openapi-fetch").FetchResponse<{
2194
+ /** Reintenta manualmente una entrega de webhook. */
2195
+ redeliverWebhook(id: string, deliveryId: string): Promise<import("openapi-fetch").FetchResponse<{
757
2196
  parameters: {
758
2197
  query?: never;
759
2198
  header?: never;
760
2199
  path: {
761
2200
  id: string;
2201
+ deliveryId: string;
762
2202
  };
763
2203
  cookie?: never;
764
2204
  };
@@ -775,11 +2215,12 @@ export declare class FacturacionClient {
775
2215
  params: {
776
2216
  path: {
777
2217
  id: string;
2218
+ deliveryId: string;
778
2219
  };
779
2220
  };
780
2221
  }, `${string}/${string}`>>;
781
- /** Re-encola un documento fallido (COLA_FALLIDA). */
782
- retryDocument(id: string): Promise<import("openapi-fetch").FetchResponse<{
2222
+ /** Dispara un evento de prueba (webhook.test) para verificar conectividad. */
2223
+ testWebhook(id: string): Promise<import("openapi-fetch").FetchResponse<{
783
2224
  parameters: {
784
2225
  query?: never;
785
2226
  header?: never;
@@ -790,33 +2231,11 @@ export declare class FacturacionClient {
790
2231
  };
791
2232
  requestBody?: never;
792
2233
  responses: {
793
- 202: {
794
- headers: {
795
- [name: string]: unknown;
796
- };
797
- content: {
798
- "application/json": {
799
- success: boolean;
800
- message: string;
801
- jobId?: string;
802
- };
803
- };
804
- };
805
- 400: {
2234
+ 200: {
806
2235
  headers: {
807
2236
  [name: string]: unknown;
808
2237
  };
809
- content: {
810
- "application/json": {
811
- success: false;
812
- message: string;
813
- code?: string;
814
- errors?: {
815
- path: string;
816
- message: string;
817
- }[];
818
- };
819
- };
2238
+ content?: never;
820
2239
  };
821
2240
  };
822
2241
  }, {
@@ -826,186 +2245,69 @@ export declare class FacturacionClient {
826
2245
  };
827
2246
  };
828
2247
  }, `${string}/${string}`>>;
829
- /** Descarga el XML firmado. Retorna ArrayBuffer. */
830
- getInvoiceXml(id: string): Promise<ArrayBuffer>;
831
- /** Descarga el CDR (constancia SUNAT). */
832
- getInvoiceCdr(id: string): Promise<ArrayBuffer>;
833
- /** Descarga el PDF generado. */
834
- getInvoicePdf(id: string): Promise<ArrayBuffer>;
835
- sendSummary(body: paths["/api/v1/summary/send"]["post"]["requestBody"]["content"]["application/json"]): Promise<import("openapi-fetch").FetchResponse<{
2248
+ /** Rota el secret HMAC de un webhook. El nuevo secret se devuelve una sola vez. */
2249
+ rotateWebhookSecret(id: string): Promise<import("openapi-fetch").FetchResponse<{
836
2250
  parameters: {
837
2251
  query?: never;
838
2252
  header?: never;
839
- path?: never;
840
- cookie?: never;
841
- };
842
- requestBody: {
843
- content: {
844
- "application/json": {
845
- empresaRuc: string;
846
- correlativo: string;
847
- fechaEmision: string;
848
- fechaReferencia: string;
849
- items: {
850
- tipoDoc: string;
851
- serie: string;
852
- correlativo: string;
853
- clienteTipoDoc: string;
854
- clienteNumDoc: string;
855
- estadoItem: "1" | "2" | "3";
856
- tipoMoneda?: string;
857
- montoOperGravadas?: number;
858
- montoOperExoneradas?: number;
859
- montoOperInafectas?: number;
860
- montoOperGratuitas?: number;
861
- montoIgv?: number;
862
- montoIsc?: number;
863
- montoOtrosCargos?: number;
864
- montoTotal: number;
865
- }[];
866
- };
2253
+ path: {
2254
+ id: string;
867
2255
  };
2256
+ cookie?: never;
868
2257
  };
2258
+ requestBody?: never;
869
2259
  responses: {
870
- 202: {
871
- headers: {
872
- [name: string]: unknown;
873
- };
874
- content: {
875
- "application/json": {
876
- success: boolean;
877
- message: string;
878
- data?: {
879
- id?: string;
880
- estado?: string;
881
- ticket?: string;
882
- hash?: string | null;
883
- };
884
- };
885
- };
886
- };
887
- 400: {
2260
+ 200: {
888
2261
  headers: {
889
2262
  [name: string]: unknown;
890
2263
  };
891
- content: {
892
- "application/json": {
893
- success: false;
894
- message: string;
895
- code?: string;
896
- errors?: {
897
- path: string;
898
- message: string;
899
- }[];
900
- };
901
- };
2264
+ content?: never;
902
2265
  };
903
2266
  };
904
2267
  }, {
905
- body: {
906
- empresaRuc: string;
907
- correlativo: string;
908
- fechaEmision: string;
909
- fechaReferencia: string;
910
- items: {
911
- tipoDoc: string;
912
- serie: string;
913
- correlativo: string;
914
- clienteTipoDoc: string;
915
- clienteNumDoc: string;
916
- estadoItem: "1" | "2" | "3";
917
- tipoMoneda?: string;
918
- montoOperGravadas?: number;
919
- montoOperExoneradas?: number;
920
- montoOperInafectas?: number;
921
- montoOperGratuitas?: number;
922
- montoIgv?: number;
923
- montoIsc?: number;
924
- montoOtrosCargos?: number;
925
- montoTotal: number;
926
- }[];
2268
+ params: {
2269
+ path: {
2270
+ id: string;
2271
+ };
927
2272
  };
928
2273
  }, `${string}/${string}`>>;
929
- sendVoided(body: paths["/api/v1/voided/send"]["post"]["requestBody"]["content"]["application/json"]): Promise<import("openapi-fetch").FetchResponse<{
2274
+ /** Lista los catálogos SUNAT disponibles. */
2275
+ getCatalogs(): Promise<import("openapi-fetch").FetchResponse<{
930
2276
  parameters: {
931
2277
  query?: never;
932
2278
  header?: never;
933
2279
  path?: never;
934
2280
  cookie?: never;
935
2281
  };
936
- requestBody: {
937
- content: {
938
- "application/json": {
939
- empresaRuc: string;
940
- correlativo: string;
941
- fechaEmision: string;
942
- fechaReferencia: string;
943
- items: {
944
- tipoDoc: string;
945
- serie: string;
946
- correlativo: string;
947
- motivoBaja: string;
948
- }[];
949
- };
950
- };
951
- };
2282
+ requestBody?: never;
952
2283
  responses: {
953
- 202: {
2284
+ 200: {
954
2285
  headers: {
955
2286
  [name: string]: unknown;
956
2287
  };
957
2288
  content: {
958
2289
  "application/json": {
959
2290
  success: boolean;
960
- message: string;
961
- data?: {
962
- id?: string;
963
- estado?: string;
964
- ticket?: string;
965
- hash?: string | null;
966
- };
967
- };
968
- };
969
- };
970
- 400: {
971
- headers: {
972
- [name: string]: unknown;
973
- };
974
- content: {
975
- "application/json": {
976
- success: false;
977
- message: string;
978
- code?: string;
979
- errors?: {
980
- path: string;
981
- message: string;
2291
+ data: {
2292
+ key: string;
2293
+ name: string;
2294
+ items: {
2295
+ code: string;
2296
+ label: string;
2297
+ }[];
982
2298
  }[];
983
2299
  };
984
2300
  };
985
2301
  };
986
2302
  };
987
- }, {
988
- body: {
989
- empresaRuc: string;
990
- correlativo: string;
991
- fechaEmision: string;
992
- fechaReferencia: string;
993
- items: {
994
- tipoDoc: string;
995
- serie: string;
996
- correlativo: string;
997
- motivoBaja: string;
998
- }[];
999
- };
1000
- }, `${string}/${string}`>>;
1001
- getTicketStatus(ticket: string, ruc: string): Promise<import("openapi-fetch").FetchResponse<{
2303
+ }, {}, `${string}/${string}`>>;
2304
+ /** Obtiene un catálogo SUNAT por clave (ej: "07", "61"). */
2305
+ getCatalog(key: string): Promise<import("openapi-fetch").FetchResponse<{
1002
2306
  parameters: {
1003
- query: {
1004
- ruc: string;
1005
- };
2307
+ query?: never;
1006
2308
  header?: never;
1007
2309
  path: {
1008
- ticket: string;
2310
+ key: string;
1009
2311
  };
1010
2312
  cookie?: never;
1011
2313
  };
@@ -1015,72 +2317,30 @@ export declare class FacturacionClient {
1015
2317
  headers: {
1016
2318
  [name: string]: unknown;
1017
2319
  };
1018
- content: {
1019
- "application/json": {
1020
- success: boolean;
1021
- message: string;
1022
- statusCode: string;
1023
- cdrResponse?: {
1024
- id: string;
1025
- code: string;
1026
- description: string;
1027
- notes: string[];
1028
- };
1029
- };
1030
- };
1031
- };
1032
- 202: {
1033
- headers: {
1034
- [name: string]: unknown;
1035
- };
1036
- content: {
1037
- "application/json": {
1038
- success: boolean;
1039
- message: string;
1040
- statusCode: string;
1041
- cdrResponse?: {
1042
- id: string;
1043
- code: string;
1044
- description: string;
1045
- notes: string[];
1046
- };
1047
- };
1048
- };
2320
+ content?: never;
1049
2321
  };
1050
2322
  };
1051
2323
  }, {
1052
2324
  params: {
1053
2325
  path: {
1054
- ticket: string;
1055
- };
1056
- query: {
1057
- ruc: string;
2326
+ key: string;
1058
2327
  };
1059
2328
  };
1060
2329
  }, `${string}/${string}`>>;
1061
- listCompanies(): Promise<import("openapi-fetch").FetchResponse<{
2330
+ /** Consulta pública de un comprobante por RUC/tipo/serie/número (JSON). */
2331
+ consultarComprobante(ruc: string, tipoDoc: string, serie: string, numero: string): Promise<import("openapi-fetch").FetchResponse<{
1062
2332
  parameters: {
1063
- query?: never;
1064
- header?: never;
1065
- path?: never;
1066
- cookie?: never;
1067
- };
1068
- requestBody?: never;
1069
- responses: {
1070
- 200: {
1071
- headers: {
1072
- [name: string]: unknown;
1073
- };
1074
- content?: never;
2333
+ query?: {
2334
+ total?: number;
2335
+ fecha?: string;
2336
+ receptor?: string;
1075
2337
  };
1076
- };
1077
- }, {}, `${string}/${string}`>>;
1078
- getCompany(id: string): Promise<import("openapi-fetch").FetchResponse<{
1079
- parameters: {
1080
- query?: never;
1081
2338
  header?: never;
1082
2339
  path: {
1083
- id: string;
2340
+ ruc: string;
2341
+ tipoDoc: string;
2342
+ serie: string;
2343
+ numero: string;
1084
2344
  };
1085
2345
  cookie?: never;
1086
2346
  };
@@ -1096,14 +2356,23 @@ export declare class FacturacionClient {
1096
2356
  }, {
1097
2357
  params: {
1098
2358
  path: {
1099
- id: string;
2359
+ ruc: string;
2360
+ tipoDoc: string;
2361
+ serie: string;
2362
+ numero: string;
1100
2363
  };
1101
2364
  };
1102
2365
  }, `${string}/${string}`>>;
2366
+ /** PDF público de un comprobante. */
2367
+ consultarComprobantePdf(ruc: string, tipoDoc: string, serie: string, numero: string): Promise<ArrayBuffer>;
2368
+ /** XML público de un comprobante. */
2369
+ consultarComprobanteXml(ruc: string, tipoDoc: string, serie: string, numero: string): Promise<ArrayBuffer>;
1103
2370
  /** Estado de las colas BullMQ (jobs en cada estado). */
1104
2371
  getQueueStats(): Promise<QueueStats>;
2372
+ /** Descarga binaria genérica para endpoints de archivo `{id}`. */
2373
+ private fetchBinary;
1105
2374
  /**
1106
- * Espera a que un documento llegue a estado final (ACEPTADO/RECHAZADO/COLA_FALLIDA).
2375
+ * Espera a que un documento llegue a estado final (ACEPTADO/RECHAZADO/COLA_FALLIDA/ANULADO).
1107
2376
  * Hace polling cada `intervalMs`. Timeout en `timeoutMs`.
1108
2377
  */
1109
2378
  waitForDocument(id: string, options?: {