El registro de productos en VTEX se organiza en cuatro piezas: el producto, vinculado a una categoría y a una marca; los SKU, que son las variantes vendibles; las especificaciones, definidas por categoría; y las imágenes de cada SKU. Publicar sin retrabajo depende de dejar esas cuatro piezas listas antes de que el producto entre en la tienda.
En VTEX, el catálogo es el centro de la tienda: de él salen la vitrina, la búsqueda, los filtros y los catálogos que van a los marketplaces conectados. Cuando los datos llegan incompletos, el problema se propaga. El filtro de voltaje no funciona, la ficha técnica aparece a medias, y el mismo producto hay que arreglarlo de nuevo en cada canal que lee la tienda.
Muchos equipos cargan los productos directamente en el panel de administración, uno por uno. Funciona mientras el catálogo es pequeño. Con cientos de lanzamientos por temporada, el panel se vuelve un cuello de botella, y la prisa produce justamente las fichas incompletas que después salen caras.
¿Cómo organiza VTEX el registro de productos?
Conviene tener clara la estructura antes de preparar los datos:
- Producto. La ficha general: nombre, descripción, marca, categoría.
- SKU. Cada variante vendible del producto, con código, dimensiones, peso, código de barras e imágenes propias.
- Especificaciones. Los atributos del producto y del SKU, definidos por categoría, que alimentan la ficha técnica y los filtros.
- Categoría. El árbol de la tienda, que decide qué especificaciones puede tener cada producto.
El detalle de la estructura y de los campos está en la documentación oficial de VTEX, en el centro de ayuda y en el portal de desarrolladores. La guía del catálogo de VTEX dice que todo producto se vincula a una categoría y a una marca y tiene al menos un SKU, y que todas las especificaciones deben estar completas para que el ítem quede activo. La lógica general es estable: quien prepara bien el SKU y las especificaciones antes de la publicación evita la mayor parte del retrabajo.
Qué preparar antes
- El árbol de categorías definido. Cambiar la categoría de muchos productos después afecta a las especificaciones y a los filtros. Conviene cerrar el árbol antes del lanzamiento.
- Especificaciones por categoría. Lista qué atributos tiene cada categoría, con los valores aceptados. De ahí salen los filtros que usa el cliente.
- SKU completo. Código, código de barras, dimensiones y peso del embalaje. Un peso o una medida equivocados aparecen después en el cálculo del flete.
- Imágenes por SKU. Cada color o variante con sus propias fotos, en el orden correcto.
- Texto revisado. Nombre y descripción con el estándar de la tienda, sin el texto del proveedor copiado.
La guía de SKU de VTEX pide al menos una imagen asociada al SKU y acepta el EAN como identificador alternativo. Para el código de barras, mira el post sobre GTIN y EAN en el ecommerce; para las fotos, el de fotos de producto por canal.
Publicar sin pasar por encima de lo que ya está en la tienda
Quien publica por integración necesita un cuidado adicional: la tienda no parte de cero. Ya hay productos, alguien ajustó un campo desde el panel, un SKU se desactivó a propósito. Conviene acordar antes qué sistema manda en cada campo, para que la integración y el equipo no se sobrescriban mutuamente.
Otra práctica que ayuda es leer el SKU en la tienda antes de escribir y comprobar después que lo escrito quedó como debía. Parece lento, pero evita el tipo de error que solo aparece cuando el cliente se queja.
Cómo publica AdCore Turbo en VTEX
AdCore Turbo publica los datos de producto en el catálogo de la tienda VTEX. Antes de escribir, lee el SKU en la tienda, y después vuelve a leer lo que escribió para comprobarlo. La ficha en sí está en el PIM, con atributos por familia, aprobación con registro de quién aprobó e historial de versiones, y las fotos quedan vinculadas al SKU en el DAM.
Para quien ya tiene el catálogo en VTEX, la carga de ese catálogo en AdCore Turbo se organiza junto con nuestro equipo, por webhook de SKU, CSV, Google Sheets o API, según el caso. Los detalles de la integración están en la página de VTEX. Lo que se busca es dejar de cargar productos a mano en el panel y llegar a la tienda con la ficha ya completa. Antes de publicar, conviene leer también sobre atributos de producto.