Przejdź do głównej zawartości

Usługi Tworzenia Delivery Jobów

Ta strona wyjaśnia, jak tworzyć delivery joby w Fleet API oraz jak potwierdzić, czy przesłane joby zostały poprawnie utworzone.

Skróty i terminy​

  • API: Application Programming Interface.
  • ERP: Enterprise Resource Planning.
  • HTTP: Hypertext Transfer Protocol.

Którego endpointu użyć?​

Skorzystaj z poniższego mapowania w zależności od wolumenu i potrzeb potwierdzania:

1) Bulk Upload Delivery Jobs​

Co to oznacza​

Umożliwia przesłanie wielu jobów w jednym żądaniu, co jest odpowiednie przy integracji dużych wolumenów z ERP lub systemami dispatch.

Potwierdzenia i powiadomienia​

Usługa bulk upload obsługuje pole webhooks_url. Po zakończeniu przetwarzania Cartrack wysyła callback webhooka, aby Państwa system mógł potwierdzić wynik i uzgodnić, które joby zostały utworzone. W zakresie konfiguracji webhooka, weryfikacji podpisu i zasad bezpieczeństwa prosimy zapoznać się z Webhooks.

Cel​

  • Najlepszy wybór dla cyklicznych importów dostaw lub dużych wolumenów.
  • Zapewnia zespołom operacyjnym wiarygodny proces potwierdzania, zamiast zakładać, że wszystkie joby utworzono.
  • Pomaga szybko wykrywać scenariusze częściowego utworzenia.

Uwagi dla deweloperów​

  • Traktuj to żądanie jako przepływ asynchroniczny.
  • Callbacki webhooków traktuj jako źródło prawdy dla końcowego statusu przetwarzania.
  • Porównuj joby wysłane z wynikami callbacków i uruchamiaj retry/escalation dla jobów nieutworzonych.

2) Create a Delivery Job​

Co to oznacza​

Pozwala utworzyć jeden delivery job na jedno żądanie i otrzymać natychmiastową odpowiedź API.

Potwierdzenia i błędy​

Jeśli job nie może zostać utworzony, API zwróci kod HTTP inny niż 200 wraz z odpowiednim komunikatem błędu.

Cel​

  • Najlepiej pasuje do interaktywnych przepływów, w których użytkownik tworzy joby pojedynczo.
  • Błędy są widoczne od razu i mogą zostać przekazane do zespołów wsparcia lub dispatch.

Uwagi dla deweloperów​

  • Waliduj HTTP status każdej operacji.
  • Wszystkie odpowiedzi inne niż 200 traktuj jako jednoznaczne niepowodzenie utworzenia.
  • Loguj i zwracaj komunikat błędu z API, aby przyspieszyć obsługę operacyjną.

Rekomendowany Wzorzec Integracji​

  1. Utrzymuj referencję po stronie klienta dla każdego wysłanego joba (ERP/dispatch).
  2. Stosuj bulk upload z webhooks_url dla wysokiego wolumenu.
  3. Śledź callbacki i wykonuj uzgodnienie jobów oczekiwanych vs utworzonych.
  4. Wszystkie odpowiedzi inne niż 200 przy tworzeniu pojedynczym traktuj jako błędy.
  5. Wykonuj retry lub escalation dla jobów nieudanych zgodnie z wewnętrznym procesem.