Ana içeriğe atla
PATCH
Alım programı, paket sayısı veya notlar gibi gönderi ayrıntılarını güncelle. Lojistikle ilgili herhangi bir alan değişirse (alım tarihi, saati, paket sayısı veya ağırlık), mevcut lojistik siparişi iptal edilir ve otomatik olarak yenisi oluşturulur. Belirtmediğin alanlar mevcut gönderiden korunur. Güncellenen program alanları alım programı kuralları kapsamında doğrulanır.
Gönderiler alındıktan sonra değiştirilemez. Zaten alınmış bir gönderiyi güncellemeye çalışmak 409 Conflict döndürür.
Bir evde test kiti paketinin etiketi zaten yazdırılmıştır, bu nedenle yalnızca notes değişebilir. Bir evde test kiti paketi için yeni bir alım zaman aralığı veya ağırlık 409 Conflict döndürür; bunun yerine gönderiyi iptal et ve yeni bir gönderi oluştur. Bir evde test kiti paketini güncellemek için bağlı her evde test kiti siparişi erişim bağlamında olmalıdır. Aksi takdirde çağrı 403 döndürür. Erişim bölümüne bak.

İstek

Yol parametreleri

string
gerekli
Gönderi referans ID’si (ör. P2611194821).

Gövde parametreleri

Tüm gövde parametreleri isteğe bağlıdır — yalnızca değiştirmek istediğin alanları ekle.
string
YYYY-MM-DD biçiminde yeni alım tarihi, çıkış konumunun saat diliminde yorumlanır.
string
HH:MM biçiminde yeni en erken alım saati, çıkış konumunun saat diliminde yerel saat olarak yorumlanır.
string
HH:MM biçiminde yeni en geç alım saati, çıkış konumunun saat diliminde yerel saat olarak yorumlanır.
integer
Yeni paket sayısı.
number
Yeni ağırlık (kg).
string
Yeni notlar veya açıklamalar. En fazla 128 karakter.

Yanıt

Başarılı olduğunda API, güncellenmiş gönderiyle 200 OK döndürür.
string
gerekli
Gönderi referans tanımlayıcısı.
string
gerekli
Gönderi yaşam döngüsü durumu. pending, in_transit, delivered, fault veya cancelled değerlerinden biri.
string
gerekli
Lojistik sağlayıcı. go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups veya dhl_express değerlerinden biri. Ev kiti paketi dhl_parcel veya yurt dışına Warenpost International olarak gittiğinde dhl_warenpost olur.
string
Lojistik sağlayıcıdan alınan harici takip numarası. null olabilir.
string
Oluşturma sırasında belirtildiği şekliyle paketin içeriğine dair serbest metin açıklaması. null olabilir.
string
gerekli
Etiketi kimin yazdırdığı: aniva veya external. Bu çağrıyı yalnızca aniva gönderileri kabul eder.
string
İki paketli bir sevkiyattaki diğer paketin referansı. Tek yönlü bir paket için null.
object
Alım adresi. null olabilir.
object
Teslimat adresi. origin ile aynı yapıdadır. null olabilir.
object
Planlanan alım aralığı. null olabilir.
string
İsteğe bağlı notlar. null olabilir.
object[]
gerekli
Lojistik sağlayıcıdan gelen kronolojik yaşam döngüsü olayları (en eskisi önce). Her girişte state, code, detail_code, status, description, location ve time bulunur. Her alan için Gönderiyi getir sayfasına bak. Henüz bir olay gözlemlenmediyse boş dizidir.
ShipmentAppointmentLink[]
gerekli
Bu gönderiye bağlı randevular, en eski bağlantıdan başlayarak. Her giriş { id, added_at } şeklindedir; her id değerini Randevuyu getir ile karşılaştır. Yalnızca erişim bağlamındaki randevular listelenir.
ShipmentHomeKitOrderLink[]
gerekli
Bu gönderiye bağlı ev kiti siparişleri, en eski bağlantı önce olacak şekilde, aynı { id, added_at } yapısında. Yalnızca erişim kapsamındaki siparişler listelenir. Muayenehane paketleri için boş dizidir.
string
Gönderinin kargo şirketiyle en son ne zaman eşleştirildiği, UTC zamanı olarak. İlk senkronizasyona kadar null.
string
gerekli
Oluşturulma zaman damgası (ISO 8601).
string
Son güncelleme zaman damgası (ISO 8601). null olabilir.

Hata yanıtları