El recorrido de un comprobante
Cada paso por el que pasó un comprobante, con fecha y detalle, para explicar a tu cliente qué pasó y cuándo.
El status dice dónde está un comprobante; el recorrido dice cómo llegó ahí. Cada paso queda registrado: cuándo lo aceptamos, cuándo lo firmamos, qué respondió el SRI, cuándo se generó el RIDE y a quién se envió por correo.
curl https://api.fiscalbase.io/v1/ec/invoices/0192f6a1-…/events \
-H "Authorization: Bearer fb_live_…"{
"object": "list",
"data": [
{
"id": "0192f6a3-…",
"object": "document_event",
"document_id": "0192f6a1-…",
"type": "emailed",
"revision": 1,
"data": { "to": "compras@ferreteriaelsol.ec" },
"created_at": "2026-09-29T15:04:19.402Z"
},
{
"id": "0192f6a2-…",
"object": "document_event",
"document_id": "0192f6a1-…",
"type": "authorized",
"revision": 1,
"data": { "number": "2909202601179214673900120010010000000011234567813" },
"created_at": "2026-09-29T15:04:14.118Z"
}
],
"next_cursor": "…",
"prev_cursor": null
}El recorrido va del paso más reciente al más antiguo y se pagina como toda lista. Está en cada tipo de comprobante: /v1/ec/credit-notes/{id}/events, /v1/ec/withholdings/{id}/events…
Los pasos
type | Qué pasó | data |
|---|---|---|
accepted | Lo aceptamos y numeramos | — |
signed | Lo firmamos con tu certificado | sha256 del XML firmado |
received | El SRI lo recibió | outcome |
returned | El SRI lo devolvió al recibirlo | codes, los códigos de sri_messages |
authorized | El SRI lo autorizó | number, el número de autorización |
not_authorized | El SRI lo rechazó | codes |
authorization_overdue | Pasaron 24 horas sin decisión del SRI | attempts |
rendered | Generamos el RIDE | sha256 del PDF |
emailed | Lo enviamos a una dirección | to |
resubmitted | Lo corregiste y volvió a pending | — |
imported | Llegó en una importación | import_id, verification |
verified | Un listado del SRI que subiste después confirmó su autorización | import_id de esa importación, verification |
annulled | Registraste su anulación en el SRI | annulled_on, reason |
revision dice a qué versión del comprobante corresponde: la primera es 1 y cada corrección suma una. Así distingues la devolución de la primera versión de la autorización de la segunda.
Un correo aparece una vez por dirección. Si reenvías el comprobante con /email, cada envío suma sus propios pasos emailed.
Los webhooks que enviamos por este comprobante están en el registro de entregas de cada endpoint, filtrando por document_id.