Vista general
- Genera el XML y la clave de acceso Tu sistema construye el comprobante con el esquema del SRI.
- Firma el XML con el .p12 Tu sistema lo firma con tu certificado.
- Envía el XML firmado a recepción El SRI responde si lo recibió o lo devolvió.
- Consulta la autorización por clave de acceso El SRI responde con el resultado real.
Etapa 1: generar el XML y la clave de acceso
El comprobante se construye como un XML que respeta el esquema de la ficha técnica del SRI. A cada comprobante se le asigna una clave de acceso de 49 dígitos que lo identifica de forma única. Un XML que no cumple el esquema se rechaza en la recepción.
Etapa 2: firmar
El XML se firma electrónicamente con tu certificado .p12. Una firma inválida o un certificado vencido es de las causas más comunes de rechazo.
Etapa 3: recepción
El XML firmado se envía al servicio de recepción del SRI, que lo valida a nivel formal. La respuesta es una de dos:
| ESTADO | QUÉ SIGNIFICA | QUÉ HACES |
|---|---|---|
| RECIBIDA | El SRI aceptó el documento para procesarlo | Pasa a consultar la autorización |
| DEVUELTA | El SRI lo rechazó | Lee los mensajes, corrige y vuelve a empezar |
Etapa 4: autorización
Con la clave de acceso consultas el servicio de autorización. Aquí el SRI responde con el resultado real:
| ESTADO | QUÉ SIGNIFICA | QUÉ HACES |
|---|---|---|
| AUTORIZADO | El comprobante tiene validez tributaria | Guarda el número y la fecha de autorización, y entrega el comprobante |
| NO AUTORIZADO | El SRI no lo autorizó | Lee los mensajes, corrige y emite de nuevo |
| EN PROCESAMIENTO | Aún no termina | Vuelve a consultar. No reenvíes el comprobante |
El tiempo de autorización varía. Por eso tu integración no debe asumir que la respuesta llega al instante.
Dónde suele fallar
| SÍNTOMA | CAUSA TÍPICA | QUÉ HACER |
|---|---|---|
| DEVUELTA en la recepción | XML fuera de esquema, firma inválida, datos incorrectos | Corrige según el mensaje. Revisa el catálogo de errores |
| El SRI dice que la clave ya está registrada | Reenviaste un comprobante que ya había llegado | Consulta primero el estado antes de reenviar |
| Se queda EN PROCESAMIENTO mucho tiempo | Demora del SRI | Reintenta la consulta con espera creciente |
| La clave dice pruebas pero envías a producción | Mezcla de ambientes | La clave lleva el ambiente adentro: debe coincidir con los endpoints |
Entrega al cliente
Una vez autorizado, entregas al cliente el XML autorizado y su representación impresa (RIDE). Guarda la clave de acceso: la necesitarás para consultar el XML cuando haga falta.
Cómo se simplifica con una API
Con una API como Flashpi, tu sistema envía un JSON y recibe el estado y la clave de acceso. La generación del XML, la firma y las consultas a recepción y autorización las resuelve la API.
Conclusión
El flujo del SRI tiene cuatro etapas y dos lugares donde esperar. Si tu integración trata la recepción como si fuera la autorización, tarde o temprano duplicará comprobantes.