Segresta Doc

Tema

  Plugin Bar

 

bar braccialetto nfc ricarica credito operazioni bar movimenti report vendite entrata uscita limite giornaliero soglia minimarfidvenditeacquistisaldooperatorePlugin

📍 Dove si trova in Segresta: Sidebar › Bar (per admin) · oppure Area riservata → Bar (per utenti)

Index ​

Task ​

Inizia da qui ​

Il plugin Bar permette di gestire acquisti e ricariche al bar tramite braccialetto NFC, senza contanti. Il credito può essere ricaricato online dall’area riservata o in segreteria; ogni acquisto al bar avviene semplicemente scansionando il braccialetto, con saldo aggiornato e storico movimenti sempre disponibili.

Funzionalità principali:

  • Ricarica del credito Admin Utente: aggiungi credito al braccialetto dal bar (admin) o dall’area riservata (utente).
  • Acquisti e vendite Admin: registra operazioni scansionando il braccialetto o selezionando l’utente.
  • Storico movimenti Admin Utente: consulta tutte le ricariche e acquisti.
  • Gestione crediti e report Admin: verifica saldi, genera report, e imposta limiti giornalieri e soglie minime di spesa.

Tutto in modo semplice e tracciato sia per utenti che per admin.

⚡ Azioni rapide ​

Ricarica braccialetto Admin Utente ​

🎯 Vuoi aggiungere credito sul braccialetto di un utente?

In pratica

📍 Bar → Seleziona utente → Ricarica
oppure
📍 Area riservata → Bar → Ricarica

Per Admin:

  1. Vai su Bar dalla sidebar
  2. Clicca sull'utente nella lista (o doppio clic)
  3. Clicca su Ricarica o + Ricarica
  4. Inserisci l'importo della ricarica
  5. Aggiungi una descrizione opzionale (es. "Ricarica iniziale")
  6. Conferma

Per Utente:

  1. Vai su Area riservata → Bar
  2. Clicca su Ricarica
  3. Inserisci l'importo
  4. Scegli la modalità di pagamento
  5. Completa il pagamento

Ricarica online

Gli utenti possono ricaricare il braccialetto direttamente dall'area riservata, pagando online con le modalità configurate (bonifico, carta, PayPal, ecc.).

Registra vendita Admin ​

🎯 Vuoi registrare un acquisto al bar?

In pratica

📍 Bar → Scansiona braccialetto oppure Seleziona utente → Registra vendita

  1. Identifica l'utente

    • Opzione 1: Scansiona il braccialetto NFC con il lettore RFID
    • Opzione 2: Cerca e seleziona l'utente dalla lista

  2. Verifica il credito
    Il sistema mostra automaticamente il credito disponibile dell'utente.

  3. Registra la vendita

    • Inserisci l'importo dell'acquisto
    • Aggiungi una descrizione (es. "Bibita", "Merenda")
    • Clicca su Registra

  4. Conferma
    Il sistema controlla automaticamente:

    • Che il credito sia sufficiente
    • Che non sia stato superato il limite giornaliero
    • Che il credito non scenda sotto la soglia minima

  5. Operazione completata
    Il credito viene scalato automaticamente e l'operazione viene registrata nello storico.

Controlli automatici

Il sistema impedisce automaticamente le vendite se:

  • Il credito non è sufficiente
  • È stato raggiunto il limite giornaliero
  • Il credito scenderebbe sotto la soglia minima configurata

Visualizza movimenti Admin Utente ​

🎯 Vuoi vedere lo storico delle operazioni di un utente?

In pratica

📍 Bar → Doppio clic sull'utente
oppure
📍 Area riservata → Bar → Movimenti

Per Admin:

  1. Vai su Bar dalla sidebar
  2. Doppio clic sull'utente nella lista
  3. Si apre il pannello con tutti i movimenti dell'utente

Per Utente:

  1. Vai su Area riservata → Bar
  2. Vedi automaticamente l'elenco dei tuoi movimenti

