Productos

Información necesaria para que los productos se envíen a Shopify se realiza a través de los campos obligatorios: 

  • title: Nombre de producto
  • body_html: Descripción de producto
  • sku: Referencia de producto, para el control interno de Sales Layer.

Nota importante sobre los campos de productos

  • Algunos de los campos listados en la pestaña de Productos en realidad pertenecen a la entidad Shopify ProductVariant.
  • Este comportamiento es intencional: Shopify siempre crea al menos una variante por producto (llamada Default Title), y estos campos a nivel de variante se ponen a disposición aquí para compatibilidad con tiendas que no gestionan variantes reales.
  • Si tus productos tienen variantes, recomendamos encarecidamente mapear los campos relacionados con precio e inventario (por ejemplo, presentment_prices, sku, barcode, inventory_quantity) en la pestaña Variants en su lugar.
  • Antes de cambiar cualquier mapeo relacionado con campos de variante, prueba los cambios en un entorno de staging para verificar la sincronización correcta, especialmente al usar Shopify Markets, donde el precio y la disponibilidad se gestionan por variante y mercado.

Campos básicos que aparecen en el conector por defecto no son estrictamente necesarios para el envío de productos a Shopify, pero pueden ser útiles para gestionar la información:

  • price: Precio del artículo, admite decimales.
  • compare_at_price: Corresponde al precio anterior del producto. El valor en compare_at_price debe ser mayor que el precio actual. Ejemplo: 100€ - 75€:
    • Enviar 0 para eliminar la comparativa de precios (es decir, volver al precio anterior).
    • Número mayor que 0 corresponde al precio anterior. En este ejemplo serían los 100€ que se ven tachados.
  • cost_per_item: el coste de fabricación o similar
  • taxable: booleano o texto.
    • true|yes|sí : el producto sujeto a impuesto (el IVA de este producto).
    • false|no: el producto sin impuesto
  • handle: Identificador de URL. Es la última parte de la construcción de la URL específica del producto, utilizada para SEO. Si no se envía, Shopify crea uno por defecto.
  • seo_title: Título SEO
    • El conector mantiene el campo metafields_global_title_tag por la retrocompatibilidad, aunque ya no se recomienda su uso. La forma recomendada es usar seo_title.
    • No mapear ambos campos metafields_global_title_tag y seo_title al mismo tiempo.
  • seo_description: Descripción SEO
    • El conector mantiene el campo metafields_global_description_tag por la retrocompatibilidad, aunque ya no se recomienda su uso. La forma recomendada es usar seo_description.
    • No mapear ambos campos metafields_global_description_tag y seo_description al mismo tiempo.
  • requires_shipping: tipo booleano, la opción true corresponde a un producto físico que requiere envío, de lo contrario es false. 
  • weight_unit: Menú desplegable de unidad de peso. Unidades permitidas g, kg, lb, oz. 
    • Anteriormente gestionado en el campo grams. Se mantiene en el conector por retrocompatibilidad, pero ya no se recomienda su uso. 
    • El campo weight_unit no funciona si el campo grams está activo. 
    • No se puede mapear con el campo tipo lista. Si se quiere enviar desde el mismo, es posible mapearlo como vacío en el conector y aplicar la fórmula PRINT(“list_type_field”).
  • weight: Campo de peso, soporta decimales. Indicar si el producto está marcado como producto físico (requires_shipping). Aparece cuando se marca la casilla anterior. 
    • Anteriormente gestionado en el campo grams. Se mantiene en el conector por retrocompatibilidad, pero ya no se recomienda su uso. 
    • El campo weight no funciona si el campo grams está activo.
  • sort_order: personaliza el orden de variantes. Importante, se mapea a nivel de producto. Para consultar más información sobre la configuración del campo, revisar el apartado de Variantes.
  • vendor: Corresponde al proveedor de los productos en venta.
  • product_type: Conjunto de atributos del producto/el tipo de producto. Cada producto puede tener solo un tipo de producto.
  • template_suffix: El tema/plantilla del producto. Hay que enviar uno de los valores existentes y los temas deben ser creados o comprados previamente desde Online Store -> Themes. Revisar más detalles sobre la gestión en SL aquí. 
  • country_code_of_origin: atributo configurable de región o país de origen para el control aduanero. Consultar la lista de posibles valores en la documentación oficial de Shopify. 
  • province_code_of_origin: El código de provincia de origen según ISO 3166-2 (ejemplo: ES-V, FR-IDF, etc.)
  • harmonized_system_code: El código arancelario (importaciones entre países), habitualmente entre 6 y 13 dígitos. 

  • country_harmonized_system_codes: mismo comportamiento que los campos country_code_of_origin y harmonized_system_code. Estos códigos pueden especializarse por país. Campo tipo tabla con la siguiente estructura:

     
 
  • status: Estado de producto (V → Visible, D → Borrador, I → Invisible). Consultar las reglas específicas en el artículo Estado y visibilidad.
 

