Esta guía le lleva de cero a una tienda Shopify conectada a Dolibarr, con una licencia activa y las sincronizaciones configuradas. Corresponde a Doli2Shop 2.6.3 y a las versiones posteriores. Calcule una hora, diez minutos de ella en Shopify. Las capturas muestran una tienda de demostración ficticia: los nombres, dominios y números que verá en su sistema serán los suyos.

Los pasos, en orden:

  1. los requisitos previos;
  2. la instalación del paquete y la activación del módulo;
  3. la conexión de la tienda Shopify;
  4. la licencia;
  5. el asistente de configuración;
  6. el sentido de la sincronización;
  7. el stock (real o virtual) y la ubicación de Shopify;
  8. las tareas programadas;
  9. las comprobaciones finales;
  10. qué ocurre cuando termina la licencia.

1. Requisitos previos

Elemento Requisito
Dolibarr versión 18 a 24
PHP 7.4 como mínimo. El límite superior depende de su Dolibarr: PHP 8.1 como máximo con Dolibarr 18, PHP 8.5 como máximo con Dolibarr 23 y 24
Base de datos MySQL 5.7 o superior, o MariaDB 10.3 o superior
Dirección de Dolibarr en HTTPS (obligatorio: Shopify se niega a devolver la conexión a una dirección HTTP)
Cuenta de Dolibarr una cuenta de administrador: las pantallas del módulo le están reservadas
Shopify una tienda y una cuenta autorizada a instalar una aplicación en ella
Planificador el módulo de Dolibarr «Tareas programadas» activo, con su disparador del sistema configurado (véase la sección 8)

Doli2Shop se apoya en los módulos de Dolibarr Productos, Terceros, Pedidos de clientes, Stock y Categorías: Dolibarr los activa con él si aún no lo están.

2. Instalar el paquete y activar el módulo

Ha recibido un archivo .zip (correo de confirmación de DoliStore). Hay dos formas de instalarlo.

Desde Dolibarr. Vaya a Inicio → Configuración → Módulos, abra la pestaña Instalar módulo externo y suelte el archivo .zip. Si Dolibarr lo rechaza (instalación desde la aplicación bloqueada o carpeta custom no declarada), use la segunda forma.

A mano. Descomprima el archivo en la carpeta htdocs/custom/ de su servidor: debe obtener htdocs/custom/doli2shop/. El archivo conf/conf.php de Dolibarr debe declarar esta carpeta:

$dolibarr_main_url_root_alt='/custom';
$dolibarr_main_document_root_alt='/ruta/a/htdocs/custom';

Después active el módulo:

  1. Vuelva a Inicio → Configuración → Módulos.
  2. Escriba doli2shop en el campo de búsqueda.
  3. En la ficha del módulo, ponga el interruptor en «activo».
  4. Haga clic en el icono de engranaje de la ficha para abrir la configuración.

El módulo no tiene entrada en el menú izquierdo de Dolibarr: el engranaje de esta lista es siempre su puerta de entrada. Llega a una barra de pestañas; la primera es Asistente.

3. Conectar la tienda Shopify

Puede conectar la tienda de dos formas que llevan al mismo resultado: desde la pestaña Asistente (paso 1) o desde la pestaña Tiendas.

Asistente, paso 1, antes de la conexión

Antes de la conexión, el paso 1 muestra No conectado y el botón Conectar mi tienda Shopify. En la pestaña Tiendas, el botón equivalente se llama Conectar una tienda (vía Shopify).

Lista de tiendas, una tienda conectada

  1. Haga clic en el botón. Si su Dolibarr no está en HTTPS, el módulo se niega y lo dice: corrija la dirección ($dolibarr_main_url_root en conf/conf.php) antes de volver a intentarlo.
  2. Sale de Dolibarr hacia una página de doli2shop.ptitetete.org que anuncia cuatro pasos. Haga clic en «Instalar Doli2Shop».
  3. En Shopify: inicie sesión en su cuenta, elija la tienda si tiene varias, lea los permisos solicitados y apruébelos. Shopify muestra él mismo estos permisos; compruebe que la dirección del navegador es realmente la de Shopify antes de aprobar. La aplicación también se presenta en https://apps.shopify.com/doli2shop.
  4. Shopify le devuelve automáticamente a Dolibarr. El módulo guarda las credenciales de la tienda, detecta su ubicación de stock y registra los webhooks (las notificaciones que Shopify envía a Dolibarr). Un mensaje «¡Conectado exitosamente a su-tienda.myshopify.com!» lo confirma.

Para comprobarlo: en la pestaña Tiendas, la tienda aparece con su dominio de Shopify; en el asistente, el paso 1 muestra Conectado a seguido del dominio, con la fecha de conexión y el identificador de la ubicación. Para reconectar una tienda (token caducado, permisos cambiados), use el botón de reconexión de la misma fila o del paso 1: la configuración ya realizada se conserva.

4. Activar la licencia

La licencia se gestiona tienda por tienda.

Ficha de la tienda, subpestaña Licencia

  1. En la pestaña Tiendas, haga clic en Editar en la fila de la tienda y después en la subpestaña Licencia.
  2. En Activar una licencia DoliStore, introduzca su número de serie, con el formato SI-YYYY-XXXX-XXXX (el del correo de confirmación de DoliStore; las letras se convierten automáticamente en mayúsculas) y haga clic en Activar esta licencia. El módulo necesita el dominio Shopify de la tienda: una tienda que aún no está conectada (sección 3) no puede recibir una licencia.
  3. El mensaje «Licencia DoliStore activada correctamente» confirma la activación y Estado de licencia pasa a Licencia válida.
  4. En cualquier momento, Verificar ahora consulta el servidor de licencias y actualiza el estado y la fecha de la última verificación.

Conviene saber:

  • Prueba. Una prueba es un número de serie SI-… de corta duración, emitido por el mantenedor: se activa exactamente como una licencia normal y termina como ella (sección 10).
  • Tienda predeterminada. La primera tienda conectada es la tienda predeterminada. Mientras el servidor de licencias no anuncie una fecha de parada, no se bloquea: la pantalla Salud la muestra como Exenta (tienda predeterminada) y esta subpestaña lleva la mención nunca bloqueada. Lea esa mención junto con la sección 10: una vez superada la fecha de parada anunciada por el servidor, la tienda predeterminada se detiene como las demás.
  • Edición Community. La edición Community, gratuita y publicada bajo licencia libre, no contiene ningún sistema de licencias: funciona sin clave, la pantalla Salud muestra Edición Community (gratuita) y el soporte técnico está reservado a los socios.
  • Servidor de licencias inaccesible. El módulo muestra No se ha podido verificar su licencia en este momento y lo reintenta solo. Para la tienda predeterminada, la sincronización continúa mientras la última verificación correcta tenga menos de 14 días (plazo por defecto); pasado ese plazo, se detiene hasta que el servidor vuelva. Una tienda secundaria solo se sincroniza cuando se ha podido verificar su licencia: una caída prolongada del servidor la pone en pausa y se reanuda sola después.
  • Nunca verificada. Una tienda predeterminada cuya licencia nunca se ha podido verificar correctamente no se bloquea, aunque el servidor siga inaccesible.

5. El asistente de configuración

La pestaña Asistente tiene seis pasos. Recuerda el paso en que se quedó, y un botón permite empezar de nuevo.

Paso Título Qué se configura
1 Conexion Shopify la conexión descrita en la sección 3
2 Configuracion Dolibarr Almacen por defecto y Usuario CRON / Webhook (obligatorios), luego Categoría clientes Shopify y Mapeo tipo de tercero B2B/B2C
3 Pedidos el prefijo de los pedidos, el plazo de entrega, Origen del pedido, Condiciones de pago, la cuenta bancaria para los pagos y los tratamientos automáticos (albaranes, facturas, pagos)
4 Envio Mapeo de métodos de envío, por tienda
5 Pago Mapeo de métodos de pago, por tienda
6 Activacion el control final, la activación de los webhooks y de las tareas programadas