Cosa vedi:

  • Data e ora dell'operazione
  • Tipo (Entrata/Ricarica o Uscita/Acquisto)
  • Importo
  • Descrizione
  • Operatore (chi ha registrato l'operazione)
  • Credito residuo dopo l'operazione

Aggiorna credito Admin ​

🎯 Vuoi ricalcolare il credito di un utente basandoti sui movimenti?

In pratica

📍 Bar → Seleziona utente → Aggiorna totale

  1. Vai su Bar dalla sidebar
  2. Seleziona l'utente dalla lista
  3. Clicca su Aggiorna totale o Ricalcola credito
  4. Il sistema ricalcola il credito sommando tutte le entrate e sottraendo tutte le uscite
  5. Il credito viene aggiornato automaticamente

Quando usarlo

Utile se hai fatto modifiche manuali ai movimenti o se vuoi verificare che il credito sia corretto rispetto allo storico delle operazioni.

Report vendite Admin ​

🎯 Vuoi vedere le statistiche delle vendite del bar?

In pratica

📍 Bar → Report oppure Contabilità → Report bar

  1. Vai su Bar → Report (o Contabilità → Report bar)
  2. Seleziona il periodo:
    • Data inizio: prima data del periodo
    • Data fine: ultima data del periodo
  3. Clicca su Genera report
  4. Vedi le statistiche:
    • Totale vendite (uscite)
    • Totale ricariche (entrate)
    • Numero di operazioni
    • Dettaglio per utente o operatore
  5. Esporta i dati se necessario

Come funziona il Bar ​

Come funziona il credito con il braccialetto ​

Il plugin Bar usa un sistema molto semplice: ogni utente ha un braccialetto NFC che funziona come un "portafoglio elettronico".

In pratica come funziona:

  1. Ricarica: tu (o la segreteria) puoi aggiungere soldi al braccialetto. Questo si chiama "Entrata" ed aumenta il tuo saldo.
    • Esempio: Ricarichi il braccialetto con 20 €, ora li hai disponibili per spendere.
  2. Acquisto: quando vuoi comprare qualcosa al bar, basta scansionare il braccialetto oppure indicare il tuo nome. Il sistema scala i soldi dalla ricarica (questa è chiamata "Uscita").
    • Esempio: Comprando una bibita da 2 €, il tuo saldo scende di 2 €.
  3. Tutto è automatico: ogni movimento viene registrato, quindi puoi sempre controllare tutto.

Quali sono le operazioni possibili?

  • Entrata: quando aggiungi credito (ricarica)
  • Uscita: quando fai un acquisto e spendi

Braccialetto NFC: cos’è e a cosa serve? ​

Il braccialetto NFC è personale: è il modo più veloce e pratico per pagare al bar, senza usare soldi!

Vantaggi pratici:

  • Identificazione immediata: basta avvicinare il braccialetto per essere riconosciuto e vedere subito il tuo credito.
  • Più sicuro: niente contanti da gestire, meno rischio di perdere soldi.
  • Ogni spesa è registrata: puoi vedere tutte le ricariche e gli acquisti fatti.
  • Solo tu puoi usarlo: il braccialetto ha un codice unico associato al tuo account.

Attivarlo è facile:

  • Lo colleghi al tuo account nelle impostazioni utente.
  • Il codice del braccialetto si chiama braccialetto_rfid (niente paura, di solito lo gestisce la segreteria!).
  • In qualunque momento puoi cambiarlo o associarne uno nuovo.

Limite giornaliero di spesa ​

Per evitare che si spenda troppo in un solo giorno, si può impostare un tetto massimo di spesa giornaliera.

Come funziona:

  • Ogni utente può avere un proprio limite giornaliero personalizzato.
  • Se spendi più del limite con gli acquisti al bar, il sistema blocca l'acquisto e ti avvisa.
  • Il conteggio riparte ogni giorno da zero (si azzera a mezzanotte).

Esempio pratico:

  • Limite giornaliero impostato a 10,00 €
  • Hai già speso oggi: 7,50 €
  • Vuoi comprare qualcosa che costa 3,00 €
  • Risultato: puoi acquistare (perché 7,50 + 3,00 = 10,50 €, ma il controllo viene fatto PRIMA della spesa e resti sotto il limite).

Consiglio per i genitori

Puoi usare questa funzione per controllare quanto spendono i tuoi figli ogni giorno al bar.

Soglia minima credito: come funziona ​

Si può anche impostare una soglia minima, cioè il saldo MINIMO che deve rimanere sul braccialetto dopo un acquisto. Serve per evitare che il credito vada sotto zero o avere sempre una piccola riserva.

Come funziona:

  • La soglia minima si imposta nelle impostazioni generali (di solito la mette la segreteria).
  • Il sistema controlla sempre PRIMA della spesa: se dopo l’acquisto il saldo va sotto la soglia, l’operazione viene bloccata e nessun soldo viene scalato.

Esempio pratico:

  • Hai sul braccialetto: 5,00 €
  • Soglia minima impostata: 2,00 €
  • Vuoi comprare qualcosa che costa 4,00 €
  • Risultato: acquisto BLOCCATO (5,00 - 4,00 = 1,00 € che è meno della soglia minima).

Piccolo trucco sicurezza

Questa funzione ti assicura che sul braccialetto ci siano sempre almeno un paio di euro, così da non restare mai proprio senza credito!

Ricarica braccialetto ​

Ricarica in segreteria ​

📍 Bar → Seleziona utente → Ricarica

Quando usarlo:
Quando la segreteria ricarica il braccialetto per conto dell'utente (es. pagamento in contanti o bonifico).

Procedura:

  1. Vai su Bar dalla sidebar
  2. Clicca sull'utente nella lista (o doppio clic)
  3. Clicca su Ricarica o + Ricarica
  4. Compila:
    • Importo: importo della ricarica (es. 20,00 €)
    • Descrizione: descrizione opzionale (es. "Ricarica iniziale", "Pagamento bonifico")
  5. Clicca su Salva o Conferma

Cosa succede:

  • Il credito dell'utente viene aumentato dell'importo inserito
  • L'operazione viene registrata come "Entrata" nello storico
  • L'operatore viene registrato automaticamente (chi ha fatto la ricarica)
Per esempio...

🎯 Obiettivo
Ricarica il braccialetto di "Mario Rossi" con 25,00 € pagati in contanti.

  1. Vai su Bar dalla sidebar.
  2. Cerca "Mario Rossi" nella lista (puoi usare il filtro).
  3. Doppio clic su "Mario Rossi" per vedere i dettagli.
  4. Clicca su Ricarica.
  5. Compila:
    • Importo: 25,00
    • Descrizione: Ricarica pagamento contanti
  6. Clicca su Salva.

Il credito di Mario Rossi viene aumentato di 25,00 € e l'operazione viene registrata nello storico.

Ricarica online (utente) ​

📍 Area riservata → Bar → Ricarica

Quando usarlo:
Quando l'utente ricarica il proprio braccialetto direttamente dall'area riservata, pagando online.

Procedura:

  1. L'utente accede all'Area riservata
  2. Vai su Bar
  3. Vedi il credito attuale
  4. Clicca su Ricarica
  5. Inserisci l'importo della ricarica
  6. Scegli la modalità di pagamento (bonifico, carta, PayPal, Satispay, ecc.)
  7. Completa il pagamento

Cosa succede:

  • Dopo il pagamento, il credito viene aggiunto automaticamente
  • L'operazione viene registrata come "Entrata" nello storico
  • L'utente riceve una conferma della ricarica

Pagamento immediato

Con alcune modalità di pagamento (carta, PayPal, Satispay), il credito viene aggiunto immediatamente. Con bonifico, potrebbe essere necessario attendere la conferma del pagamento.

Ricarica per familiari ​

📍 Area riservata → Bar → Ricarica → Seleziona familiare

Quando usarlo:
Quando un genitore ricarica il braccialetto dei figli dall'area riservata.

Procedura:

  1. Accedi all'Area riservata
  2. Vai su Bar
  3. Vedi l'elenco dei familiari con i loro crediti
  4. Seleziona il familiare da ricaricare
  5. Clicca su Ricarica
  6. Inserisci l'importo e completa il pagamento

Cosa vedi:

  • Credito attuale di ogni familiare
  • Limite giornaliero di ogni familiare (se configurato)
  • Storico movimenti di ogni familiare

Registrare operazioni ​

Registrare una vendita ​

📍 Bar → Scansiona braccialetto oppure Seleziona utente → Registra vendita

Quando usarlo:
Quando un utente acquista qualcosa al bar e vuoi registrare l'acquisto.

Procedura:

  1. Identifica l'utente:
    • Opzione 1: Scansiona il braccialetto NFC con il lettore RFID
    • Opzione 2: Cerca e seleziona l'utente dalla lista
  2. Verifica credito: il sistema mostra automaticamente il credito disponibile
  3. Inserisci i dati:
    • Importo: importo dell'acquisto (es. 2,50 €)
    • Descrizione: descrizione opzionale (es. "Bibita", "Merenda", "Gelato")
  4. Conferma: clicca su Registra o Conferma

Controlli automatici:

  • ✅ Credito sufficiente
  • ✅ Limite giornaliero non superato
  • ✅ Soglia minima rispettata

Cosa succede:

  • Il credito viene scalato automaticamente
  • L'operazione viene registrata come "Uscita" nello storico
  • L'operatore viene registrato automaticamente
Per esempio...

🎯 Obiettivo
Registrare l'acquisto di una bibita (2,50 €) da parte di "Mario Rossi".

  1. Al bar, scansiona il braccialetto NFC di Mario Rossi (o cerca "Mario Rossi" nella lista).
  2. Il sistema mostra: "Credito disponibile: 15,00 €".
  3. Inserisci:
    • Importo: 2,50
    • Descrizione: Bibita
  4. Clicca su Registra.

Il credito di Mario Rossi viene scalato a 12,50 € e l'operazione viene registrata nello storico.

Registrare operazione manuale ​

📍 Bar → Seleziona utente → Nuova operazione

Quando usarlo:
Per registrare operazioni speciali (es. rimborsi, correzioni, operazioni manuali).

Procedura:

  1. Vai su Bar dalla sidebar
  2. Seleziona l'utente dalla lista
  3. Clicca su Nuova operazione o + Operazione
  4. Scegli il tipo:
    • Entrata: aumenta il credito (ricarica, rimborso, correzione)
    • Uscita: diminuisce il credito (acquisto, correzione)
  5. Compila importo e descrizione
  6. Salva

Per correzioni

Utile per correggere errori o registrare operazioni particolari che non sono normali acquisti o ricariche.

Gestione crediti ​

Visualizzare elenco utenti ​

📍 Bar → Lista utenti

Cosa vedi:

  • Nome e cognome utente
  • Credito attuale
  • Limite giornaliero (se configurato)
  • Ultima operazione

Filtri disponibili:

  • Nome: cerca per nome o cognome
  • Credito: filtra per range di credito
  • Ultima operazione: filtra per data ultima operazione

Visualizzare movimenti utente ​

📍 Bar → Doppio clic sull'utente

Cosa vedi:

  • Lista movimenti: tutte le operazioni dell'utente in ordine cronologico
  • Dettagli operazione:
    • Data e ora
    • Tipo (Entrata/Uscita)
    • Importo
    • Descrizione
    • Operatore (chi ha registrato)
    • Credito dopo l'operazione

Filtri:

  • Periodo: filtra per data inizio/fine
  • Tipo: filtra per Entrata o Uscita
  • Operatore: filtra per chi ha registrato l'operazione

Aggiornare credito manualmente ​

📍 Bar → Seleziona utente → Aggiorna totale

Quando usarlo:
Per ricalcolare il credito di un utente basandoti su tutti i movimenti registrati.

Procedura:

  1. Vai su Bar dalla sidebar
  2. Seleziona l'utente dalla lista
  3. Clicca su Aggiorna totale o Ricalcola credito
  4. Il sistema:
    • Somma tutte le entrate (ricariche)
    • Sottrae tutte le uscite (acquisti)
    • Aggiorna il credito dell'utente

Formula:

Credito = Somma(Entrate) - Somma(Uscite)

Verifica coerenza

Utile per verificare che il credito visualizzato corrisponda alla somma di tutte le operazioni registrate.

Configurare limite giornaliero ​

📍 Anagrafica → Seleziona utente → Modifica → Limite giornaliero bar

Procedura:

  1. Vai su Anagrafica dalla sidebar
  2. Seleziona l'utente dalla lista
  3. Clicca su Modifica
  4. Trova il campo Limite giornaliero bar
  5. Inserisci l'importo massimo che l'utente può spendere in un giorno (es. 10,00 €)
  6. Salva

Come funziona:

  • Il limite si applica alle uscite (acquisti) della giornata
  • Il sistema somma tutte le uscite del giorno
  • Se un nuovo acquisto supererebbe il limite, viene bloccato
  • Il limite si resetta ogni giorno a mezzanotte

Report vendite ​

Generare report vendite ​

📍 Bar → Report oppure Contabilità → Report bar

Procedura:

  1. Vai su Bar → Report (o Contabilità → Report bar)
  2. Seleziona il periodo:
    • Data inizio: prima data del periodo da analizzare
    • Data fine: ultima data del periodo
  3. Clicca su Genera report

Cosa vedi:

  • Totale vendite: somma di tutte le uscite (acquisti) nel periodo
  • Totale ricariche: somma di tutte le entrate (ricariche) nel periodo
  • Numero operazioni: totale operazioni registrate
  • Dettaglio per utente: vendite e ricariche per ogni utente
  • Dettaglio per operatore: operazioni registrate da ogni operatore
  • Grafici: visualizzazione grafica delle vendite (se disponibile)

Esportare report ​

📍 Report bar → Esporta

Formati disponibili:

  • Excel (.xlsx): file Excel con tutti i dati del report
  • PDF: documento PDF formattato

Cosa contiene l'export:

  • Riepilogo totale vendite e ricariche
  • Dettaglio operazioni per utente
  • Dettaglio operazioni per operatore
  • Statistiche e totali

Domande frequenti ​

Come funziona il braccialetto NFC?

Permessi Admin Utente

Il braccialetto NFC contiene un codice RFID univoco associato all'utente. Al bar, scansiona il braccialetto con il lettore RFID per identificare immediatamente l'utente e vedere il suo credito. Puoi anche selezionare l'utente manualmente dalla lista.
Il braccialetto viene associato all'utente nelle impostazioni anagrafica.
-> Braccialetto NFC

Come ricarico il braccialetto?

Permessi Admin Utente

Per utenti: dall'Area riservata → Bar → Ricarica. Inserisci l'importo, scegli la modalità di pagamento e completa il pagamento online.
Per segreteria: da Bar → seleziona l'utente → Ricarica. Inserisci l'importo e una descrizione opzionale.
-> Ricarica braccialetto

Come registro un acquisto al bar?

Permessi Admin

Scansiona il braccialetto NFC con il lettore RFID (o seleziona l'utente dalla lista), inserisci l'importo dell'acquisto e una descrizione opzionale, poi clicca su Registra. Il sistema controlla automaticamente il credito disponibile, il limite giornaliero e la soglia minima prima di permettere l'acquisto.
-> Registrare una vendita

Cosa succede se il credito non è sufficiente?

Permessi Admin

Il sistema blocca automaticamente l'acquisto se il credito non è sufficiente. Viene mostrato un messaggio di errore e l'operazione non viene registrata. L'utente deve prima ricaricare il braccialetto.
Il sistema controlla anche che il credito non scenda sotto la soglia minima configurata.

Cos'è il limite giornaliero?

Permessi Admin

È il massimo importo che un utente può spendere al bar in un singolo giorno. Viene configurato per ogni utente nell'anagrafica. Il sistema somma tutte le uscite della giornata e blocca gli acquisti che supererebbero il limite. Il limite si resetta ogni giorno a mezzanotte.
Utile per i genitori che vogliono limitare le spese giornaliere dei figli.
-> Limite giornaliero

Cos'è la soglia minima credito?

Permessi Admin

È il minimo credito che deve rimanere sul braccialetto dopo ogni acquisto. Viene configurata nelle impostazioni generali. Se un acquisto farebbe scendere il credito sotto questa soglia, l'operazione viene bloccata.
Utile per mantenere sempre un minimo di credito per emergenze o per evitare saldi negativi.
-> Soglia minima credito

Dove vedo i movimenti di un utente?

Permessi Admin Utente

Per admin: da Bar → doppio clic sull'utente. Si apre il pannello con tutti i movimenti (ricariche e acquisti) con data, importo, descrizione e operatore.
Per utenti: dall'Area riservata → Bar. Vedi automaticamente l'elenco dei tuoi movimenti.
-> Visualizzare movimenti

Come genero un report delle vendite?

Permessi Admin

Vai su Bar → Report (o Contabilità → Report bar). Seleziona il periodo (data inizio e data fine) e clicca su Genera report. Vedi le statistiche delle vendite, ricariche e operazioni. Puoi esportare i dati in Excel o PDF.
-> Generare report vendite

Posso ricaricare il braccialetto dei miei figli?

Permessi Utente

Sì: dall'Area riservata → Bar vedi l'elenco di tutti i familiari con i loro crediti. Puoi selezionare un familiare e ricaricare il suo braccialetto, pagando online con le modalità configurate.
-> Ricarica per familiari

Come aggiorno il credito di un utente?

Permessi Admin

Il credito viene aggiornato automaticamente ad ogni operazione. Se vuoi ricalcolarlo manualmente basandoti su tutti i movimenti, vai su Bar → seleziona l'utente → Aggiorna totale. Il sistema ricalcola il credito sommando tutte le entrate e sottraendo tutte le uscite.
-> Aggiornare credito manualmente

Posso correggere un errore in un'operazione?

Permessi Admin

Sì: puoi registrare un'operazione manuale di correzione. Se hai registrato un acquisto per errore, registra un'operazione "Entrata" con lo stesso importo per annullarlo. Se hai dimenticato di registrare un acquisto, registra un'operazione "Uscita" con la data corretta.
-> Registrare operazione manuale