Parametreler
| Parametre | Açıklama |
|---|---|
| claimItemStatus | İade kaleminin statüsü; tablodaki değerlerden biri |
| startDate / endDate | Milisaniye; iadenin lastModifiedDate tarihine göre çalışır |
| orderNumber | Siparişin numarası |
| claimIds | Tekil ya da çoğul iade kimliği; verilirse diğer parametreler dikkate alınmaz |
| page / size | Sayfalama; API referansında size varsayılanı 50, en fazla 200 |
Sonuçlar lastModifiedDate sırasıyla döner. claimDate alanı GMT olarak milisaniye cinsinden gelir; satıcı paneliyle eşleştirmek için GMT+3'e çevirin.
İade statüleri
| Statü | Anlamı |
|---|---|
| Created | Müşteri iade butonuna bastı; iadenin ilk statüsü |
| WaitingInAction | İade ürünü satıcıya ulaştı; onay ya da ret bekliyor |
| WaitingFraudCheck | Onaylanan iade fraud kontrolünde (askıdaki iadeler) |
| Accepted | İade kabul edildi |
| Rejected | İade reddedildi |
| Unresolved | Sorun bildirildi; iade ihtilaflı |
| Cancelled | İade iptal edildi |
| InAnalysis | İade analizde |
Onay ve ret işlemleri yalnız WaitingInAction statüsündeki iadelerde yapılabilir. Bu yüzden günlük iş akışınızın merkezinde WaitingInAction sorgusu olmalıdır.
Yanıtta neler var?
Her iade kaydı sipariş numarası, sipariş ve iade tarihi, müşteri adı, kargo bilgileri ve kalemlerden oluşur. orderShipmentPackageId iade paketinin kimliğidir. items dizisinde her eleman bir sipariş kalemini (orderLine: ürün adı, barkod, satıcı stok kodu, fiyat) ve o kaleme ait iade kalemlerini (claimItems) taşır.
Her iade kaleminde kendi kimliği, statüsü, müşterinin iade sebebi (customerClaimItemReason), varsa Trendyol'un sebebi (trendyolClaimItemReason) ve müşteri notu bulunur. Onay ve ret isteklerinde kullanılan kimlikler bu iade kalemi kimlikleridir.
Müşterinin iade talebi reddedilip ürün geri gönderilecekse red paketinin bilgisi rejectedpackageinfo alanında gelir. Bu alan yalnız red paketi oluştuğunda görünür. rejectedpackageinfo.packageId ile kendi kargo anlaşmanızla gönderim yapabilir, rejectedpackageinfo.cargoTrackingLink ile kargoyu izleyebilirsiniz.
Audit servisi: iade kaleminin geçmişi
GET .../claims/items/{claimItemsId}/audit servisi bir iade kaleminin statü geçişlerini, değişiklik tarihini, işlemin yapıldığı platformu ve işlemi yapan kişiyi döndürür. İşlem entegrasyonla yapıldıysa executorApp alanında SellerIntegrationApi, satıcı panelinden yapıldıysa Seller Center Orders BFF yazar. Bunların dışındaki kayıtlar sizin tarafınızdan yapılmamış işlemlerdir.
Audit verisi iade yanıt sürenizi ölçmek için de kullanılabilir: kalemin WaitingInAction statüsüne geçtiği an ile Accepted, Rejected ya da Unresolved statüsüne geçtiği an arasındaki süre satıcının karar süresidir.
İade çekme ve audit servislerinin limiti dakikada 1000 istektir. Onay ve ret servislerinin limiti ise yalnız dakikada 5 istektir.
Sık sorulanlar
Trendyol'da yeni iadeleri nasıl çekerim?
GET /integration/order/sellers/{sellerId}/claims servisini claimItemStatus=Created ile çağırın. Depoya ulaşan ve karar bekleyenler için WaitingInAction sorgulanır.
İade tarihleri neden panelden farklı görünüyor?
claimDate GMT olarak gelir. Satıcı paneliyle eşleştirmek için 3 saat ekleyerek GMT+3'e çevirmeniz gerekir.
Bir iadeyi kimin onayladığını nasıl görürüm?
İade kaleminin audit servisini çağırın. executorApp alanı işlemin entegrasyondan mı panelden mi yapıldığını, executorUser alanı işlemi yapan kullanıcıyı gösterir.
claimIds parametresi verince diğer filtreler çalışır mı?
Hayır. claimIds verildiğinde diğer parametreler işleme alınmaz; yalnız ilgili iade kimliklerinin bilgileri döner.
Reddedilen iadenin ürünü müşteriye nasıl geri gönderilir?
Red paketi oluştuysa iade kaydındaki rejectedpackageinfo alanında paket kimliği ve kargo takip linki gelir. Kendi kargo anlaşmanızla bu paket kimliği üzerinden gönderim yapabilirsiniz.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı