Yanıt alanları
Servis supplierAddresses listesiyle birlikte varsayılan sevkiyat ve fatura adreslerini ayrı nesneler olarak döner (defaultShipmentAddress, defaultInvoiceAddress).
| Alan | Açıklama |
|---|---|
| id | Adres kimliği; ürün isteklerinde kullanılır |
| addressType | Shipment (sevkiyat), Invoice (fatura) ya da Returning (iade) |
| isShipmentAddress / isInvoiceAddress / isReturningAddress | Adresin hangi amaçlarla kullanıldığı |
| isDefault | Varsayılan adres mi |
| country, city, cityCode, district, districtId, postCode | Konum bilgileri |
| address / fullAddress | Açık adres ve tam adres metni |
Adres kimlikleri nerede kullanılır?
| Kullanım | Alan | Servis |
|---|---|---|
| Ürünün çıkış deposu | shipmentAddressId | Ürün yaratma v2, onaylı varyant güncelleme |
| Ürünün iade deposu | returningAddressId | Ürün yaratma v2, onaylı varyant güncelleme |
| Fatura bilgisi | defaultInvoiceAddress | Muhasebe eşleştirmesi için okunur |
İki alan da ürün isteklerinde isteğe bağlıdır. Gönderilmezse varsayılan adresleriniz geçerli olur. Birden çok deposu olan satıcılar her ürünü doğru depoya bağlamak için bu kimlikleri kullanır.
Kullanım kuralları
- Satıcı başvuru süreciniz tamamlanmadıysa servisi kullanmayın. Doküman bunu açıkça belirtir.
- Adresler sık değişmez. Yanıtı saklayın ve yalnız panelde adres değiştirdiğinizde yeniden çekin.
- Eski limit tablosunda bu servis için saatte 1 istek sınırı vardı. 14 Eylül 2026'dan beri Product Integration Read grubundadır; yine de gereksiz çağrıdan kaçının.
- Yurt dışı storefront'larda satış yapıyorsanız storeFrontCode başlığıyla ilgili ülkenin adreslerini isteyin.
- Yeni bir depo eklediğinizde önce satıcı panelinde tanımlayın; servis yalnız panelde kayıtlı adresleri döner.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Ürün yanlış depodan çıkıyor | shipmentAddressId gönderilmedi ya da eski kimlik | Güncel adres listesinden doğru id'yi seçin |
| İadeler yanlış adrese gidiyor | returningAddressId eksik | Varyant güncellemesiyle iade adresini atayın |
| Servis 429 dönüyor | Sık çağrı | Yanıtı önbelleğe alın |
| Liste boş ya da eksik | Başvuru süreci tamamlanmamış ya da storefront farklı | Başvuruyu tamamlayın, storeFrontCode değerini kontrol edin |
Adreslerin sipariş tarafındaki karşılığı farklıdır: müşterinin teslimat ve fatura adresi sipariş paketindeki shipmentAddress ve invoiceAddress alanlarında gelir. Bu servis yalnız satıcının kendi adreslerini verir.
Örnek: iki depolu satıcı
İstanbul ve İzmir'de iki deposu olan bir satıcı düşünelim. Satıcı panelinde iki sevkiyat adresi ve bir iade adresi tanımlıdır. Adres servisini bir kez çağırır ve yanıtı saklar.
- İstanbul deposu: addressType Shipment, id: 1001 (örnek değer)
- İzmir deposu: addressType Shipment, id: 1002 (örnek değer)
- İade deposu: addressType Returning, id: 1003 (örnek değer)
İzmir'den çıkacak ürünleri yüklerken shipmentAddressId: 1002 ve returningAddressId: 1003 gönderir. Zaten yayında olan bir ürünü depo değiştirmek için onaylı varyant güncelleme servisine barkodla birlikte yeni shipmentAddressId değerini yollar. Böylece kargo, siparişi doğru depodan teslim alır.
Sık sorulanlar
shipmentAddressId nereden alınır?
GET /integration/sellers/{sellerId}/addresses yanıtındaki sevkiyat adresinin id değeridir. Ürün yaratma ve varyant güncelleme isteklerinde kullanılır.
Adres kimliklerini göndermek zorunlu mu?
Hayır. Ürün isteklerinde isteğe bağlıdır. Gönderilmezse varsayılan sevkiyat ve iade adresleriniz kullanılır.
Bu servis müşteri adreslerini verir mi?
Hayır. Yalnız satıcının sevkiyat, fatura ve iade adreslerini verir. Müşteri adresi sipariş paketlerini çekme servisinden gelir.
Servisi ne sıklıkla çağırmalıyım?
Yalnız adresleriniz değiştiğinde. Yanıtı saklamak yeterlidir; servis eskiden saatte bir istekle sınırlıydı.
Yayındaki ürünün çıkış deposunu değiştirebilir miyim?
Evet. Onaylı varyant güncelleme servisi (variant-bulk-update) shipmentAddressId ve returningAddressId alanlarını kabul eder. Barkodla birlikte yeni kimliği gönderin.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı