Salt la conținutul principal
PATCH
Actualizează detaliile expedierii, cum ar fi programul de preluare, numărul de colete sau observațiile. Dacă se modifică orice câmp relevant pentru logistică (data preluării, ora, numărul de colete sau greutatea), comanda logistică existentă este anulată și se creează automat una nouă. Câmpurile pe care le omiți se păstrează din expedierea existentă. Câmpurile actualizate ale programului sunt validate conform regulilor privind programul de preluare.
Expedierile nu pot fi modificate după preluare. Încercarea de a actualiza o expediere care a fost deja preluată returnează 409 Conflict.
Un colet cu kit de testare la domiciliu are deja eticheta tipărită, deci doar notes se poate modifica. Un nou interval de preluare sau o nouă greutate pentru un colet cu kit de testare la domiciliu returnează 409 Conflict; în schimb, anulează-l și creează o expediere nouă. Pentru a actualiza un colet cu kit de testare la domiciliu, fiecare comandă de kit de testare la domiciliu asociată trebuie să fie în contextul tău de acces. În caz contrar, apelul returnează 403. Vezi Acces.

Cerere

Parametri de cale

string
obligatoriu
ID-ul de referință al expedierii (de ex., P2611194821).

Parametri de corp

Toți parametrii din body sunt opționali — include doar câmpurile pe care vrei să le modifici.
string
Noua dată de preluare în format YYYY-MM-DD, interpretată în fusul orar al locației de origine.
string
Noua oră minimă de preluare în format HH:MM, interpretată ca oră locală în fusul orar al locației de origine.
string
Noua oră maximă de preluare în format HH:MM, interpretată ca oră locală în fusul orar al locației de origine.
integer
Noul număr de colete.
number
Noua greutate în kg.
string
Observații sau mențiuni noi. Maximum 128 de caractere.

Răspuns

În caz de succes, API-ul returnează 200 OK cu expedierea actualizată.
string
obligatoriu
Identificatorul de referință al expedierii.
string
obligatoriu
Starea expedierii în ciclul de viață. Una dintre valorile pending, in_transit, delivered, fault sau cancelled.
string
obligatoriu
Furnizorul de logistică. Una dintre valorile go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups sau dhl_express. Un colet cu kit pentru acasă folosește dhl_parcel sau dhl_warenpost când pleacă în străinătate ca Warenpost International.
string
Numărul extern de urmărire de la furnizorul de logistică. Poate fi null.
string
Descriere în text liber a conținutului coletului, așa cum a fost furnizată la creare. Poate fi null.
string
obligatoriu
Cine a tipărit eticheta: aniva sau external. Doar expedierile aniva acceptă acest apel.
string
Referința celuilalt colet dintr-o expediere cu două colete. null pentru un colet într-un singur sens.
object
Adresa de ridicare. Poate fi null.
object
Adresa de livrare. Aceeași structură ca origin. Poate fi null.
object
Intervalul programat de ridicare. Poate fi null.
string
Note opționale. Poate fi null.
object[]
obligatoriu
Evenimente cronologice din ciclul de viață de la furnizorul de logistică (cele mai vechi primele). Fiecare intrare conține state, code, detail_code, status, description, location și time. Vezi Obține expedierea pentru fiecare câmp. Listă goală dacă nu s-au înregistrat încă evenimente.
ShipmentAppointmentLink[]
obligatoriu
Programările asociate cu această expediere, în ordinea asocierii (cele mai vechi primele). Fiecare intrare este { id, added_at }; corelează fiecare id cu Obține programarea. Sunt listate doar programările din contextul tău de acces.
ShipmentHomeKitOrderLink[]
obligatoriu
Comenzile de kituri pentru acasă asociate cu această expediere, de la cea mai veche asociere, în aceeași formă { id, added_at }. Sunt listate doar comenzile din contextul tău de acces. Listă goală pentru coletele de la cabinete.
string
Momentul ultimei sincronizări a expedierii cu transportatorul, ca moment UTC. null până la prima sincronizare.
string
obligatoriu
Data și ora creării (ISO 8601).
string
Data și ora ultimei actualizări (ISO 8601). Poate fi null.

Răspunsuri de eroare