API externa y accesos temporales

Conecta tus sistemas con Orama mediante la API o comparte datos de tesorería con terceros usando enlaces temporales.

Orama ofrece dos formas de compartir datos con el exterior:

API externa: para que tus sistemas (ERP, BI, cuadros de mando internos) consulten datos de tesorería automáticamente
Accesos temporales: enlaces de sólo lectura con fecha límite para compartir información con terceros (asesores, inversores, auditores)

API externa

Avanzado — La API está pensada para equipos técnicos o integradores que necesitan conectar sus propios sistemas con Orama. Si no tienes un equipo técnico, puedes saltar esta sección y usar los accesos temporales.

La API externa permite que sistemas externos consulten datos de tu tesorería de forma automatizada. Por ejemplo, tu ERP puede pedir a Orama el saldo actual, las previsiones de cobro del próximo mes o el listado de partidas.

Cómo funciona

Toda la comunicación se realiza mediante peticiones HTTP (el estándar de internet). Tu sistema envía una petición a Orama con un token de acceso y Orama responde con los datos solicitados en formato JSON.

Crear un token de acceso

Ve a Configuración de empresa

En el menú, accede a Configuración de tu empresa.

Accede a la sección Desarrolladores

Dentro de Configuración, busca la sección Desarrolladores o API. Aquí se gestionan los tokens de acceso.

Crea un nuevo token

Pulsa en Crear token. Se generará un token único que tu sistema necesitará para autenticarse.

Copia y guarda el token

Copia el token y guárdalo en un lugar seguro. Solo se muestra una vez. Si lo pierdes, tendrás que crear uno nuevo.

Importante — Trata el token de acceso como una contraseña. No lo compartas por correo electrónico ni lo publiques en ningún sitio. Si sospechas que un token ha sido comprometido, elimínalo inmediatamente y crea uno nuevo.

Usar el token

Tu sistema técnico debe incluir el token en la cabecera accessToken de cada petición. Por ejemplo:

GET https://api.orama.ai/api/external/v1/tesorería
Header: accessToken: tu-token-aqui

Documentación técnica (Swagger)

Orama incluye una documentación interactiva de todos los endpoints disponibles. Tu equipo técnico puede acceder a ella en:

https://app.swaggerhub.com/apis-docs/orama.ai/orama-api-es/v1

Allí encontrarán:

Lista completa de endpoints disponibles
Parámetros que acepta cada endpoint
Ejemplos de respuesta
La posibilidad de probar peticiones directamente desde el navegador

Comparte la URL de la documentación Swagger con tu equipo técnico o integrador. Es la referencia más completa y siempre está actualizada.

Accesos temporales para terceros

Si necesitas que una persona externa (un asesor fiscal, un inversor, un auditor) vea tus datos de tesorería sin darle acceso completo a Orama, puedes crear un enlace temporal de solo lectura.

Cómo funciona

Concepto	Detalle
Tipo de acceso	Sólo lectura — el tercero puede ver pero no modificar nada
Duración	Tú decides la fecha límite. Pasada esa fecha, el enlace deja de funcionar
Un solo uso	Cada enlace es único. Una vez usado, queda marcado como "Usado"
Revocable	Puedes eliminar el acceso en cualquier momento, incluso antes de que caduque

Crear un acceso temporal

Ve a Configuración > Accesos externos

En la configuración de tu empresa, busca la sección de Accesos externos o Enlaces temporales.

Crea un nuevo acceso

Pulsa en Crear acceso. Configura la fecha límite hasta la que será válido.

Copia el enlace

Se generará un enlace único. Cópialo y envíalo a la persona que necesita acceder.

El tercero accede

Cuando la persona abra el enlace, podrá ver los datos de tesorería en modo lectura. No necesita crear cuenta en Orama.

Estados del acceso

Estado	Significado
Activo	El enlace está listo para usar. Puedes copiarlo y compartirlo
Usado	El enlace ya ha sido abierto por el destinatario
Caducado	Se ha superado la fecha limite. El enlace ya no funciona

Eliminar un acceso

Si necesitas revocar el acceso antes de que caduque (por ejemplo, si lo enviaste a la persona equivocada), simplemente elimínalo desde la lista de accesos. El enlace dejará de funcionar inmediatamente.

Los accesos temporales son ideales para reuniones puntuales. Por ejemplo, antes de una reunión con tu asesor fiscal, creas un enlace que caduca al día siguiente. El asesor puede ver los datos durante la reunión y al día siguiente el acceso se cierra automáticamente.

Relacionados

Configuración de empresa

Gestiona los datos de tu empresa, trabajadores, permisos, opciones generales y tu plan de suscripción.

Exportar datos

Descarga movimientos, el cuadro de tesorería, el histórico diario o la comparativa real vs previsto en Excel para informes y auditorías.

Conectar tu ERP

Cómo integrar tu software de gestión (Sage, A3 Innuva, Holded, Odoo) con Orama para importar facturas automáticamente.

Was this page helpful?