Holded
Orama se conecta a Holded con una API key (API v2) y descarga facturas de venta, compras, abonos, pagos y remesas cada 2 horas para crear previsiones.
Orama se conecta a Holded con una API key y descarga tus facturas de venta, compras, abonos, pagos y remesas cada dos horas. Cada documento se convierte en una previsión de cobro o pago con su vencimiento, y se cierra sola cuando el movimiento llega al banco.
La conexión usa la API v2 de Holded y es de solo lectura: Orama no crea ni modifica nada en tu cuenta de Holded.
Qué importa y cada cuánto
| Dato | Detalle | Frecuencia |
|---|---|---|
| Facturas de venta | Con vencimientos múltiples si los hay | Cada 2 h, L–V, 9:00–23:00 |
| Facturas de compra | Incluidas las devoluciones de compra | Cada 2 h, L–V, 9:00–23:00 |
| Abonos (notas de crédito) | Restan de la previsión | Con las facturas |
| Pagos registrados en Holded | Marcan la previsión como cobrada/pagada | Con las facturas |
| Remesas | Agrupaciones de recibos | Cada 2 h, L–V, 9:00–23:00 |
| PDF de la factura | Bajo demanda | Al abrir la factura |
Orama trabaja de forma incremental: en cada pasada lee los documentos creados o modificados desde la última factura conocida (con dos días de margen), de modo que una factura editada en Holded se actualiza también en Orama.
Cómo conectarlo
Crea la API key en Holded
En Holded ve a Configuración → Desarrolladores → API keys y pulsa Nueva API key. Ponle un nombre reconocible ("Orama") y copia la clave.
Abre la integración en Orama
En Orama, Integraciones → Holded → Conectar. Deja seleccionada la versión v2 de la API.
Pega la API key y guarda
Orama valida la clave y lanza la primera importación. En unos minutos verás las facturas en Listados → Facturas y las previsiones en el cuadro de tesorería.
Cómo se convierten las facturas en previsiones
Cada factura cae en una partida según las reglas de conciliación de facturas de esa partida. Para clientes y proveedores concretos usa el NIF como palabra obligatoria: es el dato más fiable que trae Holded. Las facturas con varios vencimientos generan una previsión por vencimiento.
Cuando Holded registra un pago sobre la factura, Orama marca la previsión como cobrada o pagada aunque el movimiento bancario tarde en aparecer; al llegar, se concilian.
Errores frecuentes y solución
| Mensaje o síntoma | Causa | Solución |
|---|---|---|
| "API key no válida" | Clave copiada con espacios o revocada en Holded | Genera una clave nueva y pégala sin espacios |
| Solo llegan facturas de venta | La clave no tiene alcance sobre compras | Crea la clave desde un usuario administrador de Holded |
| Importes en otra divisa | Facturas emitidas en moneda distinta al euro | Orama convierte al tipo de cambio de la factura; revisa la columna "Importe en divisa original" en Listados |
| Faltan facturas antiguas | La primera carga trae los últimos dos meses | Pulsa Actualizar con carga completa o importa el histórico por Excel |
| Error 429 / "demasiadas peticiones" | Límite de la API de Holded | Orama reintenta solo; si persiste varias horas, contacta con soporte |
Preguntas frecuentes
¿Qué importa Orama desde Holded?
Facturas de venta, facturas de compra, abonos, el estado de pago de cada documento (con sus pagos registrados) y las remesas. Es una conexión de solo lectura.
¿Dónde se crea la API key de Holded?
En Holded: Configuración → Desarrolladores → API keys → Nueva API key. Copia la clave y pégala en la integración de Holded en Orama.
¿Qué diferencia hay entre la API v1 y la v2 de Holded en Orama?
La v2 es la versión por defecto para conexiones nuevas: filtra por fechas de forma fiable, pagina por cursor y trae el detalle completo de cada factura (vencimientos múltiples, pagos, campos personalizados). La v1 se mantiene para conexiones antiguas.
¿Puedo tener Holded y el banco conectados a la vez?
Sí, es lo habitual: Holded aporta las facturas (lo previsto) y el banco los movimientos (lo real). Orama concilia ambos.
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.
Odoo
Conecta Odoo con una API key y sincroniza facturas, abonos y remesas cada dos horas.