Puntos de atención:

  • En el paso 2, el almacén es indispensable: sin almacén por defecto, el stock no se descuenta cuando llega un pedido de Shopify, y nada se lo indica. Estos ajustes son comunes a todas las tiendas; solo se modifican desde la tienda predeterminada.
  • En los pasos 4 y 5, las correspondencias son propias de cada tienda. Si tiene varias, elija primero la tienda en el selector Configurar tienda y después configure sus correspondencias.
  • En el paso 6, el módulo comprueba la conexión, el almacén y el usuario, y muestra Webhooks registrados y CRONs activos. Los botones Activar webhooks y Activar CRONs corrigen un contador incompleto; Finalizar la configuracion cierra el asistente señalando lo que aún falta.

6. El sentido de la sincronización

La pestaña Direcciones de sincronización decide, tipo de dato por tipo de dato, quién escribe en quién.

Pantalla Direcciones de sincronización

Las cinco primeras filas (Sincronización de productos, Sincronización de pedidos, Sincronización de pagos, Sincronización de envíos y Sincronización de stocks) se configuran con un sentido: Shopify a Dolibarr, Dolibarr a Shopify o Bidireccional. Sin sincronización solo se ofrece de entrada para los productos; para los pedidos, los pagos, los envíos y los stocks, solo aparece si ese ajuste ya está guardado. La sexta fila, Estrategia de resolución de conflictos, no es un sentido: ofrece cinco estrategias para decidir qué lado se impone cuando el mismo dato ha cambiado en ambos (prioridad a Shopify, a Dolibarr, al cambio más reciente, al más antiguo, o resolución manual).

Lo que hay que saber antes de guardar:

  • Los stocks: mientras no se haya guardado nada en esta pantalla, el sentido mostrado y aplicado es Dolibarr a Shopify. Dolibarr es la referencia del stock (reposiciones, producción, inventario) y Shopify no escribe en él.
  • Los productos: no hay ningún sentido preseleccionado. La lista muestra Seleccionar dirección de sincronización: elija un sentido y guarde. Mientras no elija ninguno, no se guarda ninguno.
  • Pedidos, pagos, envíos: solo funciona el sentido Shopify a Dolibarr. El sentido Dolibarr a Shopify aún no está implementado para estos tres tipos: un ajuste que lo incluya se guarda pero queda sin efecto, y la pantalla lo anuncia con una advertencia. Para los envíos, el sentido mostrado por defecto es Bidireccional: elija Shopify a Dolibarr.
  • Los pagos y los envíos dependen de los pedidos: no corte la sincronización de pedidos si quiere las demás.

Haga clic en Grabar al final de la pantalla para validar las seis filas.

7. Stock real o virtual, ubicación de Shopify

Estos ajustes son propios de cada tienda: elija primero la tienda correspondiente en el selector de tienda que aparece en la parte superior de la pantalla.

Real o virtual. En la pestaña Sincronización de productos, la casilla Sincronizar stocks activa el envío del stock a Shopify. La casilla Usar stock virtual para Shopify, que solo se puede marcar si la primera lo está, envía a Shopify el stock virtual (stock real, menos los pedidos de clientes, más los pedidos a proveedores) en lugar del stock real. Se recomienda el stock virtual: evita vender lo que ya está comprometido.

Ubicación. Shopify gestiona el stock por ubicación. El módulo detecta la ubicación en el momento de la conexión (sección 3). Para comprobarla o cambiarla: pestaña Tiendas, Editar en la fila de la tienda, subpestaña Envío, campo ID de ubicación de Shopify. El identificador se lee en la administración de Shopify, en los ajustes de las ubicaciones.

8. Las tareas programadas

Doli2Shop trabaja sobre todo con las tareas programadas de Dolibarr. Se encuentran en Inicio → Herramientas de administración → Tareas programadas; filtre por el módulo doli2shop.

Tareas programadas del módulo

