La integración del catálogo XML de VTEX te permite sincronizar el catálogo de productos de tu tienda VTEX con Connectif, generando un feed XML personalizado. Esta integración permite importar tus productos a Connectif y sincronizarlos de forma masiva fácilmente.
En este artículo, aprenderás cómo generar tu feed XML para VTEX y cómo sincronizarlo con Connectif.
Dificultad: Baja.
¿Cuándo utilizarlo?: Al abrir tu cuenta en Connectif.
Antes de empezar: requisitos previos
Para poder integrar tu catálogo XMLde Vtex con Connectif, necesitarás:
Acceso al Admin de VTEX.
Permisos administrativos para crear y gestionar plantillas XML.
Una Colección en VTEX que incluya todos los productos que desees exportar al feed XML (consulta la documentación de VTEX para configurarla).
PASO 1. Configuracion del XML en VTEX
1.1. Creación de la plantilla XML en VTEX
1. Accede al panel de administración de VTEX, dirígete a "Configuración de la Tienda > Canales" y haz clic en Integración XML.
2. Haz clic en Nuevo XML.
3. En Tipo de XML, escoge la opción Open XML (por defecto).
4. Asigna un Nombre de Archivo para identificarlo.
5. Completa los campos:
En Tipo de Codificación, escoge la opción UTF-8 (por defecto).
En Colección, escoge la colección de productos que serán listados.
En Formato de precios escoge la opción Por defecto.
En Separador de categorías escoge la opción Google Shopping.
6. Marca la casilla Mostrar producto con SKU estándar.
1.2. Definición de los campos del producto en VTEX
7. En el área referente al Tag raíz, completa la información tal como se ve en la siguiente imagen o como se indica en la documentación oficial de VTEX.
8. Configura la plantilla XML para que incluya la información de producto, tal como se indica en la siguiente tabla:
| Campo en Connectif | Campo VTEX | Campo en XML |
|---|---|---|
ID externa del producto |
ID producto |
id |
Nombre |
Nombre de sku |
title |
Precio unitario |
Precio actual del SKU + Tasas |
sale_price_with_tax |
Precio unitario original |
Precio actual del SKU + Tasas |
sale_price_with_tax |
Precio unitario sin impuestos |
Precio actual del SKU |
sale_price |
URL de detalle |
Link |
link |
Categorías |
Departamento + Categoría |
g:product_type |
URL de imagen |
Imagen |
image_link |
Descripción |
Descripción de producto |
description |
Disponibilidad |
Disponibilidad Google Shopping |
g:availability |
Marca |
Marca |
brand |
En esta tabla tienes las referencias para completar la información en VTEX:
- Campo en Connectif: es el nombre del campo tal como aparece en la Ficha de Producto de Connectif.
- Campo en VTEX: es el nombre tal como aparece en la interfaz de VTEX como referencia.
- Campo en XML: es la información que debes incluir en el input de VTEX.
Por ejemplo, para asociar el campo ID externa del producto de Connectif, en VTEX deberás introducir "id" en el área ID producto; para asociar el campo Nombre de Connectif, en VTEX deberás introducir "title" en el área Nombre del SKU.
9. Haz clic en Guardar.
10. Con todo listo, el XML tendría el siguiente aspecto:
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<channel>
<item>
<id><![CDATA[ 1 ]]></id>
<title><![CDATA[ Product ]]></title>
<description><![CDATA[ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sollicitudin orci et dolor lobortis, nec elementum metus mattis. Vestibulum et commodo ante. ]]></description>
<g:product_type><![CDATA[ Level 1 > Level 2 > Level 3 > Level 4 ]]></g:product_type>
<brand><![CDATA[ Brand ]]></brand>
<link><![CDATA[ https://connectif.vtexcommercestable.com.br/product/p?idsku=13 ]]></link>
<image_link><![CDATA[ https://connectif.vteximg.com.br/arquivos/ids/155403_2 ]]></image_link>
<sale_price><![CDATA[ 6,00 ]]></sale_price>
<sale_price_with_tax><![CDATA[ 7,00 ]]></sale_price_with_tax>
<g:availability><![CDATA[ in stock ]]></g:availability>
</item>
</channel>
</rss>
1.3. Generación de la URL del Feed XML
11. Una vez guardada la plantilla, VTEX generará el feed XML y, en la columna URL estará disponible la URL pública del mismo, que tendrá un aspecto similar al siguiente:
https://{tu-workspace}.vtexcommercestable.com.br/XMLData/{nombre-de-tu-plantilla}.xml12. Accede a esa URL desde un navegador y comprueba que el XML se está generando correctamente.
PASO 2. Sincronización del feed XML con Connectif
13. Accede a tu Tienda de Connectif, dirígete a "Ecommerce> Catálogo" y haz clic en Sincronización de productos.
14. Ve a la pestaña Feed de productos y haz clic en Configurar.
15. En el área Añadir feed de productos, añade la URL del feed de productos que acabas de crear.
16. Vincula los parámetros de tu Feed XML con los de la Ficha de Producto de Connectif.
Si necesitas más información sobre cómo sincronizar tu feed con Connectif, revisa este artículo.
17. Una vez determinada la configuración de la sincronización, haz clic en Activar para programar la sincronización, o en Activar y sincronizar inmediatamente para ejecutar una sincronización y programar la siguiente dentro del período establecido.
¡Éxito!
Has sincronizado tu Catálogo XML de VTEX con Connectif.
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
Integración personalizada para enviar datos, para enviar datos desde Connectif a sistemas o aplicaciones externos.
Detectar y reaccionar a enlaces web creados fuera de Connectif, para detectar y reaccionar a los clics en cualquier enlace de tu web.
Integración con Facebook e Instagram, para conectar tu cuenta de Facebook Ads con Connectif y empezar a gestionar tus audiencias.
Formularios integrados, para integrar en Connectif formularios ya existentes en tu web.