Gestionar colecciones VTEX masivamente con CSV: guía operativa

Para agregar productos a una colección VTEX de forma masiva necesitas una lista de SKU IDs en CSV, tus credenciales App Key y App Token, y una herramienta que hable con la API de VTEX. Con VTEX Reemplazar subes el CSV, revisas un preview de qué se agrega, se quita y se mantiene, y aplicas los cambios con un clic.

Esta guía cubre el flujo completo: qué necesitas preparar, cómo debe verse el archivo, cómo interpretar el preview antes de tocar producción y cómo auditar el resultado. Está pensada para quien administra un catálogo VTEX real: cientos o miles de SKUs, colecciones que rotan cada temporada y cero tiempo para hacerlo a mano.

¿Por qué actualizar colecciones a mano no escala?

El admin de VTEX resuelve bien la gestión producto por producto, pero se vuelve un cuello de botella cuando la operación crece. Armar una colección de campaña con 300 productos implica buscar cada uno, agregarlo y verificar que quedó. Quitar los que ya no van es el proceso inverso. Es trabajo mecánico, lento y propenso a errores: un producto que se te pasó, otro duplicado, una colección de oferta que salió a producción con artículos de precio regular.

Y hay un problema adicional: cuando el cambio se hace a mano, producto por producto, es difícil reconstruir después qué se modificó. Si la colección amaneció distinta a lo que el área comercial pidió, no tienes un punto de partida claro para investigar.

La alternativa es tratar la colección como datos: una lista de SKU IDs define qué debe contener, y una herramienta se encarga de que la realidad coincida con esa lista.

¿Qué necesitas antes de empezar?

Solo tres cosas:

• La lista de SKU IDs que debe contener la colección. Normalmente sale de tu ERP, de un Excel maestro del área comercial o de un export de catálogo.
• El ID de la colección que vas a actualizar. Si no lo tienes a mano, VTEX Gestor lista todas tus colecciones con nombre e ID.
• Credenciales de API de VTEX: un par App Key / App Token con permisos sobre catálogo. Se generan desde el admin de VTEX; el detalle está en la documentación oficial de VTEX.

Con eso, entras a Clico (crear una cuenta es gratis durante la Beta), conectas tu cuenta VTEX una sola vez y ya puedes operar.

¿Qué formato debe tener el CSV?

El formato es deliberadamente simple: un SKU ID por fila.

102034
102035
102047
102101

Algunas notas prácticas:

• No necesitas columnas adicionales (nombre, precio, stock): solo los IDs.
• Puedes armar la lista en Excel o Google Sheets y guardarla como CSV.
• El archivo representa el estado final deseado de la colección, no solo "lo nuevo". Esa idea es la clave para entender el preview.

¿Cómo funciona el flujo con VTEX Reemplazar paso a paso?

Somos los creadores de Clico, así que esta parte tómala como lo que es: nuestra propuesta, con sus razones. El flujo:

1. Conecta tu cuenta VTEX. Ingresas App Key y App Token una vez; quedan cifradas y asociadas a tu usuario. Puedes guardar múltiples cuentas si manejas varias tiendas.
2. Elige la colección que vas a actualizar.
3. Sube el CSV con la lista de SKU IDs.
4. Revisa el preview. La herramienta compara tu lista contra el contenido actual de la colección y clasifica cada producto en tres estados.
5. Aplica los cambios. Solo cuando confirmas, se ejecutan las operaciones vía la API de VTEX.

El preview es la parte que te protege de errores:

Si el preview muestra algo raro — por ejemplo, 200 productos por quitar cuando esperabas 20 — es señal de que tu CSV está incompleto o de que apuntaste a la colección equivocada. Lo detectas antes de aplicar, no después, y nada llega a producción hasta que confirmes.

¿Para qué casos de uso sirve el reemplazo masivo?

• Rotación de temporada. La colección de "Novedades" o "Temporada" cambia de contenido cada ciclo. En lugar de vaciar y recargar a mano, subes el CSV de la nueva temporada: lo viejo sale, lo nuevo entra, lo que se repite se mantiene.
• Black Friday, Cyber Wow y campañas de oferta. El área comercial te pasa el listado de SKUs en promoción y lo conviertes en colección en minutos. Si además estás armando los links de la campaña, el UTM Builder te ayuda a etiquetarlos sin errores.
• Limpieza post-campaña. Cuando la campaña termina, a veces no quieres reemplazar sino vaciar. VTEX Limpiar vacía una o varias colecciones a la vez: ingresas los IDs separados por comas y, antes de confirmar, te muestra cuántos productos tiene cada una.
• Sincronización periódica con tu ERP. Si tu fuente de verdad es un sistema externo, puedes regenerar el CSV cada semana y reaplicarlo: la colección converge al estado del ERP sin trabajo manual.

¿Cómo auditar tus colecciones después de los cambios?

Aplicar cambios masivos sin verificar es casi tan riesgoso como hacerlos a mano. Para el control posterior está VTEX Gestor: lista todas tus colecciones con nombre, ID, tipo (manual o automática), cantidad de productos y fechas de creación y modificación, con filtros y export a CSV.

Un flujo de auditoría simple:

1. Antes de la operación, exporta la lista de colecciones a CSV (la foto del "antes").
2. Aplica los cambios con VTEX Reemplazar.
3. Vuelve a exportar y compara las cantidades de productos en Excel o Sheets.

Si la colección de campaña pasó de 480 a 300 productos y eso coincide con tu lista, la operación salió bien. Si no coincide, tienes el dato concreto para investigar.

¿Qué tan seguras están tus credenciales VTEX?

Es la pregunta correcta: un App Token con permisos de catálogo es una llave sensible. En Clico, las credenciales se guardan cifradas y quedan asociadas a tu cuenta de usuario. Puedes guardar múltiples cuentas VTEX y alternar entre ellas, útil si eres agencia o manejas varias tiendas del mismo grupo.

Una buena práctica adicional: genera un par App Key / App Token dedicado para esta integración, con los permisos mínimos necesarios sobre catálogo. Así puedes revocarlo desde VTEX en cualquier momento sin afectar otras integraciones. Más detalle sobre cómo funciona Clico por dentro en la documentación.

Todo lo anterior está disponible gratis durante la Beta de Clico; el plan Pro cuesta USD 5/mes (S/19 con Yape en Perú) al momento de escribir esto, en julio 2026.