Ir al contenido
Fiscalbase
EntrarEmpieza gratis

Webhooks para los comprobantes electrónicos del SRI

El SRI decide después de que envías el comprobante. Un webhook te avisa en el momento: autorizado, devuelto o no autorizado, firmado para que sepas que es nuestro.

Empieza gratisLeer la documentación

De un vistazo

Lo esencial antes de integrar.

  • Los seis comprobantes del SRI

    Una API y un mismo modelo

  • Sandbox gratis

    Sin RUC ni tarjeta

  • Webhooks firmados

    Te avisamos cuando el SRI decide

  • Desde USD 15 al mes

    Con 500 comprobantes incluidos

Por qué conviene un aviso

La decisión del SRI llega cuando llega.

El SRI recibe el comprobante y lo autoriza en un paso aparte. Casi siempre es cuestión de segundos, pero a veces tarda y a veces no responde.

Preguntarle al SRI cada tanto si ya decidió gasta llamadas y complica tu código. Con un webhook, tu sistema reacciona a la decisión cuando ocurre: marcar el pedido como facturado, imprimir, avisar a quien corrija.

Construirlo tú mismo no termina nunca

Esto es lo que tu equipo tendría que construir y mantener para siempre.

Por tu cuenta

  • Seis esquemas XSD del SRI, y cada cambio de versión

  • Clave de acceso de 49 dígitos con su dígito verificador

  • Firma XAdES-BES con el certificado de cada RUC

  • Dos servicios SOAP: recepción y autorización

  • Reintentos cuando el SRI no responde, sin duplicar

  • Errores del SRI traducidos a algo que tu equipo entienda

  • RIDE en PDF para los seis comprobantes

  • Correo al cliente, con el XML y el RIDE

  • Avisos antes de que venza cada certificado

  • Nuevas resoluciones del SRI, cada año

Fiscalbase

Desde USD 15 al mes

Un POST a /v1/ec/invoices

  • Validamos antes de numerar

  • Firmamos, enviamos y reintentamos

  • Te avisamos con un webhook

  • Entregamos el RIDE y el XML a tu cliente

  • Seguimos cada cambio del SRI por ti

Empieza gratis

Cómo funcionan los webhooks

El estándar de siempre, con reintentos.

  • Un evento por decisión

    invoice.authorized, invoice.returned, invoice.not_authorized e invoice.annulled, y lo mismo para cada tipo de comprobante.

  • Firmados con Standard Webhooks

    Cada entrega lleva los encabezados webhook-id, webhook-timestamp y webhook-signature. Cualquier librería del estándar la verifica.

  • Responde 2xx en 15 segundos

    Respondes con cualquier 2xx en menos de 15 segundos. Si no, reintentamos con espera creciente durante unos tres días.

  • Id, estado y número

    El evento trae el id, el estado y el número del comprobante; consultas el detalle por la API.

  • Rota el secreto sin perder entregas

    Durante el traslape cada entrega lleva dos firmas.

  • Dirección HTTPS y pública

    La dirección debe ser HTTPS y pública, incluso en Sandbox.

Registrar un endpoint

El secreto solo se muestra en esta respuesta; con él verificas las entregas.

POST /v1/webhook-endpoints

{
  "url": "https://tu-sistema.ec/webhooks/fiscalbase",
  "events": [
    "invoice.authorized",
    "invoice.not_authorized"
  ]
}

201 Created

{
  "id": "8d1f…",
  "object": "webhook_endpoint",
  "environment": "sandbox",
  "url": "https://tu-sistema.ec/webhooks/fiscalbase",
  "events": ["invoice.authorized", "invoice.not_authorized"],
  "disabled": false,
  "secret_hint": "whsec_…x7Qa",
  "secret": "whsec_…"
}

Una entrega

webhook-id: msg_3c1a7e52…
webhook-timestamp: 1790883610
webhook-signature: v1,K5oZ…

{ "id": "3c1a7e52-…",
  "type": "invoice.authorized",
  "timestamp": "2026-10-03T10:42:07.118Z",
  "data": { "id": "0f6c8f4e-…", "object": "invoice",
            "status": "authorized", "environment": "sandbox",
            "country": "ec", "entity_id": "01926c10-…",
            "number": "001-001-000000042" } }

Cada comprobante, paso a paso

Recibida, autorizada, RIDE generado, correo y portal. Con su hora, en la consola.

Factura 001-001-000001002

Ferretería El Sol S.A.

USD 285,00

Autorizada
  1. Recibida10:30:02
  2. Autorizado por el SRIIntento #2 10:42:11
  3. RIDE generado10:42:12
  4. Correo enviadocompras@elsol.ecPortal de clientesDisponible para su descarga

  • Recibida

    10:30:02

  • Autorizado por el SRI

    12 min

    10:42:11

  • RIDE generado

    < 1 s

    10:42:12

Webhooks

Firmado y con reintentos cuando el SRI decide.

POST https://erp.andina.ec/webhooks

{
  "id": "3c1a7e52-…",
  "type": "invoice.authorized",
  "timestamp": "2026-10-03T10:42:07.118Z",
  "data": {
    "id": "0f6c8f4e-…",
    "object": "invoice",
    "status": "authorized",
    "environment": "sandbox",
    "country": "ec",
    "entity_id": "01926c10-…",
    "number": "001-001-000001002"
  }
}
200 OK

API keys

Una API key por ambiente. El prefijo dice dónde emites.

  • fb_sandbox_

    ••••••••

    Sin validez tributaria

    Sandbox

  • fb_test_

    ••••••••

    Ambiente de pruebas del SRI

    Pruebas

  • fb_live_

    ••••••••

    Validez tributaria

    Producción

Todo para empezar

Tu primera factura

De cero a una factura autorizada en Sandbox.

Leer la guía

Referencia de la API

Cada endpoint, sus campos y sus errores.

Ver la referencia

Sandbox

Prueba sin RUC ni tarjeta.

Crear cuenta

Preguntas frecuentes

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.

Sigue leyendo

API de facturación electrónica SRI Ecuador

Una API para los seis comprobantes.

Leer

Firma electrónica XAdES para el SRI

Sube tu certificado una sola vez.

Leer

Ambiente de pruebas del SRI y Sandbox

Prueba sin RUC, sin tarjeta.

Leer

RIDE del SRI en PDF por API

El PDF de tu comprobante autorizado.

Leer
En la documentación: Webhooks

Empieza a facturar hoy

Sandbox gratis, sin RUC ni tarjeta.

Empieza gratisHabla con nosotros