Przejdź do treści
Wypróbuj za darmoWypróbuj

Integracja z kasą · GoPOS

Lokamo i GoPOS. Menu z kasy, bon na kasę.

Lokamo łączy się z GoPOS przez publiczne API w wersji 3. Pobiera kategorie, dania i grupy dodatków do menu QR, a zamówienie gościa potrafi przesłać na kasę jako bon na miejscu, z dodatkami i numerem stolika w komentarzu. Do połączenia potrzebujesz Client ID, Client Key i Organization ID z panelu GoPOS.

Umów prezentację Wypróbuj 14 dni za darmo
  • 3pola obowiązkowe
  • API v3oficjalne, bezpośrednie połączenie z GoPOS
  • 1pole opcjonalne: ID kasy

Jak to działa z GoPOS

Od menu w GoPOS do bonu na kasie.

Menu przechodzi z kasy do Lokamo od pierwszego dnia. Przesyłanie zamówień na kasę uruchamiamy dla Twojego lokalu, po teście na Twojej kasie.

01 / 03

Menu z GoPOS w Lokamo

Synchronizacja pobiera kategorie, dania i grupy dodatków. Pozycja wyłączona w GoPOS albo oznaczona jako brak stanu trafia do Lokamo jako niedostępna.

02 / 03

Gość zamawia przy stoliku

Dodatki z grup dodatków mają minimalną i maksymalną liczbę wyborów, więc gość nie złoży zestawu, którego kasa nie przyjmie.

03 / 03

Bon na kasie GoPOS

Gdy włączysz przesyłanie zamówień do kasy (POS), zamówienie jedzie jako bon na miejscu: pozycje z identyfikatorem z GoPOS, dodatki jako pozycje podrzędne, a numer stolika, imię gościa i notatka w komentarzu bonu.

Status: wdrażamy na zgłoszenie. Przesyłanie zamówień na kasę GoPOS jest dziś wyłączone dla wszystkich lokali. Integracja jest zbudowana według dokumentacji GoPOS API v3, ale nie mamy jeszcze testu na koncie produkcyjnym żadnego lokalu, a dostęp do API przyznaje GoPOS na wniosek (partner@gopos.pl). Zamówienia włączamy pojedynczo, dla konkretnego lokalu, po teście na jego kasie. Do tego czasu integracja pobiera menu z kasy, a zamówienia gości obsługa widzi w panelu i na ekranie kuchni.

Odpowiedź wprost

Co przechodzi z GoPOS i czego potrzebujesz.

Menu

Co przechodzi z GoPOS do Lokamo

  • Kategorie i pozycje z nazwą, opisem, ceną i zdjęciem.
  • Dostępność: pozycja wyłączona w GoPOS albo bez stanu magazynowego jest w Lokamo niedostępna.
  • Grupy dodatków z kasy jako grupy dodatków w menu, z minimalną i maksymalną liczbą wyborów. Nazwa i cena dodatku pochodzą z listy dań.
  • Kategorie i pozycje skasowane w kasie są pomijane.

Czego nie ma: wariantów. W GoPOS rozmiar jest osobnym daniem, a nie wyborem wewnątrz jednego, więc Lokamo odwzorowuje menu jeden do jednego. Sklejanie rozmiarów na siłę zepsułoby identyfikator, którym potem przesyłamy zamówienie.

Połączenie

Czego potrzebujesz do połączenia

Client ID wymagane
Z klucza aplikacji wygenerowanego w panelu GoPOS.
Client Key wymagane
Sekret widoczny tylko raz, przy generowaniu klucza. Skopiuj go od razu.
Organization ID wymagane
W panelu GoPOS, tam gdzie klucze: Ustawienia, Dostępy do API.
ID kasy opcjonalne
Kieruje bon na konkretną kasę. Bez niego bon idzie tam, gdzie GoPOS kieruje domyślnie.

Logowanie do kasy odnawia się samo w tle, więc raz wpisane dane nie wymagają dalszej obsługi z Twojej strony.

W dniu uruchomienia przesyłania zamówień

Jak zamówienie trafia na kasę i gdzie są granice.

Przesyłanie zamówień do GoPOS jest dziś wyłączone dla wszystkich lokali i uruchamiamy je osobno dla każdego lokalu, więc opis mówi, jak zadziała w dniu uruchomienia.

Zamówienia na kasie

Jak wygląda zamówienie na kasie

Lokamo wysyła zamówienie typu na miejscu. Każda pozycja jedzie z identyfikatorem z GoPOS i ilością, a wybrane dodatki trafiają razem z nią, dokładnie tak, jak wygląda to w GoPOS.

Numer stolika, imię gościa i notatka trafiają do komentarza bonu, złączone kropką, a jeśli razem są za długie, Lokamo je skraca, żeby zmieściły się na kasie. Obsługa widzi na kasie, do którego stolika należy zamówienie, bez zaglądania do panelu Lokamo.

Ograniczenia

O czym trzeba wiedzieć

  • GoPOS nie ma niezobowiązującego sprawdzenia zamówienia przed wysłaniem. Lokamo sprawdza lokalnie, czy każda pozycja niesie poprawny identyfikator z kasy.
  • Numer zamówienia z Lokamo zostaje na bonie, więc duplikat dałoby się rozpoznać, ale GoPOS nie gwarantuje, że sam go odrzuci. Przy niejednoznacznej odpowiedzi Lokamo nie ponawia, tylko przekazuje zamówienie obsłudze.
  • W trybie demo zamówienia do GoPOS są zablokowane, dopóki nie dopiszemy testowego konta GoPOS do listy bezpiecznych adresów.

Krok po kroku

Jak podłączyć GoPOS do Lokamo.

  1. 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.

  2. Ustal Organization ID

    Identyfikator organizacji znajdziesz w panelu GoPOS, tam gdzie klucze: Ustawienia, Dostępy do API.

  3. Wpisz dane w panelu Lokamo

    W sekcji POS wybierz GoPOS i wklej trzy wartości. Opcjonalnie podaj ID kasy. Lokamo zapisze konfigurację dopiero po udanym teście połączenia.

  4. Pobierz menu i sprawdź je

    Uruchom synchronizację menu i porównaj pozycje, ceny oraz grupy dodatków z kasą. Przesyłanie zamówień do kasy otwieramy potem osobno, dla Twojego lokalu.

Pytania o integrację z GoPOS

Nie ma tu Twojego pytania? Odpowiadamy w dni robocze, zwykle tego samego dnia.

kontakt@lokamo.pl +48 668 568 442
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 konkretnej kasy. 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 menu 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ąć.

Czy zamówienia z Telefonu LokamoAI też trafiają do GoPOS?

Tak. Telefon LokamoAI, asystent głosowy odbierający telefony w lokalu, zapisuje zamówienie telefoniczne tą samą drogą co zamówienie online w Lokamo, więc trafia do GoPOS na tych samych zasadach. Zobacz Telefon LokamoAI.

Podłączmy Twoją kasę GoPOS. Pokażemy integrację na Twoim menu.

Umów prezentację albo zacznij od 14 dni za darmo, bez karty płatniczej. Kasę podłączasz w panelu, w sekcji POS, a przesyłanie zamówień do kasy uruchamiamy razem z Tobą, po teście.

Umów prezentację Wypróbuj 14 dni za darmo