Configuración en Sales Layer

Después de la configuración en VTEX, puedes comenzar con los pasos en Sales Layer que se describen a continuación.

En primer lugar, debes acceder a tu tablero de control de Sales Layer en https://cloud.saleslayer.com/?i=en&xss=3rdhbpowzbbt1l e ir a la opción de Canales en el menú de la izquierda:

A continuación, seleccionar la pestaña Tienda de canales, y buscar en el cuadro de conectores el correspondiente a VTEX, como se muestra en la segunda imagen:

Pulsa crear para empezar a configurar el canal.

Parámetros

En la pestaña Parámetros, tendrás que introducir la API Key y el API Token, obtenidos en el paso anterior. También tendrás que indicar el nombre de tu tienda (aquel asignado para tu empresa en VTEX):

Hacer clic en el botón verde Connect to Vtex situado en la esquina inferior izquierda, y aparecerá el siguiente mensaje:

Apunta: si esto no sucede, y aparece el siguiente mensaje, verificar los pasos previos realizados en VTEX, y si la API key, el API token o el shop name están correctos.

Cuando te hayas conectado con éxito a VTEX, aparecerán nuevos campos para continuar la configuración:

Root category: en caso de tener categorías anteriores creadas, se puede seleccionar una de ellas, de lo contrario, se puede dejar vacía.

In update overwrite stock: seleccionar "Sí" o "No" en función de si desea actualizar las existencias de Sales Layer a VTEX. Solamente en la primera sincronización, no se tendrá en cuenta esta selección, ya que necesitará enviar el stock, si el campo está incluido en Datos de salida.
Selected Warehouse: hay que elegir el almacén al que se va a sincronizar, creado en el paso anterior en VTEX.
Exportar ítems con Estado:

Solo visibles: esta opción le permitirá crear o modificar artículos solo en este estado. Si has cambiado el estado de un grupo de artículos de visible a otro estado, el conector cambiará el estado del producto/variante a inactivo, (si se trata de categorías a invisible).
Todos: esta opción le permitirá crear o modificar todos los artículos. Si esta es la configuración, los borradores y los productos invisibles se crearán como activos.
Sólo visibles: esta opción le permitirá crear o modificar artículos solo en este estado. Si has cambiado el estado de un grupo de artículos de visible a otro estado, el conector cambiará el estado del producto/variante a inactivo, (si se trata de categorías a invisible).
Visibles e invisibles: esta opción le permitirá crear o modificar artículos sólo en estos estados. Si has cambiado el estado de un grupo de artículos de visible o invisible a borrador, el conector cambiará el estado del producto/variante a inactivo, (si se trata de categorías a invisible).
Visibles y borradores: esta opción le permitirá crear o modificar artículos sólo en estos estados. Si has cambiado el estado de un grupo de elementos de visible o borrador a invisible, el conector cambiará el estado del producto/variante a inactivo, (si se trata de categorías a invisible).

Apunta: si quieres tener un comportamiento diferente para el Estado, puedes crear un campo Sales Layer llamado "status", vincularlo al campo correlativo en VTEX y tener una funcionalidad alternativa.

Incluir las categories vacías: esta selección le permitirá incluir aquellos productos que no tienen ninguna categoría relacionada.
Idioma a conectar: puedes seleccionar inglés o español. Si seleccionas el idioma secundario (diferente del primario), se mostrará la siguiente opción, y si se activa, añadirá automáticamente los textos del idioma original en los campos vacíos de los otros idiomas.

Por último, hacer clic en el botón verde Continuar, en la esquina inferior derecha de la pantalla.

Datos de salida

En esta pestaña hay tres secciones: Categorías, Productos y Variantes.

Tendrás que hacer el mapeo de campos correspondiente en cada una de ellas, seleccionando el campo relacionado de Sales Layer, que se ajuste al de la columna Nombre en VTEX.

Apunta: recuerda que puedes utilizar fórmulas para rellenar cualquier campo que necesites. Para obtener más información sobre las fórmulas, accede al siguiente enlace en nuestro Centro de Soporte: Fórmulas.

Atento: si en el mapeo de campos (categorías, productos y variantes) hay **campos vacíos**, la sincronización se comportará según los siguientes escenarios:

si se están creando artículos, la sincronización fallará para todos los artículos implicados, ya que cada campo debería haber sido mapeado.
si se están creando artículos, la sincronización borrará el contenido VTEX de ese campo para todos los artículos implicados.

Si no hay ningún mapeo relevante a realizar, los campos vacíos deberían estar siempre desactivados.

Si ya tienes una tienda en VTEX y no necesitas sincronizar campos específicos, porque quieres proteger ese contenido, puedes deshabilitarlos en el conector. Para ello, puedes seleccionarlos con la casilla que cada campo tiene a su izquierda y en el botón Acciones (en la parte superior de la pantalla) elegir Desactivar elementos seleccionados.

Aparecerá una ventana pidiendo confirmación, y al escribir y hacer clic en Desactivar, dichos campos se mostrarán como en la segunda imagen:

Apunta: se recomienda tener las categorías en VTEX siempre en estado activo para evitar problemas con la sincronización.

Atento: al desactivar y reactivar una Categoría en VTEX, podría surgir un error inesperado. Si esto ocurre, puedes borrar las categorías involucradas en VTEX y forzar la actualización desde el conector, para que se restablezcan.

En Productos, también podrás seleccionar el tipo de campo, entre Normal, Imagen, Archivo... para algunos casos:

En estas tres secciones podrás añadir nuevos campos con estos botones al final de la página.

En VTEX tienes múltiples campos estándar para añadir, estos son los que puedes añadir al canal:

Categorías:

Campo en Sales Layer	Campo en VTEX	Tipo	Obligatorio	Descripción
Reference		string	Sí	Referencia de producto de Sales Layer. En Vtex no existe, sólo se utiliza para tener datos únicos para tener los datos correctos.
Suggested ID	ID	integer		Identificador único de categoría. Si no rellena, VTEX lo generará automáticamente.
Name	Name	string	Sí	Nombre de la categoría.
Keywords	Keywords	string		Sustituye palabras para la categoría.
Title	Title	string	Sí	Texto usado en el título para la página de categoría.
Description	Description	string		Texto utilizado en la etiqueta meta description de la página Categoría.
Google Merchant Category Id	VTEX Global Category	string	Sí	Categoría global VTEX. Encontrará la lista de todos los valores posibles debajo de la tabla.
AdWorksRemarketingCode	AdWordsRemarketingCode	string \| null		Es un campo heredado. No tenga en cuenta esta información.
LomadeeCampaignCode	LomadeeCampaignCode	string \| null		Es un campo heredado. No tenga en cuenta esta información.
	FatherCategoryId	integer \| null		ID de la categoría padre, aplicar en caso de categoría y subcategoría.
	GlobalCategoryId	integer \| null		Google Global Category ID.
Create a field ‘store_front’	ShowInStoreFront	integer		Si es verdadero, la categoría se muestra en el menú superior y lateral.
For the connector to send this field correctly, the 'Visibility' field must be set to 'All'. In addition, the user must add a lowercase 'Status' field to Output Data > Categories.	IsActive	boolean		Si es verdadero, la página categoría estará disponible en la tienda.
Create a field ‘store_front_link'		boolean		Si es verdadero, el enlace categoría se activa en la tienda.
ShowBrandFilter				Si es verdadero, la página categoría muestra un filtro Marca.
Score				Puntuación por orden de búsqueda.
StockKeepingUnitSelectionMode				Define cómo se expondrá la SKU.

Note: enlace a los posibles valores: https://support.google.com/merchants/answer/6324436?hl=en

Productos

Campo en Sales Layer	Campo en VTEX	Tipo	Obligatorio	Descripción
Reference		string	Sí	Referencia de producto de Sales Layer.
	ID	integer		Identificador numérico único del producto. Si no se informa, será generado automáticamente por VTEX.
Name	Name	string	Sí	Nombre del producto. Limitado a 150 caracteres.
	CategoryPath	string		Ruta de las categorías asociadas a este producto, desde el nivel más alto de categoría hasta el nivel más bajo, separadas por '/'. Es obligatorio utilizar este campo o el campo 'CategoryId'.
	CategoryId	integer		ID de una categoría existente que se asociará a este producto. Es obligatorio utilizar este campo o el campo "CategoryPath".
Brand	BrandName	string		Nombre de la marca que se asociará a este producto. Es obligatorio utilizar este campo o el campo "BrandId". Si desea crear una nueva marca, es decir, en caso de que la marca aún no exista, utilice este campo en lugar de 'BrandId'.
	BrandId	string		ID de una Marca existente que se asociará a este producto. Es obligatorio utilizar este campo o el campo 'BrandName'.
	LinkId	string		Slug que se utilizará para construir la URL de la página del producto. Si no se informa, se generará según el nombre del producto, sustituyendo los espacios y caracteres especiales por guiones (-).
	RefId	string		Código de referencia del producto, si SKU no existe. Sólo puede haber una referencia (SKU o RefId).
