Crear tu API key

Todo empieza aquí. La API key se crea dentro de Olympus, en la aplicación web, por alguien con rol de dueño o administrador del negocio. Tarda un minuto.

Antes de empezar

• Necesitas una cuenta de Olympus con rol dueño o administrador en el negocio que va a facturar. Un vendedor, un contable o un cajero no ven este apartado.
• Hazlo desde la aplicación web. En la app móvil el apartado no aparece.

Paso a paso

1. Entra en Olympus y elige el negocio en el que vas a facturar (arriba a la izquierda, si tienes varios).

2. Abre Configuración en el menú lateral y entra en Integraciones.

   Verás el estado del emisor (si el negocio ya puede facturar), la lista de claves existentes, el registro de peticiones y un enlace a esta documentación.

3. Pulsa Nueva clave.

4. Rellena el formulario:

   Campo	Qué poner
   Nombre	El sistema que va a usarla: «ERP Odoo», «Tienda Shopify», «Facturación · producción». Lo verás en el registro de peticiones, así que sé concreto.
   Permisos	Marca solo lo que ese sistema necesita. Para emitir y consultar facturas: invoices:write e invoices:read. Para notas de crédito, retenciones, guías y liquidaciones (Ecuador): «Emitir otros comprobantes» y «Consultar comprobantes».
   Establecimiento por defecto	(Ecuador) La sucursal y el punto de emisión que se usarán cuando el payload no los indique.
   IPs permitidas	Opcional. Si tu sistema tiene IP fija, ponla: la clave no funcionará desde ninguna otra.
   Caducidad	Opcional. Para integraciones temporales o pruebas de un tercero.
   Crear clientes automáticamente	Activado por defecto: los compradores nuevos aparecen como clientes del negocio.

5. Pulsa Crear clave. Olympus la muestra una sola vez:

   dlt_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

6. Cópiala y guárdala en el gestor de secretos de tu sistema (variables de entorno, vault…). Al cerrar el aviso, Olympus solo conservará su huella: no podrás volver a verla.

7. Comprueba que funciona:

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

   Si responde con los datos del negocio y listo_para_emitir: true, ya puedes emitir.

Si la pierdes, no se recupera

Olympus no guarda la clave, solo su huella. Si no la copiaste o la perdiste, no hay forma de recuperarla: crea una nueva y revoca la anterior. Es a propósito: así una filtración de la base de datos de Olympus no expone tus claves.

Qué ves después

En Configuración → Integraciones la clave aparece enmascarada (dlt_a1b2c3d4…s9t0), con su estado, sus permisos y la fecha de último uso. Desde ahí puedes:

• Editar el nombre, los permisos, las IPs y la caducidad.
• Rotar: crea una clave nueva y deja la vieja viva 24 horas (hasta 7 días) para desplegar sin cortes.
• Revocar: la clave deja de funcionar en el acto. No se deshace.
• Ver el registro de peticiones: cada llamada con su fecha, endpoint, código de respuesta y request_id.

Recomendaciones

• Una clave por sistema. Si tu ERP y tu tienda comparten una, no sabrás quién hizo qué, y si se filtra tendrás que cortar a los dos.
• Permisos mínimos. Un sistema que solo consulta no necesita invoices:write.
• Nunca en el código ni en el repositorio. En una variable de entorno o un gestor de secretos.
• Nunca por correo ni por chat. Si ya la compartiste así, revócala.

Lo siguiente

• Autenticación: cómo enviarla en cada petición, permisos y rotación.
• Tu primera factura: Ecuador · España.