Saltar al contenido

PrelanzamientoWeb en prelanzamiento. Altas disponibles próximamente; contacto comercial abierto.

API, seguridad y errores

·3 min de lectura

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.

apiverifactuzapierautomatización
Contenido de la guía
  1. Respuesta rápida
  2. El flujo recomendado
  3. Qué puede hacer la automatización
  4. Qué debe permanecer en el SIF
  5. Zapier
  6. Make
  7. n8n
  8. Payload mínimo orientativo
  9. Seguridad y datos personales
  10. Estado de la integración

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

  1. La aplicación de origen confirma la operación.
  2. El automatizador normaliza los datos permitidos.
  3. La API recibe una clave idempotente estable.
  4. El sistema valida impuestos y datos fiscales.
  5. Se genera una sola factura y su registro.
  6. La remisión se procesa y reconcilia.
  7. 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.

Proponer una integración o caso piloto →

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 →