Przegląd
Ten przewodnik opisuje, jak korzystać z OneRail API do określania stawek wysyłki dla potencjalnej dostawy i stopniowego aktualizowania zamówienia przy użyciu częściowych aktualizacji. Te działania są kluczowe dla dynamicznego ustalania cen dostaw i efektywnego zarządzania ich przebiegiem.
Użycie punktu końcowego /delivery/get-rates
umożliwia organizacjom tworzenie wstępnych zamówień dostawy na podstawie informacji o stawkach uzyskanych od wybranych przewoźników. Następnie, częściowe aktualizacje zapewniają, że gdy bardziej dokładne dane (np. ostateczne koszty lub przypisania przewoźników) stają się dostępne, mogą być odzwierciedlone bez ponownego przesyłania całego ładunku dostawy.
Przebieg tworzenia dostawy przy użyciu uzyskiwania stawek i częściowych aktualizacji
/delivery/get-rates
Ten punkt końcowy pobiera stawki dostawy od dostępnych przewoźników na podstawie podanych szczegółów dostawy. To jest uzależnione od konfiguracji partnerów logistycznych (LP) i ustawień organizacyjnych, takich jak definicje paczek.
- Uwzględniani są jedynie przewoźnicy, którzy odpowiadają pomyślnie; nieodpowiadający przewoźnicy są wykluczeni z wyników.
- Zwrócone stawki mogą być użyte do stworzenia wstępnego zamówienia i przedstawienia opcji końcowemu użytkownikowi.
- Konfiguracja LP jest zarządzana poprzez ustawienia kontraktowe nadawcy i logikę zakupową LP.
Szczegóły pełnej implementacji można znaleźć tutaj: Swagger - Get Rates
/order/{orderID}/partial-update
Po uzyskaniu najniższej ceny dostawcy, ten punkt końcowy jest używany do aktualizacji istniejącego wstępnego zamówienia dostawy o zaktualizowane informacje, takie jak wybór przewoźnika, rozbicie ceny lub generowanie etykiety.
- Czas generowania etykiety jest kluczowy; jeśli jest wymagany natychmiastowo, żądanie aktualizacji powinno zawierać flagę
requestLabel: true
. - Umożliwia precyzyjną kontrolę postępu w realizacji dostawy od wyceny do gotowości do wysyłki.
- Idealne dla systemów, gdzie tworzenie i realizacja zamówienia odbywa się w etapach.
Szczegóły pełnej implementacji można znaleźć tutaj: Swagger - Partial Update
Przepływ pracy od początku do końca
-
Zrób zakupy porównawcze: Użyj
/delivery/get-rates
do przeglądania potencjalnych opcji dostawy i cen. - Stworzyć wstępne zamówienie dostawy: Na podstawie preferowanych stawek, rozpocznij obiekt dostawy z częściowymi informacjami (np. bez etykiet lub ostatecznych kosztów).
-
Zaktualizować dostawę: Gdy decyzje zostaną sfinalizowane, użyj
/delivery/partial-update
, aby uwzględnić wybór przewoźnika, zaktualizować koszty i wygenerować etykiety. -
Finalizuj wysyłkę: Po wypełnieniu wszystkich pól, zmień stan dostawy na
GOTOWE DO WYSYŁKI
.
Korzyści
- Odłącza wycenę od ostatecznego przesyłania dostawy.
- Zmniejsza nakład pracy porównywania stawek przewoźników.
- Wspiera szybkie scenariusze realizacji z dynamicznymi aktualizacjami.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.