Tu sistema se entera cuando el SRI decide.
Fiscalbase avisa a tu URL cada vez que un comprobante se autoriza, vuelve o se anula, firmado con Standard Webhooks.
webhook-id: msg_2Lk9…webhook-timestamp: 1795017751webhook-signature: v1,K5oZfzN95Z9…{"id": "evt_2Lk9…","type": "invoice.authorized","timestamp": "2026-11-18T15:42:31Z","data": {"object": "invoice","status": "authorized","number": "001-001-000000248","access_key": "18112026011792345618…","total": "115.00"}}
HTTP/1.1 200 OK// Cualquier 2xx en 15 segundos es una entrega.// data es el comprobante tal como lo da GET,// así que no hace falta pedirlo de nuevo.
Los eventos que importan.
Un destino por negocio, en una URL pública con HTTPS.
Comprobantes
Cada uno de los seis, al autorizarse, volver, no autorizarse o anularse.
Recibidos
Lo que tus proveedores te emiten, cuando llega y cuando cambia.
Numeración
Saltos, duplicados y choques en tus secuenciales, y cuando se resuelven.
Importaciones
Cuando termina o falla la carga de tu historial.
Firmado, como manda el estándar.
Cada entrega lleva webhook-id, webhook-timestamp y una firma HMAC-SHA256. El secreto se muestra una sola vez, y al rotarlo el anterior sigue firmando 24 o 72 horas mientras cambias tu servidor.
import { createHmac, timingSafeEqual } from "node:crypto";// El secreto viene como whsec_ más base64const key = Buffer.from(secret.slice(6, "base64"));const mac = createHmac("sha256", key).update(`${id}.${timestamp}.${body}`).digest();// webhook-signature trae una o más firmas "v1,…"const ok = signature.split(" ").some((s) => {const sig = Buffer.from(s.slice(3, "base64");return sig.length === mac.length && timingSafeEqual(sig, mac);});
Si tu servidor no responde, insistimos.
Los reintentos empiezan a los 30 segundos y se espacian hasta cada 6 horas, durante unos 3 días, siempre con el mismo webhook-id para que no proceses dos veces. Si nada funciona, avisamos por correo a los dueños y administradores.
Cada entrega, a la vista.
En la app ves cada intento con su respuesta, reenvías el que falló y vuelves a mandar todo lo recibido desde una fecha.
| Hora | Evento | Comprobante | Respuesta | Tiempo | |
|---|---|---|---|---|---|
| 15:42:31 | invoice.authorized | 001-001-000000248 | 200 | 142 ms | |
| 15:31:08 | invoice.authorized | 001-001-000000247 | 200 | 96 ms | |
| 14:58:44 | received_document.created | Distribuidora Andina | timeout | 15 s | Reenviar |
| 14:12:19 | credit_note.authorized | 001-001-000000013 | 500 | 61 ms | Reenviar |
| 13:40:02 | invoice.authorized | 001-001-000000246 | 200 | 118 ms |
Preguntas frecuentes
¿Cómo verifico la firma de un webhook?
Con cualquier librería de Standard Webhooks y el secreto del endpoint: usa los encabezados webhook-id, webhook-timestamp y webhook-signature de la entrega.
¿Qué pasa si mi servidor está caído?
Reintentamos con espera creciente, desde 30 segundos hasta cada 6 horas, durante unos tres días.
¿Qué eventos recibo?
Uno cuando el SRI autoriza, uno cuando devuelve y uno cuando no autoriza, para cada tipo de comprobante, y otro cuando registras una anulación. También puedes suscribirte a todos.
¿Puedo recibir webhooks en mi computador mientras desarrollo?
La dirección debe ser HTTPS y pública, incluso en Sandbox, así que necesitas un túnel o un servidor de pruebas accesible desde internet.
Conecta tu sistema hoy.
Prueba en Sandbox con tu propio RUC. Los webhooks funcionan igual que en Producción.