Ugrás a fő tartalomhoz
PATCH
Módosítsd a küldemény adatait, például a felvételi ütemezést, a csomagok számát vagy a megjegyzéseket. Ha bármely logisztikai szempontból lényeges mező megváltozik (felvételi dátum, idő, csomagok száma vagy súly), lemondjuk a meglévő logisztikai megbízást, és automatikusan létrehozunk egy újat. A kihagyott mezők értéke megmarad a meglévő küldeményből. A frissített ütemezési mezőket a felvételi ütemezési szabályok alapján ellenőrizzük.
A küldemények felvétel után nem módosíthatók. Ha már felvett küldeményt próbálsz módosítani, a válasz 409 Conflict.
Az otthoni tesztkészlethez tartozó csomag címkéje már ki van nyomtatva, így csak a notes módosítható. Ha egy otthoni tesztkészlethez tartozó csomagnál új felvételi időablakot vagy súlyt adsz meg, a válasz 409 Conflict; inkább mondd le, és hozz létre egy új küldeményt. Egy otthoni tesztkészlethez tartozó csomag módosításához minden kapcsolt otthoni tesztkészlet-rendelésnek a hozzáférési körödben kell lennie. Ellenkező esetben a hívás 403 választ ad. Lásd: Hozzáférés.

Kérés

Útvonalparaméterek

string
kötelező
A küldemény hivatkozási azonosítója (pl. P2611194821).

Törzsparaméterek

Minden törzsparaméter opcionális — csak azokat a mezőket add meg, amelyeket módosítani szeretnél.
string
Új felvételi dátum YYYY-MM-DD formátumban, a feladási hely időzónájában értelmezve.
string
Új legkorábbi felvételi idő HH:MM formátumban, helyi időként értelmezve a feladási hely időzónájában.
string
Új legkésőbbi felvételi idő HH:MM formátumban, helyi időként értelmezve a feladási hely időzónájában.
integer
Új csomagszám.
number
Új súly kg-ban.
string
Új megjegyzések vagy észrevételek. Legfeljebb 128 karakter.

Válasz

Siker esetén az API 200 OK választ ad vissza a módosított küldeménnyel.
string
kötelező
A küldemény referenciaazonosítója.
string
kötelező
A küldemény életciklus-állapota. A következő értékek egyike: pending, in_transit, delivered, fault vagy cancelled.
string
kötelező
Logisztikai szolgáltató. Lehetséges értékei: go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups vagy dhl_express. Az otthoni tesztkészlet-csomag dhl_parcel, illetve dhl_warenpost, ha külföldre megy Warenpost International küldeményként.
string
A logisztikai szolgáltatótól kapott külső csomagkövetési szám. Lehet null.
string
A csomag tartalmának szabad szöveges leírása, ahogyan a létrehozáskor megadták. Lehet null.
string
kötelező
Ki nyomtatta a címkét: aniva vagy external. Csak az aniva küldemények fogadják el ezt a hívást.
string
A kétcsomagos szállítmány másik csomagjának referenciája. Egyirányú csomagnál null.
object
Felvételi cím. Lehet null.
object
Kézbesítési cím. Ugyanolyan szerkezetű, mint az origin. Lehet null.
object
Ütemezett felvételi időablak. Lehet null.
string
Opcionális megjegyzések. Lehet null.
object[]
kötelező
A logisztikai szolgáltató időrendi életciklus-eseményei (a legrégebbitől kezdve). Minden elem tartalmazza a state, code, detail_code, status, description, location és time mezőket. Az egyes mezőket lásd a Küldemény lekérdezése oldalon. Üres tömb, ha még nem érkezett esemény.
ShipmentAppointmentLink[]
kötelező
Az ehhez a küldeményhez kapcsolt időpontok, a legrégebben kapcsolttól kezdve. Minden elem { id, added_at } formátumú; kérd le az egyes id értékeket az Időpont lekérése végponton. Csak a hozzáférési körödben lévő időpontok szerepelnek a listában.
ShipmentHomeKitOrderLink[]
kötelező
Az ehhez a küldeményhez kapcsolt otthoni tesztkészlet-rendelések, a legrégebben kapcsolttól kezdve, ugyanabban az { id, added_at } szerkezetben. Csak a hozzáférési körödbe tartozó rendelések szerepelnek a listában. Rendelői csomagok esetén üres tömb.
string
Mikor történt a küldemény utolsó egyeztetése a futárszolgálattal, UTC időpillanatként. Az első szinkronizálásig null.
string
kötelező
Létrehozási időbélyeg (ISO 8601).
string
Utolsó frissítés időbélyege (ISO 8601). Lehet null.

Hibaválaszok