¿Qué ocurre si mi servidor no responde?

Una respuesta 2xx cierra la entrega. Los 408, 425, 429, los 5xx y los silencios transitorios entran en la cola de reintentos con espera creciente y jitter; los demás 4xx quedan como fallo permanente.

¿Cómo evito procesar dos veces el mismo aviso?

Guarda el identificador estable del evento antes de ejecutar efectos externos. Si vuelve a llegar por un reintento o un reenvío manual, respondes 2xx sin repetir el trabajo.

¿Puedo probar los webhooks sin tocar producción?

El sandbox registra eventos, pero solo envía el ping al exterior para probar conexión y firma. Para probar un evento del catálogo con test_event, usa un endpoint de una empresa live. El evento se marca como prueba.

¿Puedo rotar el secreto sin perder eventos?

Durante 24 horas, las entregas incluyen firmas con el secreto anterior y el nuevo. Rota el secreto y actualiza tu receptor dentro de esa ventana. Los verificadores de ambos SDK pueden validar cualquiera de las firmas presentes.

Webhooks de Factuarea

Webhooks de facturación. Tu negocio reacciona al cambio

Una factura pagada, un presupuesto aprobado o un cobro recibido pueden poner en marcha tu siguiente proceso. Conecta tu ERP, CRM o aplicación con eventos firmados de Factuarea.

Empezar gratis Leer la guía

Firma HMAC-SHA256
Reintentos automáticos
Consulta y reenvío por API

Integraciones y formatos compatibles

Webhooks · Endpoint activo

Suscripciones del endpointElige qué cambio escuchar

FacturaF-2026-142Pagada

POST · HMAC-SHA256

Tu aplicación/webhooks/factuarea

200 OK

Tu ERP puede actualizar el saldo del cliente.

ID del evento01931b3e…8a0d

Automatización por eventos

De un cambio en Factuarea a un workflow en tu negocio

Suscribe una URL HTTPS a los eventos que necesitas. Factuarea envía un POST firmado con el evento y sus datos; tu aplicación los utiliza para ejecutar el siguiente paso.

Mantén tu ERP al día

Actualiza documentos y saldos al crear o pagar facturas, sin consultar continuamente si ha cambiado algo.

invoice.createdinvoice.paid

Conecta ventas, cobros y seguimiento

Usa un presupuesto aprobado o un pago recibido como señal para tus tareas de CRM, conciliación o atención al cliente.

quote.approvedpayment.received

Sigue el envío de registros VeriFactu

Reacciona ante un envío o un fallo y consulta el registro fiscal para conocer su estado. El evento de envío no sustituye la comprobación de aceptación.

invoice.verifactu_submittedinvoice.verifactu_failed

Estas conexiones se construyen con tu receptor: eliges qué eventos procesar y cómo traducirlos en acciones de tu sistema.

Explorar el catálogo de eventos

Entregas bajo control

Cuando tu servidor falla, puedes seguir el rastro

Consulta la respuesta HTTP, el intento y el próximo reintento. Tras resolver el problema, puedes reenviar una entrega desde la API.

Hasta ocho intentos por entrega
Los fallos de red, 5xx, 408, 425 y 429 se reintentan con backoff. Los demás 4xx detienen esa entrega para que corrijas el receptor.
Un evento, aunque llegue más de una vez
El ID del evento permanece estable. Guárdalo para deduplicar; el reenvío manual crea otra entrega para ese mismo evento.
Recupera el contexto desde la API
El registro de eventos permite consultar los últimos 30 días. Si un endpoint está degradado, un ping con respuesta 2xx permite recuperarlo.

Configurar reintentos y reenvíos

Registro de entregasinvoice.paid

Respuesta de tu servidor

Primer intento14:32:00 · POST

503

Reintento programadoDentro de aproximadamente 1 minuto.

ID del evento01931b3e…8a0dID de la entrega01931b3e…8a0c

Reintento programado

Espera tras cada intento fallido

1 min5 min30 min2 h12 h1 d3 d

Intervalos base con una variación de ±10%.

Un receptor que verifica antes de actuar

Firma comprobada. Secretos que puedes rotar

Usa el cuerpo original, la cabecera Factuarea-Signature y el secreto del endpoint. Los SDK comprueban HMAC-SHA256 y una tolerancia temporal de cinco minutos por defecto.

Verificar la firma

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);

Si la firma no es válida, el verificador lanza un error. Captúralo antes de procesar el evento; guarda o encola el trabajo y responde 2xx.

Rota sin cambiar tu URL

Durante 24 horas se incluyen firmas con el secreto nuevo y el anterior. Actualiza tu receptor dentro de esa ventana para mantener la verificación.

Anterior24 hNuevo

Revisar la rotación de secretos

Prueba cada parte del recorrido

En sandbox los eventos se registran y el envío externo se limita al ping. En una empresa live, test_event envía un evento del catálogo marcado como prueba por el flujo de entrega.

pingConexión y firmatest_eventLógica del receptor

Ver qué permite el sandbox

Elige cómo conectar

Una integración que encaja con tu stack

Trabaja con un SDK, consulta el contrato de la API o conecta tu asistente. Elige tu herramienta para encontrar el punto de partida y la documentación que necesitas.

Tecnologías y clientes compatibles

Tu herramienta → Factuarea

Pagos y facturación

Conecta pagos y facturación

Conoce qué eventos de Stripe procesa Factuarea y cómo se relacionan con tus facturas. Revisa la configuración y los límites de cada flujo.

Stripe → FactuareaConectar Stripe

operaciones API: 595
recursos: 50
herramientas MCP: 581
páginas de documentación: 1306

Antes de ponerlo en producción

Dudas habituales sobre webhooks

Verifica la cabecera Factuarea-Signature con HMAC-SHA256, el cuerpo sin modificar y una tolerancia de cinco minutos. Los SDK oficiales incluyen el verificador para evitar diferencias de serialización.

Tu negocio, mejor conectado

Haz que cada cambio llegue a tu sistema

Prepara tu receptor, elige los eventos y verifica la conexión con un ping. La documentación te acompaña desde la firma hasta la recuperación de entregas.

Empezar gratis Leer la guía de webhooks