Appearance
Imágenes
Sin foto no hay catalogación: la IA solo procesa productos con imagen, y varios canales exigen al menos una para publicar. Hay cinco maneras de vincular fotos a productos.
Las 5 vías
- Subir fotos — arrastrás archivos desde la computadora (múltiples a la vez). Se vinculan por el nombre del archivo.
- Captura móvil — la acción del lote genera un QR; el celular abre una sesión para sacar fotos directo sobre el producto (válida 24 hs).
- Escanear imágenes — busca en la fuente de imágenes configurada (Google Drive, HTTP público o FTP) y vincula por código. Dos alcances: solo el lote, o todo el catálogo (para fotos que llegaron después de que el producto quedó en un lote viejo). Si la organización tiene varias fuentes, se recorren todas.
- Importar imágenes CSV — archivo con código/SKU + URL. Las URLs externas se publican tal cual (VTEX/MELI las descargan al publicar).
- Analizar fotos (Visión AI) — no vincula, sino que lee las fotos ya vinculadas: detecta marca, color y material, que después la IA usa como señal.
Cómo se nombran los archivos
Formato esperado: {código}{color}_{orden}.jpg — por ejemplo 0064DLB001_1.jpg = producto 0064DLB, color 001, foto 1.
- El match es por prefijo: la foto
0064DLB001matchea el producto cuyo código es0064DLBo0064DLB001. - La foto sin sufijo
_Nes la principal (orden 0). - La misma lógica aplica para upload directo, Drive y captura móvil.
- En fuentes HTTP/FTP el patrón es
{código}.jpg(principal) +{código}_1.jpg,_2.jpg… y el código puede contener guiones bajos.
Fuentes de imágenes
| Tipo | Cómo funciona | Cuándo usarla |
|---|---|---|
| Google Drive | Carpeta por organización (folder ID + API key). El escaneo lista la carpeta y matchea por nombre. | El cliente sube fotos a una carpeta compartida. |
| HTTP público | Solo una URL base (ej. https://media.cliente.com). El sistema prueba {base}/{código}.jpg, _1, _2… y corta en el primer 404. Sin credenciales. | Las fotos ya se sirven públicas con el código como nombre (típico: las genera el ERP). |
| FTP | Lista el directorio por FTP y guarda la URL pública equivalente (necesita también la URL base HTTP, porque los canales no descargan de ftp://). | Hay FTP real con listado y las fotos también se sirven por HTTP. |
Una organización puede tener varias fuentes a la vez (ej. Drive para fotos propias + HTTP para las del ERP): el escaneo las recorre todas y deduplica.
Re-escaneo limpio (todo el catálogo): borra las imágenes de la fuente y re-importa — para cuando se re-apunta a una carpeta nueva con fotos corregidas.
Fotos sin dueño: si un archivo de la fuente no matchea ningún producto, queda registrado — el reporte de fotos sin dueño sirve para detectar errores de tipeo en los nombres de archivo.
Detectar variantes de color
Acción del lote (grupo Imágenes). Busca en la fuente códigos de foto sin producto que compartan la base de código con un producto existente (código menos el sufijo de color) y ofrece clonar el producto hermano para crear la variante:
- Clona taxonomía, marca, dimensiones y talles (con el código nuevo).
- No clona los campos de IA (nombre, descripción, SEO) ni EAN — la variante nueva queda
pendingpara generar su propio contenido con el color correcto. - El color se resuelve por lookup (código completo → sufijo) o por la tabla global de códigos de color.
- Requiere que el producto hermano exista en el lote; después del clonado se re-escanean las fotos automáticamente.
El largo del sufijo de color es configurable por organización (3 por defecto, 4 para Dragonfish).
La pestaña Imágenes del producto
Muestra la grilla de miniaturas con nombre de archivo y orden de publicación — lo que ves ahí es exactamente lo que se sube al canal, en ese orden. El listado de productos tiene además la columna Foto (miniatura) y el filtro "Con imágenes".