Przejdź do głównej treści
PATCH
Zaktualizuj szczegóły przesyłki, takie jak harmonogram odbioru, liczba paczek lub uwagi. Jeśli zmieni się którekolwiek pole istotne logistycznie (data odbioru, godzina, liczba paczek lub waga), dotychczasowe zlecenie logistyczne zostanie anulowane i automatycznie utworzy się nowe. Pominięte pola zachowają wartości z istniejącej przesyłki. Zaktualizowane pola harmonogramu są sprawdzane zgodnie z zasadami harmonogramu odbioru.
Przesyłek nie można modyfikować po odbiorze. Próba aktualizacji przesyłki, która została już odebrana, zwraca 409 Conflict.
Paczka z domowym zestawem testowym ma już wydrukowaną etykietę, więc zmienić można tylko notes. Nowe okno odbioru lub waga dla paczki z domowym zestawem testowym zwraca 409 Conflict; zamiast tego anuluj ją i utwórz nową przesyłkę. Aby zaktualizować paczkę z domowym zestawem testowym, każde powiązane zamówienie domowego zestawu testowego musi być w twoim kontekście dostępu. W przeciwnym razie wywołanie zwraca 403. Zobacz Dostęp.

Żądanie

Parametry ścieżki

string
wymagane
Identyfikator referencyjny przesyłki (np. P2611194821).

Parametry treści

Wszystkie parametry w treści żądania są opcjonalne — podaj tylko pola, które chcesz zmienić.
string
Nowa data odbioru w formacie YYYY-MM-DD, interpretowana w strefie czasowej miejsca nadania.
string
Nowa najwcześniejsza godzina odbioru w formacie HH:MM, interpretowana jako czas lokalny w strefie czasowej miejsca nadania.
string
Nowa najpóźniejsza godzina odbioru w formacie HH:MM, interpretowana jako czas lokalny w strefie czasowej miejsca nadania.
integer
Nowa liczba paczek.
number
Nowa waga w kg.
string
Nowe uwagi lub komentarze. Maksymalnie 128 znaków.

Odpowiedź

W razie powodzenia API zwraca 200 OK ze zaktualizowaną przesyłką.
string
wymagane
Identyfikator referencyjny przesyłki.
string
wymagane
Status cyklu życia przesyłki. Jedna z wartości: pending, in_transit, delivered, fault lub cancelled.
string
wymagane
Dostawca logistyczny. Jedna z wartości: go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups lub dhl_express. Paczka z zestawem domowym ma wartość dhl_parcel albo dhl_warenpost, gdy jest wysyłana za granicę jako Warenpost International.
string
Zewnętrzny numer śledzenia od dostawcy logistycznego. Może mieć wartość null.
string
Dowolny opis tekstowy zawartości paczki podany podczas tworzenia. Może mieć wartość null.
string
wymagane
Kto wydrukował etykietę: aniva lub external. To wywołanie jest obsługiwane tylko dla przesyłek aniva.
string
Numer referencyjny drugiej paczki w przesyłce dwupaczkowej. null w przypadku paczki w jedną stronę.
object
Adres odbioru. Może mieć wartość null.
object
Adres dostawy. Taka sama struktura jak origin. Może mieć wartość null.
object
Zaplanowane okno odbioru. Może mieć wartość null.
string
Opcjonalne notatki. Może mieć wartość null.
object[]
wymagane
Chronologiczne zdarzenia z cyklu życia przesyłki od dostawcy logistycznego (od najstarszych). Każdy wpis ma pola state, code, detail_code, status, description, location i time. Szczegóły każdego pola znajdziesz w Pobierz przesyłkę. Pusta tablica, jeśli nie odnotowano jeszcze żadnych zdarzeń.
ShipmentAppointmentLink[]
wymagane
Wizyty powiązane z tą przesyłką, od najstarszego powiązania. Każdy wpis ma postać { id, added_at }; każdy id sprawdź w Pobierz wizytę. Na liście są tylko wizyty w twoim kontekście dostępu.
ShipmentHomeKitOrderLink[]
wymagane
Zamówienia zestawów domowych powiązane z tą przesyłką, od najstarszego powiązania, w tym samym formacie { id, added_at }. Na liście znajdują się tylko zamówienia w twoim kontekście dostępu. Pusta tablica dla paczek z gabinetów.
string
Czas ostatniego uzgodnienia stanu przesyłki z przewoźnikiem jako znacznik czasu UTC. null do pierwszej synchronizacji.
string
wymagane
Znacznik czasu utworzenia (ISO 8601).
string
Znacznik czasu ostatniej aktualizacji (ISO 8601). Może mieć wartość null.

Odpowiedzi z błędami