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

Integracja z kasą Syrve / iiko Cloud: konfiguracja krok po kroku

Syrve (dawniej iiko) łączy się przez Cloud API i, jeśli Twoje konto obsługuje tylko jedną restaurację i jedną kasę, wykrywa je same, bez wpisywania dodatkowych identyfikatorów. Ten artykuł opisuje wyłącznie Syrve/iiko; ogólny mechanizm ekranu „Integracja POS” opisuje osobny artykuł przeglądowy.

Aktualizacja
Dla kogo
Właściciel
Plan
Każdy plan
Stan
Działa częściowo, szczegóły w treści
Na tej stronie

Zanim zaczniesz

Wygeneruj klucz apiLogin w iikoWeb albo Syrve App, w sekcji Ustawienia → Cloud API.

Krok po kroku

  1. W „Integracja POS” wybierz kartę „Syrve / iiko Cloud”.
  2. Wpisz „apiLogin (klucz API)”.
  3. Zostaw „Organization ID” i „ID kasy (terminal group)” puste, jeśli Twój klucz obsługuje jedną restaurację i jedną kasę: Lokamo wykryje je automatycznie przy zapisie. Jeśli klucz obsługuje kilka restauracji, zapis zwróci ich listę i poprosi o ręczny wybór.
  4. Pole „Adres API” zostaw domyślne (Syrve EU) albo wpisz adres dla iiko RU, jeśli tam jest Twoje konto.
  5. Kliknij „Testuj i zapisz”.
  6. Po udanym połączeniu kliknij „Synchronizuj menu”.

Dobrze wiedzieć

  • Ze wszystkich obsługiwanych kas Syrve jako jedyna potwierdza bezpiecznie ponawiane wysyłanie zamówień: niejednoznaczny błąd sieciowy można u niej bezpiecznie spróbować wysłać ponownie bez ryzyka podwójnego zamówienia.
  • „ID kasy (terminal group)” jest wymagane do wysyłania zamówień: bez niego, jeśli Lokamo nie zdoła go wykryć automatycznie, wysyłka się nie powiedzie.
  • Dane gościa (imię, telefon) celowo nie są wysyłane do Syrve razem z zamówieniem: ogranicza to ryzyko odrzucenia całego zamówienia przez restrykcyjną walidację po stronie kasy.
  • Adres API akceptuje wyłącznie domeny Syrve i iiko: inny adres zostanie odrzucony już przy zapisie, ze względów bezpieczeństwa.
  • Wysyłka zamówień na żywo do Syrve nie jest jeszcze dostępna dla żadnego lokalu: potrzebny jest wcześniej dopisany, znany identyfikator organizacji testowej po stronie Lokamo.

Najczęstsze problemy

Zapis mówi, że klucz obsługuje kilka restauracji.

Wpisz ręcznie „Organization ID” z listy, którą panel pokazuje w komunikacie błędu.

Zapis mówi, że apiLogin nie ma dostępu do żadnej restauracji.

Sprawdź w iikoWeb/Syrve App, czy klucz Cloud API jest aktywny i przypisany do właściwego konta.

Adres API zostaje odrzucony.

Adres musi zaczynać się od https:// i być domeną Syrve albo iiko: sprawdź literówki, zwłaszcza przy ręcznym wpisywaniu adresu dla iiko RU.

Wysyłka zamówienia kończy się błędem o braku kasy docelowej.

Uzupełnij ręcznie „ID kasy (terminal group)”: automatyczne wykrywanie działa tylko wtedy, gdy Twoje konto ma dokładnie jedną aktywną kasę.

Co dalej

Integracja z kasą: przeglądEkran /admin/pos: wybór systemu kasowego, synchronizacja karty i wysyłka zamówień, oraz kiedy wysyłka na żywo naprawdę się włącza.Panel obsługi: zamówienia, stoliki i wezwania na żywoEkran /staff: tablica zamówień ze statusami, wezwania gości, stoliki na żywo, dostępność dań i historia zmiany.

Zapytaj asystenta AI o tę instrukcję

Wybierz pytanie i otwórz je w swoim czacie. Asystent przeczyta tę stronę i odpowie o Twoim lokalu.

Pytanie do asystenta
Otwórz wChatGPTClaudePerplexity

Czy ta instrukcja pomogła?

Opis zgodny z panelem z 23 września 2026