Dolibarr es un ERP con CRM dentro, y eso cambia la pregunta
Dolibarr se instala en tu propio servidor o en el de un proveedor, y se compone de módulos que se activan según el negocio: terceros, presupuestos, pedidos, facturas, proyectos, stock. Mucha gente lo usa sin tocar la parte de oportunidades, y empieza y termina el ciclo con un presupuesto que se convierte en pedido y luego en factura. Cuando lo que queremos es saber qué anuncio ha traído a un cliente, no basta con preguntar «¿cuántos leads hay?», porque en tu Dolibarr quizá no se registra el lead como tal. La pregunta útil es otra: cuando nace un pedido o una factura de un tercero nuevo, ¿qué clic lo trajo?
Ahí entra el conector. Tiene en cuenta que Dolibarr es un sistema de gestión y mira el ciclo comercial como lo haces tú: un tercero, un documento que lo formaliza y, a partir de ahí, una venta que queremos contar solo una vez. La conversación sobre cuál de esos documentos marca la venta se tiene al principio, no al final.
Cómo se conecta: el módulo API REST y la clave de usuario
Según la documentación oficial de Dolibarr, el acceso por API requiere activar el módulo «API REST» desde la página de módulos; a partir de ese momento Dolibarr actúa también como servidor de servicios web. Las rutas cuelgan de /api/index.php/ y la propia instalación incluye un explorador en /api/index.php/explorer donde se ven los recursos disponibles. Para autenticarse se genera una clave de API en un usuario y se envía en la cabecera HTTP DOLAPIKEY. En instalaciones con varias entidades existe además la cabecera opcional DOLAPIENTITY. Con servidor web Nginx puede hacer falta una configuración adicional, que la documentación proporciona.
| Qué | Dirección | Para qué |
|---|---|---|
| Terceros (clientes) con su contacto | Dolibarr → Acelera Sales | Reconocer quién compra y relacionarlo con su formulario |
| Pedidos y facturas de cliente | Dolibarr → Acelera Sales | Detectar el documento que equivale a una venta y su importe |
| Venta con su importe | Acelera Sales → Meta (API de conversiones) | Que Meta optimice hacia compradores y no hacia formularios |
| Venta con el identificador de clic | Acelera Sales → Google Ads (conversión offline) | Conector listo; se activa en tu cuenta en la puesta en marcha |
La API admite parámetros de listado como limit, sortfield y sortorder, además de un parámetro sqlfilters para filtrar por columnas. La API acepta fechas en formato ISO (año-mes-día). El conector usa estos parámetros para pedir solo lo necesario en cada vuelta.
Lo que se verifica en tu instalación, no en una tabla genérica
Dolibarr es muy personalizable: los estados de un pedido o una factura, los campos extra y los módulos activos cambian de una empresa a otra. La documentación pública de la API enseña ejemplos de terceros, productos, pedidos y facturas, pero no lista los estados de cada documento; para eso remite al explorador y al código de la propia instalación. Por eso, antes de conectar, se revisa contigo qué valor de estado significa «validado», «facturado» o «pagado» en tu caso, y se anota en el mapa de la conexión. Si trabajas con el módulo de proyectos para llevar oportunidades, se mira también ahí qué campos usas. Lo que no se pueda comprobar en tu instalación, no se da por supuesto.
Pasos de la puesta en marcha
- Activar el módulo API REST en tu Dolibarr, si no lo está, y comprobar que el explorador responde desde fuera de tu red.
- Un usuario para la integración. Se crea con permisos de lectura sobre terceros, pedidos y facturas, y se genera su clave de API. Esa clave solo se comparte por un canal seguro.
- Qué documento cuenta como venta. Pedido validado, factura emitida o factura pagada: se elige uno, para no contar la misma compra dos veces.
- El origen del tercero. El píxel propio guarda el identificador de clic de quien rellena el formulario de tu web; se acuerda dónde se anota en Dolibarr para poder cruzarlo con el tercero.
- Cuadre inicial. Se leen las ventas ya cerradas y se comparan con un listado sacado de Dolibarr. Si no coinciden, se corrige antes de seguir.
- Prueba y alta. Se envían ventas de prueba a Meta y, solo cuando llegan bien, se activa la devolución real y la de Google.
Qué ves en los paneles
Delante de la venta de Dolibarr se coloca lo que Dolibarr no registra: visita, anuncio, formulario y alta del tercero. Detrás, el importe y la fecha del documento que acordamos. Cada venta aparece asociada a su campaña, conjunto de anuncios y anuncio, con coste por venta e ingresos por campaña. Si tu ciclo es largo, se ve cuánto tarda una campaña en convertirse en facturas. Para conocer el conjunto, paneles y alertas.
Qué se devuelve a Meta y a Google, y cuándo no se puede
A Meta la venta llega por la API de conversiones, con los datos personales con hash SHA-256 (la guía de la API de conversiones de Meta explica el mecanismo y la de conversiones offline de Meta desde tu CRM el caso de ventas cerradas lejos del navegador). A Google se envía como conversión offline junto con el identificador de clic, tal como describen las conversiones offline de Google Ads. Un límite que conviene decir claro: si el tercero se creó a mano, sin pasar por un formulario de tu web, la venta aparece en el panel pero no hay clic que devolver. Lo marca el dato de origen, no Dolibarr.
Siguiente paso
Si tu empresa gestiona clientes, pedidos y facturas en Dolibarr y quieres cruzarlo con tus campañas, reserva una demo. Para decidir a qué clic se atribuye cada venta, la guía de modelos de atribución ayuda a elegir.
Preguntas frecuentes
¿Dolibarr tiene que estar en la nube para conectarlo?
No. Basta con que la API REST sea accesible desde el conector, ya sea en un servidor propio o contratado. Se revisa en la puesta en marcha.
¿Qué cabecera usa la autenticación?
La clave de API del usuario va en la cabecera DOLAPIKEY. Si tienes varias entidades, se añade DOLAPIENTITY.
¿Puedo ver qué recursos expone mi instalación?
Sí: Dolibarr incluye un explorador de la API en su propia ruta. Es lo primero que se mira para ver qué está activo en tu caso.
¿Se lee un presupuesto como venta?
No por defecto. Un presupuesto es una oferta; lo que se cuenta es el documento que acordemos, normalmente un pedido o una factura.
¿Y si no uso la parte de oportunidades?
No hace falta. Si tu ciclo es presupuesto, pedido y factura, el conector parte del documento de venta y no de la oportunidad.
¿Escribe el conector en mi Dolibarr?
No. Solo lee. Un usuario con permisos de lectura es suficiente, y cualquier escritura se acordaría aparte.
¿Y si hay devoluciones o abonos?
Se decide en el mapa de la conexión cómo tratarlos, para que una venta anulada no siga contando en las campañas.