Enriquecimiento automático del catálogo

Un cliente que migra su catálogo a Zentto llega con miles de artículos, descripciones escuetas y cero fotos. La vitrina, el punto de venta y la tienda se ven vacíos, y nadie va a redactar 25.000 descripciones ni fotografiar 25.000 piezas a mano.

Zentto lo hace solo, de madrugada, sin que nadie tenga que pedirlo. Es una de las cosas que ningún ERP del mercado hace por el cliente, y conviene contarla en la venta.

Qué genera

	Qué se genera	A qué nivel	Dónde queda
Descripciones	Una frase comercial por artículo	Artículo	master."Product"."AiDescription"
Ilustraciones	Imagen de producto estilo catálogo	Categoría (configurable)	S3 + cfg."MediaAsset" / cfg."EntityImage"

Ambos procesos son reanudables: cada pasada toma lo que aún falta. Se pueden cortar, reiniciar el servicio o desplegar en medio sin perder nada, y el catálogo se completa a lo largo de varias noches.

Por qué las ilustraciones son por categoría

Es la decisión de diseño más importante de esta función, y conviene entenderla antes de cambiarla.

Un modelo de imágenes no conoce la pieza concreta. Pedirle la “bomba de aceite Renault R9 R11 1.4L Twingo” devuelve una bomba de aceite verosímil que no es esa. En repuestos —y en cualquier catálogo donde el cliente compra por calce o por equivalencia exacta— una foto parecida pero equivocada provoca pedidos mal hechos y devoluciones. Es peor que no tener foto.

Ilustrar la categoría sí es cierto: la categoría se llama BOMBA y el dibujo es de una bomba. El artículo la hereda solo si no tiene imagen propia, y va marcada como ilustración.

De paso cuesta unas 100 veces menos: 240 categorías en lugar de 25.535 artículos. Y el orden es por impacto — primero las categorías que cubren más artículos, así que con las primeras 20 imágenes la vitrina ya deja de verse vacía.

El nivel es configurable

ILUSTRACION_NIVEL acepta CATEGORIA (por defecto), MARCA o ARTICULO. Bajar a artículo es cambiar una variable, no reescribir nada — pero ten presente el párrafo anterior antes de hacerlo.

Jerarquía de imágenes: la foto real siempre gana

1. Foto propia del artículo        →  se publica      (del cliente)
2. Imagen del fabricante/proveedor →  se publica      (con permiso del proveedor)
3. Ilustración generada            →  respaldo        (marcada como ilustrativa)

La ilustración nunca pisa una foto real. Se enlaza a la categoría con RoleCode = 'ILUSTRACION'; en cuanto alguien sube una foto del artículo, esa manda y la ilustración desaparece de esa ficha.

Imágenes de terceros

Las fotos de MercadoLibre, catálogos de fabricantes y sitios de venta pertenecen a quien las publicó, y sus términos suelen prohibir republicarlas. Descargarlas y servirlas desde la tienda del cliente es exposición legal para él.

La vía correcta cuando el cliente es distribuidor: pedir el pack de imágenes a sus proveedores, que normalmente lo entregan sin problema. Si se usa búsqueda web, debe ser como sugerencia al operador —que confirma que tiene derecho— nunca como publicación automática.

Cómo se pone en marcha con un cliente nuevo

Los dos procesos vienen activos por defecto. Para un cliente recién migrado:

1. Comprobar que los maestros están poblados. Las ilustraciones son por categoría, así que las categorías tienen que existir. Si la carga inicial dejó categoría y marca como texto en los artículos, hay una migración que siembra los maestros desde ahí.
2. Ajustar el rubro. RUBRO_ILUSTRACION describe a qué se dedica el cliente — repuestos automotrices, farmacia, ferretería… — y entra en el prompt. Sin esto las imágenes salen genéricas de más.
3. Dejarlo correr una noche y revisar el coste, antes de subir los lotes.

Variables

Variable	Por defecto	Para qué
DESCRIPCION_IA_CRON	on	Apaga el enriquecimiento de descripciones
DESCRIPCION_IA_LOTE	25	Artículos por empresa y pasada
DESCRIPCION_IA_MODEL	el del ecosistema	Apunta a otro proveedor de IA
ILUSTRACION_CRON	on	Apaga la generación de imágenes
ILUSTRACION_NIVEL	CATEGORIA	CATEGORIA, MARCA o ARTICULO
ILUSTRACION_LOTE	3	Entidades por empresa y pasada
RUBRO_ILUSTRACION	productos	Rubro del cliente, entra en el prompt

Cuándo corren

• Descripciones: cada 20 minutos entre la 1:00 y las 5:00 (hora de la empresa).
• Ilustraciones: una vez, a las 2:30.

Los lotes son deliberadamente pequeños. Generar imágenes es caro y lento, esto corre en horas muertas y no hay ninguna prisa: es preferible tardar varias noches a saturar el servicio de IA compartido.

Lanzarlo a mano

Útil para una demo o para acelerar un alta. Ambos endpoints piden permiso de edición sobre inventario.

POST /v1/inventario/descripciones-ia
{ "limite": 50 }

POST /v1/inventario/ilustraciones
{ "nivel": "CATEGORIA", "limite": 5 }

La respuesta dice cuántos quedaban pendientes, cuántos se procesaron y si quedan más — así se puede repetir hasta terminar.

Coste

Las descripciones usan el modelo económico del ecosistema; son miles de llamadas cortas y el gasto es bajo. Las imágenes cuestan bastante más, y por eso el nivel por categoría no es solo una decisión de honestidad: 240 imágenes frente a 25.535 es la diferencia entre una cifra razonable y una factura seria.

Conviene medir una noche real antes de subir los lotes o bajar a nivel de artículo.

Aislamiento entre empresas

Los procesos corren fuera de una petición HTTP, así que abren el contexto de cada empresa antes de trabajar. Las funciones de base de datos abortan si no hay empresa activa, a propósito: los códigos de artículo se repiten entre empresas de un mismo tenant, y un proceso de fondo sin contexto podría escribir en el catálogo del vecino.