Introducción

La API de integración de Olympus permite a un sistema externo —tu ERP, tu tienda en línea, tu punto de venta, tu software a medida— emitir comprobantes electrónicos del SRI en nombre de un negocio que ya usa Olympus.

Tú envías los datos de la venta. Olympus hace todo lo demás: numera, firma, envía al SRI, espera la autorización, genera el RIDE y notifica al comprador.

Para quién es

• Integradores y desarrolladores que necesitan facturar desde un sistema que no es Olympus.
• Negocios con un ERP propio que quieren delegar la parte fiscal sin construirla.
• Software vertical (clínicas, talleres, gimnasios…) que factura a sus propios clientes.

Si solo quieres emitir facturas a mano, no necesitas la API: usa la aplicación web de Olympus.

Cómo funciona una emisión

1. Tu sistema llama a la API. Un POST /invoices/issue con el comprador, las líneas y los impuestos.

2. Olympus valida y numera. Comprueba que los totales cuadran y asigna el número de la serie que corresponde.

3. Responde de inmediato, sin esperar a la administración. En Ecuador 202 (la factura va camino del SRI); en España 201 (la factura ya está registrada y es válida).

4. En segundo plano se completa el trámite: firma y envío al SRI, o comunicación del registro a la AEAT.

5. Llega la respuesta de la administración. Segundos en Ecuador, menos de dos minutos en España.

6. El PDF se envía por correo al comprador y el estado refleja el resultado.

No bloquees la venta

No dejes a tu usuario esperando frente a una pantalla de carga: da la venta por buena en cuanto recibas la respuesta y consulta el estado después. Lee Buenas prácticas.

Qué necesita el negocio antes de empezar

Para emitir con validez tributaria, el negocio debe tener en Olympus:

En Ecuador

1. Su certificado de firma electrónica (.p12) subido, con su contraseña, en Configuración → Fiscal.
2. Al menos un establecimiento y un punto de emisión, con los códigos que le asignó el SRI.

En España

1. VERI*FACTU activo en Configuración → VERI*FACTU.
2. Su certificado subido con su contraseña, salvo que use el de la plataforma.

En ambos: el ambiente elegido, pruebas o producción. Ver Ambientes.

Puedes comprobar si ya está todo listo con una llamada:

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

{
  "negocio": { "ruc": "1790012345001", "razon_social": "COMERCIAL ANDINA S.A.", "pais": "EC" },
  "regimen": "SRI",
  "ambiente": "produccion",
  "listo_para_emitir": true,
  "requisitos_faltantes": [],
  "como_resolverlo": []
}

Si listo_para_emitir es false, requisitos_faltantes dice qué falta y como_resolverlo dónde se arregla. Siempre es en la aplicación web: la API nunca sube certificados ni activa regímenes.

Qué comprobantes se pueden emitir

Comprobante	País	Recurso
Factura	Ecuador y España	/invoices
Nota de crédito	Ecuador	/credit-notes
Nota de débito	Ecuador	/debit-notes
Comprobante de retención	Ecuador	/withholdings
Guía de remisión	Ecuador	/waybills
Liquidación de compra	Ecuador	/purchase-settlements

Los cinco comprobantes de Ecuador se explican en Otros comprobantes; requieren los scopes documents:write y documents:read.

En Ecuador, cualquier comprobante emitido desde Olympus —también los que se crean a mano en la web— se puede consultar con GET /documents/{clave_acceso}.

Lo siguiente

• Crear tu API key: dentro de Olympus, en un minuto.
• Autenticación: cómo enviarla en cada petición y qué permisos darle.
• Tu primera factura, en cinco minutos: Ecuador · España.