Ana içeriğe atla
POST
Belirtilen çıkış konumundan bir gönderi siparişi oluştur. Hedef laboratuvarı destination_lab ile belirtirsin. Gönderi, o laboratuvarın kayıtlı gönderim adresine gider. shipments_manage kapsamını gerektirir. Bu oluşturma işlemini güvenle yeniden denenebilir kılmak için isteğe bağlı bir Idempotency-Key başlığı gönder — aynı anahtarın tekrarı ikincisini oluşturmak yerine ilk yanıtı döndürür. İdempotans bölümüne bak.

İstek

Gövde parametreleri

string
gerekli
Çıkış test konumunun UUID’si. Konum aktif ve API anahtarının erişim kapsamında olmalıdır. Mevcut konum ID’lerini bulmak için Konumları listele uç noktasını kullan.
string
gerekli
Hedef laboratuvar. zotzklimas, labclinic, nordicgroup, biomes, imd veya quade değerlerinden biri. Gönderi, bu laboratuvar için kayıtlı gönderim adresine gider. Kayıtlı gönderim adresi olmayan bir laboratuvar 400 döndürür.
string
Oluşturma sırasında bu gönderiye bağlanacak isteğe bağlı randevu UUID’si. Randevu, API anahtarının erişim kapsamında olmalıdır. Bağlantı, gönderinin appointments dizisinde bir giriş olarak, karşılığında da randevunun shipments dizisinde bir giriş olarak görünür. Oluşturma sonrasında ek randevular bağlamak veya ilk bağlantıyı kaldırmak için Randevuları gönderiye bağla ve Randevuları gönderiden ayır uç noktalarını kullan.
string
gerekli
YYYY-MM-DD biçiminde alım tarihi (ör. 2026-04-15), çıkış konumunun saat dilimine göre yorumlanır. Hafta içi bir gün (Pazartesi–Cuma), bugün veya gelecekte bir tarih olmalıdır. Europe/Berlin saatine göre 16:00’dan sonra aynı gün alım yapılamaz.
string
gerekli
HH:MM biçiminde en erken alım saati (ör. 09:00), çıkış konumunun saat dilimindeki yerel saat olarak yorumlanır. 09:00 ile 19:00 arasında olmalıdır.
string
gerekli
HH:MM biçiminde en geç alım saati (ör. 12:00), çıkış konumunun saat dilimindeki yerel saat olarak yorumlanır. 09:00 ile 19:00 arasında olmalıdır. Aralık (pickup_time_till - pickup_time_from) en az 2 saat olmalıdır.
integer
varsayılan:"1"
Paket sayısı. Varsayılan olarak 1 kullanılır.
number
varsayılan:"0.5"
kg cinsinden ağırlık. Varsayılan olarak 0.5 kullanılır.
string
Alım sırasında kurye için talimatlar (gönderici notları). Belirtilmediğinde, alım adresinin kayıtlı notları kullanılır (adreste yoksa hiçbiri kullanılmaz). En fazla 128 karakter.
string
Paketin içinde ne olduğuna dair serbest metin açıklaması, kuryeye gösterilir ve contents olarak geri döndürülür. En fazla 40 karakter (ör. Medizinisch freigestellte Probe).
string
İsteğe bağlı dahili notlar. En fazla 128 karakter.

Yanıt

Başarılı olduğunda API, yeni gönderi ile birlikte 201 Created döndürür.
string
gerekli
Gönderi referans kimliği (ör. P2604151234).
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. Oluşturduğun bir gönderi aniva olur.
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. Oluşturulduktan hemen sonra boş dizidir. Arka plan senkronizasyonu, sağlayıcı bildirdikçe olayları ekler.
ShipmentAppointmentLink[]
gerekli
Bu gönderiye bağlı randevular, en eski bağlantı önce olacak şekilde. Her giriş { id, added_at } biçimindedir; her id değerini Randevuyu getir ile karşılaştır. Oluşturulduktan hemen sonra, varsa appointment_id ile iletilen randevuyu içerir.
ShipmentHomeKitOrderLink[]
gerekli
Bu gönderiye bağlı ev kiti siparişleri, aynı { id, added_at } yapısında. Oluşturduğun bir gönderi 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ı