Sincronización fiable y trazable entre Dolibarr ERP/CRM y WordPress/WooCommerce

DoliCommerce Bridge: conecte Dolibarr ERP/CRM con WooCommerce y deje de introducir los datos dos veces

¿Vende en WooCommerce y gestiona su empresa en Dolibarr? Entonces conoce el problema: copiar pedidos a mano, actualizar el stock y los precios en dos sitios o depender de un script frágil que nadie se atreve a tocar. DoliCommerce Bridge sustituye todo eso por un motor de sincronización estructurado, trazable y configurable que funciona íntegramente dentro de Dolibarr.

Presentación del módulo

DoliCommerce Bridge 1.0, publicado por NextGestion, convierte Dolibarr en el back-office central de una o varias tiendas WordPress/WooCommerce. Terceros, contactos, productos, variaciones, categorías, atributos, imágenes, stock, precios, pedidos, facturas, pagos, abonos, envíos y seguimiento de paquetes circulan entre ambos sistemas según las reglas que usted define, familia por familia y tienda por tienda.

El módulo se comunica con WooCommerce mediante la API REST oficial v3 (wc/v3), con WordPress mediante la API wp/v2 y recibe los webhooks firmados de WooCommerce. No es necesario instalar ningún plugin en WordPress y no se modifica ningún archivo del núcleo de Dolibarr, WordPress ni WooCommerce: sus actualizaciones siguen siendo libres.

Su principio rector es sencillo: ningún dato se pierde en silencio. Cada dato se mapea, se conserva como metadato, se registra en el log o se convierte en un conflicto que una persona valida.

Ventajas clave

• Adiós a la doble introducción de datos. Los pedidos WooCommerce llegan a Dolibarr con sus líneas, impuestos, gastos de envío, factura y pago según sus reglas.
• Venda solo lo que tiene. Los movimientos de stock de Dolibarr se publican en la tienda en pocos minutos, con stock de seguridad si lo necesita.
• Contabilidad limpia. Claves de idempotencia contra los duplicados, verificación de importes contra las diferencias silenciosas y reembolsos convertidos en abonos.
• Usted decide quién manda. Sentido de sincronización y fuente de verdad por familia y por campo.
• Resistente a los incidentes reales. Tienda caída, credenciales caducadas, webhook perdido o CRON detenido: los trabajos esperan, se reintentan o pasan a una cola de fallidos que puede corregir y relanzar.
• Visibilidad total. Panel, métricas de salud, identificadores de correlación en los registros, diagnóstico e informes por tienda.
• Multitienda. Un solo Dolibarr y tantas tiendas WooCommerce como necesite, cada una con su configuración.
• Puesta en producción segura. El asistente termina con una simulación que muestra exactamente qué se crearía, actualizaría o pasaría a conflicto.

Funcionalidades detalladas

Clientes y terceros

• Clientes WooCommerce sincronizados con los terceros de Dolibarr, con contactos de facturación y de envío.
• Deduplicación por identificador remoto, e-mail, referencia y NIF-IVA; las coincidencias ambiguas nunca se seleccionan automáticamente.
• Pedidos de invitados: un tercero por e-mail (clave hash) o un tercero genérico.
• Detección B2B cuando el campo empresa está informado; mapeo de roles WordPress a tipo de tercero, grupo, nivel de precios y categoría.

Catálogo y variaciones

• Productos simples, servicios (como productos virtuales), productos variables y variaciones (módulo Variantes o modo «productos separados»).
• Árbol de categorías, etiquetas (como categorías Dolibarr bajo «WooCommerce Tags»), atributos globales y términos.
• Imagen principal, galería e imágenes de variación con hash SHA-256 para evitar reenvíos, y descarga segura en la importación.
• Peso y dimensiones con conversión automática de unidades; códigos de barras EAN/GTIN (WooCommerce 9.2 o superior).
• Productos agrupados, externos, descargables, upsell y cross-sell conservados en los metadatos de mapeo.
• Tratamiento configurable de los productos eliminados: nunca se borra nada automáticamente en Dolibarr.

Stock multialmacén y precios

• Envío del stock según el modo de almacén: almacén único, suma de almacenes o cálculo personalizado (coeficiente y stock de seguridad).
• La importación de stock genera un auténtico movimiento de stock en Dolibarr.
• Precios regulares con base sin impuestos o con impuestos incluidos según el ajuste de WooCommerce; nivel de precios definido por conexión.
• Precios de oferta mediante el campo adicional dcb_sale_price o un nivel de precios dedicado; precios por rol a través de un adaptador para plugin B2B detectado.

Pedidos, facturas, pagos y reembolsos

• Importación de pedidos por webhook más un delta cada 5 minutos, con filtro por estado y mapeo de estados en ambos sentidos.
• Creación automática de facturas según el disparador elegido: creación, pago, en proceso, completado, enviado o nunca.
• Pagos derivados del pedido (fecha de pago, identificador de transacción, pasarela asociada a un modo de pago y una cuenta bancaria).
• Reembolsos totales o parciales (cantidades, envío, cargos, impuestos, motivo) convertidos en abonos, con reintegración de stock opcional.
• Moneda e importes originales conservados, aplicando el tipo de cambio multidivisa de Dolibarr.
• Comparación de totales (tolerancia de 0,02 por defecto): cualquier diferencia abre un conflicto financiero y una alerta. Los reembolsos bancarios reales nunca se lanzan automáticamente.

