İade servisleri
| İşlem | Yöntem ve yol |
|---|---|
| İade listesi | GET /oms/{vendorId}/claim-list |
| Teslim alındı bildirimi | POST /oms/{vendorId}/{claimId}/claim-delivered-to-vendor |
| Onay | POST /oms/{vendorId}/{claimId}/claim-approve |
| Ret talebi | POST /oms/{vendorId}/{claimId}/claim-decline-request |
| Ret sebepleri | GET /oms/claim-decline-reasons |
| İade sebepleri | GET /oms/{vendorId}/claim-reasons |
| İade oluşturma | POST /oms/{vendorId}/claim-create |
claim-list filtreleri ids, orderNumber, claimReason, startDate, endDate ve lastUpdatedAt'tir. Tarihler sipariş listesindeki gibi 2022/09/30 23:59:59 biçimindedir.
İade statüleri
| Statü | Anlamı |
|---|---|
| ready | Müşteri iade düğmesine bastı; iadenin ilk statüsü |
| in_cargo | Müşteri ürünü kargoya verdi |
| waiting_vendor_approve | Ürün deponuza ulaştı; onay ya da ret bekleniyor |
| approved | İade onaylandı |
| decline | İade reddedildi |
| vendor_decline_request | Ret talebi açtınız; idefix sebebi inceliyor |
Statü kalem seviyesindeki state alanında, Türkçe karşılığı stateName alanında gelir; örneğin approved için İade onaylandı.
Adım adım iade işleme
- claim-list ile talepleri çekin. Üst seviyedeki id iade talebinin claimId'sidir; items[].id ise talebin kalemleridir (claimLineIds).
- Ürün deponuza gelince claim-delivered-to-vendor'a claimLineIds gönderin. Doküman, claim-create ile açtığınız iadelerde onay ya da retten önce bu adımı ister.
- Ürün sağlamsa claim-approve'a claimLineIds gönderin; örnek gövde: claimLineIds: [ 13, 14 ].
- Sorun varsa claim-decline-request'e claimLines gönderin: her satırda id, claimDeclineReasonId, description ve images.
- Ret sebep ID'lerini claim-decline-reasons servisinden alın; claim-reasons listesi müşteri ve platform iade sebepleri içindir.
Ret doğrudan sonuçlanmaz: kalem vendor_decline_request statüsüne geçer ve idefix sebebi kontrol eder. Görsel eklemek ret talebinizi güçlendirir. Pazaryeri iadelerinin genel düzeni için pazaryeri iade yönetimi rehberine bakabilirsiniz.
Yanıttaki dikkat edilecek alanlar
| Alan | Anlamı |
|---|---|
| customerReason, customerReasonId | Müşterinin seçtiği iade sebebi |
| vendorReason, vendorNote | Satıcının sebebi ve notu |
| platformReason | Platformun sebebi |
| cargoKey, cargoTrackingNumber | İade gönderisinin kargo bilgisi |
| orderLineId | İadenin bağlı olduğu sipariş kalemi |
| autoApproveDate, isAutoApprove | Otomatik onayla ilgili alanlar |
| isControversial | İhtilaf bilgisi |
autoApproveDate, isAutoApprove ve isControversial alanlarının kuralları dokümanda ayrıca açıklanmaz. Adları, belirli bir tarihten sonra otomatik onay olabileceğini düşündürür; iadeleri bu tarihten önce incelemek güvenli yoldur. Kesin kuralı idefix'e sorun.
Sık hatalar ve çözümleri
- claimId ile claimLineId'yi karıştırmak: yol claimId, gövde kalem ID'leri ister.
- Ret sebebini claim-reasons'tan almak: doğrusu claim-decline-reasons servisidir.
- Teslim alındı bildirmeden onay ya da ret denemek: özellikle claim-create ile açılan iadelerde önce teslim bildirimi yapılır.
- İade kodu olmadan gelen ürünü kayıtsız bırakmak: claim-create ile customerId, orderNumber, vendorCargoCompanyId, reasonId ve orderLineId göndererek iade açın.
- Onaylanan iadede stoğu artırmayı unutmak: ürün satılabilir durumdaysa kendi stok kaydınızı güncelleyin.
Sık sorulanlar
idefix iade talepleri API ile çekilebilir mi?
Evet. GET /oms/{vendorId}/claim-list servisi iade talebi oluşan sevkiyatları kalemleri, sebepleri ve statüleriyle döndürür.
İadeyi onaylamak için hangi bilgiler gerekir?
İade talebinin claimId'si (yolda) ve onaylanacak kalemlerin claimLineIds listesi (gövdede). İkisi de claim-list yanıtında bulunur.
idefix'te iadeyi reddedebilir miyim?
Doğrudan değil. claim-decline-request ile ret talebi açarsınız; kalem vendor_decline_request statüsüne geçer ve sebebi idefix kontrol eder.
İade kodu olmadan gelen ürün için ne yapılır?
POST /oms/{vendorId}/claim-create ile iade kaydı oluşturulur. Müşteri ID'si, sipariş numarası, kargo firması, sebep ve sipariş kalemi ID'si gerekir.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı