Lokamo i Twoja kasa
Lokamo i GoPOS
GoPOS jest podłączany przez klucze aplikacji generowane w panelu kasy. Poniżej jest zakres integracji bez zaokrągleń: co przechodzi, co nie przechodzi i gdzie kończy się nasza pewność.
- wdrożenie etapami
- czytelny przepływ
- pomiar przed obietnicą
Krótka odpowiedź
Lokamo łączy się z GoPOS przez publiczne API w wersji 3. Pobiera kategorie, pozycje i grupy modyfikatorów do karty QR, a zamówienie gościa potrafi wysłać na kasę jako bon na miejscu, z dodatkami i numerem stolika w komentarzu. Sama wysyłka jest dziś wyłączona i otwieramy ją osobno dla każdego lokalu. Do konfiguracji potrzebujesz Client ID, Client Key i Organization ID z panelu GoPOS.
Odpowiedź wprost
Co przechodzi z GoPOS do Lokamo
Synchronizacja pobiera kategorie, pozycje i grupy modyfikatorów. Pozycja przenosi nazwę, opis, cenę, zdjęcie i dostępność: wyłączona w GoPOS albo oznaczona jako brak stanu magazynowego trafia do Lokamo jako niedostępna. Kategorie i pozycje skasowane w kasie są pomijane.
Grupy modyfikatorów stają się w Lokamo grupami dodatków wraz z minimalną i maksymalną liczbą wyborów, więc gość nie może złożyć zestawu, którego kasa nie przyjmie. Nazwa i cena dodatku są rozwiązywane z listy pozycji, bo w GoPOS modyfikator jest pozycją jak każda inna.
Czego nie ma: wariantów. W GoPOS rozmiar jest osobną pozycją, a nie wyborem wewnątrz jednej, więc Lokamo odwzorowuje kartę jeden do jednego i nie skleja rozmiarów w grupę. Sklejanie ich na siłę zepsułoby identyfikator, którym potem wysyłamy zamówienie.
02 · praktycznie
Czego potrzebujesz do połączenia
Trzy wartości są obowiązkowe: Client ID, Client Key oraz Organization ID. Client Key jest sekretem i w panelu GoPOS pokazuje się tylko raz, w momencie generowania klucza, więc skopiuj go od razu. Organization ID znajdziesz w panelu albo w odpowiedzi zapytania GET /api/v3/me.
Czwarte pole, ID kasy (point of sale), jest opcjonalne i kieruje bon na konkretną kasę. Bez niego zamówienie trafia tam, gdzie GoPOS kieruje domyślnie.
Autoryzacja działa w tle: Lokamo wymienia klucze na krótkotrwały token dostępowy i odnawia go przed wygaśnięciem, więc raz wpisane dane nie wymagają obsługi.
01Trzy wartości są obowiązkowe: Client ID, Client Key oraz Organization ID
02Czwarte pole, ID kasy (point of sale), jest opcjonalne i kieruje bon na konkretną kasę
03Autoryzacja działa w tle: Lokamo wymienia klucze na krótkotrwały token dostępowy i odnawia go przed wygaśnięciem, więc raz wpisane dane nie wymagają obsługi
03 · praktycznie
Jak wygląda zamówienie na kasie
Wysyłka zamówień na kasę jest dziś wyłączona na całej instalacji i uruchamiamy ją osobno dla każdego lokalu, więc opis poniżej mówi, jak zadziała w dniu uruchomienia. Lokamo wysyła zamówienie typu na miejscu. Każda pozycja jedzie z identyfikatorem z GoPOS i ilością, a wybrane dodatki jako pozycje podrzędne przypisane do swojej grupy modyfikatorów, zgodnie z tym, jak opisuje to specyfikacja GoPOS.
Numer stolika, imię gościa i notatka do zamówienia trafiają do komentarza bonu, złączone kropką rozdzielającą i przycięte do długości akceptowanej przez API. Obsługa widzi więc na kasie, do którego stolika należy zamówienie, bez zaglądania do panelu Lokamo.
Najpierw znajdź wąskie gardło. Dopiero potem wybierz zmianę.
04 · praktycznie
Ograniczenia, o których trzeba wiedzieć
GoPOS nie udostępnia niezobowiązującego sprawdzenia zamówienia przed wysłaniem, takiego jak Fodimi. Lokamo weryfikuje więc tylko lokalnie, czy każda pozycja niesie poprawny identyfikator z kasy, a właściwą weryfikację robi dopiero samo zamówienie.
W bonie umieszczamy identyfikator zamówienia z Lokamo, dzięki czemu duplikat da się rozpoznać na liście zamówień w GoPOS. API nie dokumentuje jednak odrzucania duplikatów po tym polu, więc nie traktujemy go jak klucza idempotencji: gdy odpowiedź kasy jest niejednoznaczna, Lokamo nie ponawia wysyłki i przekazuje zamówienie obsłudze do ręcznego wbicia.
Wysyłka w trybie demo jest u nas domyślnie zablokowana, dopóki nie mamy identyfikatora sandboxa GoPOS na liście bezpiecznych celów. To nie jest usterka, tylko domyślne zachowanie bezpiecznika, który woli nie wysłać niż wysłać w złe miejsce.
więcej przejść
krótszy przepływ
Krok po kroku
Jak podłączyć GoPOS do Lokamo
Od wygenerowania klucza w panelu GoPOS do pierwszej synchronizacji karty.
- Wygeneruj klucz aplikacji w GoPOS
W panelu GoPOS utwórz klucz i skopiuj Client ID oraz Client Key. Sekret jest widoczny wyłącznie w momencie generowania, więc zapisz go od razu.
- Ustal Organization ID
Identyfikator organizacji znajdziesz w panelu GoPOS albo w odpowiedzi zapytania GET /api/v3/me.
- Wpisz dane w panelu Lokamo
W sekcji POS wybierz GoPOS i wklej Client ID, Client Key oraz Organization ID. Opcjonalnie podaj ID kasy, jeśli bon ma trafiać na konkretne stanowisko. Lokamo zapisze konfigurację dopiero po udanym teście połączenia.
- Pobierz kartę i sprawdź ją
Uruchom synchronizację menu i porównaj pobrane pozycje, ceny oraz grupy dodatków z kartą na kasie. Wysyłkę zamówień otwieramy potem osobno, dla Twojego lokalu.
Bez niedomówień
Częste pytania
Krótko i konkretnie, także tam, gdzie odpowiedź brzmi „to zależy”.
Gdzie znajdę Client Key?
W panelu GoPOS, przy generowaniu klucza aplikacji. Sekret pokazuje się tam tylko raz, więc jeśli go zgubisz, trzeba wygenerować nowy klucz.
Czy zamówienie może trafić na konkretną kasę?
Tak, jeśli podasz ID kasy (point of sale). Pole jest opcjonalne, a bez niego bon idzie tam, gdzie GoPOS kieruje domyślnie.
Czy Lokamo scali rozmiary w jedną pozycję z wyborem?
Nie. W GoPOS rozmiar jest osobną pozycją, więc karta w Lokamo odwzorowuje to jeden do jednego. Sklejanie ich zepsułoby identyfikator, którym wysyłamy zamówienie na kasę.
Co się dzieje, gdy GoPOS odpowie niejednoznacznie?
Zamówienie zostaje oznaczone jako niedostarczone, a obsługa wbija je ręcznie. Ponowienie mogłoby utworzyć drugi bon w kuchni, a tego nie da się cofnąć.