Productos
Información necesaria para que los productos se envíen a Shopify se realiza a través de los campos obligatorios:
- tit le: 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: booloeano 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.