Cómo funciona el versionado de la API de Shopify

Shopify mantiene una política definida de versionado de API, y esa política afecta directamente al ciclo de vida del conector de Shopify de Sales Layer.

Entender cómo gestiona Shopify las versiones de su API ayuda a explicar por qué Sales Layer publica nuevas versiones del conector y por qué pueden ser necesarias migraciones con el tiempo.

Documentación oficial: Política de versionado de la API de Shopify

Puntos clave de la política de versionado de Shopify

• Shopify publica una nueva versión de la API cada trimestre: enero, abril, julio y octubre.
• Cada versión recibe soporte durante 12 meses desde su fecha de publicación.
• Shopify garantiza la compatibilidad con versiones anteriores dentro de una misma versión durante ese periodo de 12 meses.
• Cuando finaliza el periodo de soporte, Shopify desactiva esa versión y las integraciones que la utilizan dejan de funcionar.

Política de versionado de Sales Layer

Sales Layer mantiene su propio sistema de versionado para el conector de Shopify, alineado con las versiones de API compatibles con Shopify.

Este enfoque está pensado para mantener la compatibilidad a largo plazo con los servicios de Shopify, facilitar la migración y mejorar la visibilidad de los cambios del conector.

Compromiso con las versiones activas

Sales Layer procura mantener al menos dos versiones activas y estables del conector, cada una compatible con una de las versiones de la API de Shopify que reciben soporte al mismo tiempo.

Esta política ayuda a mantener la continuidad del servicio y reduce el riesgo asociado a que las versiones más antiguas lleguen al fin de su soporte.

El objetivo es mantener una diferencia de al menos 3 meses y como máximo 9 meses entre las API compatibles con las versiones activas del conector.

Actualmente, el conector muestra al cliente la versión compatible de la API de Shopify.

Cada migración se comunica con antelación e incluye documentación, instrucciones paso a paso y soporte técnico cuando sea necesario.

Cambios habituales en una nueva versión del conector

Cada nueva versión del conector puede introducir cambios en campos, comportamiento o arquitectura. Algunos ejemplos habituales son:

• Cambios en los nombres o tipos de campos, por ejemplo inventory_management reemplazado por tracked
• Campos obsoletos o que ya no son compatibles con versiones más recientes de la API
• Nuevos permisos requeridos en la aplicación personalizada de Shopify del cliente
• Ajustes en la lógica de sincronización, como una transición a GraphQL o cambios en las reglas de visibilidad

Estos cambios pueden requerir reasignar campos, actualizar permisos de Shopify o validar manualmente configuraciones existentes. Por este motivo, todas las migraciones se gestionan de forma controlada y asistida.

La versión actual del conector se muestra en la pestaña Registro de actividad del conector.

Para obtener más detalles, consulta Preguntas frecuentes sobre el versionado.