Resolución de problemas

El servicio no arranca: error de licencia#

Credenciales incorrectas#

Verificar que ClienteId, ClienteSecret y LicenciaId en Configuracion.xml son correctos y corresponden a la licencia asignada a esta instalación.

Puerto UDP/123 bloqueado#

El licenciador verifica la hora real mediante una consulta NTP antes de validar la licencia. Si el firewall corporativo bloquea el tráfico UDP saliente al puerto 123, la validación falla aunque las credenciales sean correctas.

Diagnóstico: Intentar conectar al puerto 123 de un servidor NTP público desde el servidor donde se ejecuta el servicio:

Test-NetConnection -ComputerName time.windows.com -Port 123

Solución: Solicitar al equipo de red que abra el puerto UDP/123 saliente hacia internet.

Reloj del servidor desincronizado#

Si el puerto 123 está abierto pero el servicio sigue sin validar la licencia, comprobar la hora del servidor. El licenciador compara la hora local con la hora NTP recibida; si la diferencia es significativa, rechaza la licencia para evitar el uso con el reloj manipulado.

Solución: Sincronizar el reloj del servidor con un servidor de tiempo. En Windows:

w32tm /resync /force

Si el servicio de tiempo de Windows no está activo:

net start w32tm
w32tm /resync /force

El servicio arranca pero no importa pedidos#

Los pedidos están en un estado no configurado#

Solo se importan pedidos en los estados definidos en la configuración de la tienda. Verificar que los estados de los pedidos pendientes coinciden con los configurados.

Los pedidos son anteriores a la fecha mínima#

El conector ignora pedidos anteriores a la fecha mínima configurada. Revisar este parámetro si se esperan pedidos históricos.

El artículo del pedido no tiene SKU mapeado#

Si un artículo de la tienda no tiene correspondencia con ningún artículo del ERP por referencia/SKU, el pedido puede fallar o importarse sin ese artículo. Revisar el log para identificar el SKU problemático y crear el mapeo correspondiente.

El servicio arranca pero no exporta artículos#

El artículo no tiene la opción «Exportar a tienda» activa#

En la tabla de relación artículo-tienda, cada artículo debe tener marcada la opción de exportación. Verificar que los artículos esperados están configurados para exportarse.

El almacén configurado no tiene stock#

Verificar que los códigos de almacén configurados para la tienda son los correctos y que contienen stock en el ERP.

Errores de conexión con la tienda#

Timeout o error de red#

Verificar que el servidor tiene acceso HTTPS a la URL de la tienda. Comprobar que las credenciales API (API Key, Secret o token) son correctas y no han caducado.

Certificado SSL no válido#

Algunos servidores de tienda usan certificados autofirmados o caducados. Revisar el certificado SSL de la tienda y renovarlo si es necesario.

Descuadres de importe en pedidos importados#

Si el log muestra avisos de descuadre frecuentes, revisar:

• La tolerancia de descuadres configurada: si es muy baja, pedidos con diferencias mínimas de redondeo generarán advertencias.
• El artículo de ajuste configurado: debe ser un artículo válido en el ERP que acepte importes positivos y negativos.

Revisión del log#

El fichero de log principal se encuentra en C:\Logs\Sit.Sync.ECommerce.log. Contiene el detalle de cada ciclo de sincronización, incluyendo pedidos procesados, artículos exportados y errores producidos.

Shopify: errores HTTP 429 (Too Many Requests)#

El conector espera 510 ms entre llamadas para mantenerse dentro de los límites de la API de Shopify. Si siguen produciéndose errores 429, puede deberse a que otras aplicaciones de la tienda consumen el mismo cupo de peticiones. Revisar las integraciones activas en el panel de Shopify y desactivar las que no sean necesarias.

WooCommerce: errores de timeout en exportación#

El conector aplica un timeout de 90 segundos por petición. Si el servidor de la tienda no responde a tiempo, el conector registra el error y continúa con la siguiente tienda. Para diagnosticar: revisar el rendimiento del servidor de WooCommerce, reducir el número de artículos exportados por ciclo o aumentar el intervalo entre ejecuciones del servicio.

Prestashop clásico: la exportación de artículos no funciona#

El conector clásico de Prestashop no implementa la exportación de artículos. Cualquier intento de actualizar productos desde el ERP hacia esta tienda producirá un error en el log. Es un comportamiento esperado, no un fallo de instalación. Asegurarse de que la opción «Exportar artículos» esté desactivada en la configuración de la tienda Prestashop clásica.