Se manca internet o il Cloud non è disponibile

La connessione cade: provider, router, temporale, guasto dell'operatore. Il locale non chiude per questo — gli ospiti sono in piedi alla cassa. Di seguito trovi cosa continua a funzionare, cosa no e cosa deve fare il turno.

Distingui due guasti, perché si comportano in modo diverso:

Cosa è successo	Cassa nel locale	Ospite dalla strada
Manca internet nel locale	Funziona offline: batte, stampa, accumula la coda	La vetrina si apre (viene distribuita dal CDN), l'ordine va nel Cloud — ma nel locale lo si vedrà solo dopo il ripristino della connessione
Il Cloud non è disponibile	Lo stesso: la cassa non distingue l'uno dall'altro — per lei è «record non inviato»	La vetrina può aprirsi dalla cache, l'inserimento dell'ordine e il pagamento non andranno a buon fine

La cassa di proposito non cerca di indovinare la causa: qualsiasi errore di rete significa «lavoriamo in locale, record in coda».

Cosa continua a funzionare#

Cassa (POS web). Non è una semplice pagina in cache, ma una vera coda di record sul Dispositivo:

l'ordine viene battuto e va nella coda degli ordini (vive sulla cassa 24 ore);
la Ricevuta e il Turno cassa — coda di operazioni dedicata (apertura turno, versamento e prelievo, Ricevuta, reso, chiusura turno). Ogni operazione ha una chiave idempotente lato client, quindi il reinvio non duplica nulla;
il Turno aperto offline riceve un numero temporaneo e continua a funzionare: il gate «senza turno aperto il pagamento è vietato» vale anche offline, calcola sulla cache locale;
menu, prezzi, Tavoli, anagrafiche si leggono dalla cache locale del browser — ci sono finiti mentre la connessione c'era;
il ricaricamento della pagina non butta fuori alla schermata di accesso: la cassa si apre in «sessione degradata» sull'istantanea locale e si riconnette da sola quando la rete torna.

Stampa. La Ricevuta, il ticket cucina e l'etichetta si stampano tramite il Bridge che sta sullo stesso computer: la cassa lo contatta all'indirizzo locale della macchina — internet non serve.

Ricevuta fiscale. Se il Registratore fiscale è collegato allo stesso computer, la Ricevuta viene battuta tramite il Bridge sullo stesso canale locale: il registratore fiscale accumula i documenti e l'operatore fiscale li recupera quando la connessione torna. Per la 54-ФЗ è una modalità ordinaria, non una violazione.

Schermata di accesso. Finché nel browser c'è una sessione recente (finestra di 7 giorni), il cassiere accede e lavora; l'invio di quanto accumulato richiederà comunque un'autenticazione reale al ripristino della connessione.

Cosa non funziona senza connessione#

Schermo cucina (KDS). I ticket arrivano tramite il Cloud; senza internet i nuovi ordini non arriveranno in cucina — ci arriveranno al ripristino della connessione. Nel frattempo la cucina lavora con i ticket stampati, se avete configurato la stampa in cucina, o con la comanda a voce.
Terminale bancario. Il pagamento con carta richiede l'autorizzazione della banca — offline non andrà a buon fine. Accettate contanti.
Pagamento online da parte dell'ospite (carta sulla vetrina, pagamento del conto ospite dal Tavolo, pagamento al chiosco) — serve l'accesso al provider di pagamento.
Seconda cassa e tablet del cameriere. I Dispositivi non si sincronizzano tra loro sulla rete locale: ciascuno gestisce la propria coda e la reinvia da sé. Un contorno locale condiviso («modalità LAN») non lo facciamo deliberatamente — è una decisione del titolare del prodotto: copriamo l'autonomia di una singola cassa con stampa.
Report X. La chiusura intermedia si calcola sul server in base alle vendite — offline la cassa rifiuterà onestamente. Il Turno si può chiudere, il report Z si formerà quando la connessione torna.
Le sezioni dell'area di amministrazione che calcolano sul server — «Ordini», «Finanze», «Statistiche», «Magazzino», «Personale». Leggono il Cloud e offline mostrano al massimo l'ultimo dato che sono riuscite a leggere.
Schermo di consegna, display della coda, chiosco — anch'essi superfici Cloud.

