Jeśli zniknął internet lub chmura jest niedostępna

Połączenie się zrywa: dostawca, router, burza, awaria u operatora. Lokal się przy tym nie zamyka — goście stoją przy kasie. Poniżej — co dokładnie nadal działa, co nie i co ma robić zmiana.

Rozróżniaj dwa rodzaje awarii, bo zachowują się różnie:

Co się stało	Kasa w lokalu	Gość z ulicy
Zniknął internet w lokalu	Działa offline: bije, drukuje, gromadzi kolejkę	Witryna otwiera się (jest serwowana z CDN), zamówienie trafia do chmury — ale w lokalu zobaczą je dopiero po przywróceniu połączenia
Chmura jest niedostępna	To samo: kasa nie odróżnia jednego od drugiego — dla niej to „rekord nie poszedł”	Witryna może otworzyć się z pamięci podręcznej, złożenie zamówienia i płatność nie przejdą

Kasa celowo nie próbuje zgadnąć przyczyny: każdy błąd sieci oznacza „pracujemy lokalnie, rekord do kolejki”.

Co nadal działa#

Kasa (webowy POS). To nie jest zwykła strona z pamięci podręcznej, ale prawdziwa kolejka rekordów na urządzeniu:

zamówienie jest bite i trafia do kolejki zamówień (żyje na kasie 24 godziny);
paragon i zmiana kasowa — własna kolejka operacji (otwarcie zmiany, wpłata i wypłata, paragon, zwrot, zamknięcie zmiany). Każda operacja ma kliencki klucz idempotentności, więc dosyłanie niczego nie dubluje;
zmiana otwarta offline dostaje tymczasowy numer i działa dalej: bramka „bez otwartej zmiany płatność jest zabroniona” offline też obowiązuje, liczy po lokalnej pamięci podręcznej;
menu, ceny, stoły, słowniki są czytane z lokalnej pamięci podręcznej przeglądarki — trafiły tam, gdy było połączenie;
przeładowanie strony nie wyrzuca na ekran logowania: kasa otwiera się w „sesji zdegradowanej” na podstawie lokalnego zrzutu i sama się przełącza, gdy sieć wróci.

Druk. Paragon, ticket kuchenny i etykieta są drukowane przez bridge, który stoi na tym samym komputerze: kasa łączy się z nim po lokalnym adresie maszyny — internet nie jest do tego potrzebny.

Paragon fiskalny. Jeśli kasa fiskalna jest podłączona do tego samego komputera, paragon jest bity przez bridge tym samym lokalnym kanałem: pamięć fiskalna gromadzi dokumenty, a operator danych fiskalnych dogania je, gdy pojawi się połączenie. Dla 54-FZ to tryb standardowy, a nie naruszenie.

Ekran logowania. Dopóki w przeglądarce jest niedawna sesja (okno — 7 dni), kasjer loguje się i pracuje; wysłanie nagromadzonych danych i tak będzie wymagało prawdziwej autoryzacji po przywróceniu połączenia.

Co nie działa bez połączenia#

Ekran kuchenny (KDS). Tickety trafiają na niego przez chmurę; bez internetu nowe zamówienia nie dotrą na kuchnię — pojadą tam po przywróceniu połączenia. W tym czasie kuchnia pracuje na wydrukach ticketów, jeśli masz skonfigurowany wydruk na kuchnię, albo na ustnym przekazaniu.
Terminal bankowy. Płatność kartą wymaga autoryzacji w banku — offline nie przejdzie. Przyjmuj gotówkę.
Płatność online przez gościa (karta w witrynie, płatność rachunku gościa ze stołu, płatność w kioku) — potrzebny jest dostęp do dostawcy płatności.
Druga kasa i tablet kelnera. Urządzenia nie synchronizują się między sobą w sieci lokalnej: każde prowadzi własną kolejkę i samo ją dosyła. Wspólnego lokalnego obiegu („tryb LAN”) świadomie nie robimy — decyzja właściciela produktu: zamykamy autonomię jednej kasy z drukiem.
Raport X. Przekrój pośredni jest liczony na serwerze na podstawie sprzedaży — offline kasa uczciwie odmówi. Zamknąć zmianę można, raport Z powstanie, gdy wróci połączenie.
Sekcje panelu administracyjnego, które liczą na serwerze — „Zamówienia”, „Finanse”, „Statystyki”, „Magazyn”, „Personel”. Czytają chmurę i offline pokazują w najlepszym razie to, co zdążyły przeczytać.
Ekran wydawki, tablica kolejki, kiosk — też powierzchnie chmurowe.

