📡 Modalità Offline

Cosa fa

La Modalità Offline di NOX permette di continuare a lavorare anche senza connessione internet. È pensata per agenti, venditori, tecnici esterni e chiunque debba operare in zone con copertura instabile (zone industriali, magazzini interrati, cantine, fiere, viaggi in treno).

Cosa puoi fare offline:

Tutto quello che fai mentre sei offline finisce in una coda sul tuo dispositivo. Appena torna la connessione, NOX invia automaticamente le operazioni al server e tu non perdi nulla.

🚦 Come capire lo stato della connessione

In alto a destra nella topbar (la barra blu in cima) c'è una pillola di stato che ti dice in tempo reale come sta la sincronizzazione:

AspettoSignificato
☁️ verde Online — connesso e tutto sincronizzato
☁️ rosso Offline — nessuna connessione internet
☁️ arancio + numero Operazioni in coda — il numero indica quante operazioni attendono di essere inviate al server
⟳ rotella Sincronizzazione in corso — sta inviando le operazioni
👆
Tap sulla pillola apre un menu con dettagli: stato connessione, numero operazioni in coda, ora dell'ultima sincronizzazione, e i pulsanti per le azioni manuali.

📥 Preparare il dispositivo PRIMA di partire

Per lavorare offline devi scaricare prima il pacchetto offline. Senza questo passaggio non vedrai cataloghi e clienti quando sei senza rete.

  1. 1 Connettiti a internet (WiFi o 4G)
  2. 2 Apri NOX e fai login normalmente
  3. 3 Tocca la pillola verde ☁️ in alto a destra
  4. 4 Tocca 📥 Scarica pacchetto offline
  5. 5 Attendi qualche secondo. Vedi il messaggio "✓ Scaricati N record (catalogo + soggetti)"

Il pacchetto contiene: clienti, voci catalogo (fino a 10.000), listini, tipi pagamento e tipi documento. Tutto viene salvato sul dispositivo (nel browser, in IndexedDB) e resta disponibile anche senza rete.

📅
Aggiorna il pacchetto regolarmente. Se aggiungi clienti o voci catalogo dal gestionale principale, gli agenti sul campo non li vedranno finché non rifanno "Scarica pacchetto offline". Buona prassi: scaricare ogni mattina prima di uscire.

📴 Lavorare offline

Quando perdi la connessione, NOX se ne accorge automaticamente:

Niente schermata di errore. Tutto si comporta come se fossi online — l'unica differenza è la pillola rossa in alto e le operazioni che si accumulano in coda. Continua a lavorare tranquillo.

📤 Sincronizzare quando torna la rete

Appena il telefono ritrova la connessione (esci dal seminterrato, riprendi il segnale 4G, ti colleghi al WiFi del cliente), NOX sincronizza automaticamente:

Non devi fare niente: succede tutto da solo. Se vuoi forzare la sincronizzazione (es. hai fretta e vuoi essere sicuro), tap sulla pillola e premi 🔄 Sincronizza ora.

⚙️ Le azioni del menu offline

PulsanteCosa faQuando si usa
🔄 Sincronizza ora Forza l'invio della coda al server Quando vuoi essere sicuro che tutto sia partito (richiede di essere online)
📥 Scarica pacchetto offline Aggiorna catalogo + clienti sul dispositivo Prima di uscire per la giornata, o quando sai che il magazziniere ha aggiunto nuovi articoli
🧹 Pulisci sincronizzate Rimuove dalla coda locale le operazioni già inviate con successo Periodicamente, per tenere pulita la coda. Le op completate restano "in lista" finché non le pulisci, ma sono già al sicuro sul server

🔁 Idempotenza: niente duplicati

NOX è progettato per essere sicuro contro i doppi invii. Ogni operazione offline riceve un identificativo univoco (UUID) appena la fai. Se la connessione si interrompe a metà invio, NOX ritenta — ma il server riconosce che l'operazione è già stata processata e la salta. Mai un ordine doppio per problemi di rete.

🆘 Quando qualcosa non va

Sintomo Causa probabile Cosa fare
La pillola resta arancio anche dopo essere tornato online Sincronizzazione automatica non è partita Tap sulla pillola → "Sincronizza ora" per forzare
"Errore sync" nel menu pillola Il server ha rifiutato qualche operazione (dato non valido, P.IVA duplicata…) Apri ogni operazione fallita e correggila. Le op valide restano in coda e si rimandano alla prossima sync
"Necessaria connessione per scaricare il pacchetto offline" Stai provando a scaricare quando sei offline Connettiti a internet e riprova
"Catalogo vuoto" quando provi a creare un documento offline Non hai mai scaricato il pacchetto offline su questo dispositivo Connettiti, scarica il pacchetto, poi puoi tornare offline
Op in coda che non spariscono mai Errori di validazione persistenti Apri il menu pillola, vedi il messaggio di errore, correggi i dati e ritenta
Cambio dispositivo / browser → coda persa La coda è salvata per browser/dispositivo, non sul cloud Sincronizza SEMPRE prima di cambiare dispositivo o disinstallare il browser

💡 Suggerimenti pratici

📱
Limite IndexedDB: il browser tipicamente riserva 50-200 MB per ogni sito. Per quasi tutti gli scenari basta abbondantemente, ma se hai un catalogo enorme e mille operazioni in coda, alcuni browser potrebbero pulire i dati per fare spazio. Sincronizza spesso per non accumulare troppe op in coda.

🔐 Sicurezza dei dati offline

I dati offline (clienti, catalogo, coda operazioni) sono salvati nell'IndexedDB del browser, accessibili solo dal sito gnox.it. Significa:

Per dispositivi aziendali condivisi: usa la modalità "Browser ospite" o esci con logout esplicito al termine del turno.

📞 Supporto

Per problemi con la modalità offline contatta NOX con: