Tworzenie dostawy
Aby utworzyć zamówienie dostawy, wykonaj następujące kroki:
-
Zaloguj się, używając apilogin utworzonego podczas łączenia.
-
Pobierz listę organizacji za pomocą /api/1/organizations dla danego apilogin. Jeśli returnAdditionalInfo: true, odpowiedź zwróci również aktualną wersję Twojego RMS.
-
Pobierz listę terminali dostaw, wywołując /api/1/terminal_groups. Ponieważ Syrve Live API działa bezpośrednio z frontami, określenie terminala jest wymagane, jeśli funkcja automatycznej dystrybucji jest wyłączona.
-
Pobierz menu, wywołując /api/1/nomenclature. Nomenklatura musi być przygotowana wcześniej i załadowana do API. Przechowuj ID pozycji po swojej stronie.
-
Możesz również sprawdzić aktualną listę pozycji na liście zatrzymań za pomocą /api/1/stop_lists.
-
Pobierz typy płatności /api/1/payment_types. Typy płatności muszą być wcześniej skonfigurowane w instancji Syrve.
-
Skonfiguruj i załaduj miasta i ulice do API.
-
Uruchom zapytanie /api/1/deliveries/create.
SourceKey
SourceKey działa dwustronnie.
Jeśli przypiszesz go do apilogin, to zamówienia tworzone z tego apilogin otrzymają dokładnie ten source.
Z drugiej strony, jeśli jest określony, działa jako filtr (zamówienia z inną wartością w polu source nie będą dostępne do przeglądania dla tego apilogin).
Innymi słowy, pole „source” jest potrzebne do ograniczenia widoczności zamówień dla integracji zewnętrznej (na przykład jeden integrator powinien widzieć tylko swoje własne zamówienia).
W innych przypadkach nie trzeba wskazywać source.