GuíaEjemplosReferencia API
apisunat.netIngresar

Primeros pasos

  • API SUNAT
  • Inicio rápido
  • Integra con IA
  • Servidor MCP
  • n8n
  • Autenticación
  • Planes y límites
  • Planillas y honorarios

Configurar el RUC

  • Emisores
  • Establecimientos y series

Emitir

  • Documentos
  • Idempotencia
  • Estados
  • Correos
  • Catálogos

Integración

  • Errores
  • Webhooks
  • Cambios

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_ o asu_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

  1. Agrega API SUNAT Trigger y copia su URL de producción.
  2. En el panel crea un webhook con esa URL, en el mismo modo (Prueba o Producción) que tu clave.
  3. 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.

Servidor MCP< PreviousAutenticaciónNext >

Powered by heyo

On this page

InstalaciónCredencialesEmitirRecibir webhooks