Cosa deve fare il personale#

Continuate a battere. Appena la connessione cade, sulla cassa compare un banner ambra «offline» e un chip «N non inviati». È una modalità normale: l'ordine è accettato, la Ricevuta è stampata, il denaro è incassato.
Stampate la Ricevuta per l'ospite come al solito. La stampa è locale — la carta esce.
Lavorate sullo stesso Dispositivo e nello stesso browser. La coda sta su questo computer: non si può passare al secondo tablet e «recuperare da lì».
Non pulite la cache del browser, non uscite dall'Account, non aprite la cassa in modalità incognito — così cancellereste gli ordini e le Ricevute non inviati.
Ricaricare la pagina si può. La coda sopravvive al ricaricamento e al riavvio del browser.
Non battete lo stesso ordine due volte «per sicurezza»: il sistema è protetto dai duplicati al reinvio, ma due ordini diversi li conterà onestamente come due.
Non accettate la carta — il Terminale offline non autorizza. Contanti, e se l'ospite lo desidera — Fattura da pagare in seguito.
Il banner rosso «N non consegnati» significa che una parte dei record non è passata nemmeno dopo il ripristino della connessione (scadenza o rifiuto del server). È un motivo per chiamare il responsabile, non per nascondere il banner.

Cosa succederà quando la connessione tornerà#

Il reinvio inizia da solo — all'evento «rete disponibile», al ritorno sulla scheda e a timer.

Il chip «N non inviati» diminuisce e scompare. Gli ordini compaiono nella sezione «Ordini» e sullo schermo cucina, le Ricevute ricevono i numeri, il magazzino viene scaricato secondo le schede tecniche.
Non ci saranno duplicati. Ogni ordine ha un identificatore lato client, ogni operazione di cassa ha una chiave di idempotenza; il server riconosce la ripetizione e non la applica una seconda volta.
Il Turno offline viene sostituito con quello reale. Il numero temporaneo del Turno viene riscritto su quello reale in tutte le Ricevute e i movimenti ancora in coda.
Il report Z si forma per il Turno chiuso offline.
Nulla viene eliminato in silenzio. I record che non è stato possibile consegnare (scadute le 24 ore o il server ha restituito un errore irrecuperabile) finiscono in un elenco separato «non consegnati» (conservato 7 giorni, fino a 100 record) e vengono mostrati con un banner rosso che si può nascondere manualmente.

L'ordine è preservato: la coda viene reinviata in sequenza e, sugli errori temporanei del server, ritenta con una pausa crescente.

Limitazioni#

L'offline è disponibile solo per la cassa e la stampa — e nient'altro. Lo schermo cucina, il terminale bancario e la sincronizzazione tra dispositivi nella rete locale non funzionano senza internet; un circuito LAN completo non viene realizzato per scelta consapevole.
La coda è legata al dispositivo e al browser. Si trova nella memoria di un browser specifico: un altro computer, un altro browser o la modalità in incognito non la vedono.
La durata della coda è di 24 ore per gli ordini e le operazioni di cassa. Oltre le ventiquattro ore senza connessione, i record passano nell'elenco «non consegnato» e non scompaiono in silenzio.
La sessione offline dura 7 giorni. Successivamente la cassa richiederà il normale accesso, che senza rete non è possibile.
Il report X offline non è disponibile — viene calcolato sul server.
Le superfici per gli ospiti (vetrina, chiosco) mantengono la coda solo per un'ora — sono pensate per un'interruzione breve della rete mobile dell'ospite, non per il lavoro senza internet.
Cassa Android. La presa dell'ordine e la ricevuta fiscale locale offline funzionano, mentre il record nel registro delle ricevute e il turno cassa offline non sono ancora disponibili (pianificati). La fonte di verità offline in questo caso è la memoria fiscale.
Il test end-to-end «cavo staccato» su un registratore fiscale reale non è ancora stato eseguito. La modalità offline della cassa è coperta da codice e test automatici (tra cui l'e2e «offline all'interno della sessione»), mentre la verifica su hardware reale da parte del titolare è in programma — lo diciamo apertamente, invece di spacciarla per già completata.

Risoluzione dei problemi#

La cassa chiede di accedere, anche se prima funzionava. La sessione ha più di sette giorni oppure il browser è stato pulito. Senza rete non è possibile accedere — ripristinate la connessione.

Il chip «N non inviato» non diminuisce. Verificate che la connessione sia davvero tornata (aprite un sito qualsiasi) e lasciate attiva la scheda della cassa: l'invio successivo avviene in base all'evento di rete, al ritorno sulla scheda e al timer. Se il chip resta con lo stesso numero, controllate il banner rosso: parte dei record potrebbe essere finita in «non consegnato».

È comparso il banner rosso «N non consegnato». I record non sono stati accettati dal server: è scaduto il termine di un giorno oppure la risposta era irrecuperabile (ad esempio, l'accesso è stato revocato). Gli ordini e le ricevute di questo elenco vanno registrati manualmente — confrontate con le ricevute cartacee del turno.

L'ordine è stato registrato offline, ma in cucina non c'è. È normale: il ticket arriverà sullo schermo cucina al ripristino della connessione. Finché non c'è rete, la cucina lavora con i ticket stampati.

La ricevuta non si stampa offline. Allora il problema non è internet: verificate che il bridge su questo computer sia avviato e la stampante collegata — Cenaly Hardware Bridge. Il bridge e la cassa comunicano all'interno della stessa macchina.

Dopo il ripristino della connessione sono comparsi ordini duplicati. Duplicati dovuti all'invio successivo non possono esserci — verificate se lo stesso ordine è stato registrato due volte a mano e annullate quello in eccesso nella sezione «Ordini».

Domande frequenti#

La cassa funziona senza internet?#

Sì: registra gli ordini, stampa le ricevute e le fiscalizza tramite il bridge sullo stesso computer. Tutto ciò che deve andare nel cloud si accumula nella coda sul dispositivo e viene inviato automaticamente.

I dati andranno persi?#

No. La coda sopravvive al ricaricamento della pagina e al riavvio del browser, e ciò che non è stato possibile consegnare finisce nell'elenco visibile «non consegnato», non svanisce. Si può perdere solo manualmente — pulendo i dati del browser.

Si possono registrare ricevute ai sensi della 54-ФЗ offline?#

Sì, se il registratore fiscale è collegato allo stesso computer del bridge: la memoria fiscale accumula i documenti e li trasmette all'operatore dei dati fiscali quando la connessione sarà disponibile. È una modalità prevista dalla legge.

Perché lo schermo cucina non funziona?#

I ticket passano attraverso il cloud. Non abbiamo una rete locale tra la cassa e lo schermo cucina — è una decisione consapevole: copriamo l'autonomia della cassa con la stampa, non l'intera sala. Finché non c'è rete, la cucina si basa sui ticket stampati.

Sì — la vetrina è distribuita tramite CDN e non dipende dal vostro internet. L'ordine effettuato dall'ospite arriverà al cloud, ma in locale lo vedrete solo dopo il ripristino della connessione.

Cosa fare con il pagamento con carta?#

Accettare contanti: il terminale bancario necessita dell'autorizzazione presso la banca.

Quanto tempo può resistere la cassa senza connessione?#

Un giorno per la coda degli ordini e delle operazioni di cassa, sette giorni per la sessione. In pratica significa che potrete lavorare tranquillamente per un turno.

Sezioni correlate#

Cassa (POS) — ordine, pagamento, modalità di servizio e sezione «Lavoro offline»
Turno cassa e report Z — apertura, movimenti, report X e Z
Cenaly Hardware Bridge — bridge sul computer POS, stampanti e registratori fiscali
Stampa in cucina — ticket per stazione, quando lo schermo cucina non è disponibile
Schermo cucina (KDS) — come i ticket arrivano in cucina
Primo giorno: bar, ristorante, mensa — cosa attivare subito

Se manca la connessione Internet