Ambientes

Tanto el SRI como la AEAT tienen dos ambientes, y Olympus emite en el que el negocio tenga configurado:

Ambiente	Qué es
pruebas	Los comprobantes se tramitan pero no tienen validez tributaria. Para desarrollar e integrar.
produccion	Comprobantes reales, con validez tributaria y efectos fiscales.

El ambiente es del negocio, no de la clave

A diferencia de otras APIs, aquí no hay claves de prueba y claves de producción. El ambiente lo decide el negocio en Configuración → Fiscal, y todas sus claves emiten en él.

El motivo es la numeración: la serie de facturas es única y compartida. Una clave de pruebas que emitiera en un negocio de producción consumiría números reales y dejaría huecos en la numeración, que ninguna administración perdona.

Consulta en qué ambiente estás antes de emitir:

curl https://olympus.atharix.com/api/v1/me -H "X-API-Key: $OLYMPUS_API_KEY"

{ "ambiente": "pruebas", "listo_para_emitir": true, "requisitos_faltantes": [] }

Cada comprobante que emites también dice en cuál se emitió:

{ "id": "6f1e…", "pais": "EC", "ambiente": "pruebas", "clave_acceso": "2409…13" }

Hazlo explícito en tu sistema

Guarda el ambiente junto a cada comprobante y muéstralo en tu interfaz. Así nadie confunde una factura de pruebas con una real cuando mire el histórico dentro de seis meses.

Qué cambia entre uno y otro

Casi nada en la API: mismos endpoints, mismo payload, mismas respuestas. Lo que cambia es:

• El servidor de la administración al que se envía el comprobante.
• La validez: un comprobante de pruebas no sustenta nada.
• La marca en el PDF: los comprobantes de pruebas se imprimen señalados.
• En Ecuador, además, el dígito de ambiente dentro de la clave de acceso (posición 24: 1 o 2).

Pasar a producción

1. Emite en pruebas los casos que vas a usar de verdad. Como mínimo: una factura a cliente identificado, una sin identificar, una con descuento y una con varias líneas e impuestos distintos.

2. Comprueba que el documento sale como esperas. Descarga el PDF (y en Ecuador, el XML) de una factura ya tramitada y revisa importes, impuestos y datos del comprador.

3. Prueba los errores. Envía totales que no cuadren y una referencia_externa repetida. Tu sistema tiene que saber qué hacer con cada uno.

4. Verifica la configuración de producción. En Ecuador, la firma electrónica real, vigente y con su contraseña; en España, VERI*FACTU activo y el certificado puesto. Consulta GET /me: listo_para_emitir tiene que ser true.

5. Cambia el ambiente desde Configuración → Fiscal. Olympus no permite pasar a producción con requisitos pendientes.

6. Emite una factura real y compruébala antes de abrir el grifo a todo el volumen: en Ecuador, en el portal del SRI con su clave de acceso; en España, en urls.verificacion.

La numeración de pruebas y producción es la misma

La serie no se reinicia al cambiar de ambiente: si emitiste 50 facturas de pruebas, la primera real será la 51. Es el comportamiento normal y no supone ningún problema, pero conviene saberlo antes de que alguien pregunte por qué su primera factura real no es la número 1.

Checklist antes de producción

• GET /me responde listo_para_emitir: true
• El certificado está vigente y no caduca en los próximos meses
• (Ecuador) Los establecimientos y puntos de emisión coinciden con los que autorizó el SRI
• Tu sistema guarda el id, el identificador fiscal (clave_acceso o huella) y el ambiente
• Tu sistema trata no_autorizado, no solo el camino feliz
• Usas Idempotency-Key en las emisiones
• Usas referencia_externa para cruzar cada factura con la venta de tu sistema
• No bloqueas la venta esperando la respuesta de la administración