Lokamo i Twoja kasa
Lokamo i Twoja kasa
Zamówienie ze skanu ma wylądować na kasie i na ekranie kuchni bez przepisywania. Poniżej jest dokładnie to, co robi każda z czterech integracji, i to, czego żadna z nich nie robi.
Krótka odpowiedź
Lokamo łączy się z czterema systemami kasowymi: GoPOS, Dotykacka, Fodimi oraz Syrve (iiko Cloud). Integracja pobiera kartę z kasy do Lokamo i to działa od pierwszego dnia. Wysyłka zamówienia gościa z powrotem na kasę jest napisana i opisana, ale wyłączona: włączamy ją pojedynczo, dla konkretnego lokalu, po teście na jego kasie. Karta jedzie tylko w jedną stronę, z POS do Lokamo. Kasy nie trzeba wymieniać.
Zacznij tutaj
Integracja to dwa połączenia, nie jedno
Pierwsze połączenie pobiera kartę. Kategorie, pozycje, ceny, zdjęcia i dostępność wędrują z kasy do Lokamo, a każda pozycja zapamiętuje przy okazji swój identyfikator z POS. To ten identyfikator sprawia, że kasa później rozpoznaje zamówienie.
Drugie połączenie wysyła zamówienie i to ono czeka dziś na uruchomienie. Gdy jest włączone, gość zamawia ze skanu kodu przy stoliku, a Lokamo składa bon z tych samych identyfikatorów i przekazuje go do kasy jako zamówienie na miejscu, z numerem stolika.
Bez integracji Lokamo też działa: zamówienie widać w panelu i na ekranie kuchni, tylko ktoś musi wbić je na kasę. Tak wygląda to dziś także z integracją, bo wysyłkę zamówień na kasę mamy wyłączoną na całej instalacji i odblokowujemy ją per lokal, po sprawdzeniu na Waszej kasie. Do tego czasu integracja daje Wam kartę pobraną z POS i zgodne identyfikatory pozycji, czyli dokładnie to, czego wysyłka potrzebuje w dniu uruchomienia. Lokamo trzyma jedną aktywną integrację na lokal, więc to samo zamówienie nie poleci nigdy do dwóch systemów naraz.
Wybierz temat
Materiały dopasowane do sytuacji
Każda strona odpowiada na jedno pytanie i prowadzi do konkretnego następnego kroku.
Lokamo i GoPOS
Co przechodzi z GoPOS do karty QR, jakie dane potrzebne są do połączenia i jak wygląda zamówienie z Lokamo na kasie GoPOS.
Czytaj 02IntegracjaLokamo i Dotykacka
Dotykacka podłącza się przez ekran zgody, bez przepisywania kluczy. Sprawdź, co przechodzi do karty QR i jak działa wysyłka zamówienia.
Czytaj 03IntegracjaLokamo i Fodimi
Fodimi wymaga tylko identyfikatora firmy i numeru restauracji. Sprawdź, co przechodzi do karty QR i jakie są ograniczenia integracji.
Czytaj 04IntegracjaLokamo i Syrve
Syrve i iiko Cloud łączą się jednym kluczem API. Rozmiary produktu stają się wariantami, a grupy modyfikatorów dodatkami.
CzytajKontekst 01
Jak wygląda podłączenie
Kasę podłącza właściciel konta w panelu Lokamo, w sekcji POS. Dla GoPOS, Fodimi i Syrve wpisuje się dane dostępowe z panelu dostawcy. Dotykacka ma prawdziwy ekran zgody: klikasz „Połącz”, wybierasz swoją chmurę, zatwierdzasz i wracasz do Lokamo z gotowym połączeniem.
Zapis nie idzie na ślepo. Lokamo najpierw wykonuje test połączenia na Twoim lokalu i zapisuje konfigurację dopiero wtedy, gdy test przejdzie. Martwa integracja w bazie wygląda potem jak działająca, a to najgorszy możliwy stan do zdiagnozowania w środku serwisu.
Klucze trafiają do osobnego miejsca, do którego sięga wyłącznie serwer Lokamo. W konfiguracji widocznej dla obsługi zostaje z sekretu tylko skrócony ślad, cztery ostatnie znaki. Potem uruchamiasz synchronizację karty i porównujesz ją z kasą. Wysyłki zamówień nie włączasz sam: to ostatni krok i robimy go razem z Wami.
Kontekst 02
Czego integracja nie robi
To nie jest dwukierunkowa synchronizacja i nie warto na nią liczyć. Karta jedzie wyłącznie z kasy do Lokamo. Zmiana ceny po stronie Lokamo nie wróci na kasę, a pozycja dopisana w Lokamo nie pojawi się w POS.
Synchronizacja karty jest uruchamiana ręcznie przez właściciela, a nie w tle co godzinę. To decyzja, nie brak: karta gościa nie ma prawa zmienić się w środku serwisu bez wiedzy lokalu. Pozycja, która zniknęła z kasy, nie jest kasowana w Lokamo, tylko przestawiana na niedostępną, żeby historia zamówień się nie rozjechała.
Integracja nie przenosi płatności, fiskalizacji ani stanów magazynowych. Rozliczenie zostaje po stronie kasy. Nie każdy z czterech systemów oddaje też tyle samo: warianty i dodatki mapują się w każdym inaczej, a jeden z nich nie oddaje ich dziś wcale. Szczegóły są na stronie konkretnej kasy.
Kontekst 03
Co się dzieje, gdy zamówienie nie dojdzie
Zamówienie trafia do kolejki, zanim gość zobaczy potwierdzenie, więc zerwane połączenie w połowie drogi nie gubi go po cichu. Pierwsza próba wysyłki idzie od razu, kolejne po minucie, dwóch i trzech.
Po czterech nieudanych próbach zamówienie zostaje oznaczone jako niedostarczone, a karta zamówienia w panelu obsługi mówi wprost, że trzeba wbić je ręcznie. To jest celowe: zamówienie przy stoliku, które nie dotarło do kasy w kilka minut, jest incydentem operacyjnym, a nie zadaniem w tle, i nikt nie chce automatycznej wysyłki pół godziny po tym, jak kelner wpisał je sam.
Osobny przypadek to odpowiedź niejednoznaczna, czyli sytuacja, w której kasa odpowiedziała, ale nie wiadomo, czy bon powstał. Wtedy Lokamo nie ponawia, bo dwa bony w kuchni kosztują więcej niż jedno wbicie ręczne. Wyjątkiem jest Syrve, gdzie identyfikator zamówienia jest kluczem po stronie kasy i powtórka nie może utworzyć drugiego bonu.
Kontekst 04
Bezpiecznik przed pierwszym prawdziwym bonem
Wysyłka zamówień ma osobny bezpiecznik, niezależny od konfiguracji lokalu, i dziś obie jego zapadki są zamknięte. Pierwsza jest po stronie lokalu: tryb produkcyjny wymaga osobnego potwierdzenia go-live. Druga jest po naszej stronie i działa globalnie: dopóki nie odblokujemy wysyłki na całej instalacji, żadne zamówienie nie wyjdzie do POS, niezależnie od tego, co ustawisz w panelu.
W trybie demo dochodzi do tego trzecie ograniczenie: zamówienie poleci wyłącznie do środowiska testowego wpisanego wcześniej na listę znanych celów, a lista sandboxów jest dziś krótka i uzupełniamy ją, gdy dostawca da nam dostęp.
Brzmi nadmiarowo i ma tak brzmieć. Pomyłka w konfiguracji nie kończy się tu błędem na ekranie, tylko bonem w cudzej kuchni, więc domyślną odpowiedzią systemu na niepewność jest „nie wysyłam”.
Krok po kroku
Jak podłączyć kasę do Lokamo
Cztery kroki od danych dostępowych do karty pobranej z kasy i sprawdzonej pozycja po pozycji.
- Wybierz swój system kasowy
W panelu Lokamo wejdź w sekcję POS i wskaż jeden z obsługiwanych systemów: GoPOS, Dotykacka, Fodimi albo Syrve (iiko Cloud).
- Podaj dane dostępowe
Wpisz dane z panelu dostawcy albo, w przypadku Dotykacki, kliknij Połącz i zatwierdź zgodę w chmurze Dotykacki. Lokamo testuje połączenie i zapisuje konfigurację dopiero po udanym teście.
- Pobierz kartę z kasy
Uruchom synchronizację menu. Lokamo pobiera kategorie, pozycje, ceny i dostępność z POS i zapamiętuje przy każdej pozycji jej identyfikator z kasy.
- Sprawdź kartę i umów uruchomienie wysyłki
Porównaj pobraną kartę z tym, co widzisz na kasie, pozycja po pozycji. Wysyłki zamówień do POS nie włączysz sam: jest wyłączona globalnie, a otwieramy ją dla konkretnego lokalu po teście na jego kasie, więc na tym etapie napisz na kontakt@lokamo.pl.
Bez niedomówień
Częste pytania
Krótko i konkretnie, także tam, gdzie odpowiedź brzmi „to zależy”.
Czy zamówienia z Lokamo trafiają dziś na kasę?
Jeszcze nie automatycznie. Wysyłka jest gotowa i opisana na stronach poszczególnych kas, ale wyłączona na całej instalacji, a otwieramy ją pojedynczo, dla konkretnego lokalu, po teście na jego kasie. Do tego czasu integracja pobiera kartę z POS, a zamówienia gości obsługa widzi w panelu i na ekranie kuchni.
Czy muszę wymieniać kasę?
Nie. Lokamo dokłada się do kasy, którą już masz, o ile jest to GoPOS, Dotykacka, Fodimi albo Syrve. Bez integracji Lokamo także działa: zamówienia widać w panelu i na ekranie kuchni, tylko ktoś musi wbić je na kasę.
Czego mojej kasy nie ma na liście?
Wtedy integracji po prostu nie ma i nie obiecujemy terminu. Menu QR, zamówienia przy stoliku, rachunek i opinie działają niezależnie od systemu kasowego.
Czy mogę mieć podłączone dwie kasy naraz?
Nie. Lokamo trzyma jedną aktywną integrację na lokal. To zabezpieczenie: dwie aktywne integracje oznaczałyby ryzyko dwóch bonów za to samo zamówienie.
Czy zmiana ceny w Lokamo wróci na kasę?
Nie. Karta jedzie wyłącznie z kasy do Lokamo. Ceny zmieniasz tam, gdzie zawsze, a potem uruchamiasz synchronizację.
Kto ma dostęp do kluczy API?
Podaje je właściciel konta. Trzymane są osobno od reszty konfiguracji, w miejscu dostępnym wyłącznie dla serwera Lokamo, a w panelu widać z nich jedynie cztery ostatnie znaki.
Jak sprawdzić, czy integracja naprawdę działa?
Panel ma przebieg kontrolny działający tylko do odczytu: sprawdza połączenie, liczbę kategorii i pozycji, kompletność cen, unikalność identyfikatorów i spójność kategorii. Nie wysyła przy tym żadnego zamówienia, bo test, który tworzy bon w restauracji, nie jest testem.