intifact 1.3.2 → 1.3.3
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/README.md +236 -227
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,227 +1,236 @@
|
|
|
1
|
-
# intifact
|
|
2
|
-
|
|
3
|
-
[](https://www.npmjs.com/package/intifact)
|
|
4
|
-
[](https://www.npmjs.com/package/intifact)
|
|
5
|
-
|
|
6
|
-
SDK oficial de TypeScript para emitir comprobantes electrónicos ante **SUNAT
|
|
7
|
-
(Perú)**: facturas, boletas, notas de crédito y débito, guías de remisión,
|
|
8
|
-
resúmenes diarios y comunicaciones de baja.
|
|
9
|
-
|
|
10
|
-
Tú mandas JSON. La API arma el XML UBL 2.1, lo firma con tu certificado, lo
|
|
11
|
-
envía a SUNAT, procesa el CDR y te devuelve el PDF con su QR. No necesitas saber
|
|
12
|
-
nada de UBL, XMLDSig ni SOAP.
|
|
13
|
-
|
|
14
|
-
Los tipos se generan del OpenAPI de la API, así que el editor te avisa del campo
|
|
15
|
-
que falta o del que escribiste mal **antes** de ejecutar nada.
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
npm install intifact
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Requiere Node 18+ (usa `fetch` nativo). Funciona igual en Bun y Deno.
|
|
22
|
-
|
|
23
|
-
## Empieza en pruebas
|
|
24
|
-
|
|
25
|
-
El ambiente **lo decide la key**, no un parámetro. Las creas tú desde el
|
|
26
|
-
[panel de Intifact](https://intifact.com).
|
|
27
|
-
|
|
28
|
-
| Prefijo | Destino | Validez fiscal | Consume tu plan | Certificado |
|
|
29
|
-
|---|---|---|---|---|
|
|
30
|
-
| `fact_test_` | SUNAT beta | Ninguna | No | Uno de prueba compartido |
|
|
31
|
-
| `fact_live_` | SUNAT producción | Real | Sí | El tuyo |
|
|
32
|
-
|
|
33
|
-
Integra entero con `fact_test_`. Cuando funcione, cambias la key por la de
|
|
34
|
-
producción — el código no cambia ni una línea.
|
|
35
|
-
|
|
36
|
-
> [!WARNING]
|
|
37
|
-
> Una key `fact_live_` emite comprobantes fiscales reales desde la primera
|
|
38
|
-
> request. Un error ahí no se borra: se anula con nota de crédito o
|
|
39
|
-
> comunicación de baja.
|
|
40
|
-
|
|
41
|
-
## Tu primera factura
|
|
42
|
-
|
|
43
|
-
```ts
|
|
44
|
-
import { FacturacionClient } from "intifact";
|
|
45
|
-
|
|
46
|
-
const fact = new FacturacionClient({
|
|
47
|
-
baseUrl: "https://api-facturacion.intifact.com",
|
|
48
|
-
apiKey: process.env.INTIFACT_API_KEY, // fact_test_...
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
const { data, error } = await fact.sendInvoice({
|
|
52
|
-
empresaRuc: "20553510661",
|
|
53
|
-
tipoDoc: "01", // 01 factura · 03 boleta
|
|
54
|
-
serie: "F001",
|
|
55
|
-
correlativo: "1",
|
|
56
|
-
fechaEmision: "2026-01-15",
|
|
57
|
-
tipoMoneda: "PEN",
|
|
58
|
-
tipoOperacion: "0101", // venta interna
|
|
59
|
-
|
|
60
|
-
clienteTipoDoc: "6", // 6 RUC · 1 DNI
|
|
61
|
-
clienteNumDoc: "20000000001",
|
|
62
|
-
clienteRazonSocial: "EMPRESA CLIENTE SAC",
|
|
63
|
-
|
|
64
|
-
detalle: [{
|
|
65
|
-
unidad: "NIU",
|
|
66
|
-
cantidad: 2,
|
|
67
|
-
codProducto: "PROD001",
|
|
68
|
-
descripcion: "Producto de ejemplo",
|
|
69
|
-
montoValorUnitario: 100.0,
|
|
70
|
-
montoBaseIgv: 200.0,
|
|
71
|
-
porcentajeIgv: 18,
|
|
72
|
-
igv: 36.0,
|
|
73
|
-
tipAfeIgv: "10", // gravado, operación onerosa
|
|
74
|
-
totalImpuestos: 36.0,
|
|
75
|
-
montoPrecioUnitario: 118.0,
|
|
76
|
-
montoValorVenta: 200.0,
|
|
77
|
-
}],
|
|
78
|
-
|
|
79
|
-
montoIgv: 36.0,
|
|
80
|
-
totalImpuestos: 36.0,
|
|
81
|
-
valorVenta: 200.0,
|
|
82
|
-
subTotal: 236.0,
|
|
83
|
-
montoImpVenta: 236.0,
|
|
84
|
-
leyendas: [{ legendCode: "1000", legendValue: "DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES" }],
|
|
85
|
-
formaPago: [{ tipo: "Contado", monto: 236.0, fechaPago: "2026-01-15" }],
|
|
86
|
-
});
|
|
87
|
-
|
|
88
|
-
if (error) throw new Error(error.message);
|
|
89
|
-
console.log(data.data.id, data.data.estado); // → "550e8400-…" "ENCOLADO"
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
¿No quieres calcular los importes tú? `computeInvoice()` te los devuelve a
|
|
93
|
-
partir de cantidades y precios, sin emitir nada.
|
|
94
|
-
|
|
95
|
-
## Errores
|
|
96
|
-
|
|
97
|
-
Ningún método lanza excepciones por respuestas de la API: devuelven
|
|
98
|
-
`{ data, error }`, igual que `openapi-fetch`. Un `throw` solo aparece si se cae
|
|
99
|
-
la red.
|
|
100
|
-
|
|
101
|
-
```ts
|
|
102
|
-
const { data, error } = await fact.sendInvoice(payload);
|
|
103
|
-
|
|
104
|
-
if (error) {
|
|
105
|
-
console.error(error.message); // "Error de validación"
|
|
106
|
-
console.error(error.errors); // [{ path: "detalle.0.igv", message: "..." }]
|
|
107
|
-
return;
|
|
108
|
-
}
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
Los errores de schema llegan **al instante**, con el campo exacto. Los rechazos
|
|
112
|
-
de SUNAT llegan después, en el estado del documento.
|
|
113
|
-
|
|
114
|
-
## El resultado de SUNAT llega después
|
|
115
|
-
|
|
116
|
-
Ningún `send*` devuelve el CDR. La API responde **202** con
|
|
117
|
-
`{ id, estado: "ENCOLADO", hash }` y encola el documento: si SUNAT está caída,
|
|
118
|
-
reintenta sola con backoff en vez de fallarte la venta.
|
|
119
|
-
|
|
120
|
-
Tienes dos formas de enterarte del desenlace:
|
|
121
|
-
|
|
122
|
-
```ts
|
|
123
|
-
// 1. Webhook (recomendado en producción)
|
|
124
|
-
await fact.createWebhook({
|
|
125
|
-
url: "https://miapp.com/hooks/sunat",
|
|
126
|
-
events: ["document.accepted", "document.rejected"],
|
|
127
|
-
});
|
|
128
|
-
|
|
129
|
-
// 2. Polling (cómodo en desarrollo)
|
|
130
|
-
const doc = await fact.waitForDocument(data.data.id, { timeoutMs: 120_000 });
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
`waitForDocument` consulta cada 2s hasta un estado final —`ACEPTADO`,
|
|
134
|
-
`RECHAZADO`, `COLA_FALLIDA` o `ANULADO`— o hasta que expire el timeout.
|
|
135
|
-
|
|
136
|
-
### Reintentar es seguro
|
|
137
|
-
|
|
138
|
-
La API es idempotente por `empresa + tipoDoc + serie + correlativo`. Si se te
|
|
139
|
-
cae la conexión y no sabes si llegó, **repite el mismo POST con el mismo
|
|
140
|
-
correlativo**: te devuelve el mismo `id` y el mismo `hash`, sin reenviar nada a
|
|
141
|
-
SUNAT.
|
|
142
|
-
|
|
143
|
-
Lo único que rompe esa garantía es pedir un correlativo nuevo en el reintento.
|
|
144
|
-
Llama a `getNextCorrelativo()` **una vez**, guárdalo junto con la venta, y
|
|
145
|
-
reutiliza ese.
|
|
146
|
-
|
|
147
|
-
## Descargar los archivos
|
|
148
|
-
|
|
149
|
-
```ts
|
|
150
|
-
const pdf = await fact.getInvoicePdf(id); // ArrayBuffer
|
|
151
|
-
const xml = await fact.getInvoiceXml(id); // XML firmado
|
|
152
|
-
const cdr = await fact.getInvoiceCdr(id); // CDR de SUNAT (zip)
|
|
153
|
-
|
|
154
|
-
await fact.getDespatchPdf(id, "ticket80"); // "a4" | "ticket80" | "ticket58"
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
## Un webhook para todos tus RUC
|
|
158
|
-
|
|
159
|
-
Si facturas para terceros, no registres uno por empresa. Omitiendo `empresaRuc`
|
|
160
|
-
el webhook cubre **toda tu cuenta**, con un solo secret, e incluye los RUC que
|
|
161
|
-
des de alta después:
|
|
162
|
-
|
|
163
|
-
```ts
|
|
164
|
-
const { data } = await fact.createWebhook({
|
|
165
|
-
url: "https://miapp.com/hooks/sunat",
|
|
166
|
-
events: ["document.accepted", "document.rejected"],
|
|
167
|
-
});
|
|
168
|
-
// data.data.secret — se muestra UNA sola vez
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
Cada payload trae `data.empresaRuc`, así que ruteas por ahí y verificas la firma
|
|
172
|
-
HMAC siempre con la misma clave. Pasa `empresaRuc` solo si quieres que los
|
|
173
|
-
eventos de una empresa puntual vayan a otra URL.
|
|
174
|
-
|
|
175
|
-
## Establecimientos (anexos)
|
|
176
|
-
|
|
177
|
-
Emitir sin `establecimientoCodigo` usa el matriz `"0000"`, así que esto solo
|
|
178
|
-
hace falta si facturas desde más de un punto de venta — la dirección del
|
|
179
|
-
establecimiento es la que sale impresa en el comprobante.
|
|
180
|
-
|
|
181
|
-
```ts
|
|
182
|
-
await fact.createBranch(companyId, {
|
|
183
|
-
codigo: "0001", // el que te asignó SUNAT en SOL
|
|
184
|
-
nombre: "Sucursal Miraflores",
|
|
185
|
-
direccion: "Av. Larco 1234",
|
|
186
|
-
ubigeo: "150122",
|
|
187
|
-
});
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
El `codigo` tiene que coincidir con el del portal SOL (Mis Trámites >
|
|
191
|
-
Establecimientos Anexos): si no calza, el comprobante sale con un punto de
|
|
192
|
-
emisión que SUNAT no reconoce. El matriz `"0000"` no se puede desactivar.
|
|
193
|
-
|
|
194
|
-
## Qué cubre
|
|
195
|
-
|
|
196
|
-
| Área | Métodos |
|
|
197
|
-
|---|---|
|
|
198
|
-
| Comprobantes | `sendInvoice`, `computeInvoice`, `sendNote`, `computeNote` |
|
|
199
|
-
| Guías | `sendDespatch`, `sendDespatchMulti`, `sendDespatchTransportista` |
|
|
200
|
-
| Anulaciones | `cancelInvoice`, `cancelBoleta`, `sendVoided`, `sendSummary` |
|
|
201
|
-
| Documentos | `listDocuments`, `getDocument`, `retryDocument`, `getNextCorrelativo`, `waitForDocument` |
|
|
202
|
-
| Archivos | `getInvoiceXml/Cdr/Pdf`, `getNoteXml/Pdf/Cdr`, `getDespatchXml/Cdr/Pdf` |
|
|
203
|
-
| CDR | `consultarCdr` |
|
|
204
|
-
| Empresas | `listCompanies`, `getCompany`, `createCompany`, `updateCompany`, `getCompanyLogo` |
|
|
205
|
-
| Establecimientos | `listBranches`, `createBranch`, `updateBranch`, `deleteBranch` |
|
|
206
|
-
| Webhooks | `createWebhook`, `listWebhooks`, `getWebhook`, `updateWebhook`, `deleteWebhook`, `listWebhookDeliveries`, `redeliverWebhook`, `testWebhook`, `rotateWebhookSecret` |
|
|
207
|
-
| Catálogos | `getCatalogs`, `getCatalog` |
|
|
208
|
-
| Consulta pública | `consultarComprobante`, `consultarComprobantePdf`, `consultarComprobanteXml` |
|
|
209
|
-
| Colas | `getQueueStats` |
|
|
210
|
-
| Tickets | `getTicketStatus` |
|
|
211
|
-
|
|
212
|
-
Las operaciones administrativas (subir certificado y logo, gestionar API keys,
|
|
213
|
-
tenants, auditoría, planes, reconciliación con SUNAT) requieren la master key y
|
|
214
|
-
**no** se exponen aquí.
|
|
215
|
-
|
|
216
|
-
Reclamar un RUC que otra cuenta registró (`POST /companies/claim`) sí acepta tu
|
|
217
|
-
key, pero se hace desde el portal: recibe tu `.p12` con su contraseña, y eso no
|
|
218
|
-
debería vivir en el código de tu app.
|
|
219
|
-
|
|
220
|
-
## Documentación
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
1
|
+
# intifact
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/intifact)
|
|
4
|
+
[](https://www.npmjs.com/package/intifact)
|
|
5
|
+
|
|
6
|
+
SDK oficial de TypeScript para emitir comprobantes electrónicos ante **SUNAT
|
|
7
|
+
(Perú)**: facturas, boletas, notas de crédito y débito, guías de remisión,
|
|
8
|
+
resúmenes diarios y comunicaciones de baja.
|
|
9
|
+
|
|
10
|
+
Tú mandas JSON. La API arma el XML UBL 2.1, lo firma con tu certificado, lo
|
|
11
|
+
envía a SUNAT, procesa el CDR y te devuelve el PDF con su QR. No necesitas saber
|
|
12
|
+
nada de UBL, XMLDSig ni SOAP.
|
|
13
|
+
|
|
14
|
+
Los tipos se generan del OpenAPI de la API, así que el editor te avisa del campo
|
|
15
|
+
que falta o del que escribiste mal **antes** de ejecutar nada.
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npm install intifact
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Requiere Node 18+ (usa `fetch` nativo). Funciona igual en Bun y Deno.
|
|
22
|
+
|
|
23
|
+
## Empieza en pruebas
|
|
24
|
+
|
|
25
|
+
El ambiente **lo decide la key**, no un parámetro. Las creas tú desde el
|
|
26
|
+
[panel de Intifact](https://intifact.com).
|
|
27
|
+
|
|
28
|
+
| Prefijo | Destino | Validez fiscal | Consume tu plan | Certificado |
|
|
29
|
+
|---|---|---|---|---|
|
|
30
|
+
| `fact_test_` | SUNAT beta | Ninguna | No | Uno de prueba compartido |
|
|
31
|
+
| `fact_live_` | SUNAT producción | Real | Sí | El tuyo |
|
|
32
|
+
|
|
33
|
+
Integra entero con `fact_test_`. Cuando funcione, cambias la key por la de
|
|
34
|
+
producción — el código no cambia ni una línea.
|
|
35
|
+
|
|
36
|
+
> [!WARNING]
|
|
37
|
+
> Una key `fact_live_` emite comprobantes fiscales reales desde la primera
|
|
38
|
+
> request. Un error ahí no se borra: se anula con nota de crédito o
|
|
39
|
+
> comunicación de baja.
|
|
40
|
+
|
|
41
|
+
## Tu primera factura
|
|
42
|
+
|
|
43
|
+
```ts
|
|
44
|
+
import { FacturacionClient } from "intifact";
|
|
45
|
+
|
|
46
|
+
const fact = new FacturacionClient({
|
|
47
|
+
baseUrl: "https://api-facturacion.intifact.com",
|
|
48
|
+
apiKey: process.env.INTIFACT_API_KEY, // fact_test_...
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
const { data, error } = await fact.sendInvoice({
|
|
52
|
+
empresaRuc: "20553510661",
|
|
53
|
+
tipoDoc: "01", // 01 factura · 03 boleta
|
|
54
|
+
serie: "F001",
|
|
55
|
+
correlativo: "1",
|
|
56
|
+
fechaEmision: "2026-01-15",
|
|
57
|
+
tipoMoneda: "PEN",
|
|
58
|
+
tipoOperacion: "0101", // venta interna
|
|
59
|
+
|
|
60
|
+
clienteTipoDoc: "6", // 6 RUC · 1 DNI
|
|
61
|
+
clienteNumDoc: "20000000001",
|
|
62
|
+
clienteRazonSocial: "EMPRESA CLIENTE SAC",
|
|
63
|
+
|
|
64
|
+
detalle: [{
|
|
65
|
+
unidad: "NIU",
|
|
66
|
+
cantidad: 2,
|
|
67
|
+
codProducto: "PROD001",
|
|
68
|
+
descripcion: "Producto de ejemplo",
|
|
69
|
+
montoValorUnitario: 100.0,
|
|
70
|
+
montoBaseIgv: 200.0,
|
|
71
|
+
porcentajeIgv: 18,
|
|
72
|
+
igv: 36.0,
|
|
73
|
+
tipAfeIgv: "10", // gravado, operación onerosa
|
|
74
|
+
totalImpuestos: 36.0,
|
|
75
|
+
montoPrecioUnitario: 118.0,
|
|
76
|
+
montoValorVenta: 200.0,
|
|
77
|
+
}],
|
|
78
|
+
|
|
79
|
+
montoIgv: 36.0,
|
|
80
|
+
totalImpuestos: 36.0,
|
|
81
|
+
valorVenta: 200.0,
|
|
82
|
+
subTotal: 236.0,
|
|
83
|
+
montoImpVenta: 236.0,
|
|
84
|
+
leyendas: [{ legendCode: "1000", legendValue: "DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES" }],
|
|
85
|
+
formaPago: [{ tipo: "Contado", monto: 236.0, fechaPago: "2026-01-15" }],
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
if (error) throw new Error(error.message);
|
|
89
|
+
console.log(data.data.id, data.data.estado); // → "550e8400-…" "ENCOLADO"
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
¿No quieres calcular los importes tú? `computeInvoice()` te los devuelve a
|
|
93
|
+
partir de cantidades y precios, sin emitir nada.
|
|
94
|
+
|
|
95
|
+
## Errores
|
|
96
|
+
|
|
97
|
+
Ningún método lanza excepciones por respuestas de la API: devuelven
|
|
98
|
+
`{ data, error }`, igual que `openapi-fetch`. Un `throw` solo aparece si se cae
|
|
99
|
+
la red.
|
|
100
|
+
|
|
101
|
+
```ts
|
|
102
|
+
const { data, error } = await fact.sendInvoice(payload);
|
|
103
|
+
|
|
104
|
+
if (error) {
|
|
105
|
+
console.error(error.message); // "Error de validación"
|
|
106
|
+
console.error(error.errors); // [{ path: "detalle.0.igv", message: "..." }]
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Los errores de schema llegan **al instante**, con el campo exacto. Los rechazos
|
|
112
|
+
de SUNAT llegan después, en el estado del documento.
|
|
113
|
+
|
|
114
|
+
## El resultado de SUNAT llega después
|
|
115
|
+
|
|
116
|
+
Ningún `send*` devuelve el CDR. La API responde **202** con
|
|
117
|
+
`{ id, estado: "ENCOLADO", hash }` y encola el documento: si SUNAT está caída,
|
|
118
|
+
reintenta sola con backoff en vez de fallarte la venta.
|
|
119
|
+
|
|
120
|
+
Tienes dos formas de enterarte del desenlace:
|
|
121
|
+
|
|
122
|
+
```ts
|
|
123
|
+
// 1. Webhook (recomendado en producción)
|
|
124
|
+
await fact.createWebhook({
|
|
125
|
+
url: "https://miapp.com/hooks/sunat",
|
|
126
|
+
events: ["document.accepted", "document.rejected"],
|
|
127
|
+
});
|
|
128
|
+
|
|
129
|
+
// 2. Polling (cómodo en desarrollo)
|
|
130
|
+
const doc = await fact.waitForDocument(data.data.id, { timeoutMs: 120_000 });
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
`waitForDocument` consulta cada 2s hasta un estado final —`ACEPTADO`,
|
|
134
|
+
`RECHAZADO`, `COLA_FALLIDA` o `ANULADO`— o hasta que expire el timeout.
|
|
135
|
+
|
|
136
|
+
### Reintentar es seguro
|
|
137
|
+
|
|
138
|
+
La API es idempotente por `empresa + tipoDoc + serie + correlativo`. Si se te
|
|
139
|
+
cae la conexión y no sabes si llegó, **repite el mismo POST con el mismo
|
|
140
|
+
correlativo**: te devuelve el mismo `id` y el mismo `hash`, sin reenviar nada a
|
|
141
|
+
SUNAT.
|
|
142
|
+
|
|
143
|
+
Lo único que rompe esa garantía es pedir un correlativo nuevo en el reintento.
|
|
144
|
+
Llama a `getNextCorrelativo()` **una vez**, guárdalo junto con la venta, y
|
|
145
|
+
reutiliza ese.
|
|
146
|
+
|
|
147
|
+
## Descargar los archivos
|
|
148
|
+
|
|
149
|
+
```ts
|
|
150
|
+
const pdf = await fact.getInvoicePdf(id); // ArrayBuffer
|
|
151
|
+
const xml = await fact.getInvoiceXml(id); // XML firmado
|
|
152
|
+
const cdr = await fact.getInvoiceCdr(id); // CDR de SUNAT (zip)
|
|
153
|
+
|
|
154
|
+
await fact.getDespatchPdf(id, "ticket80"); // "a4" | "ticket80" | "ticket58"
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## Un webhook para todos tus RUC
|
|
158
|
+
|
|
159
|
+
Si facturas para terceros, no registres uno por empresa. Omitiendo `empresaRuc`
|
|
160
|
+
el webhook cubre **toda tu cuenta**, con un solo secret, e incluye los RUC que
|
|
161
|
+
des de alta después:
|
|
162
|
+
|
|
163
|
+
```ts
|
|
164
|
+
const { data } = await fact.createWebhook({
|
|
165
|
+
url: "https://miapp.com/hooks/sunat",
|
|
166
|
+
events: ["document.accepted", "document.rejected"],
|
|
167
|
+
});
|
|
168
|
+
// data.data.secret — se muestra UNA sola vez
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Cada payload trae `data.empresaRuc`, así que ruteas por ahí y verificas la firma
|
|
172
|
+
HMAC siempre con la misma clave. Pasa `empresaRuc` solo si quieres que los
|
|
173
|
+
eventos de una empresa puntual vayan a otra URL.
|
|
174
|
+
|
|
175
|
+
## Establecimientos (anexos)
|
|
176
|
+
|
|
177
|
+
Emitir sin `establecimientoCodigo` usa el matriz `"0000"`, así que esto solo
|
|
178
|
+
hace falta si facturas desde más de un punto de venta — la dirección del
|
|
179
|
+
establecimiento es la que sale impresa en el comprobante.
|
|
180
|
+
|
|
181
|
+
```ts
|
|
182
|
+
await fact.createBranch(companyId, {
|
|
183
|
+
codigo: "0001", // el que te asignó SUNAT en SOL
|
|
184
|
+
nombre: "Sucursal Miraflores",
|
|
185
|
+
direccion: "Av. Larco 1234",
|
|
186
|
+
ubigeo: "150122",
|
|
187
|
+
});
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
El `codigo` tiene que coincidir con el del portal SOL (Mis Trámites >
|
|
191
|
+
Establecimientos Anexos): si no calza, el comprobante sale con un punto de
|
|
192
|
+
emisión que SUNAT no reconoce. El matriz `"0000"` no se puede desactivar.
|
|
193
|
+
|
|
194
|
+
## Qué cubre
|
|
195
|
+
|
|
196
|
+
| Área | Métodos |
|
|
197
|
+
|---|---|
|
|
198
|
+
| Comprobantes | `sendInvoice`, `computeInvoice`, `sendNote`, `computeNote` |
|
|
199
|
+
| Guías | `sendDespatch`, `sendDespatchMulti`, `sendDespatchTransportista` |
|
|
200
|
+
| Anulaciones | `cancelInvoice`, `cancelBoleta`, `sendVoided`, `sendSummary` |
|
|
201
|
+
| Documentos | `listDocuments`, `getDocument`, `retryDocument`, `getNextCorrelativo`, `waitForDocument` |
|
|
202
|
+
| Archivos | `getInvoiceXml/Cdr/Pdf`, `getNoteXml/Pdf/Cdr`, `getDespatchXml/Cdr/Pdf` |
|
|
203
|
+
| CDR | `consultarCdr` |
|
|
204
|
+
| Empresas | `listCompanies`, `getCompany`, `createCompany`, `updateCompany`, `getCompanyLogo` |
|
|
205
|
+
| Establecimientos | `listBranches`, `createBranch`, `updateBranch`, `deleteBranch` |
|
|
206
|
+
| Webhooks | `createWebhook`, `listWebhooks`, `getWebhook`, `updateWebhook`, `deleteWebhook`, `listWebhookDeliveries`, `redeliverWebhook`, `testWebhook`, `rotateWebhookSecret` |
|
|
207
|
+
| Catálogos | `getCatalogs`, `getCatalog` |
|
|
208
|
+
| Consulta pública | `consultarComprobante`, `consultarComprobantePdf`, `consultarComprobanteXml` |
|
|
209
|
+
| Colas | `getQueueStats` |
|
|
210
|
+
| Tickets | `getTicketStatus` |
|
|
211
|
+
|
|
212
|
+
Las operaciones administrativas (subir certificado y logo, gestionar API keys,
|
|
213
|
+
tenants, auditoría, planes, reconciliación con SUNAT) requieren la master key y
|
|
214
|
+
**no** se exponen aquí.
|
|
215
|
+
|
|
216
|
+
Reclamar un RUC que otra cuenta registró (`POST /companies/claim`) sí acepta tu
|
|
217
|
+
key, pero se hace desde el portal: recibe tu `.p12` con su contraseña, y eso no
|
|
218
|
+
debería vivir en el código de tu app.
|
|
219
|
+
|
|
220
|
+
## Documentación
|
|
221
|
+
|
|
222
|
+
Documentación completa en **[docs.intifact.com](https://docs.intifact.com/docs)**.
|
|
223
|
+
|
|
224
|
+
| | |
|
|
225
|
+
|---|---|
|
|
226
|
+
| [Quickstart](https://docs.intifact.com/docs/facturacion/quickstart) | Tu primera factura, con ejemplos en Node, PHP, Python, C# y cURL |
|
|
227
|
+
| [Autenticación](https://docs.intifact.com/docs/facturacion/authentication) | Ambientes `test`/`live`, alcance de las keys y rate limit |
|
|
228
|
+
| [Idempotencia](https://docs.intifact.com/docs/facturacion/documents#idempotencia) | Qué devuelve un reintento y cómo no duplicar comprobantes |
|
|
229
|
+
| [Webhooks](https://docs.intifact.com/docs/facturacion/webhooks) | Eventos, firma HMAC y verificación en 4 lenguajes |
|
|
230
|
+
| [Guías de remisión](https://docs.intifact.com/docs/facturacion/despatch) | Tipos 09 y 31, reparto a varios destinos |
|
|
231
|
+
| [Códigos de error](https://docs.intifact.com/docs/facturacion/error-codes) | HTTP, respuestas de SUNAT y cuáles se reintentan solos |
|
|
232
|
+
| [Catálogos SUNAT](https://docs.intifact.com/docs/facturacion/catalogs) | Tipos de documento, afectación IGV, unidades de medida |
|
|
233
|
+
|
|
234
|
+
## Licencia
|
|
235
|
+
|
|
236
|
+
MIT
|