Visibility	IsVisible	boolean		Muestra (true) u oculta (false) el producto en los resultados de búsqueda y en las páginas de producto, pero el producto puede seguir añadiéndose al carro de la compra. Normalmente es aplicable para regalos.
Description	Product Description	string		Por defecto, el conector publica los productos marcados como visibles y deja el resto sin publicar.
	DescriptionShort	string		Descripción del producto.
release_date Ejemplo"2019-01-01T00:00:00"	ReleaseDate	string		Store Framework: Portal CMS heredado: Palabras clave o sinónimos relacionados con el producto, separados por coma (,). "Televisión", por ejemplo, puede tener una palabra sustituta como "TV". Este campo es importante para que sus búsquedas sean más completas.
	Keywords	string		Etiqueta del título del producto. Limitada a 150 caracteres. Se presenta en la pestaña del navegador y corresponde al título de la página del producto.
Title	Title	string		Este campo es importante para el SEO.
Si el conector no recibe ‘title’, se genera a partir del campo 'Name'
status	IsActive	boolean
	TaxCode	string
	MetaTagDescription	string
	ShowWithoutStock	boolean
	Score	integer

Variantes

Campo en Sales Layer	Campo en VTEX	Tipo	Obligatorio	Descripción
Variant Reference		string	Sí	Referencia de variante de Sales Layer.
	ID	integer		Identificador único SKU. Si no se informa, será generado automáticamente por VTEX.
	ProductId	integer		ID del Producto asociado a esta SKU.
	IsActive	boolean		Define si la SKU está activa (true) o no (false). Durante la creación de una SKU, no defina este campo como verdadero o recibirá un error 400 Bad Request. Deberá activar la SKU después, como se explica en Activación de una SKU.
Actualmente, el conector no soporta este campo.	ActivateIfPossible	boolean		Si se establece en “true”, este atributo actualizará automáticamente la SKU como activa una vez asociada con una imagen o un componente activo. Se recomienda establecerlo en true, a menos que se prevea un flujo de trabajo interno para activar manualmente las SKUs.When set to true, this attribute will automatically update the SKU as active once associated with an image or an active component. Se recomienda establecerlo en true, a menos que tenga previsto un flujo de trabajo interno para activar manualmente las SKU.
Variant name	Name	string	Sí	Nombre SKU, es decir, la variación del producto añadido anteriormente. Por ejemplo: Producto - Frigorífico, SKU - 110V. Limitado a 200 caracteres.
	RefId	string		Código de referencia utilizado internamente con fines organizativos. Debe ser único. Obligatorio sólo si no se informa del Ean, pero también puede utilizarse junto con el Ean.
EAN	EAN	string		Código EAN. Obligatorio sólo si RefId no está informado, pero también puede utilizarse junto a RefId. Si el campo está vacío y sin fórmulas, no tiene ningún efecto. No sobrescribirá el contenido actual de los valores establecidos en la cuenta VTEX. Solo se permite un EAN. Si se cambia el EAN en el lado VTEX, no tendrá efecto en el lado Capa de Ventas. Esto significa que la capa de ventas no volverá a enviar el EAN a VTEX a menos que se realicen cambios en el lado de la capa de ventas. Por lo tanto, las modificaciones realizadas en el EAN en VTEX (modificaciones no realizadas por el conector SL) no se sobrescribirán, aunque estos valores difieran de los establecidos en el campo asignado de los conectores dentro de la cuenta PIM.
PackagedHeight	PackagedHeight	number		Altura utilizada para el cálculo del envío.
PackagedLength	PackagedLength	number		Longitud utilizada para el cálculo del envío.
PackagedWidth	PackagedWidth	number		Anchura utilizada para el cálculo del envío.
PackagedWeightKg	PackagedWeightKg	integer		Peso utilizado para el cálculo del envío, en la medida configurada en la tienda, que por defecto es en gramos. No rellene este campo con 0 o nulo, ya que podría dar lugar a problemas de envío.
Height	Height			Altura real de la SKU.
Length	Length			Longitud real de la SKU.
Width	Width			Anchura real de la SKU.
WeightKg	WeightKg			Peso de la SKU en la medida configurada en la tienda, que por defecto es en gramos.
CubicWeight	CubicWeight			Peso cúbico.
IsKit	IsKit			Flag para establecer si la SKU del producto está compuesto por uno o más SKUs, convirtiéndose así en un bundle. Debe activarse si va a añadir un paquete. Una vez activada, la bandera no se puede revertir. Fecha y hora de creación de la SKU.
CreationDate	CreationDate	string		Fecha y hora de creación de la SKU.
RewardValue	RewardValue	string		Para añadir el producto como preventa, introduzca la fecha estimada de llegada del producto en formato ISO-8601. Debe tener en cuenta tanto la fecha de lanzamiento como el cálculo del flete para la fecha de llegada.
EstimatedDateArrival	EstimatedDateArrival	string \| null		Proporcionado por los fabricantes para identificar su producto. Este campo debe rellenarse si el producto tiene un código de fabricante específico.
ManufacturerCode	ManufacturerCode	string		Proporcionado por los fabricantes para identificar su producto. Este campo debe rellenarse si el producto tiene un código de fabricante específico.
	CommercialConditionId	integer		Se utiliza para definir promociones específicas de SKU o reglas de pago a plazos. Si no hay ninguna condición específica, utilice 1 (valor por defecto). Este campo no acepta 0. Más información en Registrar una condición comercial.
