Installazione App Cassa (Windows e Android)
Prerequisiti
Prima di procedere con l'installazione, verificare che il punto vendita soddisfi i seguenti requisiti.
Requisiti hardware minimi
| Piattaforma | CPU | RAM | Spazio disco | Display |
|---|---|---|---|---|
| Windows Desktop | Intel i3 / AMD Ryzen 3 (o superiore) | 4 GB | 500 MB liberi | 1024x768 minimo |
| Tablet Android | ARM64 (Snapdragon 665 o superiore) | 3 GB | 500 MB liberi | 10" consigliato |
Requisiti di rete
- Connessione internet per l'attivazione iniziale e la sincronizzazione
- Rete LAN per comunicazione con stampanti di rete e altri dispositivi POS
- Porta 4222 (NATS) e 443 (HTTPS) in uscita verso il server cloud
- In modalita LAN-only: il dispositivo master deve essere raggiungibile sulla porta configurata (default 8090)
Credenziali necessarie
- Codice attivazione dispositivo (fornito dal rivenditore)
- Credenziali operatore (create dalla console amministrativa)
Installazione su Windows Desktop
Download e installazione
- Scaricare il pacchetto di installazione
.msixdal portale di distribuzione fornito dal rivenditore - Fare doppio clic sul file scaricato per avviare l'installazione
- Confermare l'installazione quando richiesto da Windows
- L'applicazione apparira nel menu Start come "POS Cassa"
Prima configurazione
- Avviare l'app dal menu Start
- Schermata di attivazione: inserire il codice di attivazione del dispositivo. Questo registra il terminale nel sistema e lo associa al tenant corretto
- Configurazione server: l'URL del server viene preconfigurato dal codice di attivazione. In caso di installazione manuale, inserire l'indirizzo completo (es.
https://api.pos-enterprise.com) - Sincronizzazione iniziale: l'app scarichera prodotti, categorie, layout e configurazioni. Questa operazione puo richiedere alcuni minuti alla prima esecuzione
- Login operatore: inserire le credenziali dell'operatore per accedere alla cassa
Configurazione di rete
- In Impostazioni > Modalita Connessione e possibile scegliere tra:
- Cloud: connessione diretta al broker NATS (configurazione standard)
- LAN Master: questo dispositivo funge da hub per gli altri (consigliato per la cassa principale)
- LAN Client: si connette a un master locale via WebSocket
- Auto: tenta la connessione cloud, con fallback su LAN
Aggiornamenti
L'app si aggiorna automaticamente tramite il sistema MSIX. In alternativa, scaricare manualmente la nuova versione dal portale di distribuzione e installarla sopra la versione corrente; i dati locali vengono preservati.
Installazione su Tablet Android
Installazione da APK (sideload)
- Abilitare le origini sconosciute: Impostazioni > Sicurezza > Origini sconosciute (o "Installa app sconosciute" per il browser utilizzato)
- Trasferire l'APK sul tablet via USB, email o download diretto dal portale
- Aprire il file APK e confermare l'installazione
- Concedere i permessi richiesti al primo avvio:
- Accesso alla rete locale (per stampanti e dispositivi)
- Bluetooth (per stampanti Bluetooth e lettori barcode)
- Fotocamera (per scansione barcode, opzionale)
- Storage (per backup locale)
Prima configurazione
La procedura e analoga a Windows:
- Avviare l'app "POS Cassa" dal drawer applicazioni
- Inserire il codice di attivazione
- Attendere la sincronizzazione iniziale
- Effettuare il login operatore
Consigli per tablet in produzione
- Blocco orientamento: impostare il tablet in modalita landscape fissa (Impostazioni > Display > Rotazione automatica OFF)
- Modalita kiosk: per impedire l'uscita accidentale dall'app, utilizzare la funzione "Blocca app" di Android (Impostazioni > Sicurezza > Blocco app)
- Risparmio energetico: disabilitare l'ottimizzazione batteria per l'app POS (Impostazioni > Batteria > Ottimizzazione batteria > POS Cassa > Non ottimizzare)
- Standby display: impostare il timeout schermo su "Mai" quando il tablet e alimentato da corrente
Registrazione del dispositivo
Dopo l'attivazione, il dispositivo viene registrato nel sistema con un identificativo univoco. Il rivenditore puo verificare lo stato di tutti i dispositivi attivati dalla console amministrativa alla sezione "Dispositivi".
Ogni dispositivo e associato a:
- Un tenant (ristorante)
- Un tipo (cassa, cameriere, kiosk)
- Una licenza che determina i moduli disponibili
FAQ
D: L'app funziona senza connessione internet? R: Si, dopo la sincronizzazione iniziale l'app funziona completamente offline. Gli ordini vengono salvati localmente e sincronizzati alla riconnessione. Le stampanti di rete locale continuano a funzionare.
D: Posso installare l'app su piu dispositivi con lo stesso account? R: Ogni dispositivo richiede un proprio codice di attivazione e licenza. Un operatore puo pero effettuare il login su qualsiasi dispositivo attivato del proprio tenant.
D: Come ripristino l'app in caso di problemi? R: In Impostazioni > Avanzate e disponibile l'opzione "Reset sincronizzazione" che cancella i dati locali e ri-esegue il download completo dal server. I dati sul server non vengono modificati.
Vedi Anche
- Configurazione Stampanti ESC/POS -- Setup stampanti termiche
- Risoluzione Problemi Comuni -- Errori frequenti e soluzioni