İ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.

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: 31 Ekim tarihinden itibaren isteyen satıcılar iade değişim sürecini kullanabilecektir. Response içerisinde "replacementOutboundpackageinfo" alanından değişim paket bilgileri dönecektir.

NOT: Claim issue servisinden "2101" (Sipariş sorusundan gelen değişim talebi (müşterinin talebi yoksa kullanılmamalı) reasonId ile iade red edildiği durumda değişim onaylanmış olacaktır.

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,
            "replacementOutboundpackageinfo: //değişim olmadığı durumda boş dönecektir.
            {
                "cargoTrackingNumber":72602420957047272632,
                "cargoProviderName":"Aras Kargo Marketplace",
                "cargoSenderNumber": "733861966410",
                "cargoTrackingLink": "https"://kargotakip.araskargo.com.tr/mainpage.aspx?code=90909090909",
                "packageid": 28717254,      // değişim paket id bilgisidir
                items: [
                    b71461e3-d1a0-4c1d-9a6d-18ecbcb5432d     // claimItem.Id
                 ]"
            "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"
                    },
                    "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"
                    },
                    "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.
returnRejected İadesi reddedilen siparişler için kullanılır.
returnAccepted İadesi kabul edilen siparişler için kullanılır.
Cancelled İadesi iptal edilmiş siparişler için kullanılır.