Envíos y seguimiento

• La validación o el cierre de una expedición en Dolibarr completa el pedido WooCommerce cuando todo está enviado.
• Número de seguimiento enviado a Shipment Tracking, Advanced Shipment Tracking o, en su defecto, a un metadato genérico con nota de pedido.
• Mapeo de métodos de envío por instancia de zona hacia los modos de envío de Dolibarr.

Impuestos y cupones

• Tipos y clases de impuestos WooCommerce importados como sugerencias de mapeo hacia los tipos de IVA de Dolibarr (con impuestos locales y compuestos).
• Cupones aplicados convertidos en descuentos de línea con nota; definiciones de cupones conservadas en una tabla espejo.

Correspondencias y fuentes de verdad

• Para cada familia: Dolibarr maestro, WooCommerce maestro, bidireccional, manual o desactivado, con frecuencia propia y botón de pausa.
• Por campo: Dolibarr, WooCommerce, el más reciente o siempre manual. Por defecto, Dolibarr manda en catálogo, stock y precios, y WooCommerce en clientes y pedidos.
• Motor de mapeo editable (estados, impuestos, pagos, envíos, almacenes, campos, roles) y Field Mapping Builder para vincular campos adicionales de Dolibarr con meta_data de WooCommerce.
• Motor de reglas del tipo SI condiciones ENTONCES acciones.

Centro de conflictos

Cuando ambos lados modifican el mismo objeto, una fusión a tres vías por campo compara cada valor con la última instantánea sincronizada. Lo que no puede decidirse automáticamente llega al Centro de conflictos, donde un usuario autorizado conserva el valor de Dolibarr, conserva el de WooCommerce o ignora la diferencia.

Cola, reintentos, webhooks y CRON

• Cada cambio (trigger de Dolibarr, webhook firmado, delta programado o clic en la interfaz) se convierte en un trabajo de una cola persistente con prioridades y fusión de trabajos.
• Un worker ejecutado por las tareas programadas de Dolibarr cada minuto: ninguna llamada remota ralentiza el guardado de un registro ni la recepción de un webhook.
• Reintentos con retroceso exponencial, limitador de caudal, disyuntor por conexión, recuperación de trabajos bloqueados y cola de fallidos con edición y relanzamiento.
• Cinco barreras antibucle y operaciones financieras exactamente una vez.
• Webhooks registrados y reparados automáticamente, deduplicados por Delivery-ID; reconciliación nocturna de objetos ausentes, mapeos rotos y diferencias de stock, precios e importes.

Panel, registros, diagnóstico e informes

• Panel de sincronización con métricas de salud y notificaciones.
• Registros detallados con identificador de correlación y enmascaramiento de datos personales.
• Página de diagnóstico con quince grupos de comprobaciones.
• Informes multitienda con exportaciones y sincronización masiva.
• Pestaña «WordPress / WooCommerce» en las fichas de producto, tercero, pedido y factura, con botón «Sincronizar ahora».

Asistente de primera sincronización y simulación

Un asistente de 14 pasos guía la puesta en marcha: conexión y detección de capacidades de la tienda, sentidos y fuentes de verdad, mapeos de estados, impuestos, pagos y envíos, almacenes, filtros y reglas, y emparejamiento de los datos existentes. La simulación (dry-run) no escribe nada, ni en Dolibarr, ni en WooCommerce, ni en las tablas de mapeo, e indica para cada objeto si se crearía, actualizaría, quedaría igual, entraría en conflicto o se omitiría.

Multitienda

Conecte una entidad Dolibarr (compatible multiempresa) con un número ilimitado de tiendas WooCommerce. Cada conexión tiene sus credenciales, alcance del catálogo, almacenes, moneda, idioma, nivel de precios, mapeos, reglas, cola, registros, webhooks y planificación, y puede estar Activa, En pausa o Desactivada sin perder trabajos.

Seguridad y RGPD

• Autenticación HTTP Basic sobre HTTPS, claves en la URL (HTTPS) u OAuth 1.0a; contraseña de aplicación WordPress para los medios.
• Secretos cifrados con AES-256-GCM, enmascarados en pantalla y nunca registrados en los logs.
• Webhooks verificados por HMAC-SHA256, controles CSRF y de permisos.
• Datos personales enmascarados en los registros, purga de logs a los 90 días y de trabajos terminados a los 14 días, clientes invitados agrupados por e-mail con hash.

Resumen de sincronizaciones

Todos los sentidos son configurables por familia y por conexión.

Requisitos

