Consultar el estado de un comprobante por la API y qué significa cada código

Por qué hay que consultar

Al emitir por la API recibes al instante la clave de acceso, pero el SRI autoriza de forma asíncrona. Tu integración debe mostrar «en proceso» y consultar el estado unos segundos o minutos después.

Consultar con la api_key de emisión

Envía un POST a /plataforma/api/v2/consulta/comprobante con:

• api_key: la del punto de emisión.
• claveacceso: los 49 dígitos que te devolvió la emisión.

La respuesta trae:

• estado (número) y estado_texto.
• mensaje: por ejemplo «El comprobante se esta procesando, consulte el estado nuevamente en unos minutos».
• motivo: el motivo del rechazo, si lo hubo.
• enlace_pdf y enlace_xml cuando está autorizado (y enlace_pdf_pos si la empresa usa PDF tipo ticket).

Códigos de estado

• -1 borrador: guardado pero no enviado al SRI.
• 0 en proceso: en la cola; se genera, firma y envía.
• 1 generado / 2 firmado / 3 recibido: pasos intermedios; el SRI aún no contesta con la autorización.
• 4 autorizado: válido. Ya tiene PDF y XML. Es final.
• 5 no autorizado: el SRI lo rechazó. Mira el motivo, corrige y vuelve a enviar.
• 6 error de secuencial: ese número ya está registrado en el SRI. Corrige el número y reprocesa.
• 7 error al firmar: revisa la firma electrónica de la empresa (vigencia y contraseña).
• 8 en procesamiento: el SRI lo tiene en proceso; espera.
• 9 anulado: se dio de baja y ya no tiene validez tributaria. No significa autorizado. En notas de crédito, débito y retenciones puede indicar que falta completar la anulación en SRI en línea.
• 11 SRI no disponible: transitorio; el sistema lo reintenta solo.
• 15 establecimiento cerrado: el SRI dice que ese establecimiento no está abierto en tu RUC. Se arregla en SRI en línea, no reintentando.
• 17 corregir firma electrónica: la firma caducó, la contraseña está mal o no corresponde al RUC.
• 18 corregir comprobante: el XML no cumple la estructura del SRI, la fecha es extemporánea o la clave de acceso está mal.

¿Cuáles son finales?

Los estados 4 y 9 son definitivos. Los estados 5, 6, 7, 15, 17 y 18 esperan una acción tuya. Los demás (0, 1, 2, 3, 8, 11) se mueven solos: vuelve a consultar.

Preguntas frecuentes

Mi factura salió con estado 18 por fecha extemporánea. ¿Qué hago?

El SRI solo acepta comprobantes transmitidos el mismo día de su fecha. Emite un comprobante nuevo con la fecha de hoy.

¿Dónde veo el comprobante emitido por la API?

En el sistema, en Documentos Enviados SRI, en el establecimiento, punto y ambiente de la api_key.