Picking Returned Orders (getClaims)

Picking Returned Orders

You can get orders with Trendyol system with this method.

As of Monday, October 25, 2021, the items.orderLine.lineItems field in the getClaims service will be removed. You can check the return status from the currently available items.claimItems.claimItemStatus.

  • GET getShipmentPackages

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

NOTE 1: You can request with like that kind of query suppliers/{supplierid}/claims?claimItemStatus=Created

NOTE 2: Using status: Created, WaitingInAction, Accepted, Cancelled, Rejected, Unresolved, InAnalysis

NOTE 3: If you want to get your new orders, you have to request wih Created status.

NOTE 4: The claimDate information is sent to you in Timestamp (milliseconds) GMT format. To match the date information with the supplier panel, you need to process as GMT + 3.

NOTE 5: If the customer's return request is rejected and a return rejection package has been created to be sent back, the package information will be returned to you from the "rejectedpackageinfo" field. If there is no return rejection package, this field will not appear

NOTE 6: The rejectedpackageinfo.packageId information is the id of the returned rejection package. By using this Id information, you can send with your own cargo agreement (your own cargo codes) and notify us from the Shipping code update service.

NOTE 7: rejectedpackageinfo.cargoTrackingLink returns the reject claim cargo package when it is shipped. Sellers working with their own cargo agreement can control the cargo process from this field.

Parameter Definiton Type
claimIds See the details of the respective claim packages, singular or plural. string
claimItemStatus It is the shipping code of the claim package. string
endDate It works according to the creation date of the claim package. integer
startDate It works according to the creation date of the claim package. integer
orderNumber The order number of the claim package. string
size Specifies the maximum number of items to be listed on a page. integer
page Returns only information on the specified page. integer

NOTE : When the claimIds parameter is given, all other parameters are not processed and only the values of the respective claimId will be returned.

NOTE : The "orderShipmentPackageId" value is the id value of the return package.

Example of Service Response

{
    "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,      //rejected return package id
                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": [.    // It will be removed on October 25, 2021.
                            { 
                               "id": 29815494, 
                               "lineItemStatus": { 
                                   "name": "UnDelivered" 
                               } 
                           } 
                         ]
                    },
                    "claimItems": [
                        {
                            "id": "b71461e3-d1a0-4c1d-9a6d-18ecbcb5158c",  ~~   claimLineItemIdList   ~~
                            "orderLineItemId": 29815493,
                            "customerClaimItemReason": {
                                "name": "Beden uymama",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "trendyolClaimItemReason": {
                                "name": "Beden uymama",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "claimItemStatus": {
                                "name": "Created"
                            },
                            "note": "",
                            "customerNote":"Customer note",
                            "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": [.    // It will be removed on October 25, 2021.
                            { 
                               "id": 29815494, 
                               "lineItemStatus": { 
                                   "name": "UnDelivered" 
                               } 
                           } 
                         ]
                    },
                    "claimItems": [
                        {
                            "id": "b71461e3-d1a0-4c1d-9a6d-18ecbcb5432d",   ~~   claimLineItemIdList   ~~
                            "orderLineItemId": 29815494,
                            "customerClaimItemReason": {
                                "name": "Beden uymama",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "trendyolClaimItemReason": {
                                "name": "Beden uymama",
                                "externalReasonId": 23,
                                "code": "UNFIT"
                            },
                            "claimItemStatus": {
                                "name": "Created"
                            },
                            "note": "",
                            "customerNote":"Customer note",
                            "resolved": false
                        }
                    ]
                }
            ]
        }
    ]
}
Service Definition
Created The first status of the orders returns. This occurs when the customer presses the return button.
WaitingInAction This statu returns when the returned orders reaches the supplier.
ReturnAccepted It returns when the return orders approved.
Unresolved Return orders in disputed status. After the process of reporting a problem, the order becomes a disputed status.
Rejected Return is used for rejected orders.
Cancelled This status is returned to the orders that are not returned within 7 days even though the return request is created by our customer.
Accepted It is used for orders accepted for returns.
InAnalysis It is used for orders with a refund.