N11 iade talepleri API: listeleme, onay, erteleme ve red

Servisteki metotlar

Dokümanda erteleme ve red isteklerindeki talep numarası alanı claimReturnlId yazımıyla geçer. İsteği hazırlarken WSDL'deki alan adını esas alın.

Listeleme filtreleri ve durumlar

searchData.status şu değerleri alır: REQUESTED (talep geldi), PENDING (erteleme talep edildi), PENDED (değerlendirme ertelendi), APPROVED (onaylandı), DENIED (reddedildi), CANCELLED (iptal edildi), MANUAL_REFUND (manuel para iadesi tamamlandı) ve ALL. Boş ya da geçersiz değer REQUESTED kabul edilir.

Diğer filtreler: executer (BUYER, SELLER, OPERATOR, SYSTEM, SHIPMENT), searchInfoType ve searchQuery ile alıcı e-postası, teslim alan, alıcı adı, sipariş numarası ya da ürün koduna göre arama, sender (SELLER, N11, ALL) ve searchData.period ile GG/AA/YYYY biçiminde tarih aralığı.

Yanıttaki her talepte claimReturnId, status, returnReasonType ve returnReasonDescription (iade nedeni), orderNumber, productId, productName, quantity, unitPrice, finalPrice, kargo firması ve takip numarası, campaignNumber, sellerCampaignNumber, deliveryFeeType (ByBuyer, BySeller, Conditional) ve alıcı bilgileri bulunur.

Reddetme kuralları

ClaimReturnDeny, ürünün size geri gönderilme biçimini returnShipmentType alanıyla ister. Kurallar red nedenine göre değişir:

• Red nedeni "Ürün Mağazaya Ulaşmadı": returnShipmentType boş bırakılır. Alıcının girdiği takip numarası otomatik gönderilir.
• Diğer nedenler, CUSTOM: Ürünü kendiniz kargoya verdikten sonra trackingNumber alanında takip numarasını gönderirsiniz.
• Diğer nedenler, CAMPAIGN: shipmentCompanyId, trackingNumber ve deliveryReceiptNumber boş bırakılır. Ürünü kampanya koduyla gönderdiğinizde takip kodu sisteme otomatik tanımlanır. Kodu ClaimReturnList yanıtındaki sellerCampaignNumber (Mağaza Gönderi Kampanya No) alanında bulursunuz.

Redde kanıt için imageFirstUrl, imageSecondUrl, imageThirdUrl ve videoUrl alanlarıyla görsel ve video bağlantısı eklenebilir.

İade ile stok ve sipariş ilişkisi

İade talebi sipariş paketinin durumunu değiştirmez. N11'in SOAP ve REST karşılaştırma tablosuna göre iade talep edilen ya da iadesi tamamlanan siparişler REST sipariş servisinde Delivered görünür. Bu yüzden iadeyi sipariş durumundan değil, bu servisten izlemelisiniz.

• Onayladığınız iadede ürün depoya ulaşınca stoğu kendi sisteminizde geri ekleyin ve N11'e yeni adedi gönderin.
• Hasarlı dönen ürünü satılabilir stoğa eklemeyin.
• Erteleme gün sayısını (pendingDayCount) gerçekçi verin; erteleme nedenini ClaimReturnPendingReasonType listesinden seçin.

İadeleri azaltmaya yönelik pratik öneriler için: pazaryerinde iade oranını düşürme.

Sık sorulanlar

İlgili N11 API konuları