Połączenie serwera z chmurą
Czym jest serwer lokalny lokalizacji, jak połączyć go z chmurą tokenem synchronizacji, do czego służą klucze logowania urządzeń i co sprawdzić, gdy kasa się nie synchronizuje.
Zaktualizowano 2 listopada 2026
Na tej stronie
Serwer lokalny to komputer w lokalizacji, który obsługuje na miejscu kasy, drukarki, bramki, kuchnie i ekrany. Działa także bez internetu, a z chmurą wymienia dane w tle. Tu połączysz go z chmurą i dowiesz się, co zrobić, gdy dane przestają płynąć.
Do czego to służy
Panel i kasa to dwa miejsca pracy na tych samych danych. W panelu ustawiasz produkty, ceny i urządzenia, a kasa w lokalizacji z nich korzysta. Serwer lokalny jest pośrednikiem: pobiera z chmury konfigurację i odsyła sprzedaż. Dzięki temu krótka przerwa w internecie nie zatrzymuje sprzedaży ani wejść przez bramki.
Zanim zaczniesz
Uprawnienia:
- Lokalizacja musi już istnieć - zob. Lokalizacja i jej karta.
- Token wygeneruje osoba z uprawnieniem do edycji lokalizacji. Przycisk wymaga osobnego uprawnienia Zmiana serwera lokalnego.
- Komputer serwera instaluje technik. Ty przekazujesz mu dane połączenia z panelu.
- Wszystko, co dotyczy połączenia, jest w zakładce Synchronizacja na karcie lokalizacji.
Jak działa wymiana danych
- Panel Zmieniasz konfigurację: produkty, ceny, stanowiska, drukarki, identyfikatory.
- Pobranie danych Serwer lokalny pobiera zmiany z chmury, zwykle co około 30 sekund.
- Praca na miejscu Kasy sprzedają, bramki wpuszczają, kuchnia wydaje - także bez internetu.
- Wysłanie danych Serwer lokalny wysyła do chmury rachunki, sprzedaże, paragony i przejścia.
Zmiana w panelu dociera więc na kasę z najbliższą synchronizacją, a sprzedaż z kasy pojawia się w panelu z chwilą opóźnienia. Bez internetu kasa pracuje dalej, a zaległe dane wysyła po powrocie połączenia.
Serwer lokalny dostaje tylko dane operatora swojej lokalizacji: jego kartę, jego lokalizacje i jego pliki (oraz pliki wspólne). Danych innych operatorów kasa nie widzi, a kopie pobrane wcześniej usuwa sama. Obraz, który ma być widoczny na kasach kilku operatorów, np. zdjęcie produktu ze wspólnego katalogu, wgraj jako plik wspólny, bez operatora.
Sprzedaż, którą chmura już przetworzyła (np. wystawiła do niej fakturę), nie zmienia się po późniejszej zmianie na kasie. Chmura pomija wtedy zmiany kwot, pozycji, płatności i dokumentu, a zapisuje resztę, np. numer paragonu. Poprawkę takiej sprzedaży robi się zwrotem.
Po aktualizacji systemu z listopada 2026 serwer lokalny raz pobiera z chmury wszystkie dane od nowa. Pierwsze pobranie po aktualizacji trwa więc dłużej niż zwykle. Dane z kasy, które czekają na wysłanie, nie giną.
Połączenie serwera lokalnego
- Otwórz kartę lokalizacji i zakładkę Synchronizacja.
- Kliknij .
- Skopiuj z okna UUID lokalizacji i Token synchronizacji albo od razu cały blok Konfiguracja .env dla serwera lokalnego.
- Przekaż te dane technikowi, który instaluje serwer lokalny - wpisuje je w konfiguracji serwera.
- Kliknij .
- Poczekaj na pierwsze połączenie i sprawdź, czy Status połączenia zmienił się na Połączono.
Jeden token obsługuje jeden serwer lokalny. Chmura zapamiętuje serwer, który pierwszy się nim połączył (pole Serwer lokalny z datą „od…”). Inny komputer z tym samym tokenem zostanie odrzucony. Jak bezpiecznie wymienić komputer, opisuje Wymiana serwera.
Po połączeniu sprawdź, czy dane płyną: zob. Stan synchronizacji.
Urządzenia i klucze logowania
Każde urządzenie dodane na karcie lokalizacji ma własny Klucz logowania: stanowisko POS, drukarka fiskalna i systemowa, terminal płatniczy, bramka, terminal kuchenny, wyświetlacz i kamera systemowa. Kluczem urządzenie przedstawia się serwerowi lokalnemu przy konfiguracji.
- Otwórz kartę urządzenia na karcie lokalizacji.
- W sekcji Informacje systemowe kliknij przy Kluczu logowania (albo w menu karty wybierz Pokaż klucz logowania).
- Skopiuj klucz i przekaż go osobie, która konfiguruje urządzenie.
zakłada nowy klucz. Stary przestaje działać od razu, więc urządzenie trzeba skonfigurować ponownie. Rób to, gdy klucz trafił w niepowołane ręce albo urządzenie zmienia miejsce. Pokazanie i regeneracja klucza wymagają uprawnienia Regenerowanie klucza logowania tego rodzaju urządzenia.
Co na co wpływa
| Gdy… | …to |
|---|---|
| wyłączysz Aktywna w lokalizacji | serwer lokalny przestaje się synchronizować (odmowa z kodem LOCALIZATION_INACTIVE) |
| wygenerujesz nowy token | stary token przestaje działać, serwer trzeba skonfigurować ponownie |
| zregenerujesz klucz urządzenia | to jedno urządzenie traci połączenie z serwerem lokalnym |
| zmienisz cenę albo produkt w panelu | kasa zobaczy zmianę po najbliższym pobraniu danych |
| kasa sprzeda bez internetu | sprzedaż pojawi się w panelu, gdy wróci połączenie |
Kasa się nie synchronizuje
Zacznij od statusu w zakładce Synchronizacja lokalizacji. Znaczenie statusów opisuje Stan synchronizacji.
Opis tekstowy diagramu
- Status połączenia → Wygeneruj token i wpisz go na serwerze (Nieskonfigurowano)
- Status połączenia → Sprawdź token i UUID w konfiguracji serwera (Oczekuje na połączenie)
- Status połączenia → Sprawdź, czy serwer działa i ma internet (Bezczynny lub Offline)
- Status połączenia → Są Ostatnie błędy albo odrzucone rekordy? (Połączono)
- Są Ostatnie błędy albo odrzucone rekordy? → Przeczytaj kod i powód w karcie błędu (tak)
- Są Ostatnie błędy albo odrzucone rekordy? → Poczekaj na kolejny cykl (nie)
Gdy chmura w ogóle nie przyjmuje połączenia, w panelu widzisz tylko status Oczekuje na połączenie albo Offline. Kod odmowy dostaje wtedy serwer lokalny - zapytaj o niego osobę, która go obsługuje:
| Kod | Przyczyna | Co zrobić |
|---|---|---|
| INVALID_SYNC_TOKEN | serwer używa nieznanego albo unieważnionego tokenu | wygeneruj nowy token i wpisz go na serwerze |
| LOCALIZATION_INACTIVE | lokalizacja jest wyłączona | włącz Aktywna w edycji lokalizacji |
| INSTALLATION_MISMATCH | tym tokenem łączy się inny komputer niż zapamiętany | przy wymianie sprzętu użyj ; jeśli to pomyłka - wyłącz drugi komputer |
Powiązane
- Stan synchronizacji Jak czytać zakładkę Synchronizacja lokalizacji - status połączenia, ostatnie błędy, odrzucone rekordy, pliki na serwerze lokalnym i historię wymiany danych.
- Wymiana serwera i tokenu Jak bezpiecznie wymienić komputer serwera lokalnego, wygenerować nowy token synchronizacji albo odciąć lokalizację od chmury, bez dublowania sprzedaży i stanów.
- Lokalizacja i jej karta Jak dodać lokalizację, uzupełnić jej dane i adres, wybrać produkty sprzedawane na miejscu i co znajdziesz w zakładkach karty lokalizacji.