Integración API Dolibarr: cómo conectarte, configurar y seguir las mejores prácticas

Dolibarr es un ERP y CRM de código abierto que usan pymes de toda Europa para gestionar facturación, clientes, productos y mucho más, todo desde una instancia autoalojada. Si tu software toca finanzas, facturación o facturación a clientes, conectarte a Dolibarr te da acceso a los datos que tus usuarios ya guardan ahí.

Integrar tu producto con la API de Dolibarr te permite:

• Sincronizar facturas y fichas de clientes en tus flujos contables o financieros
• Obtener cuentas por cobrar abiertas para impulsar funciones de tesorería, previsión o recobro
• Reducir la entrada manual de datos y mantener registros coherentes entre herramientas
• Atender a una amplia base de pymes que ejecutan su propia instancia de Dolibarr

Esta guía cubre la API de Dolibarr, cómo configurarla y las mejores prácticas a seguir, todo más sencillo con la API Unificada de Facturación de Chift.

¿Qué es la API de Dolibarr?

Dolibarr incluye una API REST nativa que convierte cualquier instancia en un proveedor de datos en cuanto se activa el módulo adecuado. Es una interfaz limpia y moderna para una herramienta que reúne facturación, CRM y ERP.

Esto es lo que necesitas saber:

• Tipo de API: REST, con cuerpos de solicitud y respuesta en formato JSON
• Verbos HTTP: GET, POST, PUT y DELETE para acceso completo de lectura y escritura
• Autenticación: una clave API que se envía en la cabecera DOLAPIKEY (también puede pasarse como parámetro de consulta api_key)
• URL base: la proporciona el cliente. Como Dolibarr es de código abierto y autoalojado, cada instancia tiene su propia dirección, con la forma https://<tu-servidor>/api/index.php/
• Explorador interactivo: cada instancia incluye un explorador Swagger en /api/index.php/explorer, para navegar las rutas disponibles en esa instalación concreta

Como Dolibarr es una API integrada dentro de un ERP/CRM, y cada cliente ejecuta su propia instancia, la URL base forma parte de la configuración de conexión, no es un endpoint fijo que puedas dejar fijo en el código.

Puedes explorar las rutas disponibles directamente en el explorador Swagger que incluye cada instancia de Dolibarr.

{{CTA-1}}

Ejemplos de casos de uso de la integración API Dolibarr

Integrarte con Dolibarr abre formas prácticas de mejorar tu producto y aportar valor a tus usuarios. Así es como los proveedores de software aprovechan los datos de Dolibarr a través de la API Unificada de Facturación de Chift.

Sincronizar facturas y clientes con el software contable

Plataformas contables como Inqom y MyUnisoft ya usan el conector de Dolibarr de Chift para obtener automáticamente facturas y fichas de clientes desde las instancias de Dolibarr de sus usuarios, manteniendo la contabilidad exacta y al día. Se acabaron los exports manuales caóticos: menos errores y mejor colaboración entre los empresarios y sus contables.

Seguimiento de facturas en tiempo real en portales de clientes

Muestra el historial de facturas y el estado de pago directamente en tu aplicación de cara al cliente. Dar a los usuarios acceso de autoservicio a sus documentos de facturación reduce las consultas de soporte y mejora la experiencia, sin tener que entrar en Dolibarr por separado.

Previsión de tesorería con datos de facturas abiertas

Las herramientas de gestión de tesorería pueden obtener las facturas pendientes desde Dolibarr para construir proyecciones precisas de cuentas por cobrar. Analizar los plazos y patrones de pago ayuda a tus usuarios a planificar y anticipar con confianza los movimientos de tesorería. Agicap, por ejemplo, usa las integraciones de facturación de Chift para este tipo de flujo de tesorería.

Automatizar el recobro con cuentas por cobrar abiertas

Las plataformas de recobro pueden conectarse a Dolibarr a través de Chift para obtener automáticamente las cuentas por cobrar abiertas y activar los flujos de cobro. Esto elimina el seguimiento manual y garantiza una actuación a tiempo sobre las facturas impagadas. Recovr, por ejemplo, se apoya en las integraciones de facturación de Chift para automatizar este tipo de recobro.

Para más ejemplos de cómo las integraciones de facturación pueden mejorar tu producto, explora nuestros casos de estudio de Chift.

Configurar tu integración API Dolibarr

Preparar una instancia de Dolibarr requiere unos pasos en el panel de administración y luego una configuración rápida de la conexión. Así funciona:

