⚡ Core Engine Retail

Módulo 01: Inventario, Serialización, Variantes y Agente AI

El módulo de inventario de UrbanStock no es un inventario tradicional de números genéricos. Es un sistema de trazabilidad física serializada por unidad, diseñado específicamente para retail de moda, sneakers y prendas, conectado en tiempo real al motor de ventas del Agente de Inteligencia Artificial.

1

Estructura Jerárquica del Inventario

El sistema organiza los artículos en 3 capas relacionales perfectamente enlazadas:

1. PRODUCTO BASE
👟 "Tenis Nike Air Jordan 4 Retro"
Precio Detal: RD$8,500 Costo: RD$5,000 Palabras clave: #croki
2. VARIANTE DE COLOR Y TALLA
🔴 Color: "Negro/Rojo (Bred)"
• Talla: "42"
• Foto propia: /uploads/bred.jpg
3. PRENDA FÍSICA
(Serial 001)
🟢 Disponible
3. PRENDA FÍSICA
(Serial 002)
🔴 Vendido
2. VARIANTE DE COLOR Y TALLA
🔵 Color: "Azul (Military)"
• Talla: "41"
• Foto propia: /uploads/blue.jpg
3. PRENDA FÍSICA
(Serial 001)
🟢 Disponible
3. PRENDA FÍSICA
(Serial 002)
🟢 Disponible
1. PRODUCTO BASE
👟 "Tenis Nike Air Jordan 4 Retro"
Detal: RD$8,500 Costo: RD$5,000 Palabras clave: #croki
2. VARIANTE DE COLOR Y TALLA
🔴 Color: "Negro/Rojo (Bred)"
• Talla: 42 | 📷 /uploads/bred.jpg
3. PRENDA FÍSICA
(Serial 001)
🟢 Disponible
3. PRENDA FÍSICA
(Serial 002)
🔴 Vendido
2. VARIANTE DE COLOR Y TALLA
🔵 Color: "Azul (Military)"
• Talla: 41 | 📷 /uploads/blue.jpg
3. PRENDA FÍSICA
(Serial 001)
🟢 Disponible
3. PRENDA FÍSICA
(Serial 002)
🟢 Disponible
2

Modalidades de Creación: Simple vs Multi-Color

Al crear o editar un producto en el POS, tienes dos modalidades:

Modalidad A

Modo Simple (Solo Tallas)

  • Uso: Productos que no tienen variedad de color (ej. gorras de un solo tono, medias blancas, accesorios).
  • Configuración: Ingresas las tallas (ej. S, M, L o 38, 40, 42) y la cantidad física de cada una.
Modalidad B

Modo Multi-Color (Fotos Propias por Color)

  • Uso: Artículos con varios colores o combinaciones (ej. Tenis Jordan en Rojo, Azul y Blanco o Polos Tommy en Negro y Verde).
  • Beneficio Comercial: Cada color tiene su propia foto individual en alta resolución.
  • Ventaja para el Agente AI: Cuando el cliente en WhatsApp pide "Mándame fotos del tenis rojo", el bot le envía exclusivamente la foto del color rojo, evitando confusiones.
3

Seriales Físicos Únicos y Códigos de Barras

Cada prenda física que entra al inventario recibe un código serial único e irrepetible:

🏷️ Estructura de la Etiqueta Serial:

[CÓDIGO-BASE]-[COLOR]-[TALLA]-[SECUENCIAL_3_DÍGITOS]
• Ejemplo en Calzado Multi-Color: JDN4-NEG_ROJ-42-001
• Ejemplo en Artículo Simple: GORRA-BULLS-U-001

🔒 Ventajas de Seguridad:

  1. Control de Mermas y Robo Hormiga: Cada código representa exactamente una prenda física en percha o caja en almacén.
  2. Trazabilidad Total en Tienda: En el sistema queda registrado de forma inmutable:
    • Fecha y hora exacta de ingreso al inventario.
    • En qué número de factura se vendió y qué cajero la cobró.
    • Si se dio de baja por merma, el motivo exacto de la baja y el supervisor responsable.
4

Etiquetas, Alias & Jerga Dominicana (Tags / Palabras Clave)

Los clientes en República Dominicana y Latinoamérica rara vez buscan por el nombre oficial de catálogo. Usan jerga callejera, apodos o categorías populares.

🏷️ ¿Cómo funcionan las Palabras Clave?

En el formulario de producto puedes agregar apodos y términos separados por comas:

