Configuración inicial

Canales de venta

Configurá al menos un canal donde vas a publicar. Cada canal necesita sus credenciales.

1. Andá a Canales en el menú lateral y hacé clic en "Nuevo".
2. Seleccioná el tipo de canal y completá las credenciales:

Canal	Credencial 1	Credencial 2	Base URL / Extra
VTEX	appKey	appToken	accountName
MercadoLibre	appId	clientSecret	OAuth (botón autorizar)
Tiendanube	clientId	clientSecret	OAuth
Shopify	accessToken	-	store.myshopify.com
Google Merchant	-	-	merchantId + Service Account
Rappi	clientId	clientSecret	storeId + country
PedidosYa	clientId	clientSecret	chainId + vendorId

Marcas y categorías

Se usan para auto-asignar datos al subir productos y para publicar en VTEX.

1. Andá a Catálogo > Marcas. Cargalas una por una o usá "Importar CSV".
2. El CSV de marcas necesita columnas: name, vtex_brand_id, aliases, local.

   Tip: Los aliases de marca sirven para el auto-matching. Si tu ERP dice "NIKE SA" pero la marca es "Nike", agregá "NIKE SA" como alias.

3. Andá a Catálogo > Categorías. Cargalas manual o por CSV.
4. El CSV de categorías necesita: erp_key, department_name, vtex_department_id, category_name, vtex_category_id.
5. En cada marca/categoría podés hacer clic en "Generar descripción con IA" para crear Tag Title, descripción HTML y meta descripción SEO.

Especificaciones de producto

Atributos como material, estilo, tipo de calce, género. Se definen por categoría y aparecen como campos editables al catalogar.

1. Andá a Configuración > Especificaciones.
2. Opción A — Manual: Creá una spec, elegí la categoría, escribí el nombre (ej: "Material Principal") y agregá los valores permitidos (ej: Cuero, Charol, Gamuza).
3. Opción B — Importar CSV: Hacé clic en "Importar CSV". Una fila por spec: columna 1 = nombre, las demás = valores:

   Material Principal;Cuero;Charol;Gamuza;Eva;Sintético
   Estilo;Urbano;Vestir;Deportivo;Casual
   Tipo de Calce;Estandar;Ancho;Angosto
   Genero;Hombre;Mujer;Unisex;Niños

4. Si la spec aplica a todas las categorías, dejá "Categoría" vacío (será global).
5. Si tenés el VTEX Field ID, cargalo para vincular automáticamente al publicar.
6. Al editar un producto, vas a ver la tab "Especificaciones" con un dropdown por cada spec de esa categoría.

Tablas de lookup

Si tu ERP exporta la marca, categoría o color en archivos separados (por código de artículo), subilos como lookups.

1. Andá a Configuración > Tablas de lookup y hacé clic en "Nuevo".
2. Ponele un nombre (ej: "Marcas ERP"), elegí el tipo (Marca, Categoría o Color) y la columna de cruce.
3. Guardá y después hacé clic en "Subir archivo" en la tabla.
4. Subí el CSV/XLSX e indicá el nombre de la columna clave (ej: COD_ART) y la columna valor (ej: MARCA).
5. A partir de ahora, cada vez que subas un lote, los campos vacíos se completan automáticamente.

Tip: Para categorías, el valor puede ser un path separado por / (ej: "CALZADO / SANDALIA / PLAYA") y el sistema lo separa en sección, rubro y línea.

Medidas de Aforo

Configurá el alto, ancho, largo y peso por categoría o género.

1. Las medidas se cargan en Catálogo > Tablas de lookup: creá una tabla de tipo "Medidas de aforo" (tipo dimensions) y agregá tus clases (cada fila tiene un nombre identificatorio, ej. "Calzado adulto").
2. Podés agregar palabras clave (keywords) y opcionalmente limitarlo por género o categorías.
3. El sistema aplica las dimensiones evaluando las filas de arriba hacia abajo (la primera regla que matchea, gana). Poné las reglas específicas arriba y las generales al final.
4. Medidas obligatorias: en los ajustes de tu Organización podés activar "Medidas obligatorias". Si está prendido, los productos sin medidas no podrán pasar al estado Listo ni publicarse en VTEX o MercadoLibre.

Mapeos CSV (opcional)

Si tu CSV tiene columnas con nombres diferentes al estándar, creá un mapeo.

1. Andá a Configuración > Mapeos CSV y creá uno nuevo.
2. Mapeá cada campo interno al nombre real de tu columna. Ejemplo: codigoReferenciaProducto -> MI_COD_ART.
3. Campos obligatorios: codigoReferenciaProducto y codigoReferenciaSku.
4. Opcionales: codigoProveedor, descripcionErp, talle, linea, rubro, seccion, marcaErp, temporada.
5. Al crear un lote, seleccioná este mapeo en "Mapeo de columnas".

Si tu CSV ya usa los nombres estándar (o variantes comunes como SKU_PRINCIPAL, DESCRIPCION, MARCA, TALLE) no necesitás mapeo — el sistema los detecta automáticamente.