İstek alanları ve dosya kuralları
| Alan | Kural |
|---|---|
| claimIssueReasonId | Ret sebebi kimliği; sebep servisinden alınır |
| claimItemIdList | Reddedilecek iade kalemi kimlikleri; virgülle ayrılır |
| description | Serbest metin; en fazla 500 karakter |
| files | form-data dosya alanı; dosya başına en fazla 5 MB |
Desteklenen dosya türleri arasında jpeg, jpg, png, pdf, tiff, doc, docx, mp4 ve quicktime vardır. Şu sebeplerde dosya gerekmez: 1651 (iade paketi tarafıma teslim edilmedi), 451 (ürünü analize alacağım) ve 2101 (sipariş sorusundan gelen değişim talebi). Diğer bütün sebeplerde dosya zorunludur.
1651 sebebi, iade WaitingInAction statüsüne geçtikten sonraki ilk 24 saat içinde seçilemez. Servisin limiti onay servisi gibi dakikada 5 istektir.
Ret sebepleri (8 Ekim 2026 sonrası)
| Kod | Ret sebebi |
|---|---|
| 51 | Ürün olağan dışı kullanılmış ve/veya müşteri kaynaklı hasar görmüş |
| 151 | İade edilen ürünün parçası / aksesuarı eksik |
| 201 | Satılan üründen tamamen farklı bir ürün (yanlış) iade edildi |
| 401 | İade edilen ürün veya adedi eksik |
| 451 | Ürünü analize alacağım |
| 1651 | İade paketi tarafıma teslim edilmedi |
| 1951 | Kurumsal iade faturası iletilmedi veya hatalı |
| 2051 | Ürünün koruyucu ambalajı (hijyen bandı, mühür, paket) açılmış |
| 2077 | Ürün iade edilemeyen kişiselleştirilmiş (özel üretim) statüsünde |
| 2078 | Gelen üründe kusur yok; müşteri memnuniyeti için iadeyi kabul etmek istiyorum |
| 2079 | Ürünü doğru ve sağlam gönderdim; iade edilen ürün eksik, hasarlı ya da farklı ulaştı |
| 2101 | Sipariş sorusundan gelen değişim talebi (müşterinin talebi yoksa kullanılmamalı) |
Trendyol 8 Ekim 2026'da 251, 1701, 1751, 2201, 2001 ve 2151 kodlarını kullanımdan kaldırdı. Bu kodlarla gönderilen istekler hata döner. Güncel liste servisten okunmalıdır; doküman örneğinde 1801, 1851 ve 1901 gibi analiz sonucu sebepleri de yer alır.
Müşteri iade sebepleri ayrı bir listedir
İade çekme yanıtındaki customerClaimItemReason, müşterinin ya da Trendyol'un seçtiği iade sebebidir ve ret sebeplerinden farklı bir listedir. Aynı numara iki listede farklı anlama gelebilir. Örneğin 401 müşteri listesinde "Vazgeçtim", ret listesinde "İade edilen ürün veya adedi eksik" anlamındadır.
| Kod | Müşteri iade sebebi |
|---|---|
| 251 | Modelini beğenmedim |
| 301 | Kusurlu ürün gönderildi |
| 351 | Yanlış ürün gönderildi |
| 401 | Vazgeçtim |
| 501 / 551 | Bedeni küçük geldi / büyük geldi |
| 651 | Ürün belirtilen özelliklere sahip değil |
| 701 | Yanlış sipariş verdim |
| 1651 | Kalitesini beğenmedim |
| 2043 | Ürünümün parçası/aksesuarı eksik gönderildi |
İki listeyi kodunuzda ayrı tablolarda tutun. Müşteri sebeplerini iade analizinde, ret sebeplerini yalnız createClaimIssue isteğinde kullanın. İade oranını düşürme yolları için pazaryerinde iade oranını düşürme yazısına bakabilirsiniz.
Sık sorulanlar
Trendyol iadesini API ile nasıl reddederim?
POST /integration/order/sellers/{sellerId}/claims/{claimId}/issue servisine claimIssueReasonId, claimItemIdList ve description gönderin; gerekli sebeplerde kanıt dosyasını form-data ile ekleyin.
Ret talebinde dosya zorunlu mu?
1651, 451 ve 2101 sebepleri dışında dosya zorunludur. Dosya başına sınır 5 MB'tır.
Ret sebebi kodlarını nereden alırım?
GET /integration/order/claim-issue-reasons servisinden. Liste Ekim 2026'da güncellendi; eski kodları sabit yazmak yerine servisten okuyun.
Hangi iadelere ret açılabilir?
Yalnız WaitingInAction statüsündeki, ürünü deponuza ulaşmış iadelere ret talebi açılabilir.
customerClaimItemReason ile ret sebebi aynı şey mi?
Hayır. customerClaimItemReason müşterinin ya da Trendyol'un iade sebebidir. Ret sebepleri ayrı bir listedir ve aynı numaralar farklı anlam taşıyabilir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı