Guía de instalación
Del paquete a una tienda Shopify conectada, con licencia y sincronizada: requisitos, conexión, licencia, ajustes, tareas programadas
Descargar el PDFEsta 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:
- los requisitos previos;
- la instalación del paquete y la activación del módulo;
- la conexión de la tienda Shopify;
- la licencia;
- el asistente de configuración;
- el sentido de la sincronización;
- el stock (real o virtual) y la ubicación de Shopify;
- las tareas programadas;
- las comprobaciones finales;
- 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:
- Vuelva a Inicio → Configuración → Módulos.
- Escriba
doli2shopen el campo de búsqueda. - En la ficha del módulo, ponga el interruptor en «activo».
- 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.
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).
- 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_rootenconf/conf.php) antes de volver a intentarlo. - Sale de Dolibarr hacia una página de doli2shop.ptitetete.org que anuncia cuatro pasos. Haga clic en «Instalar Doli2Shop».
- 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.
- 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.
- En la pestaña Tiendas, haga clic en Editar en la fila de la tienda y después en la subpestaña Licencia.
- 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. - El mensaje «Licencia DoliStore activada correctamente» confirma la activación y Estado de licencia pasa a Licencia válida.
- 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.
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.
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.
- 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.
- 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.
- 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.