Documentación para desarrolladores

Elige tu país

La API es la misma; la fiscalidad no. Cada país tiene su sección con su tutorial, su payload y sus reglas.

Ecuador · SRI

Facturas, notas de crédito y débito, retenciones, guías de remisión y liquidaciones de compra: clave de acceso, RIDE y XML firmado. La autorización llega en segundos.

Empezar con Ecuador →

España · VERI*FACTU

Registros de facturación encadenados: la factura tiene validez al emitirse y se comunica a la AEAT después. Con retención de IRPF y recargo de equivalencia.

Empezar con España →

Tu primera factura, en una llamada

Emitir una factura (Ecuador)

curl -X POST https://olympus.atharix.com/api/v1/invoices/issue \
-H "X-API-Key: $OLYMPUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "comprador": {
    "tipo_identificacion": "04",
    "identificacion": "1792060346001",
    "razon_social": "COMERCIAL ANDINA S.A.",
    "email": "facturas@andina.ec"
  },
  "items": [{
    "descripcion": "Servicio de soporte mensual",
    "cantidad": 1,
    "precio_unitario": 100.00,
    "impuestos": [{ "codigo": "2", "codigo_porcentaje": "4" }]
  }]
}'

Olympus responde con el identificador del comprobante y se encarga del resto: numerar, firmar, comunicar a la administración, generar el PDF y enviárselo al comprador.

Empezar

Crea tu clave, entiende cómo funciona la emisión y qué necesita el negocio para poder facturar.

Introducción →

Referencia

Todos los endpoints, campos, códigos de error y ejemplos en curl, Python, Node y PHP.

Ver la referencia →

Errores

Qué significa cada código, cuáles se reintentan y cuáles piden corregir el payload.

Tabla de errores →

Buenas prácticas

Lo que separa una integración que aguanta en producción de una que da problemas.

Leer →

Agentes: bots con los permisos del equipo

Un agente es un miembro del equipo que es un bot: tiene su responsable, sus permisos del mismo catálogo que las personas y sus propias claves. Lee KPIs, listados y reportes contables, y emite dentro de lo que el negocio le deje hacer solo.

Agentes

Qué es un agente, cómo se crea, qué puede tener y qué no, su autonomía, sus topes y su seguridad.

Introducción →

Datos para agentes

Ventas, cartera, compras, caja, inventario e ingresos recurrentes, con la definición de cada cifra.

KPIs →

Lo que Olympus hace por ti

Tú envías	Olympus se encarga
Comprador, líneas e impuestos	Numerar la factura con la serie que toca
—	Construir el comprobante en el formato de la administración
—	Firmarlo con el certificado del negocio (Ecuador) o encadenar su registro (España)
—	Enviarlo y reintentar si el servicio no responde
—	Generar el PDF y enviárselo al comprador
Consultar el estado	Devolverte el estado, la autorización y los mensajes de la administración