Ambientes
El SRI tiene un ambiente de pruebas y uno de producción. En el API, el ambiente lo decide el token: la solicitud no tiene un campo para elegirlo.
El token decide el ambiente
| Token | Ambiente | ambiente en las respuestas |
|---|---|---|
glm_prueba_… | Pruebas del SRI | PRUEBAS |
glm_prod_… | Producción del SRI | PRODUCCION |
Para cambiar de ambiente, cambia de token. La URL base, los campos y las respuestas son los mismos en los dos.
Qué cambia entre pruebas y producción
| Pruebas | Producción | |
|---|---|---|
| Validez tributaria | No | Sí |
| Servicios web del SRI | Los de pruebas | Los de producción |
| Correo con el XML y el RIDE | A un buzón de Golem, nunca al receptor | Al correo del receptor |
| Secuenciales | Propios del ambiente de pruebas, por punto de emisión y tipo de comprobante | Los del punto de emisión, compartidos con la aplicación |
| Clave de acceso (dígito de ambiente, posición 24) | 1 | 2 |
| Créditos | 1 por comprobante emitido | 1 por comprobante emitido |
| Consultas, listado y descargas | Solo comprobantes de pruebas | Solo comprobantes de producción |
Idempotency-Key | Independiente de producción | Independiente de pruebas |
Consultas separadas por ambiente
Un token solo ve los comprobantes de su ambiente, emitidos desde el API o desde la aplicación. Consultar con un token de pruebas la clave de acceso de un comprobante de producción (o al revés) responde 404 NO_ENCONTRADO, igual que un comprobante de otra empresa. Así, una integración de pruebas no puede descargar comprobantes con validez tributaria.
Secuenciales
Los comprobantes de pruebas tienen su propia numeración y no consumen números de producción. GET /empresa devuelve en siguientesSecuenciales el próximo número de cada tipo en el ambiente del token.
Créditos en pruebas
Cada comprobante emitido consume un crédito del saldo de la empresa, también en el ambiente de pruebas. Si el comprobante termina DEVUELTO, NO_AUTORIZADO o ERROR, el crédito vuelve al saldo. Las consultas, el listado y las descargas no consumen créditos.
Requisitos del SRI para pruebas
El SRI solo recibe comprobantes de pruebas de un RUC habilitado para ese ambiente en SRI en línea. Si el RUC no está habilitado, el SRI devuelve los comprobantes y el estado queda en DEVUELTO con el mensaje del SRI en mensajes.
Idempotencia por ambiente
La misma Idempotency-Key en pruebas y en producción corresponde a dos operaciones distintas. Si usas el número de pedido como clave, el pedido que probaste con un token de pruebas se emite normalmente con el de producción. Detalle en Idempotencia.
Pasar a producción
- Emite y consulta en pruebas los casos que use tu sistema: factura, nota de crédito, retención, errores de validación y respuestas
202. - Crea un token de producción en Cuenta > API e integraciones y reemplázalo en tu sistema.
- Revoca el token de pruebas si ya no lo necesitas.
Los comprobantes de producción se envían al SRI y al correo del receptor desde la primera solicitud: revisa antes los datos de los clientes y de los productos.