👟 Ejemplo en Calzado:
# croki
# blanquitos
# retro
# jordan
# básquetbol
# gym
👕 Ejemplo en Polos:
# el caballito
# polo ralph
# vestir
# elegante
# fiesta
🎒 Ejemplo en Ropa Infantil:
# niños
# kids
# escolar
# regreso a clases

🤖 Búsqueda Inteligente del Agente AI:

  • El motor de búsqueda limpia tildes, mayúsculas y palabras de relleno ("hola manin tienen los tenis...").
  • Si el cliente escribe: "¿Tienes los crokis blanquitos en 42?", el bot busca en Nombre + Categoría + Palabras Clave y encuentra al instante el Nike Air Force 1.
5

Armar la Pinta / Productos Hermanos (Combinaciones)

Permite conectar prendas que combinan estéticamente para que el Agente AI y el cajero ofrezcan el look completo al cliente.

👔 CONFIGURACIÓN DE PINTA EN EL SISTEMA
• Para el color: 🔴 Rojo
• Prenda hermana vinculada: Tenis Jordan 4 Retro
• Color que hace juego: Bred (Negro con Rojo)

🔄 Características Clave:

  1. Recomendación Bidireccional Automática: Si vinculas el Polo Rojo ➔ Jordan Bred, el sistema sabe automáticamente que si alguien cotiza el Jordan Bred, debe sugerirle el Polo Rojo.
  2. Combinación Fina por Color: Si una prenda tiene 5 colores, puedes definir que el Polo Rojo recomiende el Jordan Bred, pero que el Polo Azul recomiende el Jordan Military Blue.
  3. Protección de Stock Agotado: Si el producto hermano o el color combinado se queda sin existencia física en tienda, el sistema lo oculta de inmediato y nunca ofrece prendas agotadas.
6

Frecuentemente Comprados Juntos (Análisis de Tickets)

Cuando no configures combinaciones manuales (o si las que tenías se agotaron), entra en acción el Nivel 2 de Sugerencias Automáticas:

📊 ¿Cómo funciona?

  1. El sistema analiza las facturas reales cobradas en la caja registradora.
  2. Identifica qué artículos suelen llevarse juntos en la misma compra (ej. Jordan 4 + Medias Nike o Polo Tommy + Gorra New Era).
  3. Memoria Rápida en Vivo: Mantiene al instante el Top 3 de complementos más vendidos de los 500 productos más populares, respondiendo en una fracción de milisegundo sin ralentizar la caja.
7

Cómo Interactúa el Agente AI (WhatsApp & Instagram)

🎭 Jerarquía de Sugerencias en Vivo:

1º Nivel: 👔 Combinaciones Manuales (Estilista / Armar la Pinta)
2º Nivel: 📊 Comprados Juntos en Caja (Ventas reales registradas)
3º Nivel: 🏬 Categorías Complementarias (Accesorios / Gorras / Medias)

💬 Ejemplo de Venta en WhatsApp (Look Completo):

👤 Cliente
"Buenas manin, ¿tienen el Polo Tommy en color rojo en talla M?"
⚡ Consulta de Stock: "Polo Tommy", Talla M
🤖 Agente AI
"¡Saludos! Sí manin, tenemos el Polo Tommy Hilfiger (Rojo) en talla M por RD$2,200. 🔥
📷 [Envía la foto oficial del Polo Rojo]
¿Deseas que te lo guarde en tu pedido?"
👤 Cliente
"Sí, agrégalo."
⚡ Acción en Pedido: Añade al carrito ➔ Sugiere Pinta: Jordan 4 Bred
🤖 Agente AI
"¡Nítido! Ya te agregué el Polo Tommy Rojo en M a tu orden. 🛒

👔 Para armar la pinta completa: Le cae perfecto el Air Jordan 4 Retro (Bred - Negro/Rojo) que tenemos disponible por RD$8,500.
📷 [Envía foto del Jordan Bred]
¿Te gustaría que te incluya un par en tu talla o te tomo los datos de entrega?"

💬 Ejemplo con Sugerencia por Ventas Frecuentes (Nivel 2):

👤 Cliente
"Quiero unos Tenis Nike Air Force 1 blancos en talla 41."
⚡ Sugerencia de Caja: 70% de clientes añade Medias Nike Cushion
🤖 Agente AI
"¡Excelente elección! Te agregué los Air Force 1 en 41 a tu carrito por RD$5,500.

💡 Sugerencia: La mayoría de nuestros clientes que llevan este modelo le suman el Pack de Medias Nike Cushion por RD$450. ¿Deseas que te agregue un paquete al pedido?"
8

