Flujos de trabajo con n8n
Instala el trigger oficial, suscríbete a eventos y recupera la entrega de webhooks.
El paquete oficial de comunidad es n8n-nodes-factuarea, versión 0.1.2 en la referencia de septiembre de 2026. Requiere Node.js 22+. Incluye una credencial de Factuarea y un trigger de eventos; utiliza el nodo HTTP Request de n8n para las demás operaciones REST.
Instala y suscríbete
Instala el paquete desde Community Nodes de tu instancia de n8n. Crea una credencial de Factuarea con una API key que incluya events:read, webhooks:read, webhooks:write y webhooks:delete. Añade Factuarea Trigger, selecciona la credencial y elige los tipos de evento del catálogo. Al activar el workflow se crea su endpoint de webhook; al desactivarlo se elimina el endpoint que pertenece a ese trigger.
Expón el webhook de n8n mediante HTTPS público. Se rechazan direcciones privadas y destinos solo locales; una excepción de salida para una tienda no habilita webhooks privados. Las credenciales de test registran eventos, pero no entregan webhooks públicos; utiliza un caso controlado en live para verificar la entrega completa.
Usa el snapshot del evento
Para un workflow de factura pagada, suscríbete a invoice.paid y mapea el recurso desde data.object. El id del evento identifica la notificación; data.object.id identifica la factura. En eventos de tienda, data.order.external_id identifica el pedido del proveedor. Guarda el ID del evento en tu sistema antes de aplicar un efecto que no deba repetirse.
{{ $json.id }}
{{ $json.type }}
{{ $json.data.object.id }}
{{ $json.data.object.total }}Firmas y recuperación
El trigger comprueba el HMAC sobre el cuerpo original de la petición y valida la fecha de la firma. La tolerancia predeterminada es de 300 segundos, configurable entre 30 y 3600. La deduplicación del nodo activo conserva en memoria los últimos 1000 ID de evento; no sustituye una deduplicación persistente entre reinicios.
Tras rotar el secreto del endpoint, desactiva y reactiva el trigger para que reciba el nuevo secreto; la doble firma solo cubre las 24 horas de gracia. Si la activación agota el tiempo de espera, consulta el listado de endpoints antes de reintentar, porque la creación puede haber terminado. Los fallos permanentes repetidos pueden degradar o suspender un endpoint; corrige la causa y recupéralo expresamente. Consulta la entrega de webhooks y las limitaciones del paquete.