Integracja z kasą · Syrve

Lokamo i Syrve. Rozmiary i dodatki prosto z nomenklatury.

Syrve i iiko Cloud działają technicznie tak samo, więc obsługujemy je jedną integracją i jednym kluczem dostępu. Rozmiary produktu stają się wariantami, a grupy modyfikatorów grupami dodatków. Według specyfikacji Syrve to jedyna z naszych integracji, w której powtórzona wysyłka nie utworzy drugiego bonu.

  • 1klucz API na start
  • Syrve + iikojedna integracja
  • ~1 hważności dostępu, odnawia się sam

Jak to działa z Syrve

Od menu w Syrve 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

Nomenklatura Syrve w Lokamo

Rozmiary produktu stają się grupą wariantów, a grupy modyfikatorów grupami dodatków, z minimalną i maksymalną liczbą wyborów.

02 / 03

Gość zamawia przy stoliku

Gość wybiera rozmiar i dodatki. Identyfikator rozmiaru jest dokładnie tym, co pojedzie potem w zamówieniu.

03 / 03

Zamówienie stolikowe w Syrve

Gdy włączysz przesyłanie zamówień do kasy (POS), Lokamo wysyła zamówienie jako zamówienie przy stoliku, z cenami takimi, jakie widział gość. Numer stolika trafia razem z zamówieniem, a numer z Lokamo chroni przed drugim bonem.

Status: wdrażamy na zgłoszenie. Przesyłanie zamówień na kasę Syrve jest dziś wyłączone dla wszystkich lokali. Integracja jest zbudowana według oficjalnej specyfikacji Syrve Cloud API, ale nie mamy jeszcze testu na koncie produkcyjnym żadnego lokalu. Klucz apiLogin generuje lokal w iikoWeb, w ustawieniach Cloud API. 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 Syrve i czego potrzebujesz.

Połączenie

Jedna wartość na start, reszta wykrywana

Klucz API wymagane
Generuje go lokal w zapleczu Syrve albo iiko, w ustawieniach Cloud API.
Identyfikator organizacji opcjonalne
Wykrywany sam, jeśli klucz obsługuje jedną restaurację.
ID kasy do wysyłki
Wykrywane samo przy jednej kasie. Do wysyłki obowiązkowe: bez niego zamówienie nie wyjdzie.
Adres API domyślny
Serwer Syrve dla Europy. Instalacja iiko wpisuje tu własny adres, wyłącznie w domenach dostawcy.

Dostęp jest ważny około godziny i odnawia się sam, więc po zapisaniu konfiguracji nie musisz nic więcej robić.

Menu

Co przechodzi z nomenklatury

  • Rozmiary produktu jako grupa wariantów, z identyfikatorem rozmiaru, który jedzie potem w zamówieniu.
  • Cena bazowa pozycji: najtańszy widoczny w menu rozmiar.
  • Grupy modyfikatorów jako grupy dodatków, z minimum i maksimum wyborów. Wymagalność wynika z minimum większego od zera.
  • Modyfikatory pojedyncze, spoza grup, zebrane w jedną wspólną grupę.

W dniu uruchomienia wysyłki

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

Wysyłka zamówień do Syrve jest dziś wyłączona dla wszystkich lokali i uruchamiamy ją osobno dla każdego lokalu, więc opis mówi, jak zadziała w dniu uruchomienia.

Zamówienia na kasie

Zamówienie stolikowe na kasie

Zamówienie wysyłamy jako zamówienie przy stoliku. Syrve wymaga ceny przy każdej pozycji, więc Lokamo przekazuje dokładnie te ceny, które widział gość. Rozmiar i dodatki jadą razem z zamówieniem, dokładnie tak jak są ustawione w Syrve.

Kasa nie potwierdza zamówienia od razu: najpierw odpowiada, że je przyjęła albo przetwarza, a bon pojawia się chwilę później. Danych gościa świadomie nie wysyłamy, bo pojedynczy błąd w nich mógłby odrzucić całe zamówienie.

Stolik

Stolik i jedyne pewne zabezpieczenie przed podwójnym bonem

Syrve ma swój własny plan sali ze stolikami, którego Lokamo jeszcze nie łączy z własnym. Numer stolika jedzie więc jako numer zewnętrzny i obsługa widzi go na bonie, ale kasa nie przypisuje zamówienia do stolika w swoim planie sali.

Numer zamówienia z Lokamo staje się numerem zamówienia w Syrve, a Syrve wymaga, żeby taki numer się nie powtarzał. Powtórzona wysyłka nie może więc otworzyć drugiego bonu i tylko tu niejasną odpowiedź kasy wolno bezpiecznie ponowić.

Krok po kroku

Jak podłączyć Syrve do Lokamo.

  1. Wygeneruj klucz API

    W zapleczu Syrve albo iiko wejdź w ustawienia Cloud API i wygeneruj klucz dla integracji zewnętrznej.

  2. Wpisz klucz w panelu Lokamo

    W sekcji POS wybierz Syrve i wklej klucz. Identyfikator organizacji i ID kasy zostaw puste, jeśli klucz obsługuje jedną restaurację. Dla iiko podaj jej adres API.

  3. Wskaż kasę i pobierz menu

    Przy kilku kasach wybierz tę, na którą mają trafiać bony, uruchom synchronizację menu i sprawdź rozmiary oraz grupy dodatków.

Pytania o integrację z Syrve

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

Czym różni się Syrve od iiko?

Z punktu widzenia integracji niczym: działają tak samo, różni się tylko adres, pod którym się z nimi łączymy. Domyślnie łączymy się z serwerem Syrve dla Europy, a dla instalacji iiko wpisuje się jej własny adres.

Muszę znać identyfikator organizacji?

Nie, jeśli klucz obsługuje jedną restaurację, bo Lokamo wykryje go sam. To samo dotyczy ID kasy, gdy w lokalu jest tylko jedna.

Czy zamówienie trafi na właściwy stolik w planie sali?

Nie w planie sali. Lokamo nie łączy jeszcze swoich stolików ze stolikami w Syrve, więc numer stolika trafia na bon jako dodatkowy numer zamówienia, który widzi obsługa.

Czy mogę wskazać własny adres serwera?

Tylko w domenach Syrve i iiko. Z kasą łączy się Lokamo, więc pole przyjmujące dowolny adres byłoby furtką do nadużyć, a nie przydatną funkcją.

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

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 Syrve na tych samych zasadach. Zobacz Telefon LokamoAI.

Podłączmy Twoją kasę Syrve. 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.