Lokamo i Twoja kasa
Lokamo i Syrve
Syrve i iiko Cloud dzielą ten sam kontrakt API, więc obsługujemy je jedną integracją. Różni je adres serwera, który podaje się w konfiguracji.
- wdrożenie etapami
- czytelny przepływ
- pomiar przed obietnicą
Krótka odpowiedź
Syrve i iiko Cloud to najbogatsze mapowanie karty w Lokamo: rozmiary produktu stają się wariantami, a grupy modyfikatorów grupami dodatków. To także jedyna integracja, w której powtórzona wysyłka nie może utworzyć drugiego bonu, bo Lokamo nadaje zamówieniu własny identyfikator akceptowany przez kasę. Sama wysyłka jest dziś wyłączona i otwieramy ją osobno dla każdego lokalu.
Odpowiedź wprost
Jedna wartość na start, reszta wykrywana
Obowiązkowy jest tylko klucz API, generowany przez lokal w zapleczu Syrve albo iiko. Identyfikator organizacji i ID kasy możesz zostawić puste: Lokamo wykryje je samo, jeśli klucz obsługuje jedną restaurację i jedną kasę. Przy większej instalacji podaje się je wprost.
Adres API domyślnie wskazuje serwer Syrve dla Europy. Instalacje iiko mają własny adres i wpisuje się go w tym samym polu. Przyjmujemy tylko adresy w domenach dostawcy, bo to serwer Lokamo nawiązuje połączenie, a pole przyjmujące dowolny adres byłoby dziurą, a nie elastycznością.
Klucz jest wymieniany na token ważny około godziny, odnawiany automatycznie, więc po zapisaniu konfiguracji nie ma tu nic do obsługi.
02 · praktycznie
Co przechodzi z nomenklatury
Karta pobierana jest z nomenklatury Syrve i mapuje się na Lokamo lepiej niż którakolwiek z pozostałych kas. Rozmiary produktu stają się grupą wariantów, a identyfikator rozmiaru jest dokładnie tym, co jedzie potem w zamówieniu. Ceną bazową pozycji jest najtańszy widoczny w karcie rozmiar.
Grupy modyfikatorów stają się grupami dodatków wraz z minimalną i maksymalną liczbą wyborów, a wymagalność wynika z minimum większego od zera. Modyfikatory pojedyncze, spoza grup, zbierają się w jedną wspólną grupę, bo zamówienie i tak nie wymaga dla nich identyfikatora grupy.
01Karta pobierana jest z nomenklatury Syrve i mapuje się na Lokamo lepiej niż którakolwiek z pozostałych kas
02Grupy modyfikatorów stają się grupami dodatków wraz z minimalną i maksymalną liczbą wyborów, a wymagalność wynika z minimum większego od zera
03 · praktycznie
Zamówienie stolikowe 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. Zamówienie wysyłamy kontraktem zamówienia stolikowego. Kontrakt wymaga ceny jednostkowej przy każdej pozycji, więc Lokamo przekazuje ceny z zamówienia gościa, a nie liczy ich ponownie po stronie kasy. Rozmiar jedzie jako identyfikator rozmiaru, dodatki jako modyfikatory z identyfikatorem grupy tam, gdzie grupa istnieje.
ID kasy jest do wysyłki obowiązkowe: bez wskazania, na którą kasę ma trafić bon, zamówienie nie wyjdzie. Samo tworzenie jest asynchroniczne, więc kasa odpowiada statusem przyjęcia albo przetwarzania, a nie gotowym bonem.
Danych gościa świadomie nie wysyłamy. Obiekt klienta w tym kontrakcie ma wymagany znacznik typu, którego kształt dla zamówienia stolikowego nie jest u nas potwierdzony, a źle złożony klient odrzuciłby całe zamówienie. Imię gościa nie jest warte tego ryzyka na bonie w lokalu.
Najpierw znajdź wąskie gardło. Dopiero potem wybierz zmianę.
04 · praktycznie
Stolik i jedyna prawdziwa idempotencja
Syrve adresuje stolik własnym identyfikatorem pobieranym z osobnego zasobu sal i stolików, którego Lokamo jeszcze nie mapuje. Numer stolika jedzie więc jako numer zewnętrzny zamówienia i obsługa widzi na bonie, gdzie je podać, ale kasa nie przypisuje go do konkretnego stolika w swoim planie sali.
Za to identyfikator zamówienia z Lokamo jedzie jako identyfikator zamówienia w Syrve, a kontrakt wymaga, żeby był unikalny. To sprawia, że powtórzona wysyłka tego samego zamówienia nie może otworzyć drugiego bonu, i dlatego Syrve jest jedyną z czterech integracji, w której niejasną odpowiedź kasy wolno bezpiecznie ponowić.
więcej przejść
krótszy przepływ
Krok po kroku
Jak podłączyć Syrve lub iiko Cloud do Lokamo
Od klucza API w zapleczu kasy do pierwszej synchronizacji karty.
- Wygeneruj klucz API
W zapleczu Syrve albo iiko wejdź w ustawienia Cloud API i wygeneruj klucz dla integracji zewnętrznej.
- Wpisz klucz w panelu Lokamo
W sekcji POS wybierz Syrve, wklej klucz i zostaw identyfikator organizacji oraz ID kasy puste, jeśli klucz obsługuje jedną restaurację. Dla instalacji iiko podaj właściwy adres API.
- Wskaż kasę i pobierz kartę
Jeśli lokal ma więcej niż jedną kasę, wybierz tę, na którą mają trafiać bony, a następnie uruchom synchronizację menu i sprawdź rozmiary oraz grupy dodatków w karcie.
Bez niedomówień
Częste pytania
Krótko i konkretnie, także tam, gdzie odpowiedź brzmi „to zależy”.
Czym różni się Syrve od iiko?
Z punktu widzenia integracji niczym: kontrakt API jest ten sam, różni się adres serwera. 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 mapuje jeszcze identyfikatorów stolików Syrve, więc numer stolika jedzie jako numer zewnętrzny zamówienia i obsługa widzi go na bonie.
Czy mogę wskazać własny adres serwera?
Tylko w domenach Syrve i iiko. Połączenie nawiązuje serwer Lokamo, więc pole przyjmujące dowolny adres byłoby ryzykiem bezpieczeństwa, a nie funkcją.