MeasurementUnit	MeasurementUnit	string		Unidad de medida de la SKU.
UnitMultiplier	UnitMultiplier	number		Este es el número múltiple de SKU. Si el Multiplicador es 5.0000, el producto puede ser añadido en cantidades múltiples de 5, 10, 15, 20, en adelante.
ModalType	ModalType	string \| null		Vincula un tipo inusual de SKU a un transportista especializado en su entrega. Este campo debe rellenarse con el nombre del modal (por ejemplo, "Productos químicos" o "Productos refrigerados"). Para saber más sobre esta función, lea nuestros artículos Cómo funciona el modal y Configuración del modal para transportistas.
KitItensSellApart	KitItensSellApart	boolean		Define si los componentes del kit pueden venderse por separado.

Nota: si añades nuevos campos en el mapeo desde la lista estándar de VTEX tendrás que renombrarlos siempre en minúsculas.

Por último, en Variantes puedes mapear todos los campos necesarios, tal y como se hace en Categorías y Productos:

Cuando se haya completado la asignación de campos, puedes hacer clic en el botón Guardar y completar en el extremo derecho de la página.

Después de esto, podrás ver el canal en tu panel:

Al guardar el conector empezará a sincronizar automáticamente y luego, lo hará de nuevo entre los siguientes 10 minutos y 3 horas, dependiendo de la carga de la API, siempre que haya habido un cambio en cualquier elemento.

Consideraciones sobre la sincronización

Además de seguir la configuración relativa al estado de los ítems, el conector sincronizará cualquier ítem que pueda haber sufrido cambios en Sales Layer (incluso si fue originado por categorías o variantes relacionadas).
Sincronizará cualquier elemento que pueda verse afectado o sea relevante por alguna modificación del conector (como la adición de mapeo de categorías, o ajustes de sincronización, por ejemplo).
No sincronizará artículos previos (que se hayan sincronizado antes) y que no hayan tenido ningún cambio o no sean relevantes para la modificación de un conector.
Si se está conectando a una tienda pre-existente en VTEX, los elementos anteriores que no existan o no estén configurados para ser sincronizados en Sales Layer, no serán modificados por ninguna sincronización.
Para más información sobre este tema puede ir al siguiente enlace en nuestro Centro de Soporte: https://support.saleslayer.com/es/api/introduccion.

Si se debe lanzar una sincronización completa, es decir, sincronizar todos los elementos, anteriores y nuevos, todos los campos, hayan sido modificados o no, además de seleccionar las opciones pertinentes, puedes utilizar el botón Forzar refresco" en la parte superior de la pestaña Parámetros (aparece al guardar el conector). Pero, en el caso de que necesites esta opción debes tener en cuenta que esta acción implicará el envío de TODO tu catálogo completo, campos multi-idioma, imágenes, fórmulas, etc. Esto afectará el tiempo de la sincronización, incrementándola en relación con la duración de la sincronización programada. Además, forzar el refresco no asegura una sincronización inmediata, ya que dependerá de la cola de procesos existente.

Nota: si se crean campos nuevos que no se mencionan en artículos relativos a este conector ni están incluidos en el conector correspondiente(el conector VTEX), se enviarán a la sección de atributos.