Política de versionado del conector
Shopify mantiene una política de versiones bien definida para sus APIs, lo que afecta directamente al ciclo de vida del conector de Shopify de Sales Layer. Comprender cómo gestiona Shopify sus versiones de API es fundamental para entender por qué Sales Layer desarrolla nuevas versiones del conector y con qué frecuencia pueden requerirse migraciones.
La documentación oficial está disponible en:
🔗 Política de Versionado de la API de Shopify
Aspectos clave de la política de versiones de Shopify:
Lanzamientos trimestrales: Shopify lanza una nueva versión de API cada tres meses (enero, abril, julio y octubre).
Ventana de soporte de 12 meses: Cada versión se mantiene durante un año desde su fecha de lanzamiento. Tras ese periodo, se considera obsoleta y deja de estar disponible.
Selección explícita de versión: Las solicitudes a la API deben especificar la versión deseada mediante el encabezado X-Shopify-API-Version o incluyéndola en la URL del endpoint.
Compatibilidad garantizada: Shopify garantiza que no habrá cambios incompatibles dentro de una misma versión durante su periodo de soporte.
Desactivación automática: Una vez transcurridos los 12 meses, Shopify desactiva automáticamente la versión, y cualquier integración que la utilice dejará de funcionar.
Política de versionado de Sales Layer
Sales Layer mantiene su propio sistema de versiones para el conector de Shopify, alineado con las versiones de API soportadas por Shopify. Este sistema busca garantizar la compatibilidad a largo plazo con los servicios de Shopify, facilitar los procesos de migración y mejorar la transparencia en los cambios del conector.
Compromiso con las versiones activas
Sales Layer mantiene el objetivo de contar con al menos dos versiones activas y estables del conector, cada una compatible con una de las cuatro versiones de API que Shopify admite simultáneamente.
Esta política pretende garantizar la continuidad del servicio y minimizar los riesgos asociados a la desactivación de versiones antiguas.
El objetivo es mantener una diferencia mínima de 3 meses y máxima de 9 meses entre las APIs que admiten las versiones activas.
Actualmente, el conector muestra al cliente la versión de API de Shopify compatible.
Cada migración se comunica con antelación y se acompaña de documentación, instrucciones paso a paso y soporte técnico si es necesario.
Cada nueva versión del conector puede introducir cambios en campos, comportamiento o arquitectura subyacente. Ejemplos comunes incluyen:
Cambios en nombres o tipos de campos (por ejemplo, inventory_management reemplazado por tracked).
Campos obsoletos o no soportados en versiones nuevas de la API.
Nuevos permisos requeridos en la app personalizada del cliente.
Ajustes en la lógica de sincronización (por ejemplo, transición a GraphQL, cambios en reglas de visibilidad).
Estos cambios pueden requerir volver a mapear campos, actualizar permisos en Shopify o validar manualmente configuraciones existentes. Por ello, todas las migraciones se realizan de forma controlada y asistida.
La versión actual se menciona en la pestaña Registro de Actividad del conector.
Consulta las FAQs sobre Versionado para más información.