Campos para gestionar Canales de venta

 

El campo published_scope permite gestionar la disponibilidad del producto en los diferentes canales de venta previamente creados y activados en Shopify. 

 
 

Desde Sales Layer se puede enviar el valor deseado mapeando con un campo tipo lista o de texto corto con opciones separadas por “|”. En otro caso, es posible mapear el campo como vacío y aplicar la fórmula PRINT, por ejemplo: PRINT("web|global")

 
 

Las opciones aceptadas:

  • all: Publicará producto en todos los canales de venta definidos en Shopify. 
  • web: Publicará el producto en el canal de venta Online Store.
  • global (predeterminado): Publicará el producto en el canal de venta Point of Sale. 
    • Valor predeterminado si published_scope no está mapeado.
    • Valor predeterminado si published_scope está deshabilitado en el conector.
  • social: Publicará el producto en el canal de venta Facebook e Instagram, Google y YouTube.
  • button: Para asignar Buy Button.
  • third-party: El conector no publica ni despublica artículos en ningún canal de venta. Usar si no se desea cambiar la configuración de los canales de venta o gestionarlos externamente (desde Shopify/apps externas). 
  • Nombre del canal específico: Para publicar en un canal de venta personalizado.
  • persist: Para gestionar canales concretos desde el conector y mantener los demás canales sin modificar (tal y como están en Shopify). Por ejemplo, si se desea que el conector publique en el canal Online store y no gestione el resto de canales, se usaría la fórmula  PRINT("web|persist")
  • Sin valor proporcionado: Si el campo published_scope está mapeado y no se proporciona ningún valor, el conector anulará la publicación del producto en todos los canales de venta.
  • Activación por fechas: Permite activar canales en la fecha concreta siguiendo la sintaxis Channel:YYYY-MM-DD. Por ejemplo PRINT(“Online Store:2025-02-11 | Facebook & Instagram:2025-01-15”)
 

Gestión de inventario (stock)

 

Para gestionar el inventario, hay que tener en cuenta los siguientes campos:

  • inventory_quantity: Stock, dependiendo de la ubicación
  • inventory_policy: Define si los clientes pueden realizar pedidos cuando el artículo está sin stock. 
  • tracked: Para realizar el seguimiento del stock (previamente inventory_management). 

Para más detalles sobre la configuración de los campos nombrados anteriormente, consultar la sección de Gestión de inventario. 

 

Campos de media

 

Esta serie de campos recoge información sobre imágenes y archivos vinculados al producto:

  • images: imagen de producto. En Sales Layer se mapea con un campo tipo imagen.
  • product_alt: para asignar un atributo alt a cada imagen del producto
  • media_video: para enviar vídeos o imágenes 3D alojados en SL
  • media_video_alt: atributo alt de archivos enviados por media_video
  • media_external: envío de vídeos externos (no alojados en SL)
  • media_external_alt: atributo alt de archivos enviados por media_external
  • media_order: establece orden de los archivos multimedia enviados por el conector

Consultar detalles sobre la gestión y configuración de cada uno de los campos en la sección Campos media y atributos alt. 

 

Campos de Markets

 

Para trabajar la información relativa a Markets hay que usar campos tipo tabla de la siguiente forma:

  • markets: habilita los mercados para el producto
  • presentment_prices: indica precios por mercado/moneda para el producto. Informado en una tabla compuesta por información obligatoria y opcional. 

Consultar más detalles sobre la configuración de ambos campos en el apartado de Shopify Markets. 

Características específicas del mapeo: categorías
Características específicas del mapeo: variantes