1. Activa el módulo API REST. En la administración de Dolibarr, ve a Configuración → Módulos y activa el módulo Web services (API REST). Una vez activo, la instancia se convierte automáticamente en proveedor REST.
2. Genera una clave API. Abre la ficha del usuario correspondiente (Ficha de usuario → Clave API) y genera la clave. Es el DOLAPIKEY que se usa para autenticar cada solicitud.
3. Configura la conexión. Se requieren dos campos:
   • url — la URL base de Dolibarr del cliente
   • token — el DOLAPIKEY generado
4. Autentica tus llamadas. Envía la clave en cada solicitud a través de la cabecera DOLAPIKEY:

python

  headers = {"DOLAPIKEY": token}

5. Gestiona las instancias multiempresa. Si el cliente usa una configuración multiempresa, activa la opción multicompany y elige el folder (entidad) correcto. La conexión enviará entonces una cabecera DOLAPIENTITY para acotar cada solicitud a esa entidad.

La API en sí es fácil de usar. Pero una integración lista para producción es más que unas cuantas llamadas: tendrás que proteger las credenciales, validar las URL autoalojadas, gestionar la paginación, acotar las solicitudes multiempresa y mantener la robustez frente a las múltiples versiones y configuraciones de módulos que usarán tus clientes. Ahí es donde se complica, y donde Chift te ayuda.

Mejores prácticas para la integración API Dolibarr

Para construir una integración fiable con Dolibarr, ten en cuenta estas recomendaciones:

• Guarda las credenciales de forma segura. El DOLAPIKEY es una clave de larga duración ligada a todos los permisos de un usuario. Guárdala en variables de entorno o en un almacén seguro, nunca en el código ni en los logs.
• Valida la URL base. Como el host lo proporciona el cliente y está autoalojado, normaliza y verifica la url, y exige HTTPS para que la clave nunca viaje en texto plano.
• Pagina los resultados. Usa page (indexado desde 0) y limit. Dolibarr limita las respuestas (un máximo implícito de alrededor de 100 registros), así que nunca supongas que una sola llamada lo devuelve todo.
• Acota siempre las solicitudes multiempresa. En instancias multiempresa, incluye la cabecera DOLAPIENTITY en cada llamada. Sin ella, las lecturas y escrituras pueden impactar en la entidad equivocada.
• Gestiona errores y diferencias de versión. Revisa con cuidado los códigos de estado HTTP. Los endpoints disponibles y el comportamiento varían según la versión de Dolibarr y los módulos activados del cliente: prepárate para la variabilidad en lugar de una configuración única.

FAQ API Dolibarr

¿Qué endpoints están disponibles en la API de Dolibarr?

El conector de Dolibarr de Chift expone un conjunto de endpoints estandarizados, incluyendo (sin limitarse a):

• Facturas /invoices
• Clientes / contactos /clients
• Productos y servicios /products
• Pagos /payments

Consulta nuestra documentación de la API de Dolibarr para ver la lista completa de rutas disponibles.

¿Cuál es el límite de peticiones de la API de Dolibarr?

Dolibarr no impone límites de peticiones a nivel de API. Como cada instancia está autoalojada, el rendimiento depende por completo de la configuración del servidor, PHP y servidor web del cliente, no de una cuota documentada por Dolibarr. Como buena práctica, evita escrituras paralelas excesivas, procesa las solicitudes de forma secuencial cuando sea posible y añade lógica de reintentos para que una instancia más lenta no rompa tu sincronización.

¿Dolibarr está en el cloud?

Dolibarr es autoalojado por defecto, en local o en la propia nube o VPS del cliente. Existe una opción SaaS gestionada (Dolibarr Cloud / Dolicloud), pero incluso así cada cliente ejecuta su propia instancia con su propia URL. Por eso la URL base siempre forma parte de la configuración de conexión.

Conéctate a Dolibarr, Odoo, Zoho Invoice y muchos más con una sola integración

Construir una conexión directa a Dolibarr lleva tiempo, esfuerzo y mantenimiento continuo, sobre todo cuando además necesitas dar soporte a otras herramientas de facturación y CRM, cada una con sus particularidades y sus configuraciones autoalojadas.

Con la API Unificada de Facturación de Chift, te conectas una sola vez y accedes a Dolibarr, Odoo, Zoho Invoice, Sellsy y muchos más a través de un modelo de datos coherente.

• Una sola integración para decenas de herramientas de facturación y CRM
• Soporte nativo para autenticación, paginación y gestión multi-tenant
• Datos unificados y estandarizados
• Sincronización en tiempo real y monitorización avanzada
• Una experiencia fluida para tus usuarios

Cuando la configuración de Dolibarr de un cliente cambia o hay que conectar una herramienta nueva, nosotros nos encargamos. Tu equipo entrega más rápido y tu producto escala sin la carga de las integraciones.

Reserva una demo →