Co ma robić personel#

Bij dalej. Gdy tylko zniknie połączenie, w kasie pojawia się bursztynowy baner „offline” i chip „N niewysłanych”. To normalny tryb: zamówienie przyjęte, paragon wydrukowany, pieniądze wzięte.
Drukuj gościowi paragon jak zwykle. Druk jest lokalny — papier wychodzi.
Pracuj na tym samym urządzeniu i w tej samej przeglądarce. Kolejka leży na tym komputerze: nie można przesiąść się na drugi tablet i „dosłać stamtąd”.
Nie czyść pamięci podręcznej przeglądarki, nie wylogowuj się, nie otwieraj kasy w trybie incognito — tak usuniesz niewysłane zamówienia i paragony.
Przeładować stronę można. Kolejka przeżywa przeładowanie i restart przeglądarki.
Nie bij jednego zamówienia dwa razy „na wszelki wypadek”: system jest zabezpieczony przed duplikatami przy dosyłaniu, ale dwa różne zamówienia uczciwie policzy jako dwa.
Nie przyjmuj karty — terminal offline nie autoryzuje. Gotówka, a jeśli gość chce — faktura do zapłaty później.
Czerwony baner „N niedostarczonych” oznacza, że część rekordów nie poszła nawet po przywróceniu połączenia (upłynął termin albo serwer odmówił). To powód, by wezwać menedżera, a nie ukrywać baner.

Co się stanie, gdy wróci połączenie#

Dosyłanie zaczyna się samo — po zdarzeniu „pojawiła się sieć”, przy powrocie do karty i po timerze.

Chip „N niewysłanych” zmniejsza się i znika. Zamówienia pojawiają się w sekcji „Zamówienia” i na ekranie kuchennym, paragony dostają numery, magazyn jest odpisywany według kart technologicznych.
Duplikatów nie będzie. Każde zamówienie ma kliencki identyfikator, każda operacja kasowa — klucz idempotentności; serwer rozpoznaje powtórzenie i nie stosuje go drugi raz.
Zmiana offline jest podmieniana na prawdziwą. Tymczasowy numer zmiany jest przepisywany na rzeczywisty we wszystkich paragonach i ruchach, które jeszcze stoją w kolejce.
Raport Z powstaje dla zmiany zamkniętej offline.
Nic nie jest usuwane po cichu. Rekordy, których nie udało się dostarczyć (upłynęła doba albo serwer zwrócił nieodwracalny błąd), trafiają do osobnej listy „niedostarczone” (przechowywana 7 dni, do 100 rekordów) i są pokazywane czerwonym banerem z możliwością ręcznego ukrycia.

Kolejność jest zachowana: kolejka jest dosyłana po kolei, a przy tymczasowych błędach serwera powtarza próbę z rosnącą pauzą.

Ograniczenia#

Tryb offline jest zamknięty dla kasy i drukowania — i tylko dla nich. Ekran kuchenny, terminal bankowy i synchronizacja między urządzeniami w sieci lokalnej nie działają bez internetu; pełny obieg LAN świadomie nie jest realizowany.
Kolejka jest powiązana z urządzeniem i przeglądarką. Leży w pamięci konkretnej przeglądarki: inny komputer, inna przeglądarka lub tryb incognito jej nie widzą.
Czas życia kolejki to 24 godziny dla zamówień i operacji kasowych. Dłużej niż dobę bez łączności — rekordy trafiają na listę „nie dostarczono”, a nie znikają po cichu.
Sesja offline żyje 7 dni. Później kasa zażąda zwykłego logowania, a jest ono niemożliwe bez sieci.
Raport X offline jest niedostępny — jest liczony na serwerze.
Powierzchnie dla gości (witrina, kiosk) utrzymują kolejkę tylko godzinę — są przewidziane na krótkotrwały zanik sieci mobilnej u gościa, a nie na pracę bez internetu.
Kasa na Androidzie. Przyjmowanie zamówienia i lokalny paragon fiskalny offline działają, a rekord w rejestrze paragonów i zmiana kasowa offline — jeszcze nie (planowane). Źródłem prawdy offline jest tam pamięć fiskalna.
Pełny test „wyciągnięto kabel” na żywym urządzeniu fiskalnym nie został jeszcze przeprowadzony. Tryb offline kasy jest pokryty kodem i testami automatycznymi (w tym e2e „offline w trakcie sesji”), a weryfikacja na prawdziwym sprzęcie przez właściciela jest w planach — mówimy o tym wprost, a nie przedstawiamy jako wykonane.

