Onboarding de un cliente

Pasos para dejar una organización nueva lista para catalogar. Se hace una sola vez por cliente; después la operación diaria es Lotes → Imágenes → IA → Publicar.

Orden recomendado

1. Crear la organización — Admin → Organizaciones (o registro en /admin/register, que crea la organización automáticamente). Completá el Perfil de tienda: tipo de tienda, años, locales, propuesta de valor (cuotas, envío gratis, retiro en tienda, cambios y devoluciones, garantía). La IA usa este perfil como contexto: solo promete beneficios que estén declarados acá.
2. Crear los canales — Configuración → Canales, con las credenciales de cada uno (ver tabla de credenciales). Para VTEX, cargá también las políticas comerciales si la cuenta tiene más de una.
3. Importar marcas — Catálogo → Marcas → Importar CSV (name, vtex_brand_id, aliases, local). Las marcas sin ID de VTEX se pueden crear en VTEX después, directo desde Catalogistan.
4. Importar categorías — Catálogo → Categorías → Importar CSV (clave SECCION RUBRO LINEA, IDs de VTEX, medidas). Los aliases permiten que el auto-asignador matchee sinónimos del ERP (ej: "T-SHIRT" como alias de "Remeras").
5. Importar especificaciones — Configuración → Especificaciones: por CSV, desde VTEX o desde MercadoLibre. Ver Especificaciones.
6. Tablas de lookup (si aplica) — cuando marca, categoría o color vienen en archivos separados del ERP. Tipo color_extendido mapea código → color + textura + material.
7. Fuente de imágenes — Configuración → Fuentes de imágenes: Google Drive (folder ID + API key), HTTP público por código, o FTP. Ver Imágenes.
8. Mapeo CSV (si el archivo del cliente usa otros nombres de columna) — Configuración → Mapeos CSV. Los campos obligatorios son codigoReferenciaProducto y codigoReferenciaSku.

Con eso, el cliente sube su primer CSV y el flujo corre solo: escaneo de fotos, asignación de marcas/categorías y lookups se aplican automáticamente al crear el lote.

Roles y permisos

Rol	Qué puede hacer
SUPER_ADMIN	Todo: crear organizaciones y usuarios, además de todo lo del Admin.
ADMIN	Configurar canales, marcas, categorías, specs, lookups y mapeos de su organización; migrar catálogos; todo lo del Operador.
OPERATOR	Subir lotes, generar IA, editar productos y SKUs, aprobar drafts, publicar.

Configuraciones por organización que conviene revisar

• Largo del sufijo de color (Configuración de la organización): cuántos caracteres del SKU identifican el color. Default 3 (ej. 0064DLB001); Dragonfish usa 4 (ej. 1010110010B100). Afecta el split de variantes de color al importar y la detección de variantes en Drive.
• Prefijos de código (género/colección): si los códigos del ERP arrancan con un prefijo que indica género o colección, declaralo — llena la sección del producto automáticamente y la IA recibe el género correcto sin carga manual.
• Guía de copy de la IA (sección "IA / Copy"): tono, público, atributos a priorizar, claims prohibidos, vocabulario y ejemplos aprobados. Modela la voz de la marca sin romper la estructura SEO. Ver Generar con IA.
• ERP / Precios: si el cliente tiene ERP conectable (Pryment, Dynamis), configuralo acá — habilita "Sync precios" en los lotes y la pantalla de Pendientes de alta.