La información necesaria para enviar productos a Shopify se define mediante estos campos obligatorios:

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

Nota importante sobre los campos de producto

• Algunos de los campos que aparecen en la pestaña Productos pertenecen realmente a la entidad ProductVariant de Shopify.
• Este comportamiento es intencionado. Shopify siempre crea al menos una variante por producto, llamada Título predeterminado, y estos campos de nivel variante están disponibles aquí por compatibilidad con tiendas que no gestionan variantes reales.
• Si tus productos tienen variantes, se recomienda encarecidamente mapear los campos relacionados con precios e inventario, como presentment_prices, sku, barcode e inventory_quantity, en la pestaña Variantes.
• Antes de cambiar mapeos relacionados con campos de variantes, pruébalos en un entorno de preproducción para verificar que la sincronización es correcta, especialmente si utilizas Shopify Markets, donde los precios y la disponibilidad se gestionan por variante y mercado.

Los campos básicos que aparecen por defecto en el conector no son estrictamente necesarios para enviar productos a Shopify, pero son útiles para gestionar la información:

• price: Precio del artículo. Admite decimales.
• compare_at_price: Corresponde al precio anterior del producto. El valor de compare_at_pricedebe ser superior al precio actual.
  • Envía 0 para eliminar la comparación de precio y dejar solo el precio actual.
  • Cualquier número superior a 0 corresponde al precio anterior.
• cost_per_item: Coste de fabricación o coste similar.
• taxable: Valor booleano o de texto.
  • true o yes: el producto está sujeto a impuestos.
  • false o no: el producto está exento de impuestos.
• handle: Identificador de URL. Es la última parte de la URL específica del producto y se utiliza para SEO. Si no se envía, Shopify lo crea automáticamente.
• seo_title: Título SEO.
  • El conector todavía mantiene el campo metafields_global_title_tag por compatibilidad con versiones anteriores, pero ya no se recomienda.
  • El método recomendado es usar seo_title.
  • No mapees metafields_global_title_tag y seo_title al mismo tiempo.
• seo_description: Descripción SEO.
  • El conector todavía mantiene el campo metafields_global_description_tag por compatibilidad con versiones anteriores, pero ya no se recomienda.
  • El método recomendado es usar seo_description.
  • No mapees metafields_global_description_tag y seo_description al mismo tiempo.
• requires_shipping: Campo booleano. true corresponde a un producto físico que requiere envío. En caso contrario, utiliza false.
• weight_unit: Menú desplegable de unidades de peso. Los valores permitidos son g, kg, lb y oz.
  • Anteriormente se gestionaba en el campo grams. El conector todavía lo admite por compatibilidad con versiones anteriores, pero ya no se recomienda.
  • El campo weight_unit no funciona si el campo grams está activo.
  • No se puede mapear con un campo de tipo lista. Si quieres enviarlo desde la misma fuente, mapéalo como vacío en el conector y aplica una fórmula.

PRINT("list_type_field")

• weight: Campo de peso. Admite decimales. Utilízalo solo si el producto está marcado como producto físico con requires_shipping.
  • Anteriormente se gestionaba en el campo grams. El conector todavía lo admite por compatibilidad con versiones anteriores, pero ya no se recomienda.
  • El campo weight no funciona si el campo grams está activo.
• sort_order: Personaliza el orden de las variantes. Importante: se mapea a nivel de producto.
• vendor: Corresponde al proveedor de los productos a la venta.
• product_type: Tipo de producto o Attribute Set. Cada producto solo puede tener un tipo de producto.
• template_suffix: Tema o plantilla del producto. Debes enviar uno de los valores existentes, y los temas deben haberse creado o comprado previamente en Tienda online > Temas.
• country_code_of_origin: Atributo configurable para la región o país de origen para control aduanero.
• province_code_of_origin: Código de provincia de origen según ISO 3166-2, por ejemplo ES-V o FR-IDF.
• harmonized_system_code: Código arancelario aduanero para importaciones entre países, normalmente de entre 6 y 13 dígitos.
• country_harmonized_system_codes: Tiene el mismo comportamiento que country_code_of_origin y harmonized_system_code. Estos códigos pueden especializarse por país. Es un campo de tipo tabla con la siguiente estructura.

• status: Estado del producto.
  • V = Visible
  • D = Borrador
  • I = Invisible

Campos para gestionar canales de venta

El campo published_scope permite gestionar la disponibilidad del producto en los distintos canales de venta ya creados y habilitados en Shopify.

Desde Sales Layer, el valor deseado puede enviarse mapeándolo con un campo de tipo lista o con un campo de texto corto con las opciones separadas por |. Si no, también es posible mapear el campo como vacío y aplicar una fórmula como esta:

PRINT("web|global")

Opciones aceptadas:

• all: Publica el producto en todos los canales de venta definidos en Shopify.
• web: Publica el producto en el canal de venta Tienda online.
• global: Publica el producto en el canal de venta Punto de venta.
  • Este es el valor por defecto si published_scope no está mapeado.
  • También es el valor por defecto si published_scope está deshabilitado en el conector.
• social: Publica el producto en los canales de venta Facebook e Instagram, Google y YouTube.
• button: Asigna el canal de venta Botón de compra.
• third-party: El conector no publica ni despublica artículos en ningún canal de venta. Utilízalo si no quieres modificar la configuración de los canales de venta o si se gestionan externamente desde Shopify o desde aplicaciones externas.
• Nombre específico del canal: Publica el producto en un canal de venta personalizado.
• persist: Permite gestionar canales específicos desde el conector y mantener otros canales sin cambios, tal como ya están en Shopify. Por ejemplo:

PRINT("web|persist")

• No se proporciona ningún valor: Si el campo published_scope está mapeado pero no se proporciona ningún valor, el conector despublica el producto de todos los canales de venta.
• Activación por fechas: Permite activar canales en una fecha específica utilizando la sintaxis Canal:AAAA-MM-DD. Ejemplo:

PRINT("Online Store:2025-02-11 | Facebook & Instagram:2025-01-15")

Gestión de inventario

Para gestionar el inventario, deben tenerse en cuenta estos campos:

• inventory_quantity: Stock, según la ubicación.
• inventory_policy: Define si los clientes pueden hacer pedidos cuando el artículo no tiene stock.
• tracked: Activa el seguimiento de inventario. Anteriormente este campo era inventory_management.

Campos de contenido multimedia

Este conjunto de campos recopila información sobre imágenes y archivos vinculados al producto:

• images: Imagen del producto. En Sales Layer se mapea con un campo de tipo imagen.
• product_alt: Asigna un atributo ALT a cada imagen de producto.
• media_video: Envía vídeos o imágenes 3D alojados en Sales Layer.
• media_video_alt: Atributo ALT para los archivos enviados mediante media_video.
• media_external: Envía vídeos externos que no están alojados en Sales Layer.
• media_external_alt: Atributo ALT para los archivos enviados mediante media_external.
• media_order: Define el orden de los archivos multimedia enviados por el conector.

Campos de Markets

Para trabajar con información de Shopify Markets, debes utilizar campos de tipo tabla de la siguiente forma:

• markets: Habilita mercados para el producto.
• presentment_prices: Indica precios por mercado o moneda para el producto. Se proporciona en una tabla compuesta por información obligatoria y opcional.