• Dolibarr 17.0 o superior.
• PHP 7.4 a 8.4 con las extensiones curl, json, openssl y mbstring.
• MySQL o MariaDB.
• WordPress con WooCommerce y su API REST v3; HTTPS muy recomendado.
• WordPress 5.6 o superior para las contraseñas de aplicación; WooCommerce 9.2 o superior para los GTIN nativos.
• Una clave API WooCommerce de lectura/escritura cuyo propietario sea gestor de tienda o administrador.
• Módulos Dolibarr Terceros y Productos y, según su uso, Stock, Pedidos, Facturas, Expediciones, Variantes, Multidivisa, Categorías y Bancos, además de Tareas programadas (obligatorio) con un crontab del sistema cada minuto.

Instalación

1. Despliegue el archivo del módulo desde Inicio, Configuración, Módulos, Desplegar módulo externo (o descomprímalo en htdocs/custom/).
2. Active DoliCommerce Bridge, el módulo Tareas programadas y los módulos Dolibarr necesarios.
3. Asigne los permisos del módulo a los usuarios correspondientes.
4. Añada la línea de crontab del sistema que ejecuta las tareas programadas de Dolibarr cada minuto.
5. En WooCommerce, cree una clave API de lectura/escritura y, si necesita subir imágenes, una contraseña de aplicación WordPress.
6. Abra el menú Commerce Sync, lance el asistente, pruebe la conexión y siga los pasos.
7. Ejecute la simulación, revise el informe y pase a producción: el asistente encola la carga inicial, registra los webhooks y activa la conexión.

Compatibilidad: información transparente

La versión 1.0 está cubierta por una batería de pruebas automatizadas ejecutada en PHP 8.3 con SQLite, dobles en memoria de Dolibarr y WooCommerce y un transporte HTTP simulado. Hasta la fecha no se ha realizado ninguna prueba en una instalación real de Dolibarr, WordPress o WooCommerce.

• Diseñado para Dolibarr 17 a 22, PHP 7.4 a 8.4 y MySQL/MariaDB (no probado en instancias reales). Dolibarr anterior a 17: no compatible.
• WooCommerce 8.x/9.x mediante API REST v3, con o sin HPOS, y WordPress multisitio: probablemente compatibles gracias a las API estándar. API heredadas v1/v2: no compatibles.
• Shipment Tracking, Advanced Shipment Tracking, Yoast SEO, Rank Math, WPML, Polylang y plugins de facturas PDF o precios B2B: adaptadores por detección, no probados.
• PrestaShop, Shopify, Magento y otras plataformas: no compatibles en la versión 1.0.

Recomendamos encarecidamente validar el módulo en una copia de preproducción antes de conectarlo a su tienda en producción.

Idiomas de la interfaz

Francés, inglés, español, alemán e italiano.

Contenido del paquete

• El módulo DoliCommerce Bridge 1.0 listo para desplegar en Dolibarr (licencia GPL v3 o posterior).
• Documentación de usuario y documentación técnica (arquitectura, esquema de base de datos, matriz de sincronización, compatibilidad).
• Manual de formación.

Preguntas frecuentes

¿Tengo que instalar un plugin en WordPress?

No. El módulo utiliza la API REST v3 de WooCommerce, la API REST de WordPress y los webhooks de WooCommerce. Solo necesita crear una clave API y, para las imágenes, una contraseña de aplicación.

¿La sincronización es en tiempo real?

Casi en tiempo real. Webhooks y triggers encolan los trabajos al instante y el worker se ejecuta cada minuto. Los deltas programados (5 minutos para pedidos y 10 para stock por defecto) recuperan lo que un webhook no haya entregado.

¿Puedo conectar varias tiendas a un mismo Dolibarr?

Sí, sin límite. Cada conexión tiene su propia configuración, cola, registros y webhooks.

¿Un webhook repetido puede duplicar una factura o un pago?

No. Pedidos, facturas, pagos, reembolsos, abonos y expediciones usan claves de idempotencia y las entregas de webhooks se deduplican por su Delivery-ID.

¿Qué ocurre si el total de Dolibarr no coincide con el de WooCommerce?

Por encima de la tolerancia (0,02 por defecto) se crea un conflicto financiero y una alerta. Nunca se valida en silencio un importe discordante.

¿Cómo se gestiona el stock con varios almacenes?

WooCommerce tiene un único stock por producto: usted elige un almacén, la suma de almacenes o un cálculo personalizado con coeficientes y stock de seguridad.

¿Qué pasa si mi tienda cae o mi clave API caduca?

Los errores de red y 5xx se reintentan con retroceso exponencial y el disyuntor pausa las llamadas a esa tienda. Las credenciales no válidas envían los trabajos a la cola de fallidos con una alerta crítica.

¿Puedo probar antes de pasar a producción?

Sí. La simulación del asistente no escribe nada. Además, recomendamos una prueba completa en una copia de preproducción.

Soporte NextGestion

DoliCommerce Bridge es un módulo desarrollado y mantenido por NextGestion, editor especializado en módulos para Dolibarr ERP/CRM. Para cualquier pregunta, asistencia o solicitud de información, visite www.nextgestion.com.

Demo del módulo DoliCommerce Bridge (WordPress / WooCommerce)
Usuario : demo
Contraseña : demo