Productes i Categories

Productes i Categories de Barra: Lògica de Preus, IVA i Estocs

La secció de Barra centralitza tota l'oferta de consumicions (cerveses, copes, refrescs, ampolles de servei VIP) de l'establiment.

Formulari de Creació de Productes de Barra (BarProduct)

Per afegir un article a barra, ves a Gestió de Barra > Productes Bar i prem Nova Beguda / Article. Has d'emplenar els següents camps:

1. Nom: Text visible al botó del TPV (Ex: Copa de Ron Barceló, Llauna de Coca-Cola).
2. Categoria: Filtre organitzatiu on se situarà l'article (Ex: Copes, Xarrups, Refrescs, Cerveses).
3. Preu: El preu final de venda al públic (PVP). S'HA D'INTRODUIR AMB IVA INCLÒS. Per exemple, si la copa es ven a 8€, introdueix 8.00.
4. Preu de Cost (Cost Price): Preu net de compra del producte al distribuïdor/proveïdor. S'HA D'INTRODUIR SENSE IVA. Aquesta dada és crucial per calcular de forma automàtica els marges reals de benefici a la secció d'informes.
5. IVA (%): Mòdul tributari (Ex: 21.00 per a begudes alcohòliques, 10.00 per a refrescs o alimentació).
6. Unitats per Caixa: Multiplicador per a la recepció de comandes (Ex: si compres caixes de 6 ampolles, posa 6).
7. Stock Actual / Mínim: Unitats físiques en magatzem.
8. Controlar Stock: Si està desactivat, les vendes es comptabilitzen comercialment però no es vigilen nivells crítics.
9. És una Ampolla Buida (Només Recompte): Activa aquesta casella per als elements de control de buits físics de magatzem. Aquests productes es descarten de la interfície de venda normal del cambrer.
10. Control d'Estoc per Ampolla Buida (useBottleStock): Checkbox que determina el funcionament del descomptat d'inventari (vegeu apartat següent).

Lògica de Control d'Estoc: Copa vs Ampolla vs Beguda Directa

El control d'estoc en discoteques i oci té particularitats operatives degut als combinats (copes servides des d'una ampolla mare). Goin Club gestiona aquestes condicions mitjançant tres configuracions clarament diferenciades:

1. Begudes de Venda Directa (Llaunes, Cervesa, Aigua)

• Configuració: isStockControlled = true i useBottleStock = false.
• Comportament del Sistema: Cada vegada que es ven una unitat al TPV (ex: una llauna de Coca-Cola), el sistema descompta automàticament 1 unitat de l'estoc de forma immediata.

2. Copes i Combinats de Licor (Ex: Copa de Ron Barceló, Gin Tonic)

• Configuració: isStockControlled = true i useBottleStock = true.
• Comportament del Sistema: La venda d'una copa a la barra del TPV NO descompta estoc de l'inventari al moment del cobrament. Això evita decimals insostenibles de càlcul (com 0.07 d'ampolla) i desajustos per dosis més generoses o abocaments accidentals.
• Com es controla doncs? L'estoc del producte base es descompta quan es marca i es comptabilitza la seva Ampolla Buida a la barra (vegeu l'apartat d'Auditoria d'Ampolles).

3. Venda d'Ampolles Senceres (VIP / Servei de Taules)

• Configuració: isStockControlled = true i useBottleStock = false (ja que és un producte independent que es ven de cop).
• Comportament del Sistema: Es descompta directament 1 ampolla sencera de l'inventari a l'instant en què s'efectua la transacció de venda.

Exemple Pràctic de Configuració de Productes per a Begudes alcohòliques

Si el teu local ofereix Ron Barceló, has de crear aquests productes separats al panell:

[!TIP] Per a la Copa de Ron Barceló, vincula el grup de modificadors de refrescs. Si el client demana la copa amb un refresc de llauna, el refresc (que té useBottleStock = false) es descomptarà a l'acte de l'estoc, mentre que el licor de l'ampolla s'auditarà mitjançant el control de buides.

Arquitectura Offline-First de Validació a la Barra

L'aplicació de Barra TPV implementa un sistema robust Offline-First per garantir que els tiquets i consumicions es puguin validar encara que es perdi completament la connexió a Internet durant l'esdeveniment:

• Base de dades local (SQLite): Els tiquets no redimits es descarreguen contínuament dels servidors de producció a la base de dades local persistent (SQLite) del terminal de barra.
• Validació Híbrida: En validar un QR, el sistema prioritza la connexió online. Si falla, recorre automàticament a SQLite per verificar si el tiquet és vàlid i té crèdit.
• Control de Doble Despesa: En marcar un tiquet localment offline, el sistema l'afegeix a una cua de redempcions pendents i el manté bloquejat perquè no es pugui reutilitzar en cap terminal. Un cop torna la connexió, la comanda es sincronitza i es liquida al servidor de forma atòmica.

Simulador Interactiu de la Barra TPV

A continuació, pots interactuar amb el simulador de l'App de Barra per provar de validar el codi de descompte DEMO-10 (crèdit de 10€) i experimentar el seu comportament: