Ciclo de vida de un comprobante
Emitir un comprobante no es una sola llamada: es un proceso. Entenderlo te evita confusiones como creer que un comprobante ya esta autorizado cuando aun no lo esta.
1. Envias el comprobante#
Envia la solicitud con POST /v1/contribuyentes/{identificacion}/comprobantes.
Si el formato, la estructura y las validaciones son correctas, la API responde
con un idOperacion: el identificador de seguimiento de tu emision.
A partir de este momento tu parte termino: la plataforma toma el comprobante y lo procesa.
2. La plataforma lo procesa#
La plataforma valida las reglas fiscales, firma el comprobante, lo transmite al
SRI y guarda el resultado. Mientras tanto, la operacion pasa por distintos
estados de envio (en_cola, enviando, enviado).
3. Sigues la operacion#
Tienes dos formas de enterarte del resultado:
- Consulta:
GET /v1/operaciones/{idOperacion}. Te devuelve el estado actual. - Webhook: si lo tienes configurado, la plataforma te notifica automaticamente cuando la operacion cambia de estado.
Usa el webhook como mecanismo principal y la consulta como respaldo. Ve Seguimiento de una operacion y Webhooks.
4. El SRI autoriza#
El campo estadoAutorizacion indica el resultado fiscal:
estadoAutorizacion |
Significado |
|---|---|
no_disponible |
Aun no hay resultado fiscal |
pendiente |
El SRI esta procesando el comprobante |
autorizado |
Autorizacion confirmada |
error |
El SRI rechazo el comprobante |
Para uso fiscal solo cuenta autorizado.
Idempotencia#
Si tu proceso reintenta una emision (por ejemplo, por un timeout), envia la misma
cabecera Idempotency-Key que en el primer intento. Asi la plataforma no crea un
comprobante duplicado y te devuelve la misma operacion.
Guarda la Idempotency-Key junto con la referencia del comprobante para poder
reintentar con seguridad. Ve Buenas practicas.