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.
 

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