Fluxos de treball amb n8n
Instal·la el trigger oficial, subscriu-te a esdeveniments i recupera el lliurament de webhooks.
El paquet oficial de comunitat és n8n-nodes-factuarea, versió 0.1.2 a la referència de setembre de 2026. Requereix Node.js 22+. Inclou una credencial de Factuarea i un trigger d’esdeveniments; fes servir el node HTTP Request de n8n per a la resta d’operacions REST.
Instal·la i subscriu-te
Instal·la el paquet des de Community Nodes de la teva instància de n8n. Crea una credencial de Factuarea amb una API key que inclogui events:read, webhooks:read, webhooks:write i webhooks:delete. Afegeix Factuarea Trigger, selecciona la credencial i tria els tipus d’esdeveniment del catàleg. En activar el workflow es crea el seu endpoint de webhook; en desactivar-lo s’elimina l’endpoint que pertany a aquest trigger.
Exposa el webhook de n8n mitjançant HTTPS públic. Es rebutgen adreces privades i destinacions només locals; una excepció de sortida per a una botiga no habilita webhooks privats. Les credencials de test registren esdeveniments, però no lliuren webhooks públics; fes servir un cas controlat en live per verificar el lliurament complet.
Fes servir el snapshot de l’esdeveniment
Per a un workflow de factura pagada, subscriu-te a invoice.paid i mapeja el recurs des de data.object. L’id de l’esdeveniment identifica la notificació; data.object.id identifica la factura. En esdeveniments de botiga, data.order.external_id identifica la comanda del proveïdor. Desa l’ID de l’esdeveniment al teu sistema abans d’aplicar un efecte que no s’hagi de repetir.
{{ $json.id }}
{{ $json.type }}
{{ $json.data.object.id }}
{{ $json.data.object.total }}Signatures i recuperació
El trigger comprova l’HMAC sobre el cos original de la petició i valida la data de la signatura. La tolerància predeterminada és de 300 segons, configurable entre 30 i 3600. La deduplicació del node actiu conserva en memòria els darrers 1000 ID d’esdeveniment; no substitueix una deduplicació persistent entre reinicis.
Després de rotar el secret de l’endpoint, desactiva i reactiva el trigger perquè rebi el secret nou; la doble signatura només cobreix les 24 hores de gràcia. Si l’activació esgota el temps d’espera, consulta el llistat d’endpoints abans de reintentar, perquè la creació pot haver acabat. Els errors permanents repetits poden degradar o suspendre un endpoint; corregeix-ne la causa i recupera’l expressament. Consulta el lliurament de webhooks i les limitacions del paquet.