Ir al contenido

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.

POSThttps://erp.ferreteriaelsol.ec/fiscalbase
webhook-id: msg_2Lk9…
webhook-timestamp: 1795017751
webhook-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"
}
}
Tu servidor200
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.

invoice.authorizedcredit_note.returnedwithholding.not_authorizedinvoice.annulled

Recibidos

Lo que tus proveedores te emiten, cuando llega y cuando cambia.

received_document.createdreceived_document.updated

Numeración

Saltos, duplicados y choques en tus secuenciales, y cuando se resuelven.

series.gap_detectedseries.duplicate_detectedseries.collision_detectedseries.gap_settled

Importaciones

Cuando termina o falla la carga de tu historial.

import.completedimport.failed

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.

verificar.js
import { createHmac, timingSafeEqual } from "node:crypto";
// El secreto viene como whsec_ más base64
const 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.

https://erp.ferreteriaelsol.ec/fiscalbaseSana
HoraEventoComprobanteRespuestaTiempo
15:42:31invoice.authorized001-001-000000248200142 ms
15:31:08invoice.authorized001-001-00000024720096 ms
14:58:44received_document.createdDistribuidora Andinatimeout15 sReenviar
14:12:19credit_note.authorized001-001-00000001350061 msReenviar
13:40:02invoice.authorized001-001-000000246200118 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.