Přejít na hlavní obsah
PATCH
Aktualizuj údaje o zásilce, jako je časový plán svozu, počet balíků nebo poznámky. Pokud se změní jakékoli pole důležité pro logistiku (datum svozu, čas, počet balíků nebo hmotnost), stávající logistická objednávka se zruší a automaticky se vytvoří nová. Pole, která vynecháš, zůstanou zachována ze stávající zásilky. Aktualizovaná pole časového plánu se ověřují podle pravidel pro plánování svozu.
Zásilky nelze po svozu měnit. Pokus o aktualizaci zásilky, která už byla vyzvednuta, vrátí 409 Conflict.
Balík s domácí testovací sadou už má vytištěný štítek, takže lze změnit pouze notes. Nové časové okno svozu nebo hmotnost u balíku s domácí testovací sadou vrátí 409 Conflict; místo toho ho zruš a vytvoř novou zásilku. Pro aktualizaci balíku s domácí testovací sadou musí být každá propojená objednávka domácí testovací sady v tvém přístupovém kontextu. Jinak volání vrátí 403. Viz Přístup.

Požadavek

Parametry cesty

string
povinné
Referenční ID zásilky (např. P2611194821).

Parametry těla

Všechny parametry těla požadavku jsou volitelné — uveď jen pole, která chceš změnit.
string
Nové datum svozu ve formátu YYYY-MM-DD, interpretované v časovém pásmu místa odeslání.
string
Nový nejdřívější čas svozu ve formátu HH:MM, interpretovaný jako místní čas v časovém pásmu místa odeslání.
string
Nový nejzazší čas svozu ve formátu HH:MM, interpretovaný jako místní čas v časovém pásmu místa odeslání.
integer
Nový počet balíků.
number
Nová hmotnost v kg.
string
Nové poznámky nebo připomínky. Maximálně 128 znaků.

Odpověď

Při úspěchu vrátí API 200 OK s aktualizovanou zásilkou.
string
povinné
Referenční identifikátor zásilky.
string
povinné
Stav životního cyklu zásilky. Jedna z hodnot pending, in_transit, delivered, fault nebo cancelled.
string
povinné
Poskytovatel logistiky. Jedna z hodnot go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups nebo dhl_express. Balík s domácí sadou je dhl_parcel, případně dhl_warenpost, když jde do zahraničí jako Warenpost International.
string
Externí sledovací číslo od poskytovatele logistiky. Může být null.
string
Volný textový popis obsahu balíku zadaný při vytvoření. Může být null.
string
povinné
Kdo štítek vytiskl: aniva nebo external. Toto volání přijímají jen zásilky aniva.
string
Reference druhého balíku zásilky se dvěma balíky. Pro jednosměrný balík je null.
object
Adresa vyzvednutí. Může být null.
object
Doručovací adresa. Stejná struktura jako origin. Může být null.
object
Naplánované okno vyzvednutí. Může být null.
string
Volitelné poznámky. Může být null.
object[]
povinné
Chronologické události životního cyklu od poskytovatele logistiky (od nejstarší). Každá položka má state, code, detail_code, status, description, location a time. Jednotlivá pole najdeš v Získat zásilku. Prázdné pole, pokud zatím nebyly zaznamenány žádné události.
ShipmentAppointmentLink[]
povinné
Termíny propojené s touto zásilkou, od nejstaršího propojení. Každá položka má tvar { id, added_at }; každé id si dohledej přes Získat termín. Uvedeny jsou pouze termíny v tvém přístupovém kontextu.
ShipmentHomeKitOrderLink[]
povinné
Objednávky domácích sad přiřazené k této zásilce, od nejstaršího přiřazení, ve stejném tvaru { id, added_at }. Uvedeny jsou pouze objednávky v tvém přístupovém kontextu. Prázdné pole pro balíky z ordinací.
string
Kdy byla zásilka naposledy sladěna s přepravcem, jako okamžik v UTC. null až do první synchronizace.
string
povinné
Časové razítko vytvoření (ISO 8601).
string
Časové razítko poslední aktualizace (ISO 8601). Může být null.

Chybové odpovědi