Ir al contenido

La API de comprobantes recibidos que el SRI no tiene

El SRI no tiene una API para recibir documentos. En Fiscalbase subes los XML que te mandan o el reporte de recibidos que descargas del SRI, confirmamos cada comprobante con el SRI y lo dejamos en tu sistema por API y por webhook.

Los seis comprobantes del SRI

Una API y un mismo modelo

Sandbox gratis

Sin pago ni certificado

Webhooks firmados

Te avisamos cuando el SRI decide

Desde USD 5,99 al mes más IVA

Con 30 comprobantes al mes y 14 días gratis

Lo que el SRI te deja para lo que recibes para lo que recibes

Tus proveedores emiten. Tú recibes. El SRI te lo muestra en un portal, no en una API.

Las facturas de tus proveedores y las retenciones que te hacen tus clientes viven en SRI en línea, en la consulta de comprobantes recibidos. Ahí puedes verlos y descargar un reporte, pero no hay un servicio al que tu sistema le pida el listado de un mes.

El SRI sí responde por la clave de acceso de 49 dígitos, pero solo conoces la clave si ya tienes el comprobante, y contesta por documentos de unos 60 días atrás. Descargar a mano, mes por mes, es lo que hoy hace casi todo el mundo.

Un comprobante recibido que no llega a tu sistema es un crédito de IVA que no ves o una retención que no emites a tiempo.

Lo que hacemos con lo que subes con lo que subes

Confirmamos cada comprobante, y tu sistema lo recibe por API y por webhook.

Tus XML o el reporte del SRI

Subes los XML sueltos o en un ZIP, o el reporte de recibidos en TXT o CSV, desde la app o con POST /v1/ec/imports.

Verificado por su clave de acceso

Cada comprobante se confirma contra el SRI. Su campo verification dice con qué se comprobó: sri, listed, signature o unconfirmed.

GET /v1/ec/received-documents

Pagina con limit y cursor, sigue next_cursor y filtra por type, period, verification o xml_status.

Un webhook por comprobante nuevo

received_document.created lleva el comprobante entero y se envía una sola vez por comprobante.

Su retención, desde la factura

De una factura recibida emites su comprobante de retención, con los porcentajes que te sugerimos, y queda ligado a ella.

Sin tu clave del SRI

Nunca la pedimos. El SRI confirma cada comprobante por su clave de acceso.

Bajarlos a mano se come tu semana

El SRI no tiene una API para lo que recibes. Esto hace hoy tu equipo para tenerlos.

Sin una API

  • Horas en SRI en línea, descargando RUC por RUC
  • Cada XML bajado y subido a tu sistema, uno por uno
  • Scripts y extensiones del navegador con tu clave del SRI
  • Robots que se rompen cada vez que el SRI cambia su portal
  • Claves bloqueadas cuando un script intenta de más
  • Retenciones que vencen porque la factura llegó tarde
  • Faltantes y duplicados al cuadrar con el SRI a fin de mes

Un GET a /v1/ec/received-documents, desde usd 5,99 al mes más iva

  • Subes el reporte del SRI o tus XML, y listo
  • Confirmamos cada clave de acceso con el SRI
  • Nunca te pedimos tu clave del SRI
  • Emites la retención desde la factura recibida
  • Un webhook por comprobante, sin duplicados

De tu proveedor a tu sistema, sin copiar nada

Cada compra que subes la confirma el SRI y tu sistema la recibe lista para usar.

POSThttps://api.fiscalbase.io/v1/webhook-endpoints/0f6c8f4e-…/backfill
// Authorization: Bearer fb_live_…
{
"since": "2026-09-01"
}
Una entrega
webhook-id: msg_9b2d41c7…
webhook-timestamp: 1790883610
webhook-signature: v1,K5oZ…
{ "id": "9b2d41c7-…",
"type": "received_document.created",
"timestamp": "2026-10-03T03:12:41.206Z",
"data": { "id": "0f6c8f4e-…", "object": "received_document",
"type": "invoice", "environment": "live",
"access_key": "2509202601179001234500110010010000012341234567811",
"verification": "sri", "xml_status": "available",
"retention": null, … } }

Subes el reporte del SRI

O los XML que te mandaron, sueltos o en un ZIP

10:42:07

Confirmamos que es real

Su clave de acceso, consultada al SRI

10:42:09

La guardamos una sola vez

Con su XML, su emisor y sus montos

10:42:12

Te avisamos

Un webhook firmado a erp.andina.ec

10:42:13

Emites su retención

Desde la factura, con los porcentajes sugeridos

10:44:30

Preguntas frecuentes

¿El SRI tiene una API para descargar comprobantes recibidos?

No. El SRI muestra los comprobantes recibidos en SRI en línea y deja descargar un reporte. Fiscalbase pone la API: subes ese reporte o los XML y los lees con GET /v1/ec/received-documents o los recibes por webhook.

¿Cómo hago la descarga masiva de mis comprobantes recibidos?

Descarga el reporte de recibidos de SRI en línea y súbelo, o sube los XML en un ZIP. Confirmamos cada comprobante con el SRI, y con un backfill desde la fecha que quieras llegan a tu endpoint por el mismo webhook que los nuevos.

¿Recibo el mismo comprobante dos veces?

No. Cada comprobante se guarda una sola vez por su clave de acceso y su evento lleva siempre el mismo webhook-id, también en un backfill, así que un receptor que deduplica ve uno solo.

¿Puedo traer un comprobante suelto?

Sí: sube su XML, o el reporte de recibidos del SRI que lo nombra, con POST /v1/ec/imports. Lo guardamos y te avisamos con received_document.created. Por el reporte, el SRI contesta por documentos de unos 60 días atrás.

¿Puedo probarlo sin mi RUC?

Sí. En Sandbox subes cualquier comprobante dirigido a tu negocio y lo lees por API y webhook. Ahí no se confirma con el SRI y no tiene validez tributaria.

¿No está la tuya? Escríbenos

Tu primera factura, hoy.

14 días gratis. No necesitas tarjeta.