İadesi Oluşturulan Siparişleri Çekme (getClaims)

İadesi Oluşturulan Siparişleri Çekme

Trendyol sisteminde iadesi oluşan siparişleri bu metod yardımıyla çekebilirsiniz.

İade red paketi bilgileri response içerisine rejectedpackageinfo alanına eklenmiştir.

25 Ekim 2021 Pazartesi tarihinden itibaren Trendyol İade Siparişleri Çekme servisinde yer alan items.orderLine.lineItems alanı kaldırılacaktır. İade statülerini şu anda da mevcut olan items.claimItems.claimItemStatus alanından kontrol edebilirsiniz. 

Iade servislerinde statüsü güncellenen iade paketleriniz servis üzerinden tarafınıza lastModifiedDate sırasına göre dönecektir.

  • GET getShipmentPackages

https://api.trendyol.com/sapigw/suppliers/{supplierid}/claims?claimItemStatus=

NOT 1: suppliers/{supplierid}/claims?claimItemStatus=Created gibi bir query ile de paket statülerine göre sorgulama yapılabilir.

NOT 2: Kullanılabilinecek statüler: Created, WaitingInAction, Accepted, Cancelled, Rejected, Unresolved, InAnalysis

NOT 3: Yeni oluşmuş paketleri çekmek için Created olarak sorgulama yapılmalıdır.

NOT 4: claimDate bilgisi sizlere Timestamp (milliseconds) GMT formatında iletilmektedir. Tarih bilgisini satıcı paneli ile eşlemek için GMT+3 olarak işlem yapmanız gereklidir.

NOT 5: Müşterinin iade talebi reddedildiyse ve geri gönderilmek üzere iade red paketi oluşmuş ise paket bilgileri "rejectedpackageinfo" alanından tarafınıza dönecektir. Iade red paketi yok ise bu alan görünmeyecektir.

NOT 6: rejectedpackageinfo.packageId bilgisi iade red paketine ait id bilgisidir. Bu Id bilgisini kullanarak kendi kargo anlaşmanız (Kendi kargo kodlarınız) ile çıkış yaparak kargo kodu besleme servisinden tarafımıza bildirebilirsiniz.

NOT 7: rejectedpackageinfo.cargoTrackingLink iade kargo paketi yola çıktığında dönmektedir. Kendi kargo anlaşmasıyla çalışan satıcılar kargo sürecini bu alandan kontrol edebilir.

Parametre Açıklama Tip
claimIds Tekil veya çoğul olarak ilgili iade paketlerinin detaylarına ulaşabilirsiniz. string
claimItemStatus İade itemin statüsüdür. string
endDate İade paketinin oluşturulma tarihine göre çalışır. integer
startDate İade paketinin oluşturulma tarihine göre çalışır. integer
orderNumber İade paketinin sipariş numarasıdır. string
size Bir sayfada listelenecek maksimum adeti belirtir. integer
page Sadece belirtilen sayfadaki bilgileri döndürür. integer

NOT: claimIds parametresi verildiği zaman diğer tüm parametreler işleme alınmayarak sadece ilgili claimId'ye ait değerler dönecektir.

NOT: "orderShipmentPackageId" değeri iade paketinin id değeridir.

Örnek Servis Cevabı

