Migración 1.10 (versión actual)
Introducción
Desde julio de 2025, hemos lanzado una nueva versión, la 1.10, totalmente compatible con la API de Shopify 2025-07. Este cambio supone una transformación arquitectónica importante, con la adopción completa de la API GraphQL, que sustituye al modelo anterior basado en REST. Esto ofrece un mejor rendimiento, llamadas más simples y una mayor alineación con la evolución de la plataforma Shopify.
Nota: Todos los nuevos conectores se crearán en esta versión.
Resumen:
Permisos en la tienda de Shopify
| Funcionalidad | Tipos de ítem de Sales Layer y campos implicados | Permiso de Shopify |
| Requerido para cualquier sincronización | read_inventory read_locales read_locations read_products read_product_listings read_publications read_translations write_products write_publications write_translations
| |
| Metafields | Cualquier metafield de categoría/producto/variante (definido o no) creado por el usuario. metafields_global_title_tag and metafields_global_description_tag no necesitan este permiso | read_metaobject_definitions |
| Markets | En producto:
En variantes:
| read_markets write_markets |
| Media files | Producto:
| read_files write_files |
| Inventory / inventory_quantity | Productos:
Variantes:
| write_inventory read_fulfillments write_fulfillments |
Actualización del formato del campo precio
Se ha actualizado el formato de los campos de precio. Ahora los precios pueden enviarse con 0, 1 o 2 decimales. El conector ahora formatea correctamente los precios con hasta dos decimales, sin necesidad de ajustes manuales.
Campos afectados:
- En productos: price, compare_at_price
- En variantes:price, compare_at_price
Canal de ventas
El conector de Shopify permite controlar la visibilidad de productos y colecciones en los distintos canales de venta mediante el campo published_scopes en Sales Layer.
| Comportamiento introducido en v1.9.3 (versión anterior) | Nuevo comportamiento (v1.10) |
|---|---|
| La misma lógica ahora se extiende a las colecciones, que también pueden publicarse o despublicarse en canales de venta específicos al igual que los productos. |
Lógica de ordenación de imágenes y medios
El campo media_order permite ordenar elementos multimedia en Shopify, como imágenes, vídeos, archivos 3D, etc.
Puedes encontrar más información sobre la lógica de media_order en este enlace.
Sincronización de medios y sistemas externos
La versión 1.10 introduce un comportamiento más claro y estricto sobre cómo se gestionan los medios de productos y variantes, especialmente cuando varios sistemas intentan administrarlos simultáneamente.
Campos afectados:
- Colecciones: no es necesaria ninguna acción.
- Productos y variantes:
| Escenario | Acción necesaria | Comportamiento esperado |
|---|---|---|
| Si tu fuente de imágenes es un ERP, DAM o apps de Shopify | Se deben desactivar los siguientes campos de medios de Sales Layer: Desactiva o elimina campos: En productos: images, media_video, media_external | El conector no gestiona medios de productos/variantes. Los medios existentes en Shopify se conservan. Los medios de un sistema externo no se modifican. |
| Si tu fuente de imágenes es Sales Layer (sin ERP, DAM ni apps de Shopify) | Mapear los campos de medios adecuados en el conector. | Sales Layer enviará todos los datos de productos y medios mapeados a Shopify, y gestionará los medios solo a través de esos campos. |
| Solo está habilitado media_external | Desactiva o elimina campos: En productos: images En variantes: media_video Activa: media_external | Solo se enviarán a Shopify los medios externos definidos en media_external. El producto mostrará únicamente los medios externos gestionados por este campo. Cualquier imagen o vídeo previamente enlazado será desvinculado y eliminado. Atención: Esto sobrescribe los medios creados por otros sistemas a menos que se indique lo contrario. |
Nota: En esta versión, se admiten ahora los metafields de imágenes, pero no se vinculan a las imágenes normales del producto en Shopify. Existen como entidades separadas.
Puedes encontrar más información sobre los metafields soportados en este artículo.
