Kargo alanları
| Alan | Anlamı | Ne zaman dolar |
|---|---|---|
| cargoCompany | Kargo firmasının adı | Kargo süreci başladığında |
| cargoNumber | Kargo takip kodu | Takip kodu atandığında; öncesinde boş |
| shipmentTrackingUrl | Takip sayfasının bağlantısı | Takip kodu atandığında |
| partialNumber | Siparişin parça numarası | Kayıt oluştuğunda |
Bu alanlar kalem satırında yer alır. Aynı siparişin kalemleri farklı parçalara ayrılmışsa her parçanın kargo bilgisi ayrı olabilir.
Takip kodundan önce: parça numarası
Satıcı panelinde gösterilen "Kargo No", sipariş numarası ile parça numarasının birleşimidir; örneğin 123456789-10 biçiminde. API'de bu değer partialNumber alanından türetilir: alan yalnız parça kısmını (10) içeriyorsa başına sipariş numarası eklenir, tireli tam değer geliyorsa olduğu gibi kullanılır.
Bu numara aynı siparişin parçalarını birbirinden ayırır. Bir siparişin iki kalemi farklı parçalarda gönderiliyorsa her parçanın numarası ve kargo bilgisi ayrı izlenir; kalemleri tek bir pakete aitmiş gibi birleştirmeyin.
Hazırlık ekranında bu numarayı göstermek, takip kodu henüz atanmamış paketleri panel ile eşleştirmeyi kolaylaştırır. Gerçek takip kodu atandığında cargoNumber dolar ve sonraki okumada parça numarasının yerine geçer.
Kargo bildirimi hakkında
Bu rehberi hazırlarken Çiçeksepeti'ne takip numarası bildiren ya da kargo durumunu güncelleyen bir API servisini resmî dokümandan doğrulayamadık. İncelediğimiz çalışan entegrasyon da kargo bilgisini yalnız okuyor. Bu yüzden kargo bildirimi için uç nokta adı vermiyoruz.
- Kargoya verme adımını satıcı panelindeki akışa göre yapın.
- Takip kodunun siparişe işlendiğini, sonraki sipariş okumasında cargoNumber alanının dolmasından anlayın.
- Kendi sisteminizde siparişi "kargoda" saymak için cargoNumber dolmasını ya da durum metninde kargo aşamasının görünmesini bekleyin.
- Müşteriye takip bilgisini kendi kanalınızdan (örneğin e-posta) gönderiyorsanız, bunu yalnız cargoNumber ve shipmentTrackingUrl dolduktan sonra yapın; boş ya da geçici numara müşteride yanlış beklenti yaratır.
Sık hatalar
- Boş takip kodunu hata saymak: "Kargoya Verilecek" aşamasında cargoNumber çoğunlukla boştur; bu normaldir.
- Parça numarasını tek başına göstermek: Paneldeki numarayla eşleşmesi için sipariş numarasıyla birleştirin.
- Eski takip bilgisini saklamak: Kargo bilgisi sonradan değişebilir; her okumada güncelleyin.
- Takip bağlantısını kurmak: Kargo firmasının adresini kendiniz oluşturmak yerine shipmentTrackingUrl alanını kullanın.
Siparişin genel akışı için Çiçeksepeti sipariş akışı ve iptal sayfasına bakın.
Sık sorulanlar
Çiçeksepeti siparişinde takip numarası hangi alanda?
cargoNumber alanında; takip bağlantısı shipmentTrackingUrl, kargo firması cargoCompany alanında gelir. Kargoya Verilecek aşamasında bu alanlar boş olabilir.
Paneldeki "Kargo No" API'de nerede?
Sipariş numarası ile partialNumber alanının birleşimidir, örneğin 123456789-10. partialNumber yalnız parça kısmını içeriyorsa başına sipariş numarasını ekleyin.
Çiçeksepeti'ne kargo takip numarası API ile gönderilir mi?
Böyle bir servisi resmî dokümandan doğrulayamadık. Kargoya verme adımını satıcı panelinden yönetin ya da güncel API dokümanınızı kontrol edin.
Takip kodu ne zaman atanır?
Kargoya Verilecek aşamasında cargoNumber çoğunlukla boştur. Paket kargo sürecine girip takip kodu atandığında alan dolar; sipariş listesini düzenli okuyarak bu değişikliği yakalarsınız.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı