Características especiales del mapeo de los campos

Al instalar el plugin, verás que se crean los siguientes campos en Magento, tanto en el menú Productos como en el de Atributos:

“Sales Layer Product Identification”
“Sales Layer Product Company Identification”
“Sales Layer Product Format Identification”

Atento: estos campos o sus valores funcionan como campos clave en Sales Layer, por lo que no deben ser modificados o eliminados, ya que, de lo contrario, los productos podrían volver a crearse durante la siguiente sincronización.

En caso de que ya tengas tu tienda Magento en funcionamiento y quieras iniciar su primera sincronización con Sales Layer, estos campos clave estarán vacíos. Para evitar duplicados, se realizará una búsqueda entre los elementos existentes según las siguientes reglas:

si se trata de una categoría, la búsqueda se hará por Clave URL y luego por ID de la categoría padre (en caso de que se haya sincronizado antes).
si es un producto, la búsqueda se hará por SKU. Si no se encuentran coincidencias, la búsqueda se hará por nombre.
las variantes se buscarán por SKU.

En caso de que no se encuentren coincidencias, se crearán.

Categorías - Layout/Is Anchor

Estos dos campos son heredados por los parámetros por defecto configurados al crear el conector Magento. En caso de que necesites una configuración diferente para distintas categorías, puedes asignar esta información en el conector utilizando los campos Layout e Is Anchor de la pestaña Categorías. Para obtener información adicional sobre estos campos, puedes consultar: https://docs.magento.com/user-guide/catalog/categories-display-settings.html y https://docs.magento.com/user-guide/catalog/categories-custom-design.html

Productos - Productos agrupados

Uno de los tipos de producto que se puede encontrar en Magento se refiere a los «Productos agrupados» que se puede enviar utilizando nuestro plugin.

Los productos agrupados pueden ser Productos simples, Productos virtuales o Productos descargables, teniendo en cuenta la disponibilidad del artículo si se ha configurado previamente para gestionar el stock.

Hay que tener en cuenta que, como se indica en la sección «Funciones admitidas y no admitidas» de este manual, los productos descargables no son compatibles con nuestro plugin.

Atento: Magento no permite otros productos que no sean simples, virtuales o descargables. En consecuencia, hay que tener en cuenta el tipo de producto al enviar productos agrupados, de modo que el conector pueda procesarlos.

Los productos se pueden agrupar utilizando dos campos predefinidos:

grouping_product_reference_1: este campo se utiliza para enlazar con un campo de artículo relacionado utilizando una única referencia.
grouping_product_reference_X: sustituye X por un número igual o superior a 2 si quieres enviar más de un producto. Deberás crear tantos campos como productos que quiera agrupar en Magento.

Nota: el campo grouping_product_reference_X solo acepta una referencia por campo: en caso de que el campo contenga más de una referencia, solo se enviará a Magento la primera.

Atento: la referencia que se está procesando no puede incluirse como referencia agrupada. En otras palabras, las referencias de agrupación de productos no pueden contenerse a sí mismas. Tampoco podrá agrupar variantes de su mismo producto.

Al enviar grouping_product_quantity_1 o bien grouping_product_quantity_X, donde X es un número igual o mayor que 2, estamos enviando la cantidad de existencias del producto agrupado correspondiente al índice escrito en el nombre del campo.

Nota: si no se envía el campo grouping_product_quantity_X, el valor resultante en Magento será 0.

Las variantes se podrán agrupar utilizando la misma regla, pero sustituyendo «producto» por «format» o «variant» en el nombre del campo.

Variantes

Los distintos productos pueden tener diferentes atributos en sus variantes. Sin embargo, no es posible tener las mismas variantes de producto con atributos diferentes. Es decir, todas las variantes bajo el mismo producto padre tienen que tener los mismos atributos rellenados, ya que de lo contrario, no se sincronizarán.

Por ejemplo, no es posible tener una variante de un producto con únicamente la «talla» seleccionada, y otra variante del mismo producto con el «color» seleccionado. Ambas variantes deben tener seleccionados tanto «tamaño» como «color», o bien solamente uno de estos atributos.

Variantes como productos

La versión 2.4.7 y superiores de nuestro plugin ofrecen la opción de procesar las variantes de Sales Layer como productos en Magento, lo que significa que las variantes que tengas en Sales Layer se sincronizarán como productos individuales en Magento.

Para seleccionar esta opción en el plugin Sales Layer, deberás marcar «Sí» en el siguiente parámetro:

Tras seleccionar esta opción, la tabla de productos de la pestaña Datos de salida se ocultará automáticamente, y los campos de producto existentes se añadirán a la tabla de variantes. Además, se eliminarán los filtros colocados anteriormente en la pestaña de productos para evitar filtros ocultos y garantizar que la información se envía correctamente.

Puntos a tener en cuenta sobre el funcionamiento de la API

En la sincronización inicial o en las actualizaciones del conector, se enviarán todos los productos.
Al modificar una variante, todas las variaciones de un producto serán enviadas considerando los filtros del conector. Si un producto en Sales Layer tiene 50 variantes, al modificar una variante se sincronizarán 50.
Al modificar una variante, se enviará el elemento padre de nivel superior (producto padre de la variante). Por tanto, si quieres enviar categorías, se recomienda cambiar el estado y modificarlas junto con las variantes que se quieran sincronizar.

Aspectos que debes tener en cuenta sobre el proceso

Todos los campos de variante se convertirán en campos de producto.
Como la tabla de productos no está activa en el conector, filtrar artículos solo será posible en los niveles de categoría o variante.
Las variantes se sincronizarán con las categorías asociadas a sus productos padre. Si la opción de enviar categorías en blanco está en «Sí», se sincronizarán todas las categorías filtradas por el conector, y si está en «No», solo se sincronizarán las categorías asociadas a productos con variantes. No olvides que es obligatorio tener categorías en los productos para generar el artículo principal en Magento.
Los campos adicionales (para atributos configurables) se cambiarán por atributos de producto, pero el funcionamiento en Magento es el mismo.
Los campos de producto agrupado deben tener la siguiente nomenclatura en la pestaña variante: 'grouping_format_reference_X' / 'grouping_variant_reference_X' y 'grouping_format_quantity_X' / 'grouping_variant_quantity_X'. En el momento de la reorganización se convertirán para que puedan procesarse como productos.
Los ID de Sales Layer de la variante se cambiarán por los del producto, por lo que si la opción «Procesar variantes como productos» está desactivada, habrá que borrar los productos existentes o eliminar los valores de los atributos de Sales Layer de la base de datos. De lo contrario, los datos se sobrescribirán al sincronizar, lo que podría provocar errores de duplicación.
Las variantes que se deseen eliminar o modificar se convertirán en productos a eliminar para poder ser desactivadas.