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

İadesi Oluşturulan Siparişleri Çekme

9 Nisan 2021 itibariyle endpoint değişikliği yapılacaktır. İki endpoint de şuanda kullanılabilir durumdadır. 9 Nisan 2021 itibariyle eski endpoint geçersiz olacaktır.

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

  • GET getClaims

Eski Endpoint: https://api.trendyol.com/sapigw/suppliers/{supplierId}/claims?claimItemStatus= (Aktif durumdadır. 9 Nisan 2021'de kaldırılacaktır)

Yeni Endpoint : https://api.trendyol.com/integration/oms/instant/suppliers/{supplierid}/claims?claimItemStatus= (Aktif durumdadır.)

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

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

NOT 3: Yeni oluşmuş paketleri çekmek için Accepted 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.

Parametre Açıklama Tip
claimIds Tekil veya çoğul olarak ilgili iade paketlerinin detaylarına ulaşabilirsiniz. string
claimItemStatus İade paketinin kargo kodudur. 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,
            "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": [
                            {
                                "id": 29815493,
                                "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": [
                            {
                                "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": "Created"
                            },
                            "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.