Ana içeriğe atla
DELETE
Bir gönderi siparişini iptal et. Bu işlem, siparişi iptal etmek için lojistik sağlayıcı API’sini çağırır ve gönderi durumunu cancelled olarak günceller. Zaten cancelled durumundaki bir gönderiyi iptal etmek bu gönderiyle birlikte 200 döndürür ve sağlayıcı yalnızca bir kez çağrılır. Tekrarlanan çağrıyı işlemi gerçekleştiren çağrıdan ayırt edebilmen için yanıt Idempotent-Replayed: true başlığını içerir. Bkz. İdempotentlik.
Gönderiler alımdan sonra iptal edilemez — bu durumda 409 Conflict döner.
Bir DHL iade etiketi tek başına iptal edilemez; bu da 409 Conflict döndürür. Bunun yerine gidiş paketini iptal et. Bir DHL gidiş paketini iptal etmek, pending durumundaki dönüş aşaması satırlarını da iptal eder. Her biri, status_updates içinde RETURN_LEG_CANCELLED kaydıyla cancelled durumuna geçer. Bkz. İade etiketleri. Birden fazla kit içeren bir kutuda, kutu tek bir kitin etiketiyle gönderilse bile her kitin kendi gidiş satırı ve kendi iade etiketi vardır. Bir kitin gidiş satırını iptal etmek, o kitin iade etiketini de iptal eder. Bir ev kiti paketini iptal etmek için bağlı tüm ev kiti siparişlerinin erişim bağlamında olması gerekir. Aksi halde çağrı 403 döndürür. Bkz. Erişim.

İstek

Yol parametreleri

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

Yanıt

Başarılı olduğunda API, iptal edilen gönderi nesnesiyle birlikte 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. Başarılı bir iptalden sonra cancelled olur.
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
İptalden önce bu gönderiye bağlı olan randevular. Her giriş { id, added_at } biçimindedir; her id değerini Randevuyu getir ile karşılaştır. Yalnızca erişim kapsamı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ı