{
    "totalElements": 2099,
    "totalPages": 2099,
    "page": 0,
    "size": 1,
    "content": [
        {
            "id": "f9da2317-876b-4b86-b8f7-0535c3b65731",  ~~   claimId   ~~
            "orderNumber": "65745805",
            "orderDate": 1524826343886,
            "customerFirstName": "Trendyol",
            "customerLastName": "Müşterisi",
            "claimDate": 1525844162827,
            "cargoTrackingNumber": 72602420957047272632,
            "cargoTrackingLink": "https://kargotakip.araskargo.com.tr/mainpage.aspx?code=90909090909",
            "cargoSenderNumber": "8106459254413",
            "cargoProviderName": "Aras Kargo Marketplace",
            "orderShipmentPackageId": 3853354,
            "rejectedpackageinfo: 
            {
                "cargoTrackingNumber":72602420957047272632,
                "cargoProviderName":"Aras Kargo Marketplace",
                "cargoTrackingLink": "https://kargotakip.araskargo.com.tr/mainpage.aspx?code=90909090909",
                "packageid": 28717254,      // reddedilen iade paket id bilgisidir
                items: [
                    b71461e3-d1a0-4c1d-9a6d-18ecbcb5432d     // claimItem.Id
    ]
    },
            "items": [
                {
                    "orderLine": {
                        "id": 28717254,
                        "productName": "Erkek Bebek Sandalet 8S5280Z1/GREEN CS4, 21",
                        "barcode": "99999999999",
                        "merchantSku": "2083667",
                        "productColor": "GREEN CS4",
                        "productSize": " 21",
                        "price": 12.95,
                        "vatBaseAmount": 8,
                        "salesCampaignId": 183631,
                        "productCategory": "Sandalet",
                        "lineItems": [.    // 25 Ekim 2021 'de bu alan kaldırılacaktır.
                            { 
                               "id": 29815494, 
                               "lineItemStatus": { 
                                   "name": "UnDelivered" 
                               } 
                           } 
                         ]
                    },
                    "claimItems": [
                        {
                            "id": "b71461e3-d1a0-4c1d-9a6d-18ecbcb5158c",  ~~   claimLineItemIdList   ~~
                            "orderLineItemId": 29815493,
                            "customerClaimItemReason": {
                                "id":"451",  ~~   claimIssueReasonId    ~~
                                "name": "Diğer",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "trendyolClaimItemReason": {
                                "id":"451",
                                "name": "Diğer",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "claimItemStatus": {
                                "name": "Created"
                            },
                            "note": "",
                            "customerNote":"Müşteri notu",
                            "resolved": false
                        }
                    ]
                },
                {
                    "orderLine": {
                        "id": 28717255,
                        "productName": "Erkek Bebek Soket Çorap 4'lü 8S7346Z1/MIX YARN DYED K00, 6-12 Ay",
                        "barcode": "99999999999",
                        "merchantSku": "2052551",
                        "productColor": "MIX YARN DYED K00",
                        "productSize": " 17-18 (6-12 Ay)",
                        "price": 9.95,
                        "vatBaseAmount": 8,
                        "salesCampaignId": 183631,
                        "productCategory": "Çorap",
                        "lineItems": [.    // 25 Ekim 2021 'de bu alan kaldırılacaktır.
                            { 
                               "id": 29815494, 
                               "lineItemStatus": { 
                                   "name": "UnDelivered" 
                               } 
                           } 
                         ]
                    },
                    "claimItems": [
                        {
                            "id": "b71461e3-d1a0-4c1d-9a6d-18ecbcb5432d",   ~~   claimLineItemIdList   ~~
                            "orderLineItemId": 29815494,
                            "customerClaimItemReason": {
                                "id":"451",
                                "name": "Diğer",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "trendyolClaimItemReason": {
                                "id":"451",
                                "name": "Diğer",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "claimItemStatus": {
                                "name": "Rejected"
                            },
                            "note": "",
                            "customerNote":"Müşteri notu",
                            "resolved": false
                        }
                    ]
                }
            ]
        }
    ]
}
Servis Açıklama
Created İadesi oluşan siparişlerin ilk statüsüdür. Bu aşamada müşteri iade butonuna bastığı zaman oluşmaktadır.
WaitingInAction İadesi oluşturalan sipariş tedarikçimize ulaştığı zaman bu statür dönmektedir.
Unresolved İhtilaflı statüsündeki iade siparişleridir. Sorun bildir işlemi yapıldıktan sonra sipariş ihtilaflı statüsüne geçmektedir.
Rejected İadesi reddedilen siparişler için kullanılır.
Cancelled Müşterimiz tarafından iade talebi oluşturulduğu halde 7 gün içinde iade edilmeyen siparişlere bu statü dönmektedir.
Accepted İadesi kabul edilen siparişler için kullanılır.
InAnalysis İadesi analizde olan siparişler için kullanılır.