Control de botellas del bar¶
En el bar, el inventario por unidades no basta: una botella "existente" puede estar medio vacía. Por eso Consul Rest controla los licores botella por botella: cada una tiene un código único, su contenido en mililitros y un ciclo de vida propio. Se registran aperturas, consumos por trago en ML, ajustes de contenido (derrames, degustaciones, cortesías) y conteos físicos midiendo lo que realmente queda en cada botella.
Es el control antifraude clave del bar: las diferencias entre lo que el sistema dice que queda y lo que mides revelan sobre-servido, derrames no registrados o pérdidas.
Requisito: insumos de tipo Licor
Solo pueden registrarse botellas de insumos de tipo Licor. Conviene capturar en el insumo el Contenido (ML) y la graduación alcohólica: el contenido se usa como sugerencia al dar de alta botellas.
Ciclo de vida de una botella¶
| Estado | Significado | Qué sigue |
|---|---|---|
| Sellada (gris) | Sin abrir, contenido completo | Abrir botella |
| Abierta (azul) | Abierta, disponible para servir | Registrar consumos, ajustes; En Uso |
| En Uso (cian) | En la barra sirviéndose activamente | Registrar consumos hasta agotarse |
| Agotada (verde) | Consumida por completo — el cierre correcto del ciclo | Nada |
| Merma (rojo) | Perdida (rotura, caducidad, etc.) | Nada — no se revierte |
Lista de botellas¶
- Ruta:
/inventario/botellas - Quién la usa: encargado de barra, gerente.
Elementos de la pantalla¶
- Botón Nueva Botella.
- Filtros: búsqueda por código, Almacén, Estado (Selladas / Abiertas / En Uso / Agotadas / Merma), casilla Solo abiertas, casilla Próximas a caducar y botón para limpiar filtros.
- Paginación.
Columnas de la tabla¶
| Columna | Qué es |
|---|---|
| Código | Código único de la botella; enlace al detalle |
| Insumo | Nombre + código del licor |
| Almacén | Dónde está registrada |
| Contenido | Barra de progreso de ML restantes con color: verde > 50 %, cian ≤ 50 %, amarillo ≤ 25 %, rojo ≤ 10 %; con el texto "actual / original ML" |
| Estado | Badge del estado |
| Ubicación | Ubicación física (estante, nivel) |
| Caducidad | En rojo con ⚠ si está próxima a caducar; la fila se pinta amarilla |
| Acciones | 👁 detalle; 📤 Abrir botella si está Sellada; ✖ Marcar agotada si está Abierta o En Uso — ambas con confirmación |
Registrar botellas¶
- Ruta:
/inventario/botellas/nueva
Campos¶
| Campo | Qué es | Obligatorio |
|---|---|---|
| Insumo (Licor) | Solo se listan insumos de tipo Licor. Al elegirlo se autocompletan contenido y costo sugeridos | Sí |
| Almacén | Dónde queda registrada la botella | Sí |
| Contenido Original (ML) | Mililitros de la botella (muestra el sugerido del insumo) | Sí |
| Costo Unitario | $ por botella (muestra el último costo del insumo) | Sí |
| Cantidad de Botellas | De 1 a 100 botellas idénticas de una sola vez (default 1) | No |
| Número de Lote | Ej. LOT-2024-001 | No |
| Fecha de Caducidad | Para las alertas de caducidad | No |
| Ubicación Física | Ej. "Estante A, Nivel 2" | No |
| Notas | Observaciones | No |
- El Panel Resumen se actualiza en vivo: botellas a registrar, contenido total en ML, costo total y costo por ML.
- Validaciones al enviar: insumo y almacén elegidos, contenido mayor a 0.
- Botones Registrar Botellas y Cancelar.
Alta masiva tras la compra
El campo Cantidad de Botellas te permite registrar hasta 100 botellas idénticas de una vez — ideal al recibir una compra: mismas características, códigos individuales generados para cada botella.
Detalle de botella¶
- Ruta:
/inventario/botellas/{Id} - Propósito: ver la ficha completa de una botella y operar todo su ciclo de vida.
Elementos de la pantalla¶
- Encabezado: código de la botella, badge de estado, nombre del insumo; botón Volver.
- Información General: código, insumo y su código, almacén, ubicación, lote, caducidad y fecha de registro.
- Contenido: porcentaje restante en grande con barra de color, texto "actual / original ML" y desglose de contenido original, actual y consumido.
- Costos: costo unitario, costo por ML (con 4 decimales) y valor restante (ML actuales × costo por ML).
- Acciones según el estado:
- Sellada: Abrir Botella (con confirmación).
- Abierta / En Uso: Registrar Consumo, Ajustar Contenido, Marcar Agotada (con confirmación) y Registrar Merma.
- Historial de Estados: tres tarjetas — Registrado (fecha), Apertura (fecha y quién la abrió, o "Pendiente") y Agotamiento (fecha o "Pendiente").
- Historial de Consumos: tabla con Fecha, Cantidad (−ML), Contenido (antes → después), Costo del consumo, Preparado por y Notas.
- Historial de Ajustes: Fecha, Tipo (badge por tipo), Cantidad ±ML, Contenido antes → después, Motivo y Realizado por.
- Notas de la botella, si existen.
Modales de operación¶
Registrar Consumo — descuenta mililitros servidos y registra el costo del consumo:
| Campo | Qué es | Obligatorio |
|---|---|---|
| Cantidad (ML) | Tope = contenido actual; muestra el disponible | Sí |
| Concepto | Ej. "Preparación coctel" | No |
Ajustar Contenido — corrige el contenido registrado:
| Campo | Qué es | Obligatorio |
|---|---|---|
| Nuevo Contenido (ML) | De 0 al contenido original. Se escribe el valor final, no la diferencia | Sí |
| Tipo de Ajuste | Ajuste de Inventario / Merma / Derrame / Degustación / Cortesía | Sí |
| Motivo | Justificación del ajuste | Sí |
Registrar Merma — marca toda la botella como pérdida:
| Campo | Qué es | Obligatorio |
|---|---|---|
| Motivo | Rotura, caducidad, etc. | Sí |
El modal advierte: "Esta acción marcará la botella como merma y no podrá revertirse".
Agotada no es lo mismo que Merma
Marcar Agotada es el cierre normal de una botella que se consumió por completo. Merma es para pérdidas (rotura, caducidad) y no se revierte. En el historial de ajustes también pueden aparecer los tipos Rotura, Ajuste Positivo y Ajuste Negativo.
Conteos de botellas¶
El equivalente del conteo físico de insumos, pero para el bar: se mide el contenido real en ML de cada botella y se ajusta el sistema. Mismo ciclo: En Proceso → Completado → Aprobado → Aplicado, con posibilidad de Cancelado.
- Quién lo usa: el encargado de barra realiza la medición; un supervisor o gerente aprueba.
Lista de conteos de botellas¶
- Ruta:
/inventario/conteos-botellas
Elementos:
- Botón Nuevo Conteo.
- Filtros: búsqueda por folio, Almacén, Estado (En Proceso / Completado / Aprobado / Aplicado / Cancelado), fecha desde/hasta y botón para limpiar.
- Tabla: Folio (enlace), Almacén, Fecha, Estado (badge), Realizado por, Botellas (total), Con Diferencia (badge amarillo o "0" verde), Diferencia $ (rojo/verde), Acciones (👁 detalle; 📋 continuar conteo si está En Proceso). Con paginación.
Estados: En Proceso (amarillo) → Completado (cian) → Aprobado (azul) → Aplicado (verde); Cancelado (gris).
Nuevo conteo de botellas¶
- Ruta:
/inventario/conteos-botellas/nuevo
| Campo | Qué es | Obligatorio |
|---|---|---|
| Almacén | Almacén (de bar) a contar | Sí |
| Fecha del Conteo | Por defecto hoy | Sí |
| Solo botellas abiertas | Marcada por defecto: incluye únicamente botellas Abiertas o En Uso; desmarcada incluye también las selladas | No |
| Notas | Observaciones | No |
Un recuadro informativo resume el proceso en 5 pasos: se crea el conteo con las botellas del almacén → se mide el contenido de cada botella en ML → al completar se calculan diferencias → un supervisor aprueba → se aplican los ajustes al inventario.
Botones Iniciar Conteo y Cancelar. Al crear, el sistema navega directo a la pantalla de medición.
Medir botellas¶
- Ruta:
/inventario/conteos-botellas/{Id}/contar
Elementos:
- Encabezado con folio, badge de estado, almacén y fecha; botones Completar Conteo (habilitado solo cuando todas las botellas están verificadas) y Ver Detalle.
- Tarjetas de progreso: Total Botellas, Verificadas (verde), Pendientes (amarillo), Con Diferencia (rojo), más una barra de porcentaje de avance.
- Si el conteo ya no está En Proceso, un aviso indica que no se pueden modificar mediciones.
- Filtros por botones: Todas (N) / Pendientes (N) / Verificadas (N).
- Tabla: Código de botella, Insumo (con código), Estado de la botella (badge Sellada/Abierta/En Uso...), Sistema (ML), Físico (ML), Diferencia (±ML con color), Verificado (✔/○) y botón Medir (o Editar si ya se midió). Las filas con diferencia se pintan en amarillo.
El modal Registrar Medición muestra:
| Campo | Qué es | Obligatorio |
|---|---|---|
| Insumo | Solo lectura | — |
| Contenido en Sistema | Solo lectura | — |
| Contenido Físico (ML) | Precargado con el del sistema; no admite valores negativos | Sí |
| Notas | Observaciones de la medición | No |
El modal calcula en vivo la diferencia y su valor en $ (según el costo por ML). Botones Guardar / Cancelar.
Flujo:
- Mide botella por botella (con regla o báscula de bar) y captura los ML físicos.
- Al verificar todas, pulsa Completar Conteo (confirmación: ya no se podrán modificar mediciones). El sistema navega al detalle.
Detalle del conteo de botellas¶
- Ruta:
/inventario/conteos-botellas/{Id}
Elementos:
- Encabezado con folio, badge de estado y almacén.
- Botones por estado:
- En Proceso: Continuar Conteo y Cancelar (modal con motivo obligatorio; irreversible).
- Completado: Aprobar (modal con Notas de Aprobación opcionales; confirma que las mediciones son correctas) y Cancelar.
- Aprobado (sin ajustes aplicados): Aplicar Ajustes (con confirmación; actualiza el contenido de las botellas en el sistema).
- Información General: folio, almacén, fecha, estado, realizado por, aprobado por y fecha (si aplica), e indicador Ajuste Aplicado (✔/✖).
- Resumen: Total Botellas, Verificadas, Con Diferencia y Valor Diferencia ($).
- Notas del conteo, si existen.
- Detalle: botones de filtro Todos / Con Diferencia; tabla con Código, Insumo, Sistema (ML), Físico (ML), Diferencia (±ML), Valor $ y Estado (✔ verificado / ○ pendiente); el pie muestra los totales de diferencia en ML y en $.
Aplica los ajustes solo tras revisar
Aplicar los ajustes modifica el contenido registrado de cada botella y no se puede deshacer. Revisa primero las diferencias en el detalle.
Las diferencias negativas son tu alerta antifraude
Una diferencia negativa en $ representa licor faltante: posible sobre-servido, derrames no registrados o pérdidas. Un conteo de botellas periódico (por ejemplo, al cierre de cada turno de barra) es el control más efectivo contra la fuga de licor. Puedes practicar el flujo completo en el demo https://demo.consul.rest (usuario gerente, contraseña Demo123!).