Package Information
Documentation
n8n-nodes-apisunat
Nodo de n8n para API SUNAT, la API de facturación electrónica para Perú. Emite facturas, boletas, notas de crédito y débito, retenciones, guías de remisión y anulaciones en SUNAT desde tus flujos de n8n, y recibe la respuesta de SUNAT por webhook.
API SUNAT arma el XML UBL 2.1, lo firma con tu certificado, lo envía a SUNAT y te devuelve el CDR y el PDF. Tú solo envías los datos de la venta en JSON.
Instalación
En n8n, ve a Settings → Community Nodes → Install y escribe n8n-nodes-apisunat.
En una instalación propia también puedes instalarlo con npm en la carpeta de nodos de n8n (~/.n8n/nodes):
npm install n8n-nodes-apisunat
Credenciales
- API SUNAT API: tu clave de API del panel de API SUNAT. Las claves
asu_test_emiten en SUNAT beta sin consumir tu plan; lasasu_live_emiten comprobantes reales. Ver autenticación. - API SUNAT Webhook: el secreto
whsec_del webhook que creas en el panel, para el nodo API SUNAT Trigger.
Nodo API SUNAT
| Recurso | Operaciones |
|---|---|
| Document | Issue (factura, boleta, nota o retención), Get, Get Many, Download File (PDF, XML, ZIP o CDR), Resend, Query SUNAT, Send Email |
| Void | Create (comunicación de baja o resumen diario), Get |
| Guide | Issue (guía de remisión remitente), Get |
| Calculation | Calculate (totales e IGV sin emitir) |
| Account | Get (plan y consumo del mes) |
| Issuer | Get, Get Many (RUC registrados) |
| Catalog | Get (catálogos de SUNAT), Search Products (catálogo 25) |
Las operaciones que emiten (Issue y Void Create) piden un Idempotency Key. Usa un valor estable de tu sistema, por ejemplo {{ "venta-" + $json.id }}: si el flujo se repite, la API devuelve el mismo comprobante y nunca emite dos veces. Ver idempotencia.
El cuerpo de Issue es el mismo JSON de POST /documents. Por ejemplo, una factura:
{
"documentType": "01",
"currency": "PEN",
"issueDate": "2026-10-27",
"customer": { "documentType": "6", "documentNumber": "20100066603" },
"items": [{ "description": "Consultoría octubre", "quantity": 1, "unitPrice": 1180 }]
}
Todos los campos están en la documentación de documentos y hay ejemplos de factura, boleta y guía de remisión.
Download File deja el archivo en un campo binario (data por defecto), listo para enviarlo por correo, guardarlo en Drive o adjuntarlo a WhatsApp.
Nodo API SUNAT Trigger
Inicia el flujo cuando SUNAT acepta, observa, rechaza o anula un documento.
- Agrega API SUNAT Trigger a tu flujo y copia su URL de producción.
- En el panel de API SUNAT, crea un webhook con esa URL en el mismo modo (Prueba o Producción) que tu clave, y elige sus eventos.
- Copia el secreto
whsec_en la credencial API SUNAT Webhook.
El nodo verifica la firma X-Apisunat-Signature (HMAC-SHA256 del cuerpo crudo) y rechaza con 401 los eventos sin firma válida o con más de 5 minutos de antigüedad. Los eventos que no elegiste se responden 200 y se ignoran. Con Only Live Mode también ignora los eventos de prueba. Ver webhooks.
Ejemplos de flujos
- Venta pagada en tu tienda → API SUNAT · Issue → Download File (PDF) → enviar al cliente por correo o WhatsApp.
- API SUNAT Trigger (document.rejected) → avisar a tu equipo por Slack con
sunat.errorCodeysunat.errorMessage. Cada código tiene su explicación en errores de SUNAT. - Cierre de mes → Document · Get Many con filtro de fechas → hoja de cálculo para tu contador.
Enlaces
API SUNAT es un servicio de RANGEL TECHNOLOGIES E.I.R.L. (RUC 20614483459). No es la API oficial de SUNAT: se conecta a sus servicios por ti.