Operaciones en Tienda: Mermas, Bajas y Etiquetas Térmicas

🎛️ Consola de Control de Prendas (Modal "Ver Seriales"):

Al hacer clic en el botón "Ver Seriales" en cualquier producto, se abre la consola de gestión de stock físico:

  1. 📊 Resumen Rápido de Estados:

    Barra superior con conteo en vivo de prendas Totales, Disponibles, Vendidas y Mermas / Bajas registradas, además de los apodos o palabras clave asociadas.

  2. 🎨 Pestañas Interactivas por Color:

    Si el artículo cuenta con variantes de color, se activan pestañas superiores (Todos (6), ⚪ Blanco (3/3), ⚫ Negros (3/3)). Al seleccionar un color específico, la lista se filtra y el botón de acción cambia automáticamente a "Seleccionar Blanco" para imprimir etiquetas por lote de ese color con un solo clic.

  3. 🔍 Buscador en Vivo de Seriales:

    Permite escribir cualquier fragmento (001, 41, BLA) para ubicar la prenda física exacta en percha o almacén en milisegundos.

  4. ⚡ Filtros Instantáneos de Estado:

    Píldoras para alternar entre Todos, Disponibles, Vendidas y Mermas.

  5. 🏷️ Tarjetas de Prenda Serializada:
    • Código Serial en 1 Sola Línea: Código serial completo (ej. NIK1-BLANCO-40-001) con botón de Copiar Código para escaneo manual o transferencias.
    • Indicador Visual de Estado: 🟢 Disponible (verde esmeralda), 🔴 Vendido (rojo) o ⚪ Merma / Eliminado (gris).
    • Talla y Color: Muestra la talla (Talla: 40) junto a la píldora de color (🎨 Blanco) y su foto miniatura.
    • Detalle de Venta: Si la prenda fue vendida, muestra el cajero que la cobró y la fecha/hora exacta.
    • Detalle de Baja: Si fue merma, muestra el motivo de la baja y el supervisor responsable.

🖨️ Impresión de Etiquetas Térmicas (Láser y Rollo):

  • ⚡
    Aviso Automático al Ingresar Mercancía: Al guardar un producto nuevo o ingresar más tallas/unidades a un producto existente, el sistema detecta con precisión las unidades recién generadas y abre un diálogo interactivo:
    👉 "¿Deseas imprimir las etiquetas de código de barras para las X nuevas unidades?"
    Al presionar "Imprimir X Etiquetas", abre de inmediato la vista previa donde puedes configurar el número de copias por serial (ej. 1 para ropa, 2 o 3 para calzado con caja).
  • 🏷️
    Impresión Individual: Botón directo de impresora en cada tarjeta de prenda.
  • 📋
    Impresión por Selección: Marca las casillas de las prendas que desees y presiona "Imprimir Selección".
  • 📦
    Impresión Masiva de Todo el Inventario: Botón para imprimir el lote completo y rotular la mercancía recién llegada.

🗑️ Bajas de Inventario y Mermas (Auditadas):

Si una prenda se daña, se mancha o se pierde en tienda:

  1. Haces clic en el botón de eliminar (🗑️) de la prenda física específica.
  2. El sistema solicita obligatoriamente el Motivo de la Baja mediante opciones predefinidas ("Dañado / Defectuoso", "Muestra de Exhibición / Probador", "Pérdida / Hurto Identificado", "Uso Interno de la Empresa" u "Otro Motivo Personalizado").
  3. La prenda cambia su estado a "Eliminado / Merma", queda guardado el usuario responsable y se registra la Salida de Inventario.
  4. El Agente de WhatsApp y el Punto de Venta descuentan la disponibilidad al instante para evitar venderla.
9

Experiencia de Usuario y Detección de Cambios

🛡️ Detector de Cambios sin Guardar:

  • Cero Mensajes Molestos: Al abrir un producto para revisarlo y salir sin modificar nada, la ventana se cierra al instante sin alertas innecesarias.
  • Protección Antipérdida de Datos: Si modificaste precios, variantes, tallas o fotos e intentas salir por error, aparece una ventana de confirmación para que no pierdas tu trabajo.

📐 Resumen de Tallas y Colores en Tabla:

  • Orden Natural: Las tallas se ordenan siempre de menor a mayor (38, 39, 40, 41 o XS, S, M, L, XL).
  • Disponibilidad Real: La tabla destaca exclusivamente las tallas y colores que tienen existencia física disponible en tienda, con el conteo desglosado por talla en la vista móvil.