API, seguridad y errores
API Verifactu con Zapier, Make o n8n: arquitectura
Cómo conectar una API Verifactu desde Zapier, Make o n8n sin dejar idempotencia, impuestos, reintentos ni estados fiscales en un flujo frágil.
Contenido de la guía
Respuesta rápida
Zapier, Make o n8n pueden transportar un evento de venta hasta una API Verifactu. No deberían decidir por sí solos la numeración, el encadenamiento ni la corrección fiscal.
La automatización debe enviar un evento identificable. La API debe validar, deduplicar, generar el registro y devolver un estado que pueda consultarse después.
El flujo recomendado
- La aplicación de origen confirma la operación.
- El automatizador normaliza los datos permitidos.
- La API recibe una clave idempotente estable.
- El sistema valida impuestos y datos fiscales.
- Se genera una sola factura y su registro.
- La remisión se procesa y reconcilia.
- El origen consulta o recibe el estado final.
El punto clave es el paso 3. Si el mismo evento llega dos veces, la respuesta debe referirse a la primera operación y no crear otra factura.
Qué puede hacer la automatización
- Detectar una venta o cambio de estado.
- Mapear campos entre herramientas.
- Invocar un endpoint autenticado.
- Guardar el identificador devuelto.
- Avisar cuando una operación requiere atención.
Qué debe permanecer en el SIF
- Numeración y series.
- Reglas de tipos de factura.
- Encadenamiento y huella.
- Registro de alta o anulación.
- Estado por registro de la AEAT.
- Auditoría y conservación.
Separar estas responsabilidades evita que editar un Zap o escenario cambie silenciosamente el comportamiento fiscal.
Zapier
Zapier permite llamar APIs con Webhooks o API by Zapier. Su documentación distingue autenticaciones y advierte de límites y posibles retrasos de procesamiento.
Un 200 del receptor confirma aceptación técnica. No debe presentarse como estado fiscal final. Guarda el identificador de operación y consulta el resultado posterior.
Make
Make guarda las solicitudes de webhook en colas y puede procesarlas en paralelo o en orden. Para facturación, el orden visual del escenario no reemplaza el control de concurrencia del SIF.
Si activas “process data in order”, sigues necesitando idempotencia. Una repetición manual o un segundo escenario todavía puede reenviar el mismo evento.
n8n
n8n ofrece nodos webhook y despliegues controlados por el propio equipo. Puede encajar cuando necesitas más gobierno sobre infraestructura, credenciales y observabilidad.
Ese control añade responsabilidad. Debes proteger secretos, limitar registros con datos personales y vigilar ejecuciones fallidas y reintentos.
Payload mínimo orientativo
{
"source": "store",
"event_id": "order-paid-1842",
"occurred_at": "2026-08-29T10:30:00Z",
"customer": {},
"lines": [],
"totals": {}
}
El ejemplo no define el contrato público de Verifactu Fácil. Muestra los elementos que permiten identificar el origen y evitar duplicados.
Seguridad y datos personales
No incluyas certificados, contraseñas ni claves privadas en un webhook. Usa credenciales revocables y limita cada integración al tenant y operación que necesita.
Revisa cuánto tiempo conserva cada herramienta los cuerpos, errores y ejecuciones. Un payload de factura puede contener datos personales y fiscales.
Estado de la integración
Verifactu Fácil todavía no ofrece una app pública de Zapier, Make o n8n. La API y los webhooks comerciales permanecen en prelanzamiento hasta completar pruebas y documentación.
La guía general de API explica eventos, estados e idempotencia con más detalle.
Siguiente paso
Cuéntanos qué sistema necesitas conectar
El servicio está en prelanzamiento. Revisamos el canal, el volumen y los datos fiscales antes de abrir una integración.
Hablar sobre tu integración →