1. Introduzione
PotaPay Γ¨ un programma di cassa pensato per sagre paesane, feste e attivitΓ delle pro loco. Permette di gestire il listino articoli, prendere comande, stampare scontrini e tenere traccia degli incassi senza obbligo di connessione internet.
Piattaforme supportate
| Piattaforma | Requisiti | Caso d'uso tipico |
|---|---|---|
| Windows | Windows 10/11 64 bit | Cassa principale, gestione amministrativa, stampa A4/A5/A6 o rotolo termico via stampante di sistema |
| Android | Android 6.0+ (API 23+) | Cassa portatile sotto al gazebo, stampa scontrini su stampante termica Bluetooth ESC/POS |
Filosofia di base
- Offline-first: tutti i dati sono in locale (SQLite). Internet serve solo per features opzionali (sync cloud, check aggiornamenti).
- Nessun abbonamento mensile: licenza una tantum legata al dispositivo.
- Funziona anche da solo: nessun account, nessun setup cloud necessario. Una postazione cassa Γ¨ sufficiente.
- Multi-cassa quando serve: si possono collegare piΓΉ postazioni in LAN o tramite cloud, mantenendo il catalogo sincronizzato.
2. Installazione e primo avvio
Windows Win
- Scarica
PotaPay-Setup-X.Y.Z.exeda www.potapay.it. - Doppio click sull'installer e segui la procedura guidata.
- Al primo avvio compare la schermata di login con il cassiere predefinito Admin Sistema (PIN
0000). - Cambia subito il PIN dell'admin: Settings β Cassieri β modifica.
Android And
- Apri il link al download dell'APK dal browser del cellulare (lo trovi su www.potapay.it).
- Conferma "Installa app sconosciute" se Android lo richiede (la prima volta).
- Avvia l'app: stesso login Admin/0000 come su Windows.
3. Licenza e modalitΓ demo
PotaPay parte in modalitΓ Demo finchΓ© non viene attivata una licenza. La demo permette di provare l'app con alcuni limiti:
- Massimo 2 reparti
- Massimo 2 articoli
- Massimo 10 scontrini al giorno
Attivare la licenza
- Vai su Settings β Licenza.
- Copia il Fingerprint PC mostrato (es.
91F6-4CE4-0DFA). - Invialo al rivenditore/amministratore: emetterΓ un codice licenza dedicato a quel fingerprint + numero postazione.
- Incolla il codice nel campo Codice licenza e premi Attiva licenza.
FunzionalitΓ pro (richiedono licenza attiva)
- ModalitΓ Online (sync con cloud potapay.it)
- Sincronizzazione API delle transazioni
- Import/Export configurazione anagrafica
- Nessun limite su numero reparti / articoli / scontrini
4. Login cassieri e ruoli
Ogni operatore della cassa Γ¨ identificato da un PIN numerico di 4 cifre. Esistono due ruoli:
| Ruolo | Permessi |
|---|---|
| Amministratore | Tutto: anagrafica reparti/articoli/cassieri, magazzino, storico, statistiche, impostazioni, reset. |
| Cassiere | Solo POS + accesso in sola lettura a Dashboard incassi, Storico comande e Magazzino. Niente impostazioni, niente modifiche all'anagrafica. |
Per creare nuovi cassieri vai su Settings β Cassieri β Nuovo cassiere. Ricorda di assegnare il ruolo giusto in fase di creazione.
5. OperativitΓ cassa (POS)
La schermata POS Γ¨ il cuore dell'app. Si compone di:
- Griglia articoli al centro (su desktop e tablet) o a tutto schermo (su phone).
- Filtri reparto in alto: tocca un reparto per filtrare gli articoli di quella categoria.
- Ricerca: campo di testo per cercare articoli per nome.
- Pannello comanda: laterale su desktop/tablet, in bottom sheet a comparsa su phone.
Aprire una nuova comanda
- Premi + Nuova in basso a destra (o tap sul tasto principale del pannello).
- Se attivo l'opzione in Settings, comparirΓ un dialog per inserire il nome cliente (opzionale) e il flag Da asporto.
- Conferma per aprire la comanda.
Aggiungere articoli
- Tocca l'articolo nella griglia: viene aggiunto alla comanda.
- Tocchi multipli incrementano la quantitΓ .
- Per modificare quantitΓ manualmente: nel pannello comanda usa i tasti + / β sulla riga.
Note e allergie
- Nota riga: long-press / icona matita sulla riga articolo. Es: "senza cipolla".
- Nota comanda: dal menu opzioni comanda. Es: "tavolo 5", "ritira alle 20".
- Allergie cliente: dal dialog note comanda. Vengono evidenziate in rosso nello scontrino per cucina.
Annullare una comanda
Tasto Annulla ordine nel pannello: chiede conferma. La comanda viene marcata come "annullata" nello storico.
6. Pagamento e chiusura comanda
Quando la comanda Γ¨ completa, premi Conferma. Si apre il dialog di pagamento.
ModalitΓ di pagamento
| ModalitΓ | Quando usarla |
|---|---|
| Contanti | Pagamento in contanti. Inserisci la cifra ricevuta β l'app calcola il resto. |
| Carta | Pagamento elettronico con POS esterno (Sumup, Nexi, ecc.). |
| Misto | Parte in carta + parte in contanti. Inserisci l'importo carta, il resto va in contanti. |
| Omaggio | Totale a 0 β¬: non registra incasso ma traccia comunque l'erogazione (utile per statistiche). |
Conferma il pagamento per chiudere la comanda. Vengono automaticamente:
- Stampati gli scontrini configurati (cliente, per reparto, cameriere β vedi Β§7).
- Scaricate le giacenze di magazzino dei prodotti base associati agli articoli.
- Inviata la transazione al server cloud (se in modalitΓ Online).
7. Stampa scontrini
PotaPay supporta tre tipi di scontrino, attivabili indipendentemente da Settings β Stampa:
| Tipo | Cosa contiene | A chi serve |
|---|---|---|
| Scontrino cliente | Lista completa con prezzi, totale, modalitΓ pagamento, eventuale resto. | Cliente che paga al banco. |
| Per reparto | Una "fetta" separata per ogni destinazione di stampa (es. Cucina, Bar). QuantitΓ grandi, niente prezzi. | Personale di servizio per preparare gli ordini. |
| Cameriere | Riepilogo unico raggruppato per reparto, senza prezzi. | Cameriere/runner che serve ai tavoli. |
Formati di stampa Win
- A4: tabella completa con colonne.
- A5 / A6: layout compatto a colonna singola.
- Rotolo termico 80mm / 57mm: layout ultra compatto per stampanti scontrino classiche.
Stampante predefinita
Da Settings β Stampa puoi scegliere una stampante predefinita installata sul sistema. Se attivi "stampa diretta", il PDF viene inviato senza mostrare il dialog di Windows, perfetto per uso a tutto schermo.
8. Stampante termica Bluetooth And
Su Android le stampanti del sistema operativo non sono utilizzabili dalla cassa. Al loro posto si usa una stampante termica Bluetooth ESC/POS, formato 80mm o 58mm.
Modelli compatibili
Qualsiasi stampante termica Bluetooth classic con supporto ESC/POS standard. Esempi testati: Munbyn, Xprinter, Goojprt. Range di prezzo tipico 40β100 β¬.
Setup in 4 passi
- Accendi la stampante e abilita la modalitΓ Bluetooth.
- Da Android β Impostazioni β Bluetooth β cerca dispositivi β Pair (PIN tipico
0000o1234). - Apri PotaPay β Settings β Stampante termica Bluetooth β Rilegge β seleziona la stampante dalla lista.
- Premi Test: deve uscire uno scontrino di prova con caratteri di vari stili.
Larghezza rotolo
Imposta 80mm o 58mm in base al rotolo che usi. Le 58mm sono piΓΉ compatte ma con meno spazio per i nomi articolo.
9. Importa comanda da QR
I clienti possono pre-ordinare tramite un sito o app esterno (es. portale potapay.it) e presentarsi al banco con un QR code. La cassa lo legge e importa direttamente le righe nella comanda corrente.
Procedura
- Apri una nuova comanda.
- Premi Importa da QR.
- Scannerizza il QR (su Windows tramite scanner USB; su Android con la fotocamera del telefono).
- In alternativa puoi incollare il contenuto del QR manualmente.
- La cassa risolve gli articoli (per codice, poi per nome se non c'Γ¨ match) e ne mostra l'anteprima.
- Conferma per aggiungere tutte le righe alla comanda.
Per articoli non trovati nel catalogo locale viene creato automaticamente un "articolo ospite" in un reparto dedicato, così la comanda risulta sempre completa.
10. Anagrafiche
L'area Amministrazione (icona Amministrazione nel POS, solo per ruolo admin) contiene tutte le anagrafiche dell'app.
Reparti
Sono le categorie principali del menu (es. Primi, Secondi, Bar, Bibite). Ogni reparto ha:
- Nome (univoco, max 50 caratteri)
- Colore: identifica visivamente gli articoli nella griglia POS
- Ordinamento: trascina per riordinare i reparti come compaiono nei tab
- Destinazione stampa (opzionale): vedi paragrafo successivo
Reparti di stampa
Le destinazioni fisiche di stampa, separate dai reparti dell'anagrafica. Permettono di accorpare piΓΉ reparti in un'unica stampa.
Esempio: Reparti Primi, Secondi, Contorni tutti puntati alla destinazione "Cucina". Al confirm di una comanda esce una sola stampa "Cucina" con tutti gli articoli di quei tre reparti aggregati, invece di tre stampe separate.
Articoli
Singoli prodotti vendibili. Per ogni articolo:
- Codice univoco (es.
AR-001): usato per import/export e match con QR esterni - Nome e prezzo
- Reparto di appartenenza
- Immagine (opzionale, base64 inline)
- Attivo: se disattivato, l'articolo resta nello storico ma sparisce dalla griglia POS
- Allergeni: associazione multipla agli allergeni EU (14 standard + custom)
- Composizione magazzino (opzionale): quali prodotti base vengono consumati per ogni vendita
Allergeni
I 14 allergeni dello standard EU 1169/2011 sono pre-caricati. Puoi aggiungerne di custom (es. "Pomodoro") per intolleranze specifiche. Sugli scontrini stampati gli allergeni associati a un articolo vengono evidenziati in rosso se il cliente ha dichiarato allergie.
11. Magazzino
La gestione magazzino Γ¨ opzionale ma utile per non finire le scorte durante una serata di sagra.
Prodotti base
Sono le materie prime/ingredienti consumati dagli articoli venduti. Esempio: Pane, Salamelle, Birra in fusto. Ogni prodotto ha:
- Nome e unitΓ di misura (pz, kg, l)
- Giacenza corrente
- Soglia minima (opzionale): sotto questa quantitΓ l'articolo viene segnato come sottoscorta
Composizione articoli
Per ogni articolo del menu definisci quanti prodotti base consuma. Esempio: Panino con salamella consuma 1 Pane + 1 Salamella. A ogni vendita confermata, la giacenza di entrambi diminuisce automaticamente di 1.
Carico rapido
Per aggiungere giacenze (rifornimento, inventario iniziale): Magazzino β Carico rapido. Inserisci quantitΓ per ogni prodotto.
Rettifica giacenza
Per impostare una giacenza assoluta (post-inventario): apri il prodotto β modifica giacenza manualmente. Viene tracciato un movimento di rettifica.
Avvisi sottoscorta
Durante l'apertura di una comanda, se uno degli articoli scelti porta un prodotto base sotto la soglia minima, compare un badge giallo accanto al nome. Niente popup invadenti, solo un'indicazione visiva.
Movimenti
Lista cronologica di tutte le variazioni di giacenza (carico, scarico da vendita, rettifica, svuotamento). Filtrabile per prodotto e periodo.
12. Storico comande
Tutte le comande chiuse o annullate sono accessibili da Amministrazione β Storico.
Filtri
- Stato: tutte / chiuse / annullate
- Data: range di giorni
- Cassiere: chi ha emesso la comanda
Dettaglio comanda
Tap su una riga apre il dettaglio: righe articoli, allergie, totale, modalitΓ di pagamento, eventuale resto, timestamp di apertura/chiusura.
Ristampa
Bottone Ristampa: rigenera lo scontrino cliente (utile se la stampa originale si Γ¨ rovinata o l'utente l'ha persa).
13. Statistiche e dashboard
Dashboard incassi
Schermata a tile con i numeri principali del periodo:
- Incasso contanti / carta / totale
- Numero comande
- Valore omaggi erogati
- Scontrino medio
Filtri rapidi: Oggi / Ultimi 7 giorni / Ultimi 30 giorni / range custom.
Statistiche dettagliate
Tabella di vendite riga per riga (una riga per ogni quantitΓ venduta) con filtri:
- Periodo (data dal / al)
- Reparti specifici
- Articoli specifici
- Solo articoli movimentati (default ON)
Esporta Excel
Premi Esporta Excel per scaricare un file .xlsx con tutte le righe filtrate + totali in coda. Utile per rendicontazione e contabilitΓ post-evento.
14. Import / Export configurazione PRO
Disponibile solo con licenza attiva. Permette di sincronizzare il catalogo tra piΓΉ postazioni o di importarlo da un portale esterno.
Esporta configurazione
Settings β Database β Esporta configurazione β genera un file .json con reparti, articoli e cassieri. Puoi mandarlo per email a un'altra cassa.
Importa configurazione
Settings β Database β Importa configurazione β seleziona il file .json. L'app riconosce automaticamente due formati:
- SagraMenu (legacy): export dal portale web SagraMenu con marker
"source":"SagraMenu" - PotaPay esteso: export dal backend cloud con UUID e relazioni complete (reparti, repartiStampa, prodottiBase, articoli, composizioni magazzino, cassieri)
L'import Γ¨ idempotente: puoi rieseguirlo all'infinito senza creare duplicati. I match avvengono per:
- Reparti / RepartiStampa / Prodotti base β nome
- Articoli β codice (campo UNIQUE)
- Cassieri β tentativo INSERT, skip su PIN giΓ esistente
15. ModalitΓ di rete (multi-cassa)
Quando hai piΓΉ postazioni di cassa devi decidere come fanno a vedere lo stesso catalogo e a non duplicare gli scontrini.
ModalitΓ Standalone (default)
La cassa lavora da sola. Nessuna comunicazione con altre casse. Catalogo e comande sono completamente locali. Buona per una sagra con una sola cassa.
ModalitΓ Server Win
Questa cassa fa da hub LAN per le altre. Espone le anagrafiche e riceve le comande dei client. Solo su Windows (richiede di mettere in ascolto una porta TCP, non possibile su Android).
- Porta predefinita:
8080(configurabile) - I client si connettono via IP locale (es.
192.168.1.10:8080)
ModalitΓ Client
La cassa si connette a un'altra cassa configurata come Server (vedi sopra). Catalogo letto dal server, comande chiuse pushate al server.
ModalitΓ Online PRO
Vedi sezione dedicata sotto.
16. ModalitΓ Online e API PotaPay PRO
La modalitΓ Online connette la cassa al backend cloud potapay.it. Disponibile solo con licenza attiva.
Cosa fa
- Scarica l'anagrafica dal server (reparti, articoli, prodotti base, allergeni, cassieri) tramite
GET /api/anagrafica - Invia le transazioni (comande chiuse) tramite
POST /api/transazioni - Outbox tolerant: se la rete Γ¨ giΓΉ le transazioni si accumulano in coda locale e partono appena torna online β nessuno scontrino viene perso
- Idempotenza: ogni transazione ha un UUID univoco (header
X-Idempotency-Key); retry dopo timeout non producono duplicati lato server
Configurazione
- Settings β Rete β seleziona Online (visibile solo con licenza)
- Compare il pannello blu "ModalitΓ Online β sincronizzazione anagrafica cloud":
- Toggle Sincronizza all'avvio dell'app: prima sync al boot
- Dropdown Sync periodica: mai / 5 / 15 / 30 / 60 minuti
- Bottone Sincronizza ora: sync manuale on-demand
- Timestamp dell'ultima sync riuscita
URL base (modalitΓ sviluppatore)
Il base URL Γ¨ hardcoded a https://api.potapay.it per la produzione. Per ambienti di test/dev puΓ² essere cambiato:
- Settings β scorri fino a Sincronizzazione API PotaPay
- Tocca 7 volte il titolo della sezione (countdown nei tap finali)
- Compare il campo "URL base (modalitΓ sviluppatore)"
- Esempi:
https://api-test.potapay.it(test cloud) ohttp://10.0.2.2:5127(dev locale da emulatore Android)
network_security_config.xml consente cleartext HTTP solo verso loopback (10.0.2.2, 127.0.0.1) e LAN privata (192.168.x.x). HTTPS verso api.potapay.it funziona sempre.
Stato coda transazioni
Sezione Sincronizzazione API PotaPay mostra in tempo reale quante transazioni sono in attesa di invio:
- Sincronizza ora: forza il drain della coda
- Ritenta falliti: rimette in pending le entry marcate come errore terminale
- Svuota coda: cancella tutta la coda locale (le comande nel DB restano, viene cancellato solo lo stato della sync)
17. Impostazioni generali
| Sezione | Cosa configura |
|---|---|
| Festival | Nome della sagra mostrato in cima all'app e in testa allo scontrino. |
| Tema | Schema colori dell'interfaccia (arancione, blu, verde, viola, marrone). Tema chiaro o scuro. |
| POS | Numero postazione (1, 2, 3...), chiedi nome cliente all'apertura comanda, raggruppa righe per reparto, mostra immagini/allergeni nella griglia. |
| Stampa | Tipi di scontrino attivi (cliente / reparto / cameriere), formato carta, stampante predefinita, stampa diretta. |
| Licenza | Stato attivazione, fingerprint dispositivo, attiva/disattiva. |
| Rete | ModalitΓ di rete (vedi Β§15β16). |
| Database | Import/export configurazione (vedi Β§14). |
| Informazioni | Versione app installata, path del database, copia versione negli appunti con long-press. |
| Stampante BT And | Setup stampante termica Bluetooth (vedi Β§8). |
| Aggiornamenti Win | Check automatico GitHub Releases, controllo manuale (vedi Β§18). |
18. Aggiornamenti dell'app Win
Su Windows l'app puΓ² controllare automaticamente la disponibilitΓ di nuove versioni.
Controllo automatico
Settings β Aggiornamenti β attiva Controlla aggiornamenti all'avvio. Al massimo una chiamata GitHub ogni 6 ore (rate limit cache).
Controllo manuale
Bottone Controlla ora nella stessa sezione. Mostra immediatamente l'esito:
- "PotaPay Γ¨ giΓ aggiornato" β tutto ok
- "Disponibile versione X.Y.Z" + bottone SCARICA β apre il dialog di download
- "Impossibile verificare gli aggiornamenti" β problema di rete
Download e installazione
- Il dialog mostra la versione corrente, quella disponibile, le note di rilascio
- Premi Scarica: barra progresso fino a completamento
- Premi Installa ora β PotaPay si chiude, parte l'installer Inno Setup
- Procedi con la procedura guidata β il database SQLite non viene toccato
19. Reset archivi e backup
Settings β Danger Zone. Tre livelli di reset, ognuno con conferma esplicita (richiede di digitare una frase di conferma).
| Livello | Cancella | Mantiene |
|---|---|---|
| 1 β Reset comande | Comande e righe (storico transazioni). Movimenti magazzino correlati. Coda outbox sync. | Cassieri, articoli, reparti, allergeni, licenza, impostazioni. |
| 2 β Reset catalogo | Tutto del livello 1 + articoli e reparti. | Cassieri, licenza, impostazioni. |
| 3 β Reset completo | Tutto. Anche cassieri, allergeni custom, prodotti base. | Ricrea automaticamente l'admin di default (Admin/Sistema, PIN 0000). |
Backup del database
Il file SQLite si trova in:
- Windows:
%APPDATA%\potapay\potapay_db.sqlite - Android:
/data/data/com.facchetti.potapay/databases/potapay_db.sqlite(accessibile solo via debug/adb)
Copialo periodicamente per avere un backup completo.
21. Promozioni bundle
Le promozioni bundle permettono di applicare automaticamente uno sconto o un omaggio quando la comanda contiene una combinazione specifica di articoli. La valutazione avviene in tempo reale durante la costruzione dell'ordine, senza alcuna azione da parte del cassiere.
Come funziona
Ogni bundle Γ¨ composto da due elementi:
- Articoli trigger β la combinazione di articoli (con quantitΓ minima) che deve essere presente nella comanda per attivare la promozione. Esempio: 1 birra + 1 panino.
- Benefit β cosa ottiene il cliente: un articolo omaggio, uno sconto percentuale o uno sconto fisso su un articolo specifico.
Tipi di benefit
| Tipo | Effetto | Esempio |
|---|---|---|
| Gratis | L'articolo benefit viene aggiunto alla comanda a prezzo zero | 1 bibita omaggio se acquisti 2 pizze |
| Percentuale | Sconto % sul prezzo dell'articolo benefit | 20% di sconto sulle patatine se acquisti un burger |
| Fisso | Sconto in β¬ sull'articolo benefit | β¬ 1,00 di sconto sull'acqua se acquisti un primo |
Preview in tempo reale
Mentre il cassiere aggiunge articoli alla comanda, il pannello ordine mostra automaticamente i bundle applicabili con una nota verde. Non Γ¨ necessario fare nulla: al momento del pagamento lo sconto Γ¨ giΓ calcolato nel totale.
Bundle ripetibili
Se la promozione Γ¨ configurata come ripetibile, il benefit si moltiplica in proporzione agli articoli trigger presenti. Esempio: trigger 1 pizza + 1 bibita, comanda con 3 pizze + 3 bibite β il benefit viene applicato 3 volte.
Parametri configurabili
| Parametro | Descrizione |
|---|---|
| Data inizio / fine | Periodo di validitΓ della promozione |
| PrioritΓ | Ordine di valutazione quando piΓΉ promozioni sono attive contemporaneamente |
| Cumulabile | Se attivo, il bundle puΓ² combinarsi con altre promozioni sulla stessa comanda |
| Attiva | Toggle per abilitare/disabilitare la promozione senza eliminarla |
22. Buoni sconto
I buoni sconto sono voucher con codice univoco che vengono generati automaticamente dalla cassa al raggiungimento di una soglia di spesa e riscattati nelle comande successive. Il sistema Γ¨ sincronizzato con il portale per supportare ambienti multi-cassa.
Generazione automatica
Quando una comanda viene pagata e il totale supera la soglia configurata, la cassa:
- Genera un codice univoco nel formato
PP-XXXXXX(prefisso configurabile) - Stampa uno scontrino separato con il codice buono e la data di scadenza
- Sincronizza il buono con il portale entro 5 minuti
Riscatto in cassa
Per applicare un buono durante il pagamento:
- Apri il dialog di pagamento premendo Incassa
- Inserisci il codice del buono nel campo apposito
- Premi Verifica β la cassa controlla validitΓ , stato e scadenza
- Se valido, l'importo del buono viene detratto dal totale da pagare
Validazione del codice
| Esito | Descrizione |
|---|---|
| Valido | Il buono Γ¨ attivo e non scaduto. Lo sconto viene applicato. |
| Non trovato | Il codice non esiste nΓ© localmente nΓ© sul portale. |
| Scaduto | La data di scadenza del buono Γ¨ giΓ passata. |
| GiΓ usato | Il buono risulta giΓ riscattato (stato: usato). |
| Errore rete | Il codice non Γ¨ in locale e non Γ¨ raggiungibile il portale. |
Uso parziale
Se il valore del buono supera il totale della comanda, il buono copre l'intero importo senza richiedere un metodo di pagamento aggiuntivo. Se invece il totale supera il valore del buono, il cassiere paga la differenza in contanti o carta. Il valore residuo viene tracciato e il buono rimane attivo fino all'utilizzo completo.
Sincronizzazione multi-cassa
I buoni sono sincronizzati con il portale ogni 5 minuti. Se un buono viene emesso da una cassa e riscattato da un'altra, la seconda cassa verifica la validitΓ direttamente sul portale prima di accettarlo.
Visualizzazione buoni (schermata admin)
Accedi da Amministrazione β Buoni sconto per vedere la lista di tutti i buoni emessi con codice, data emissione, scadenza, valore residuo e stato.
| Stato | Descrizione |
|---|---|
| Attivo | Buono valido e riscattabile |
| Usato | Buono interamente riscattato |
| Scaduto | Data di scadenza superata |
| Annullato | Buono disabilitato manualmente dal portale |
20. Risoluzione problemi
| Problema | Causa probabile | Cosa fare |
|---|---|---|
| "Firma non valida" all'attivazione licenza | Il codice Γ¨ stato emesso con un fingerprint o numero postazione diverso dal corrente. | Verifica che fingerprint e postazione mostrati corrispondano a quelli usati per generare il codice. |
| Stampante BT non risponde dopo pair | Bluetooth Android non concedeva permessi runtime al primo tentativo, oppure la stampante si Γ¨ messa in standby. | Spegni/accendi la stampante. Verifica permessi in Impostazioni β Bluetooth β PotaPay. Premi Test nella sezione stampante BT dell'app. |
| ModalitΓ Online: errore HTTP 404 | Base URL non corretto. | Verifica nella sezione sviluppatore che il base URL sia https://api.potapay.it (senza /api alla fine). |
| Import JSON dΓ errore di parse | File non riconosciuto: nΓ© SagraMenu nΓ© formato potapay esteso. | Verifica il contenuto del file. L'export potapay deve contenere almeno una sezione tra reparti/articoli. |
| Comande pre-esistenti scomparse dopo update | L'APK Γ¨ stato installato firmato con keystore diversa rispetto alla precedente. | Da 1.5.0 in poi tutti gli APK usano la stessa keystore stabile. Per ripristinare: copia il file .sqlite dal dispositivo precedente nel percorso del nuovo. |
| "INSTALL_FAILED_UPDATE_INCOMPATIBLE" su Android | L'APK che stai installando Γ¨ firmato con una chiave diversa rispetto a quello giΓ installato. | Fai uninstall dell'app, poi reinstalla (attenzione: i dati locali verranno persi). Verifica che tutti gli APK provengano dalla stessa CI. |
| FOREIGN KEY constraint failed durante reset | Bug noto, fixato in 1.4.0+x: i movimenti magazzino e la coda outbox non venivano puliti prima delle comande. |
Aggiorna l'app all'ultima versione. |
| QR import non funziona | Il formato del QR non Γ¨ riconosciuto. | L'app accetta sia il formato legacy (chiavi corte: items, c, n, p, q) sia il formato potapay.it (chiavi estese: righe, codice, nome, prezzo, qty). |
Supporto
Per problemi non elencati qui visita www.potapay.it o manda email a info@potapay.it.
Β© 2026 PotaPay β Manuale Operativo App v2.0.0
Per assistenza: info@potapay.it