Importación Manual de Catálogo
El presente documento, detalla el proceso y la estructura necesaria para la gestión de productos y sus variantes (SKUs) en VTEX, contemplando la relación con las categorías y características previamente definidas dentro del catálogo.
¿Cómo funciona el proceso de importación manual de Productos/Sku's?
Para realizar el proceso de de importación manual, el usuario de negocio deberá:
- Ingresar a la opción Catálogo | Productos y Sku´s
- Descargar de plantilla de Importación de productos/sku (template), dentro del menú Importar | Productos y Skus.
- Completar información requerida.
- Validar la estructura y datos.
- Cargar del archivo en VTEX a través de la opción Importar.
- Revisar el procesamiento y generación de logs de resultado
- A continuación, deberá descargar el archivo especificaciones de producto, para importar los atributos e importar los mismos.
- Luego, deberá descargar el archivo, para importar las imágenes, para importar las imagenes de los mismos.
🚨 Consideraciones clave
- La estructura de los archivos debe respetar el formato definido por VTEX.
- Product ID, Product reference code, SKU ID, SKU reference code
- Las imágenes deben estar disponibles mediante URL pública.
- Es recomendable validar archivos antes de importar grandes volúmenes.
- La/s categoria/s a la/s que pertenece/n los productos, deben estar previamente cargadas con sus respectivos atributos. Caso contrario, deberá crear la categoria previamente.
💡 Buenas prácticas
- Realizar pruebas con pequeños volúmenes antes de cargas masivas.
- Mantener consistencia en atributos y nomenclaturas.
- Evitar duplicación de productos o SKUs.
- Versionar archivos de importación para trazabilidad.
⚠️ Errores comunes y resolución
ERROR | DESCRIPCIÓN | COMO SOLUCIONARLO |
Campos obligatorios vacíos |
Faltan datos esenciales como nombre, categoría o identificadores, lo que provoca errores o registros incompletos en la importación.
|
Validar que todas las columnas obligatorias estén completas y sin filas vacías intermedias.
|
Inconsistencia entre producto y SKU
|
Diferencias en nombres o códigos dentro de un mismo producto generan duplicaciones o fallas en la asociación de variantes.
|
Mantener consistencia en nombre y código base del producto, diferenciando solo atributos de SKU.
|
Duplicidad de combinaciones de SKU
|
Se repiten combinaciones de atributos (como color y talle), lo que impide la correcta creación de variantes únicas.
|
Asegurar que cada combinación de atributos sea única antes de importar.
|
Formato incorrecto de datos
|
Valores mal formateados (números como texto, uso de símbolos, codificación incorrecta) generan rechazos en la carga.
|
Utilizar formatos correctos (números sin símbolos, UTF-8) y validar el archivo antes de cargarlo.
|
URLs de imágenes inválidas
|
Enlaces inaccesibles o mal estructurados impiden la correcta visualización de imágenes en los productos.
|
Verificar que las URLs sean públicas, estén en HTTPS y sean accesibles desde un navegador.
|
Errores en dimensiones o atributos
|
Valores inválidos en peso, tamaño o atributos técnicos afectan la publicación o logística del producto.
|
Validar que los valores sean correctos, mayores a cero y en las unidades correspondientes.
|
Problemas de estructura de categorías
|
Jerarquías mal definidas o categorías duplicadas generan asignaciones incorrectas dentro del catálogo.
|
Revisar la estructura (departamento, categoría, subcategoría) y evitar duplicaciones.
|