DocumentaciónSoftware (OS)Módulo: Artículos

Módulo: Artículos

Última actualización: 2026-07-20

Nota
Alcance de esta sección: Esta sección explica la estructuración del catálogo de Artículos, configuraciones de variantes (tamaños), grupos de modificadores (extras/opciones), personalización por mitades (split-half) e inventario de recetas.

Depot OS — Catálogo de Artículos y Variantes

El catálogo de Artículos es el inventario comercial de productos terminados que ofreces al cliente final. Su diseño permite estructurar menús complejos y dinámicos con absoluta flexibilidad. Cualquier cambio de precios, imágenes, modificadores o disponibilidad realizado por el administrador se propaga en tiempo real (WebSockets) a todas las terminales de venta de las sucursales al instante.


1. Variantes de Producto (Presentaciones y Tamaños)

Para no saturar la pantalla con productos duplicados, Depot OS utiliza Variantes:

  • Uso: Agrupa un mismo artículo vendido en diferentes tamaños o empaques (ej. Café Americano "Chico", "Mediano", "Grande").
  • Atributos individuales: Cada variante tiene su propio identificador interno (SKU) y su código de barras de manera diferenciada, además de un precio base de venta específico y el posible enlace a un insumo físico en el inventario para su descuento atómico al venderse.

2. Grupos de Modificadores (Extras y Especificaciones)

Los Modificadores permiten al cliente personalizar su pedido (ej. términos de carne, salsas, toppings adicionales). Al configurar un grupo de modificadores, defines:

  • Tipo de Selección:
    • Selección Única (Radio Buttons): El cliente debe elegir exactamente una opción (ej. "¿Término de la carne? Término medio / Tres cuartos / Bien cocida").
    • Selección Múltiple (Checkboxes): El cliente puede seleccionar varios modificadores en paralelo (ej. "Toppings adicionales: Piña, Jamón, Tocino").
  • Límites de Captura: Puedes configurar un mínimo requerido (ej. mínimo 1 tipo de aderezo, obligando al cajero a preguntar antes de continuar) y un máximo permitido.
  • Precios por Variantes (Variant Overrides): Permite parametrizar precios dinámicos según el tamaño del artículo (ej. el modificador "Extra Queso" cuesta $15.00 en la pizza Chica, pero $30.00 en la pizza Familiar).
  • Modificadores Condicionales: Puedes enlazar modificadores de forma nativa a variantes específicas, en lugar de aplicarlos a todo el producto (ej. el modificador "Rellena de Queso" sólo se muestra si se selecciona la variante de pizza Grande).

3. Constructor de Recetas y Mitades (Split-Half)

Cuando activas el interruptor "Es de Composición" en el artículo y la opción "Permitir Mitades" (splitHalfEnabled) en su grupo de modificadores:

  • Interfaz Interactiva: Al levantar el pedido en el POS, se despliega un panel visual que divide el artículo en tres secciones seleccionables: Toda, Mitad Izquierda y Mitad Derecha.
  • Cálculo de Precios Proporcional: Si un ingrediente extra cuesta $20.00 pesos y el cliente lo pide sólo en la mitad izquierda, el sistema calcula de forma automática un cargo de +$10.00 pesos.
  • Deducción de Inventario Exacta: Al cobrar la venta, el servidor descuenta media porción del insumo en el stock físico de la cocina.
  • Indicadores Visuales en Ticket (Side Indicators): El monitor de cocina y el ticket impreso muestran de forma clara con iconos descriptivos la distribución del producto, reduciendo errores de preparación.

4. Ejemplo Práctico: Configurar una "Pizza Especial" con Mitades y Variantes

A continuación se detalla la configuración exacta para dar de alta este artículo compuesto:

Paso 1: Crear el Artículo Base

  • Nombre: Pizza Especial
  • Categoría: Pizzas
  • Interruptores Activos:
    • "Tiene Variantes" (Para los tamaños).
    • "Tiene Modificadores" (Para los toppings adicionales).
    • "Es de Composición" (Para el desglose de ingredientes en cocina).
    • "Se envía a Cocina" (Para mandar comanda al monitor de preparación).

Paso 2: Configurar Tamaños (Variantes)

Agrega dos variantes con precios base independientes:

  1. Mediana: Precio $180.00
  2. Familiar: Precio $250.00

Paso 3: Configurar Toppings Adicionales (Grupo de Modificadores)

Crea un grupo de modificadores llamado "Ingredientes Extra":

  • Selección: Múltiple.
  • Límites: Mínimo 0, Máximo 5.
  • Permitir Mitades (splitHalfEnabled): Activo (Sí).
  • Ingredientes Extra y Precios por Tamaño:
    • Peperoni: Mediana (+$15.00) / Familiar (+$25.00).
    • Champiñones: Mediana (+$12.00) / Familiar (+$20.00).
    • Queso Extra: Mediana (+$20.00) / Familiar (+$35.00).

Resultado en Caja:

Cuando el cajero seleccione la "Pizza Especial Familiar", el POS solicitará confirmar el tamaño. Al elegir "Familiar", se abrirá el panel de mitades. Si el cajero selecciona la Mitad Izquierda y marca "Queso Extra", el sistema sumará +$17.50 pesos al precio base de la pizza de $250.00, cobrando un total exacto de $267.50 pesos.

Depot — Empleados Digitales para tu PyME