n8n
Emite comprobantes y recibe los webhooks de API SUNAT en n8n con el nodo n8n-nodes-apisunat.
El nodo comunitario n8n-nodes-apisunat agrega dos nodos a n8n:
- API SUNAT: emite y consulta comprobantes, descarga el PDF, XML, ZIP o CDR, reenvía, envía por correo, anula, emite guías, calcula totales y consulta la cuenta, los RUC y los catálogos.
- API SUNAT Trigger: inicia el flujo cuando SUNAT acepta, observa, rechaza o anula un documento.
Instalación
En n8n ve a Settings › Community Nodes › Install y escribe n8n-nodes-apisunat. En una instalación propia también puedes ejecutar npm install n8n-nodes-apisunat en ~/.n8n/nodes.
Credenciales
- API SUNAT API: tu clave
asu_test_oasu_live_. Ver Autenticación. - API SUNAT Webhook: el secreto
whsec_del webhook, para el nodo Trigger.
Emitir
Las operaciones Issue y Void › Create piden un Idempotency Key. Usa una expresión con el id de tu venta, por ejemplo {{ "venta-" + $json.id }}. El cuerpo de Issue es el mismo JSON de Documentos.
Download File deja el archivo en un campo binario (data por defecto), listo para enviarlo por correo o guardarlo.
Recibir webhooks
- Agrega API SUNAT Trigger y copia su URL de producción.
- En el panel crea un webhook con esa URL, en el mismo modo (Prueba o Producción) que tu clave.
- Pega el secreto
whsec_en la credencial API SUNAT Webhook.
El nodo verifica la firma X-Apisunat-Signature y rechaza con 401 los eventos sin firma válida o con más de 5 minutos. Ver Webhooks.
