Wprowadzenie
Przegląd
Prosta API do wstrzykiwania zamówień (dalej SOI API) została zaprojektowana w celu szybkiej integracji Syrve z zewnętrznymi usługami zamówień dostawczych, takimi jak strony internetowe restauracji, internetowe agregatory dostaw itp.
SOI API działa na bazie Syrve Live API i pozwala na tworzenie zamówień dostawczych i odbiorczych przy użyciu prostszych struktur danych oraz WebHooks do śledzenia wszelkich zmian w zamówieniach, co znacznie upraszcza rozwój gotowego rozwiązania.
Architektura SOI API może obsługiwać różne formaty przesyłania danych z systemów zewnętrznych do Syrve i może być łatwo rozszerzana.
Przepływ pracy
Komponenty
Źródło zamówienia
Źródło zamówienia lub profil integracji jest tworzony w ramach konta Syrve App™ dla restauracji (lub sieci restauracji). W ramach konta można utworzyć kilka źródeł zamówień, w zależności od liczby obsługiwanych źródeł zewnętrznych.
Aby uzyskać więcej informacji na temat tworzenia profilu, zobacz sekcję Konfigurowanie źródła zamówienia.
Tworzenie zamówienia
Każde źródło zamówienia udostępnia unikalny punkt końcowy do wstrzykiwania zamówień. System zewnętrzny musi przesłać zamówienie w określonym formacie. Zobacz sekcję Wstrzykiwanie zamówień, aby uzyskać więcej szczegółów.
Aktualizacje statusu zamówienia
Aby umożliwić otrzymywanie aktualizacji dotyczących bieżącego statusu zamówienia, w profilu integracji znajduje się specjalna właściwość z linkiem do odpowiedniego webhooka w systemie zewnętrznym ('aktualizuj status zamówienia').
Mapowanie menu
Większość nowoczesnych systemów używa uproszczonej struktury menu do tworzenia zamówień, gdzie każdy element menu jest osobnym rekordem z właściwościami takimi jak SKU/Nazwa/Cena. Aby zachować elastyczność wymaganą w branży restauracyjnej, poszczególne pozycje mogą być łączone w grupy modyfikatorów należące do dania głównego. Każdy modyfikator, z kolei, jest również określany przez parametry SKU/Nazwa/Cena.
Aby nałożyć taką strukturę na strukturę menu w Syrve, która może używać rozmiarów pozycji, schematów modyfikatorów itp., SOI API oferuje dynamiczne możliwości mapowania, kiedy identyfikatory dań w systemie zewnętrznym mogą odpowiadać sekwencji identyfikatorów w Syrve, w tym, jeśli to konieczne, nazwie rozmiaru dania.
Aby uprościć tworzenie takiego mapowania, Syrve oferuje specjalny interfejs użytkownika z możliwością eksportu do formatu Excel. Aby uzyskać więcej szczegółów na temat pracy z interfejsem, zobacz sekcję Mapowanie menu.
Ceny
W zależności od ustawień Syrve Live API, kontrola cen dla zamówień tworzonych z systemów zewnętrznych może być aktywna lub nie. Jeśli kontrola cen jest włączona, a zamówienie otrzymane z systemu zewnętrznego zawiera cenę różniącą się od tej zdefiniowanej dla odpowiedniej pozycji w Syrve POS, takie zamówienie nie zostanie zaakceptowane przez system. Zaleca się wyłączenie kontroli cen. W takim przypadku, nawet jeśli cena pozycji w systemie zewnętrznym różni się od tej w Syrve POS, zamówienie zostanie utworzone, a cena pozycji z systemu zewnętrznego zostanie zastosowana.