Dolibarr solo ejecuta estas tareas si su planificador se dispara regularmente (una línea de crontab en el servidor). El comando que debe usar se muestra en la configuración del módulo «Tareas programadas» (engranaje de su ficha, en la lista de módulos). Sin este disparador no se ejecuta nada, aunque las tareas estén «programadas».

Activas desde la instalación:

Tarea Función
Doli2ShopWebhookProcess procesa los webhooks recibidos de Shopify
Doli2ShopOrdersCatchup recupera los pedidos que un webhook haya podido perder
Doli2ShopFulfillmentCatchup recupera los envíos perdidos
Doli2ShopStockPushQueueProcess envía a Shopify los cambios de stock
Doli2ShopTokenRefresh renueva el token de conexión antes de que caduque
Doli2ShopWebhookHealthCheck comprueba los webhooks y los vuelve a registrar si hace falta
Doli2ShopHeartbeat informe diario de las métricas del módulo

Tareas de productos. Doli2ShopProductsExport y Doli2ShopProductsImport están inactivas en la instalación. Desde la versión 2.6.3, guardar el sentido de los productos (sección 6) ajusta estas dos tareas según el sentido elegido, para las tiendas conectadas y con licencia. Solo ocurre cuando cambia el estado esperado, y una tarea que haya pausado a propósito nunca se vuelve a activar. Tras guardar, compruebe su estado en la lista de tareas programadas: la captura muestra una tienda de demostración conectada y con licencia donde ya están programadas.

Para activar a mano según sus necesidades (inactivas en la instalación):

Tarea Activar si
Doli2ShopOrdersHistoricalImport importa el historial de pedidos de una tienda ya en servicio
Doli2ShopHistoricalCleanup ha lanzado esa importación histórica (limpieza posterior)
Doli2ShopAlertCheck quiere alertas por correo en caso de errores repetidos

9. Verificar la instalación

La pestaña Salud & Diagnóstico reúne las comprobaciones. Incluye en particular Resumen por tienda (conexión, webhooks activos, estado de licencia de cada tienda), Comprobaciones del sistema, Estado del módulo, Conectividad con la API de Shopify y Tareas programadas. Una insignia de color en la pestaña señala un deterioro.

Revíselo después de la instalación: conexión con Shopify correcta, webhooks activos, tareas activas, ningún permiso ausente. En caso de duda, el procedimiento «Enviar al soporte el registro del módulo y las exportaciones JSON» (https://doli2shop.ptitetete.org/es/documentation/support-export) le dice qué enviarnos.

Para conectar el módulo a un Dolibarr ya poblado (productos, terceros y pedidos existentes), siga el «Procedimiento de puesta en producción» (https://doli2shop.ptitetete.org/es/documentation/go-live) antes de activar las sincronizaciones.

10. Cuando termina la licencia

Lo que sigue describe la tienda predeterminada. Una tienda secundaria no tiene periodo de gracia: solo se sincroniza mientras su licencia es válida, y su sincronización se detiene en cuanto deja de serlo.

  1. Licencia caducada: modo degradado. El módulo muestra ¡Su licencia ha expirado!. La sincronización sigue funcionando, pero el soporte y las descargas están desactivados.
  2. Sesenta días de gracia. Tras la caducidad, la sincronización continúa 60 días más. El módulo muestra entonces La sincronización se detendrá pronto y, cuando el servidor de licencias proporciona la fecha, el día en que todo se detendrá. Sin esa fecha, no se muestra ningún día de parada.
  3. Parada. Superada la fecha, se muestra Sincronización detenida (licencia): toda la sincronización con Shopify se detiene, incluida la recepción de pedidos. Sus pedidos de Shopify dejan de llegar a Dolibarr hasta que se renueve la licencia.

Renueve su licencia antes de la parada: la sincronización se reanuda en cuanto se activa la nueva licencia (sección 4). Si nunca se ha vinculado una licencia a una tienda, el módulo lo indica con Ninguna licencia está vinculada a esta tienda.

← Volver a la documentación