Pāriet uz galveno saturu
PATCH
Atjaunini sūtījuma informāciju, piemēram, paņemšanas grafiku, paku skaitu vai piezīmes. Ja mainās kāds loģistikai būtisks lauks (paņemšanas datums, laiks, paku skaits vai svars), esošais loģistikas pasūtījums tiek atcelts un automātiski izveidots jauns. Izlaistie lauki tiek saglabāti no esošā sūtījuma. Atjauninātie grafika lauki tiek pārbaudīti atbilstoši paņemšanas grafika noteikumiem.
Sūtījumus pēc paņemšanas nevar mainīt. Mēģinot atjaunināt jau paņemtu sūtījumu, tiek atgriezts 409 Conflict.
Mājas testa komplekta pakai uzlīme jau ir izdrukāta, tāpēc var mainīt tikai notes. Jauns paņemšanas laika logs vai svars mājas testa komplekta pakai atgriež 409 Conflict; tā vietā atcel to un izveido jaunu sūtījumu. Lai atjauninātu mājas testa komplekta paku, visiem saistītajiem mājas testa komplekta pasūtījumiem ir jābūt tavā piekļuves kontekstā. Pretējā gadījumā pieprasījums atgriež 403. Skati Piekļuve.

Pieprasījums

Ceļa parametri

string
obligāts
Sūtījuma atsauces ID (piem., P2611194821).

Pieprasījuma satura parametri

Visi pamatteksta parametri ir neobligāti — iekļauj tikai tos laukus, kurus vēlies mainīt.
string
Jauns paņemšanas datums YYYY-MM-DD formātā, kas tiek interpretēts nosūtīšanas vietas laika joslā.
string
Jauns agrākais paņemšanas laiks HH:MM formātā, kas tiek interpretēts kā pulksteņa laiks nosūtīšanas vietas laika joslā.
string
Jauns vēlākais paņemšanas laiks HH:MM formātā, kas tiek interpretēts kā pulksteņa laiks nosūtīšanas vietas laika joslā.
integer
Jauns paku skaits.
number
Jauns svars kg.
string
Jaunas piezīmes vai komentāri. Maksimums 128 rakstzīmes.

Atbilde

Veiksmes gadījumā API atgriež 200 OK ar atjaunināto sūtījumu.
string
obligāts
Sūtījuma atsauces identifikators.
string
obligāts
Sūtījuma dzīves cikla statuss. Viena no šīm vērtībām: pending, in_transit, delivered, fault vai cancelled.
string
obligāts
Loģistikas pakalpojumu sniedzējs. Viena no vērtībām: go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups vai dhl_express. Mājas komplekta paka ir dhl_parcel vai dhl_warenpost, ja tā dodas uz ārzemēm kā Warenpost International.
string
Loģistikas pakalpojumu sniedzēja ārējais izsekošanas numurs. Var būt null.
string
Brīvā teksta apraksts par pakas saturu, kā norādīts izveides brīdī. Var būt null.
string
obligāts
Kurš izdrukāja uzlīmi: aniva vai external. Šo pieprasījumu pieņem tikai aniva sūtījumi.
string
Otras pakas atsauce divu paku sūtījumā. null vienvirziena pakai.
object
Paņemšanas adrese. Var būt null.
object
Piegādes adrese. Tāda pati struktūra kā origin. Var būt null.
object
Ieplānotais paņemšanas laika logs. Var būt null.
string
Neobligātas piezīmes. Var būt null.
object[]
obligāts
Hronoloģiski loģistikas pakalpojumu sniedzēja dzīves cikla notikumi (vecākie vispirms). Katram ierakstam ir state, code, detail_code, status, description, location un time. Katra lauka aprakstu skati sadaļā Iegūt sūtījumu. Tukšs masīvs, ja notikumi vēl nav fiksēti.
ShipmentAppointmentLink[]
obligāts
Ar šo sūtījumu saistītie pieraksti, sākot ar vecāko saiti. Katrs ieraksts ir { id, added_at }; pārbaudi katru id ar Iegūt pierakstu. Ir uzskaitīti tikai tie pieraksti, kas ir tavā piekļuves kontekstā.
ShipmentHomeKitOrderLink[]
obligāts
Ar šo sūtījumu saistītie mājas komplektu pasūtījumi, sākot ar vecāko saiti, tādā pašā { id, added_at } formā. Norādīti tikai tie pasūtījumi, kas ir tavā piekļuves kontekstā. Prakses sūtījumiem tas ir tukšs masīvs.
string
Laiks, kad sūtījums pēdējo reizi tika salāgots ar pārvadātāju, kā UTC laika punkts. null līdz pirmajai sinhronizācijai.
string
obligāts
Izveides laikspiedols (ISO 8601).
string
Pēdējās atjaunināšanas laikspiedols (ISO 8601). Var būt null.

Kļūdu atbildes