Este artículo enumera errores habituales del conector de Shopify y explica qué significa cada uno.

1. No se ha podido establecer la comunicación con la tienda de Shopify

Este error aparece cuando Sales Layer no puede utilizar las credenciales proporcionadas para conectarse a la API de Shopify.

La conexión puede fallar si las credenciales son incorrectas, faltan permisos necesarios o no hay ninguna ubicación disponible en Shopify.

Pasos de verificación mencionados en el artículo:

• Verifica las credenciales en Shopify y confirma que coinciden con las introducidas en el conector.
• Asegúrate de que todos los permisos necesarios estén configurados correctamente.
• Comprueba que el Nombre de la tienda introducido en el conector sea la URL real de la tienda. No se permiten URL de redirección.
• Confirma que se haya añadido al menos una ubicación en la tienda de Shopify.

2. Conector desactivado tras varios intentos de conexión

Este error significa que las credenciales no son válidas o que faltan permisos necesarios.

El conector se desactiva automáticamente después de 30 intentos fallidos de conexión con la tienda de Shopify.

3. Acceso denegado para algunos permisos

Este mensaje aparece cuando faltan algunos de los permisos necesarios para la sincronización.

El propio error muestra los permisos que faltan, para que puedas revisarlos en la configuración de la aplicación de Shopify.

4. Sincronización detenida para proteger tus datos

Si el conector detecta más de 100 errores durante la sincronización, se detiene automáticamente como medida de seguridad.

El objetivo es evitar que se sincronicen datos incorrectos con Shopify.

5. Error al cambiar la visibilidad de los Mercados

Este error ocurre cuando el conector intenta activar o desactivar un Mercado y Shopify no puede aplicar el cambio.

Por ejemplo, esto puede ocurrir si el Mercado no existe en Shopify.

6. No se ha podido identificar el idioma principal

Este error aparece cuando el conector no puede determinar el idioma principal que debe utilizar en Shopify.

La causa puede ser la falta de permisos o una diferencia entre el idioma seleccionado en el conector y el idioma configurado en Shopify.

El artículo menciona específicamente la revisión de estos permisos:

• read_locales
• read_translations
• write_translations

7. No se han podido actualizar todas las imágenes de variantes

Este error aparece cuando las imágenes enviadas para variantes no cumplen con las limitaciones de Shopify.

Los ejemplos mencionados en el artículo incluyen:

• Enviar más de una imagen para una sola variante.
• Imágenes que superan el tamaño máximo permitido por Shopify.

8. No se ha podido actualizar la información del formato porque falta el SKU

Este error significa que a la variante le faltan uno o varios atributos obligatorios.

El artículo señala específicamente la falta de datos de opción en la configuración de la variante y destaca el SKU como valor obligatorio en este mensaje de error.

9. Error interno del servidor, error 502 o error de actualización sin respuesta

Este es un error devuelto por Shopify.

En la mayoría de los casos es temporal y se resuelve en una sincronización posterior.

El artículo explica que realizar cambios habituales en los productos, o cambiar su visibilidad, puede forzar una nueva sincronización del ítem afectado y ayudar a resolver el problema.

Buenas prácticas

• Verifica siempre que las credenciales de Shopify en el conector coincidan exactamente con las credenciales de la aplicación configurada en Shopify.
• Revisa todos los permisos necesarios si el conector informa de acceso denegado o de fallos de conexión repetidos.
• Utiliza la URL real de la tienda de Shopify en el campo Nombre de la tienda, no una URL de redirección.
• Asegúrate de que la tienda de Shopify tenga al menos una ubicación activa antes de probar la conexión.
• Si el conector se detiene después de demasiados errores de sincronización, revisa los datos del catálogo antes de reiniciar el proceso.
• Comprueba que los Mercados ya existan en Shopify antes de intentar cambiar su visibilidad desde el conector.
• Para errores relacionados con idiomas, confirma tanto la configuración de idiomas de Shopify como los permisos de traducción.
• Para errores de imágenes de variantes, envía solo una imagen por variante y verifica que los archivos de imagen cumplan con los límites de Shopify.
• Si aparece un error 502 o un error de servidor similar, inténtalo de nuevo después del siguiente ciclo de sincronización o activa una nueva sincronización actualizando el ítem afectado.