Odoo
Orama se conecta a Odoo con una API key y descarga facturas de venta y compra, abonos y remesas cada 2 horas para convertirlas en previsiones de cobro y pago.
Orama se conecta a Odoo con una API key y descarga tus facturas de venta y compra, sus abonos y las remesas cada dos horas. Cada factura confirmada se convierte en una previsión de cobro o pago en el cuadro de tesorería, con su vencimiento real, y se concilia con el banco cuando llega el movimiento.
Funciona con Odoo Community y Enterprise (versión 13 o superior) alojado en la nube o en tus servidores, siempre que la API XML-RPC sea accesible desde internet. Orama solo lee: nunca crea ni modifica nada en tu Odoo.
Qué importa y cada cuánto
| Dato | Detalle | Frecuencia |
|---|---|---|
Facturas de cliente (out_invoice) | Confirmadas; borradores excluidos | Cada 2 h, L–V, 9:00–23:00 |
Facturas de proveedor (in_invoice) | Confirmadas, con vencimientos | Cada 2 h, L–V, 9:00–23:00 |
| Abonos de cliente y proveedor | Restan de la previsión correspondiente | Con las facturas |
| Estado de pago | Pagada / pendiente, para cerrar previsiones | Con las facturas |
| Remesas | Agrupaciones de cobros y pagos | Cada 2 h, L–V, 9:00–23:00 |
| PDF de la factura | Se descarga bajo demanda desde la ficha | Al abrir la factura |
En la primera sincronización Orama trae el histórico reciente; después trabaja de forma incremental releyendo los dos últimos días para recoger facturas editadas o pagadas.
Cómo conectarlo
Crea una API key en Odoo
En Odoo, abre tu perfil de usuario → Seguridad de la cuenta → Nueva clave API. Ponle un nombre (por ejemplo, "Orama") y copia la clave: solo se muestra una vez.
Abre la integración en Orama
En Orama ve a Integraciones, elige Odoo y pulsa Conectar.
Rellena los cinco datos
- Dominio: la URL de tu Odoo, por ejemplo
https://miempresa.odoo.com - Base de datos: el nombre de la base de datos (en Odoo.sh o SaaS suele coincidir con el subdominio)
- Email: el email del usuario que creó la API key
- API key: la clave que copiaste en el paso 1
- Empresa: si tu Odoo es multiempresa, la empresa cuyas facturas quieres importar
Guarda y espera la primera carga
Orama valida las credenciales y lanza la primera importación. En unos minutos verás las facturas en Listados → Facturas y las previsiones en el cuadro.
Cómo se convierten las facturas en previsiones
Cada factura genera una previsión en la partida que corresponda según las reglas de conciliación de facturas de esa partida (NIF, nombre fiscal o palabras clave). Si tienes clientes o proveedores concretos, lo más fiable es poner su NIF en la partida: así todas sus facturas caen donde toca sin revisarlas.
Si una factura tiene varios vencimientos, Orama crea una previsión por vencimiento. Cuando el cobro o el pago llega al banco, la previsión se concilia con el movimiento y desaparece de pendientes.
Errores frecuentes y solución
| Mensaje o síntoma | Causa | Solución |
|---|---|---|
| "Credenciales incorrectas" al guardar | Email, base de datos o API key no coinciden | Comprueba que el email es el del usuario que creó la clave y que el nombre de la base de datos es exacto |
| No aparecen facturas | El usuario no tiene acceso a Contabilidad o la empresa seleccionada no es la correcta | Da al usuario el rol de lectura en Facturación y revisa el campo Empresa |
| Faltan facturas antiguas | La primera carga trae el histórico reciente | Pide una carga completa desde la integración (botón Actualizar) o importa el histórico por Excel |
| Facturas duplicadas en previsiones | La misma factura cae en dos partidas | Revisa las reglas de facturas: una palabra opcional demasiado genérica suele ser la causa |
| Tiempo de espera agotado | Odoo en servidor propio con firewall | Permite el acceso a /xmlrpc/2/ desde internet o abre el puerto a Orama |
Preguntas frecuentes
¿Qué datos de Odoo importa Orama?
Facturas de cliente y de proveedor confirmadas (no borradores), sus abonos, los vencimientos y el estado de pago, además de las remesas. Orama solo lee datos; no escribe nada en Odoo.
¿Cada cuánto se sincroniza Odoo con Orama?
Cada dos horas entre las 9:00 y las 23:00 de lunes a viernes, y siempre que pulses Actualizar en la integración. Orama vuelve a leer los últimos dos días para recoger cambios.
¿Qué permisos necesita el usuario de Odoo?
Un usuario con acceso de lectura a Contabilidad (facturación) en la empresa que quieras conectar y una API key generada desde su perfil. No necesita permisos de escritura.
¿Puedo filtrar qué facturas se importan o traer campos extra?
Sí. La integración admite un filtro adicional (por ejemplo, excluir un diario concreto) y un mapeo de campos personalizados de Odoo a tags de Orama. Se configura desde soporte para cada empresa.
¿Envía Orama los movimientos bancarios a Odoo?
No. La integración es de solo lectura en dirección Odoo → Orama.
Relacionados
Conectar tu ERP
Cómo integrar tu software de gestión (Sage, A3 Innuva, Holded, Odoo) con Orama para importar facturas automáticamente.
Conciliar facturas
Configura en cada partida las reglas (NIF, nombre fiscal, palabras clave) para que las facturas de tu ERP o de Excel se asignen solas.
Listado de facturas
Consulta y gestiona las facturas importadas desde tu ERP o cargadas manualmente en Orama.
Holded
Conecta Holded con una API key y sincroniza facturas, compras y remesas cada dos horas.