Enviar al soporte el registro del módulo y las exportaciones JSON

Procedimiento para el cliente. El soporte le ha pedido —o usted quiere prepararlo antes incluso de escribir— tres archivos para diagnosticar un incidente de sincronización (por ejemplo, una resincronización de stock que termina con errores, o variantes de producto cuyo stock vuelve a cero). Estos tres archivos permiten al soporte ver exactamente lo que el módulo hizo realmente, en qué producto y con qué ajustes, sin necesitar acceso a su Dolibarr. Calcule cinco minutos: ninguno de estos pasos modifica sus datos ni su configuración.

Los tres archivos que debe adjuntar a su mensaje:

1. el registro del módulo (dolibarr_doli2shop.log);
2. la exportación JSON de un producto afectado por el problema;
3. la exportación JSON de la configuración del módulo (diagnóstico).

1. Acceder a la configuración del módulo

Doli2Shop no tiene entrada propia en el menú izquierdo de Dolibarr: se accede siempre desde la pantalla de gestión de módulos.

1. En Dolibarr, vaya a Inicio → Configuración → Módulos/Aplicaciones.
2. Filtre por doli2shop en el campo de búsqueda si la lista es larga.
3. En la ficha DOLI2SHOP, haga clic en el icono con forma de engranaje («Configurar»).

Llegará a una página con una barra de pestañas arriba (Asistente, Tiendas, Configuración, etc.). Ahí se encuentran las dos pantallas usadas a continuación: Tickets de Soporte y Salud & Diagnóstico.

2. Descargar el registro del módulo

El módulo escribe sus propias trazas (lo que realmente hizo, ciclo a ciclo) en un archivo propio, dolibarr_doli2shop.log — distinto del registro general de Dolibarr. Es este archivo el que hay que adjuntar.

1. Haga clic en la pestaña Tickets de Soporte.
2. En la parte superior de la pantalla, bajo «¿Algo que comunicarnos?», haga clic en Descargar el registro del módulo.

1. Pestaña Tickets de Soporte — aquí es donde el módulo muestra el enlace de descarga de su registro, incluso antes de la lista de tickets.
2. Botón Descargar el registro del módulo: descarga dolibarr_doli2shop.log, con su tamaño actual mostrado al lado.

El archivo descargado se llama doli2shop_AAAA-MM-DD_HHMMSS.log.

Si el botón no aparece en la pestaña Tickets de Soporte (registro desactivado), el mismo botón también existe al final de la pestaña Registro de acciones:

1. Pestaña Registro de acciones — vía alternativa si el botón no aparece en la pestaña Tickets de Soporte.
2. El mismo botón Descargar el registro del módulo, con el mismo archivo detrás, al final de esta pantalla.

Qué contiene este archivo

Las acciones realmente ejecutadas por el módulo: sincronizaciones lanzadas, errores y avisos encontrados, llamadas a la API de Shopify, decisiones tomadas (por ejemplo, por qué no se actualizó una variante). Las direcciones de correo y los nombres de sus clientes que puedan aparecer en estos mensajes se enmascaran normalmente antes de escribirse (por ejemplo, j***@***.com): el registro está pensado para diagnosticar un incidente técnico, no para transportar su fichero de clientes.

Si el registro está vacío o es muy corto

El registro puede estar desactivado, o su nivel de detalle configurado demasiado bajo para capturar el incidente. Dos ajustes, desde Inicio → Configuración → Otros → Variables (todavía sin pantalla dedicada en el módulo):

Constante	Valor a introducir	Efecto
DOLI2SHOP_LOG_FILE_ENABLED	1	Activa el registro del módulo (ya activo por defecto — compruébelo solo si sigue desesperadamente vacío)
DOLI2SHOP_LOG_FILE_LEVEL	7	Pone el registro del módulo en detalle máximo (DEBUG), solo para este módulo — sin sobrecargar el registro general de Dolibarr

Una vez colocadas estas dos constantes:

