title | Sí Tipo: string | Nombre del producto. Se encuentra en la parte superior de la página del producto. |
body_html | Sí Tipo: string | Descripción del producto. |
status | No Tipo: string|SalesLayer Status | Estado del producto: - V → Visible, D → Borrador, I → Invisible.
- En Shopify se encuentra en la ventana de estado del producto.
- Para gestionar distintos estados por tienda, puedes añadir campos separados (como “Estado 2”).
|
sku | Sí (para control interno de Sales Layer) Tipo: string | Referencia del producto. En Shopify, si no existen variantes, aparece en la ventana de Inventario. |
price | No Tipo: decimal | Precio - Shopify permite hasta dos decimales en el campo de precio. Recomendamos que adoptes esta restricción en los campos mapeados. Si necesitas colocar más de dos decimales, puedes usar la fórmula CONVERT_NUM() para convertir el formato.
- En Shopify, si no existen variantes, el precio está en la ventana de Precios dentro del producto
|
published_scope | No Tipo: list of values | Disponibilidad del producto - web
- global (predeterminado). Punto de Venta
|
No | Disponibilidad del producto - all: todos los canales de venta
- third-party: para ignorar la modificación de cualquier información sobre canales de venta desde el conector (para clientes que sincronizan estos datos desde otra aplicación).
- Tienda Online
- global (predeterminado). Punto de Venta
- social: Facebook e Instagram, Google y YouTube
- button: Botón de compra
combinación de accesos directos separados con “|” (web | global) - Tienda Online:2025-02-15
- persist: el conector publicará el ítem solo en los canales de venta Tienda Online y Punto de Venta. No gestionará ningún otro canal de venta.
Ejemplo: web|global|persist
|
vendor | No Tipo: string | Organización del producto (Proveedor)
- Debe ser creado intencionalmente, podría ser uno de los puntos de venta
- En Shopify se puede encontrar en la ventana de organización del producto dentro de un producto
|
handle | No Tipo: string | Identificador de URL
La última parte de la construcción de la URL específica del producto, se puede encontrar en la lista de motores de búsqueda dentro de un producto
|
product_type | Tipo: string | Organización del producto, conjunto de atributos del producto
- En Shopify se puede encontrar en la ventana de organización del producto dentro de un producto
|
template_suffix | No Tipo: string | Plantilla del tema
|
tags | No Tipo: string | Etiquetas - En Shopify se puede encontrar en la ventana de organización del producto dentro de un producto
|
sort_order | No Tipo: string | - Atributo configurable que puede incluir una fórmula para definir el orden de los atributos de variante, como el precio o la talla.
Los nombres de los campos deben coincidir con los listados en Datos de Salida > Productos > Nombre en Shopify.- En Shopify, esto aparecerá dentro de la ventana de Variantes u Opciones del producto.
- Ejemplos:
- PRINT("price:desc")
- PRINT("price:asc")
- PRINT("size:custom|S|M|L|X")
- Nota: en la fórmula PRINT("size:custom|S|M|L|X"), ten en cuenta que si no proporcionas todas las opciones de variante, el sistema seguirá el orden personalizado solo para las opciones especificadas. Cualquier opción no incluida mantendrá su orden original.
|
metafields_global_title_tag | No Tipo: string | Título de página, pestaña SEO
Título de metacampo predeterminado para mapear
- En Shopify se puede encontrar en la ventana de listado de motores de búsqueda dentro de un producto bajo el campo de título.
Notas: - Desde la versión v1.10.1, la forma recomendada de sincronizar este campo será mapear el campo seo_title.
- metafields_global_title_tag y seo_title no deben mapearse juntos.
|
metafields_global_description_tag | No Tipo: string | Default metafield description to map - In Shopify can be found in Search Engine Listing window within a product under description field
Notes: - From v1.10.1 the recommended way to synchronize this field will be mapping out the seo_description field.
- metafields_global_description_tag and seo_description should not be mapped out both together.
Descripción de metacampo predeterminada para mapear
En Shopify se puede encontrar en la ventana de listado de motores de búsqueda dentro de un producto bajo el campo de descripción
Notas:
- Desde la versión v1.10.1, la forma recomendada de sincronizar este campo será mapear el campo seo_description.
- metafields_global_description_tag y seo_description no deben mapearse juntos.
|
seo_title | No Tipo: string | Título SEO
Notas:
- A partir de la versión v1.10.1, seo_title es el campo recomendado para mapear este dato en Shopify.
- Importante: No mapear ambos, metafields_global_title_tag y seo_title, juntos.
|
seo_description | No Tipo: string | Meta descripción SEO
Notas:
- A partir de la versión v1.10.1, seo_description es el campo recomendado para mapear este dato en Shopify.
- Importante: No mapear ambos, metafields_global_description_tag y seo_description, juntos.
|
inventory_quantity | No Tipo: int | Stock, dependiendo de la ubicación
- Si no existen variantes, se puede encontrar en la ventana de Inventario dentro del producto
|
inventory_policy | No Tipo: string | inventory_policy define si los clientes pueden realizar pedidos cuando el artículo está sin stock. Este campo debe mapearse con un campo de tipo texto con los valores:
Si un producto no tiene variantes (es decir, es un producto único), la política se muestra en la sección de Inventario del Producto.
|
cost_per_item | No Tipo: float | Campo de Costo por Ítem, cerca del Precio, indicando el coste de fabricación o similar - En Shopify, si no hay variantes, se puede encontrar en la ventana de Precios dentro de un producto
|
country_code_of_origin | No Tipo: string | Atributo configurable, región o país de origen para el control aduanero.
Lista de valores posibles en: https://shopify.dev/api/storefront/reference/common-objects/countrycode
|
province_code_of_origin | No Tipo: string | El código de provincia ISO 3166-2 alfa-2 de donde se originó el artículo.
Enlace: ISO 3166-2 (ejemplo: ES-V, FR-IDF, etc.)
|
harmonized_system_code | No Tipo: string | El código del sistema armonizado del artículo. |
countryHarmonizedSystemCodes | No Tipo: List | Mismo comportamiento que los campos: country_code_of_origin y harmonized_system_code |
requires_shipping | No Tipo: boolean | True => Este es un producto físico, requiere campo de envío. De lo contrario, False.
En Shopify, si no hay variantes, se puede encontrar en la ventana de Envío dentro de un producto
|
tracked | No Tipo: boolean / string | Define si se debe rastrear el inventario de un artículo o no. Este campo debe coincidir con un campo de tipo texto con los valores:
- ‘yes’: permite al conector establecer el valor a la cantidad en stock.
- ‘no’ | vacío | null: no permite al conector establecer el valor a la cantidad en stock.
|
weight_unit | No Tipo: string | Menú desplegable de unidad de peso Unidad de medida (g, kg, pcs, ...) g => GRAMOS kg => KILOGRAMOS lb => LIBRAS oz => ONZAS
En Shopify, si no existen variantes, se puede encontrar en la ventana de Envío dentro de un Producto junto al campo de peso
*No funciona si el campo grams está activo
|
weight* | No Tipo: decimal | Peso, aparece cuando se marca la casilla anterior *No funciona si el campo grams está activo |
images | No Tipo: array (string) | Imagen del producto Se envía un array con el estado, el ID y el enlace de la imagen |
product_alt | No Tipo: string | Este campo se usa para asignar un atributo alt descriptivo a cada imagen del producto. Debe mapearse con un campo de tu catálogo que contenga la descripción deseada. - Si no se proporciona un valor, el conector generará automáticamente el texto alt usando el título del producto.
- En Shopify, este texto es visible al ver la imagen del producto en la galería de medios y se usa para mejorar el SEO y la accesibilidad.
Este campo se puede configurar: - Usando un campo de texto con descripciones separadas por comas, coincidiendo con el orden de las imágenes.
- Usando un campo tipo tabla, donde cada fila corresponde a la imagen en la misma posición (es decir, la primera fila aplica a la primera imagen, la segunda a la segunda, y así sucesivamente).
|
media_video | No Tipo: string | Este campo permite enviar un video o imágenes 3D desde la biblioteca de archivos de Sales Layer. |
media_video_alt | No Tipo: string | Este campo puede configurarse: - Usando un campo de texto con descripciones separadas por comas, coincidiendo con el orden de las imágenes.
- Usando un campo de tipo tabla, donde cada fila corresponde a la imagen en la misma posición (es decir, la primera fila aplica a la primera imagen, la segunda a la segunda, y así sucesivamente).
|
media_external | No Tipo: string | Es posible enviar una URL de un video externo a través del conector, como añadir un video que tengas en YouTube a un producto específico. Para ello, mapea un campo que contenga las URLs del video o videos. |
media_external_alt | No Tipo: string | Este campo puede configurarse: - Si no se proporciona un valor, el conector generará uno.
- Mediante un campo de texto con descripciones separadas por comas, en el mismo orden que los videos.
- Mediante un campo tipo tabla en una columna donde la primera fila se vincula al primer video, la segunda al segundo, y así sucesivamente.
|
media_order | No Tipo: string | Comportamiento predeterminado en versiones 1.8.x y 1.9.x: Si el campo media_order no está mapeado, el conector ordenará los elementos multimedia usando el siguiente orden predeterminado: - Media Images
- Model 3D
- Media Video
- External Video
|
Comportamiento predeterminado: versión 1.10.x
Si el campo media_order no está mapeado, el conector ordenará los elementos multimedia usando el siguiente orden: - Elementos dentro del campo media_video del conector
- Elementos dentro del campo images del conector
- Elementos dentro del campo media_external del conector
*Recuerda que el orden de los elementos dentro de un campo específico puede controlarse colocando un elemento antes que otro. |
taxable | No Tipo: string| boolean | true|yes|sí => Indica si se aplica un impuesto a un producto (el IVA de este producto).
no => No lo indica. |
compare_at_price | No Tipo: float | Corresponde al precio anterior del artículo. Ejemplo: 100€ - 75€ - 0 → para eliminar el campo compare_at_price.
- Número mayor que 0 → precio anterior. En el ejemplo anterior: 100€
El valor de compare_at_price debe ser mayor que el precio actual.
En Shopify, si no existen variantes, se puede encontrar en la ventana de Precios dentro del producto.
|
markets | No Tipo: table | Habilita los mercados para el producto.
Requiere una tabla con dos columnas: Luego, mapea el campo. |
presentment_prices | No Tipo: table | - Precios por moneda y mercado para el producto.
- Este campo puede definirse en la pestaña Variants.
- Columnas:
- currency_code
- amount
- opcional
- Precio. Es obligatorio, excepto si no deseas modificar el precio.
- Shopify admite hasta dos decimales en el campo de precio, por lo que se recomienda respetar esta restricción.
- compare_at_price
- opcional
- Precio anterior al actual. Debe ser mayor que el precio actual en Amount.
- market
- opcional
- El mercado al que se refiere, que ha sido creado previamente en Shopify y al que pertenece el producto. Si no se completa, se aplicará a todas las monedas de los distintos mercados que no tengan una moneda asignada.
Luego, mapea el campo presentment_prices. |
inventory_management | Tipo: string | En la versión 1.9, el campo inventory_management se convierte automáticamente en el campo tracked, pero se recomienda usar tracked. Las próximas versiones no soportarán inventory_management. Checkbox de Track quantity, mapeado con el campo Inv Management creado específicamente.
En Shopify, si no existen variantes, se puede encontrar en la ventana de Inventario dentro de un Producto
Valores: - ‘shopify’: Sincroniza los valores desde el campo mapeado inventory_quantity de Sales Layer a Shopify
- empty|null: No sincroniza los valores desde el campo mapeado inventory_quantity de Sales Layer a Shopify, aunque inventory_quantity tenga un valor válido.
|
fulfillment_service | No Tipo: string | En la versión v1.8: Información de ubicación, previamente definida en Shopify. Define el servicio de cumplimiento asociado al artículo. Debe mapearse con un campo de tipo texto con los valores: En la versión 1.9, el conector no implementa fulfillment_service. |
grams * | No Tipo: number | En la versión 1.9, se convierte automáticamente en los campos weight y weight_unit. Se recomienda usar weight_unit y establecer weight en su lugar. (No funciona si los campos weight y weight_unit están habilitados) Peso (si la casilla de producto físico está marcada como verdadera) - En Shopify se puede encontrar en la ventana de envío de la variante
|