Rozwiązywanie problemów#

Kasa prosi o zalogowanie, choć wcześniej działała. Sesja jest starsza niż siedem dni albo przeglądarka została wyczyszczona. Bez sieci zalogowanie jest niemożliwe — przywróć łączność.

Znaczek „N nie wysłano” nie maleje. Sprawdź, czy łączność rzeczywiście wróciła (otwórz dowolną stronę), i pozostaw kartę kasy aktywną: dosyłanie odbywa się po zdarzeniu sieciowym, powrocie do karty i według timera. Jeśli znaczek utrzymuje się przy tej samej liczbie — sprawdź czerwony baner: część rekordów mogła trafić na listę „nie dostarczono”.

Pojawił się czerwony baner „N nie dostarczono”. Rekordy nie zostały przyjęte przez serwer: minął dobowy termin albo odpowiedź była nieodwracalna (na przykład odebrano dostęp). Zamówienia i paragony z tej listy trzeba wprowadzić ręcznie — porównaj z papierowymi paragonami zmiany.

Zamówienie wprowadzono offline, a na kuchni go nie ma. Tak ma być: bilet trafi na ekran kuchenny po przywróceniu łączności. Dopóki nie ma sieci, kuchnię obsługują wydrukowane bilety.

Paragon nie drukuje się offline. To znaczy, że problem nie leży w internecie: sprawdź, czy bridge na tym komputerze jest uruchomiony i czy drukarka jest podłączona — Cenaly Hardware Bridge. Bridge i kasa komunikują się w obrębie jednej maszyny.

Po przywróceniu łączności pojawiły się duplikaty zamówień. Duplikaty od dosyłania nie mogą powstać — sprawdź, czy tego samego zamówienia nie wprowadzono dwa razy ręcznie, i anuluj zbędne w sekcji „Zamówienia”.

Częste pytania#

Czy kasa działa bez internetu?#

Tak: przyjmuje zamówienia, drukuje paragony i fiskalizuje je przez bridge na tym samym komputerze. Wszystko, co powinno trafić do chmury, gromadzi się w kolejce na urządzeniu i jest dosyłane automatycznie.

Czy dane zostaną utracone?#

Nie. Kolejka przeżywa odświeżenie strony i restart przeglądarki, a to, czego nie udało się dostarczyć, trafia na widoczną listę „nie dostarczono”, a nie znika. Stracić ją można tylko ręcznie — czyszcząc dane przeglądarki.

Czy można wystawiać paragony zgodnie z 54-FZ offline?#

Tak, jeśli urządzenie fiskalne jest podłączone do tego samego komputera co bridge: pamięć fiskalna gromadzi dokumenty i przekazuje je operatorowi danych fiskalnych, gdy pojawi się łączność. To tryb przewidziany przez prawo.

Dlaczego ekran kuchenny nie działa?#

Bilety przechodzą przez chmurę. Sieci lokalnej między kasą a ekranem kuchennym u nas nie ma — to świadoma decyzja: zapewniamy autonomię kasy z drukowaniem, a nie całej sali. Dopóki nie ma sieci, kuchnię obsługują wydrukowane bilety.

Tak — witrina jest dostarczana z CDN i nie zależy od twojego internetu. Zamówienie złożone przez gościa dotrze do chmury, ale w lokalu zobaczysz je dopiero po przywróceniu łączności.

Co zrobić z płatnością kartą?#

Przyjmować gotówkę: terminal bankowy wymaga autoryzacji w banku.

Jak długo kasa wytrzyma bez łączności?#

Dobę dla kolejki zamówień i operacji kasowych, siedem dni — dla sesji. W praktyce oznacza to: zmianę przepracujesz spokojnie.

Powiązane sekcje#

Kasa (POS) — zamówienie, płatność, tryby obsługi i sekcja „Praca offline”
Zmiana kasowa i raport Z — otwarcie, operacje, raporty X i Z
Cenaly Hardware Bridge — bridge na komputerze POS, drukarki i urządzenia fiskalne
Drukowanie na kuchnię — bilety według stacji, gdy ekran kuchenny jest niedostępny
Ekran kuchni (KDS) — jak bilety trafiają na kuchnię
Pierwszy dzień: kawiarnia, restauracja, stołówka — co włączyć od razu

Gdy zniknie internet