1. Repita la acción que falla (por ejemplo: relance la resincronización de stock desde la pestaña Sincronización manual) para que el incidente quede registrado en detalle.
2. Vuelva a descargar el registro siguiendo el paso 2 anterior.
3. Una vez recuperado el registro, elimine la constante DOLI2SHOP_LOG_FILE_LEVEL (o vuelva a ponerla en 6) para volver al nivel normal — de lo contrario el registro permanece en detalle máximo de forma continua.

3. Exportar el JSON de un producto con error

Esta exportación recupera, en directo desde Shopify, la ficha en bruto de un producto — variantes, opciones, precio, stock, metadatos y medios tal como Shopify los conoce en el momento de la exportación. Esto permite al soporte comparar lo que Shopify devuelve con lo que Dolibarr muestra, sin necesitar acceso a su tienda.

1. Localice, en la lista de errores mostrada al final de su resincronización de stock, el SKU (referencia) o el título de uno de los productos afectados — uno solo basta para un primer diagnóstico.
2. Vuelva a la configuración del módulo, pestaña Salud & Diagnóstico.
3. Haga clic en el botón Exportar un producto Shopify (JSON).

1. Botón Exportar un producto Shopify (JSON) — abre la herramienta de búsqueda de un producto por SKU, título o identificador.

2. Botón Exportar diagnóstico (JSON) — descarga con un clic la configuración completa del módulo (archivo n.º 3, más abajo).

3. Introduzca el SKU o el título localizado en el paso 1 y haga clic en Obtener el JSON.

5. Una vez mostrado el resultado, haga clic en Descargar el JSON.

El archivo descargado se llama produit_<nombre-del-producto>.json. Contiene los datos de Shopify y Dolibarr de ese único producto — no figura ningún dato personal de cliente (no es un pedido, solo una ficha de producto).

4. Exportar la configuración del módulo (diagnóstico)

Este archivo lista todos los ajustes actuales del módulo (conexión, reglas de sincronización, mapeos, etc.), lo que evita que el soporte le haga una larga serie de preguntas sobre su configuración.

1. En la misma pestaña Salud & Diagnóstico, en la parte superior de la página, haga clic en Exportar diagnóstico (JSON) (marca n.º 2 en la captura anterior).

El archivo descargado se llama diagnostic_shopify_AAAA-MM-DD_HH-mm-ss.json.

⚠️ Este archivo contiene los parámetros técnicos de conexión del módulo (nombre de la tienda, tokens de conexión a Shopify, ajustes de sincronización). El módulo ya enmascara automáticamente parte de estos valores antes de la exportación (los tokens de acceso y claves de API principales aparecen en forma truncada, por ejemplo abcd****wxyz) — pero todavía no todos los campos de conexión, a día de hoy. Una próxima versión del módulo eliminará todo identificador de conexión de este archivo, incluso en forma enmascarada.

Hasta que esa versión esté disponible: envíe este archivo al soporte únicamente si este se lo ha pedido explícitamente, solo al soporte de P'tite Tête por la vía habitual (respuesta a este mensaje, o nuevo ticket de soporte), nunca a otro destinatario, y no lo publique en ningún espacio de intercambio público.

5. Enviar los tres archivos

Responda al mensaje del soporte (o cree un mensaje desde la pestaña Tickets de Soporte) adjuntando los tres archivos:

• el registro del módulo (doli2shop_....log);
• la exportación del producto (produit_....json);
• la exportación de la configuración (diagnostic_shopify_....json) — solo si el soporte se lo ha pedido (véase la advertencia del paso 4).

Si el registro es demasiado voluminoso para su correo (más de unos pocos megabytes), comprímalo primero en un archivo .zip antes de enviarlo.

6. Qué hace el soporte con ello

El registro permite reproducir, minuto a minuto, lo que el módulo realmente intentó hacer con sus productos y localizar dónde se detuvo o falló una sincronización. La exportación del producto y la exportación de la configuración permiten contrastar el estado real de Shopify y sus ajustes con lo que reporta el registro, para identificar la causa exacta en lugar de formular hipótesis.