API de Dolibarr: conecta tu web, CRM o app sin copiar datos

Dolibarr se puede leer y escribir desde fuera con su API REST. Eso significa que tu tienda, tu CRM o una app propia pueden consultar y actualizar clientes, pedidos o facturas sin que nadie copie datos a mano. Tú envías la petición, Dolibarr responde; lo único que hay que hacer bien es montar esa conexión.

Qué es la API REST de Dolibarr y qué puedes hacer con ella

Una API (interfaz de programación de aplicaciones) es la puerta que un programa abre para que otros programas hablen con él. La de Dolibarr es una API REST: funciona sobre HTTP, el mismo protocolo de las páginas web, y trabaja con recursos identificados por una URL y métodos estándar (GET para consultar, POST para crear, PUT para actualizar). Las respuestas llegan en JSON, un formato de texto fácil de procesar.

En la práctica, puedes hacer dos cosas:

• Leer. Consultar clientes, productos, existencias o facturas desde otra herramienta.
• Escribir. Crear o actualizar esos datos desde fuera; por ejemplo, registrar en Dolibarr el pedido que acaba de entrar en tu web.

Si hoy exportas un CSV y lo reimportas en el otro sistema, ese paso puede desaparecer.

Casos típicos: dónde se nota de verdad

• Tienda online. El pedido entra en la web y aterriza en Dolibarr como pedido o factura, con su cliente y sus líneas. Y al contrario: Dolibarr manda stock y precios a la tienda. Si te planteas poner un ERP detrás de tu WooCommerce, esta checklist te ayuda a prepararte: ¿Tu tienda está lista para un ERP?
• CRM. Tu equipo comercial trabaja en el CRM, pero necesita los mismos clientes y facturas que hay en Dolibarr. Con la API, los consulta sin exportaciones semanales y devuelve los cambios de estado al ERP.
• App propia del equipo. Una aplicación interna para técnicos o comerciales en ruta puede leer sus pedidos y escribir avances en Dolibarr.
• Proveedores y mayoristas. Recibes listados de referencias y precios, y los vuelcas en Dolibarr de forma programada.
• Automatizaciones. Avisos de stock bajo, informes nocturnos, altas repetitivas… tareas que hoy hace una persona «porque se tarda un momento».

La API que trae Dolibarr de serie

El núcleo de Dolibarr incluye un módulo de Web Services que expone una API REST. No viene activo: hay que habilitarlo desde la página de módulos. Cada usuario tiene su token de acceso, y las peticiones van a rutas bajo /api/index.php/. La wiki de Dolibarr lo explica en detalle.

Para una conexión puntual puede bastar. Cuando la integración crece (varios sistemas, escrituras que no deben duplicarse, permisos por usuario), la API del núcleo puede quedarse corta.

Qué añade un módulo como EasyAPI

Ese hueco lo cubre el módulo EasyAPI, de EasySoft Tech S.L. Es una API REST profesional para Dolibarr que cubre 32 dominios del core (ventas, compras, stock, proyectos, contabilidad, RRHH y más), con estas piezas:

• Filtros, paginación, ordenación y selección de campos en todos los dominios.
• Operaciones masivas (bulk) con resultado por elemento: respuesta 207 Multi-Status y hasta 100 elementos por lote.
• Permisos nativos de Dolibarr y ACL por registro: cada petición respeta lo que ese usuario puede ver y tocar.
• Idempotencia en todas las escrituras con Idempotency-Key: si un reintento llega dos veces, no se duplica nada.
• Validación de datos con errores por campo, para saber qué corregir.
• Sesión por cookie HTTP-only con JWT y revocación, para frontales web que no exponen la clave.
• Rate limiting configurable y ETag/If-Match para regular el ritmo y los cambios simultáneos.
• Documentación OpenAPI con Swagger UI y Redoc embebidos, para probar sin salir de tu instalación.
• Servidor MCP para conectar agentes de IA como Claude o Cursor, con las mismas ACL.

El detalle está en la ficha del módulo EasyAPI.

Cómo empezar una integración, paso a paso

1. Define qué datos viajan y en qué dirección. ¿Solo lectura o bidireccional? Empieza por lo mínimo que te quite trabajo.
2. Decide quién manda sobre cada dato. Si el stock lo lleva Dolibarr, que nadie más lo sobrescriba. Así evitas contradicciones.
3. Crea un usuario específico para la integración, con los permisos que necesita y no más. No uses tu cuenta de administrador.
4. Activa el módulo de Web Services en Dolibarr y prueba con datos de ejemplo antes de tocar los reales.
5. Automatiza y deja rastro. Programa la sincronización y guarda registros: cuando algo falle, querrás saber qué petición y con qué dato.

Si prefieres no montarlo tú, EasySoft Tech S.L. también hace integraciones a medida: APIs REST y SOAP, webhooks (avisos automáticos de un sistema a otro), sincronización bidireccional y monitorización. Está todo en servicios de integraciones.

Errores y consejos

• No escribas en la base de datos a mano. Ir directo a las tablas saltándose la API rompe validaciones, permisos y lógica interna. Es el atajo más caro.
• Cuida los permisos. Lo que un usuario no puede hacer en Dolibarr no debería poder hacerlo su token. Revisa los roles antes de conectar.
• Valida antes de enviar. Un email mal formado o un NIF incompleto harán fallar la importación. Mira el error por campo y corrígelo en origen.
• Piensa en los reintentos. Si la conexión se cae a mitad, tu integración volverá a intentarlo. Con escrituras idempotentes, repetir una petición no duplica nada.
• Haz copia de seguridad antes de la primera sincronización real y prueba con lotes pequeños antes de mover miles de registros.

Preguntas frecuentes

¿Puedo conectar mi tienda online con Dolibarr?

Sí. Es uno de los casos más habituales, y en el blog tienes un ejemplo real de sincronización entre WooCommerce y Dolibarr.

¿Necesito programar para usar la API?

Para las primeras consultas, no: el módulo EasyAPI incluye documentación interactiva para lanzar peticiones y ver respuestas. Una integración completa y automatizada sí necesita algo de desarrollo, propio o contratado.

¿Qué pasa si algo falla a mitad de una sincronización?

Depende del diseño. Si las escrituras son idempotentes, puedes reintentar sin miedo a duplicar. Si no, toca repasar qué se quedó a medias.

¿Es peligroso abrir la API de mi ERP?

No tiene por qué. Cada petición se autentica y se ejecuta con los permisos de su usuario. Con un usuario acotado y un módulo que respete las ACL, tienes el control.

¿Conectamos tus herramientas?

Cuéntanos qué usas hoy y qué te gustaría que hablara con Dolibarr. Te diremos qué se puede hacer y por dónde empezar.

Hablar con un experto