Kargo firmasını değiştirmek
Gövde tek alan taşır: cargoProvider. Kabul edilen değerler YKMP, ARASMP, SURATMP, HOROZMP, DHLECOMMP, PTTMP, CEVAMP, TEXMP ve KOLAYGELSINMP'dir. Kodların firma karşılıkları kargo firmaları sayfasındadır.
- Bir paket için 5 dakika içinde yalnız bir değişiklik yapılabilir.
- Değişiklikten sonra paketi sipariş servisinden yeniden çekip yeni kargo bilgisini doğrulayın.
- TEX'e çevirme istekleri, satıcının TEX kotası dolmuşsa geçersiz olur.
- Etiketi kargo değişikliği işlendikten sonra alın. Değişiklik isteği ile etiket talebini aynı anda göndermeyin.
Kargo değişikliği çoğunlukla bir kargo firmasının bölgede hizmet veremediği, kotasının dolduğu ya da paketin ölçüsüne uygun olmadığı durumlarda gerekir. Değişikliği paketi kargoya vermeden önce yapın; kargoya verilmiş bir paketin taşıyıcısını değiştirmeye çalışmak süreci karıştırır.
Desi ve koli bildirimi
PUT .../shipment-packages/{packageId}/box-info servisi bazı kargo firmalarındaki paketler için desi (deci) ve koli sayısı (boxQuantity) bildirir. Kılavuz sayfası servisi Horoz ve CEVA Lojistik için tanımlar ve bu firmalarda iki alanın zorunlu olduğunu belirtir. API referansındaki özet ise UPS Kargo ve CEVA Lojistik yazar; kullanmadan önce kargo firmanızın kapsamda olduğunu güncel dokümanla doğrulayın.
Doğru desi, kargo faturasının doğru çıkması için önemlidir. Desi hesabını desi hesaplama aracıyla kontrol edebilirsiniz.
Ek tedarik süresi tanımlama
PUT .../shipment-packages/{packageId}/extended-agreed-delivery-date servisi paket için ek tedarik süresi tanımlar. Gövde tek alan taşır: extendedDayCount; değeri 1, 2 ya da 3 olabilir.
Paketin uzatmaya uygun olup olmadığını sipariş paketindeki alanlardan okuyun:
| Alan | Açıklama |
|---|---|
| agreedDeliveryDate | Paket için kararlaştırılan teslim tarihi |
| agreedDeliveryDateExtendible | Sürenin uzatılabilir olup olmadığı |
| agreedDeliveryExtensionStartDate / EndDate | Uzatmaya ilişkin başlangıç ve bitiş zamanları |
| extendedAgreedDeliveryDate | Uzatılmış teslim tarihi |
API referansı bu alanları paket şemasında listeler ama ayrıntılı açıklama vermez. Uzatma isteğinden önce agreedDeliveryDateExtendible değerini, istekten sonra extendedAgreedDeliveryDate değerini okuyarak işlemin uygulandığını doğrulayın.
Ek süre, ürünü gerçekten gönderebilecekseniz kullanılmalıdır. Hiç gönderemeyecekseniz tedarik edememe bildirimi, bir kısmını sonra gönderecekseniz paket bölme daha doğru seçenektir.
Limitler ve sık hatalar
| Servis | 50.000 ve 75.000 | 150.000 | 500.000 ve limitsiz |
|---|---|---|---|
| Kargo firması değiştirme | 100/dk | 200/dk | Limit yok |
| Desi ve koli bildirimi | 100/dk | 200/dk | Limit yok |
| Ek tedarik süresi | 100/dk | 200/dk | Limit yok |
Sık görülen sorunlar: 5 dakika dolmadan ikinci kargo değişikliği denemek, kod yerine firma adı göndermek, extendedDayCount'a 3'ten büyük değer yazmak ve süre uzatılamaz paket için istek atmak. Her istekten sonra paketi yeniden okumak, değişikliğin işlendiğini görmenin en güvenli yoludur.
Sık sorulanlar
Trendyol'da paketin kargo firması nasıl değiştirilir?
PUT .../shipment-packages/{packageId}/cargo-providers servisine cargoProvider alanında yeni firmanın kodunu (örneğin YKMP) gönderin. Değişiklikten sonra paketi yeniden çekip kontrol edin.
Kargo firmasını kaç kez değiştirebilirim?
Bir paket için 5 dakika içinde yalnız bir kez değişiklik yapılabilir.
Ek tedarik süresi kaç gün olabilir?
extendedDayCount alanı 1, 2 ya da 3 değerini alır. Paketin uzatmaya uygun olduğunu agreedDeliveryDateExtendible alanından kontrol edin.
TEX'e geçiş neden reddedildi?
Doküman, satıcının TEX kotası dolduğunda TEX olarak gönderilen kargo değişikliği isteklerinin geçersiz olacağını belirtir.
Desi ve koli bilgisini her kargo firması için göndermeli miyim?
Hayır. box-info servisi belirli kargo firmaları için tanımlanmıştır. Kılavuz Horoz ve CEVA Lojistik için boxQuantity ve deci alanlarını zorunlu tutar; firmanızın kapsamını güncel dokümanda kontrol edin.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı