Mantén el teu ERP al dia
Actualitza documents i saldos en crear o pagar factures, sense consultar contínuament si ha canviat res.
invoice.createdinvoice.paidWebhooks de Factuarea
Webhooks de facturació. El teu negoci reacciona al canvi
Una factura pagada, un pressupost aprovat o un cobrament rebut poden posar en marxa el procés següent. Connecta l’ERP, el CRM o l’aplicació amb esdeveniments signats de Factuarea.
- Signatura HMAC-SHA256
- Reintents automàtics
- Consulta i reenviament per API
Integracions i formats compatibles
WhatsApp
Subscripcions de l’endpointTria quin canvi escoltar
FacturaF-2026-142Pagada
POST · HMAC-SHA256La teva aplicació
200 OK/webhooks/factuareaEl teu ERP pot actualitzar el saldo del client.
Automatització per esdeveniments
D’un canvi a Factuarea a un workflow al teu negoci
Subscriu una URL HTTPS als esdeveniments que necessites. Factuarea envia un POST signat amb l’esdeveniment i les seves dades; la teva aplicació els fa servir per executar el pas següent.
Connecta vendes, cobraments i seguiment
Fes servir un pressupost aprovat o un pagament rebut com a senyal per a les tasques de CRM, conciliació o atenció al client.
quote.approvedpayment.receivedSegueix l’enviament de registres VeriFactu
Reacciona davant un enviament o un error i consulta el registre fiscal per conèixer-ne l’estat. L’esdeveniment d’enviament no substitueix la comprovació d’acceptació.
invoice.verifactu_submittedinvoice.verifactu_failedLliuraments sota control
Quan el teu servidor falla, en pots seguir el rastre
Consulta la resposta HTTP, l’intent i el reintent següent. Després de resoldre el problema, pots reenviar un lliurament des de l’API.
Fins a vuit intents per lliurament
Els errors de xarxa, 5xx, 408, 425 i 429 es reintenten amb backoff. Els altres 4xx aturen el lliurament perquè corregeixis el receptor.
Un esdeveniment, encara que arribi més d’un cop
L’ID de l’esdeveniment es manté estable. Desa’l per deduplicar; el reenviament manual crea un altre lliurament per al mateix esdeveniment.
Recupera el context des de l’API
El registre d’esdeveniments permet consultar els darrers 30 dies. Si un endpoint està degradat, un ping amb resposta 2xx permet recuperar-lo.
Registre de lliuraments
invoice.paidResposta del teu servidor
01
Primer intent14:32:00 · POST
50302
Reintent programatD’aquí a aproximadament 1 minut.
ID de l’esdeveniment
01931b3e…8a0dID del lliurament01931b3e…8a0cEspera després de cada intent fallitIntervals base amb una variació de ±10%.
1 min5 min30 min2 h12 h1 d3 dUn receptor que verifica abans d’actuar
Signatura comprovada. Secrets que pots rotar
Fes servir el cos original, la capçalera Factuarea-Signature i el secret de l’endpoint. Els SDK comproven HMAC-SHA256 i una tolerància temporal de cinc minuts per defecte.
Verifica la signatura
import { verifyWebhook } from "@factuarea/sdk";
// Request / Web API
const rawBody = await request.text();
const signature = request.headers.get("Factuarea-Signature") ?? "";
const event = verifyWebhook(
rawBody,
signature,
process.env.FACTUAREA_WEBHOOK_SECRET!,
);
console.log(event.id, event.type);Rota sense canviar la URL
Durant 24 hores s’inclouen signatures amb el secret nou i l’anterior. Actualitza el receptor dins d’aquesta finestra per mantenir la verificació.
Anterior24 hNou
Revisa la rotació de secretsProva cada part del recorregut
En sandbox els esdeveniments es registren i l’enviament extern es limita al ping. En una empresa live, test_event envia un esdeveniment del catàleg marcat com a prova pel flux de lliurament.
pingConnexió i signaturatest_eventLògica del receptorTria com connectar
Una integració que encaixa amb el teu stack
Treballa amb un SDK, consulta el contracte de l’API o connecta el teu assistent. Tria la teva eina per trobar el punt de partida i la documentació que necessites.
Tecnologies i clients compatibles
Pagaments i facturació
Connecta pagaments i facturació
Coneix quins esdeveniments de Stripe processa Factuarea i com es relacionen amb les teves factures. Revisa la configuració i els límits de cada flux.
Stripe → FactuareaConnectar Stripe- operacions API
- 595
- recursos
- 50
- eines MCP
- 581
- pàgines de documentació
- 1306
Abans de posar-ho en producció
Dubtes habituals sobre webhooks
Verifica la capçalera Factuarea-Signature amb HMAC-SHA256, el cos sense modificar i una tolerància de cinc minuts. Els SDK oficials inclouen el verificador per evitar diferències de serialització.
El teu negoci, més connectatFes que cada canvi arribi al teu sistema
Prepara el receptor, tria els esdeveniments i verifica la connexió amb un ping. La documentació t’acompanya des de la signatura fins a la recuperació de lliuraments.