2. Getting Returned Orders

You can get returned orders with Trendyol system with this method.

  • You need to send "storeFrontCode" as Header Parameter.
  • Your packages, whose status is updated in return services, will be returned to you in the order of lastModifiedDate.
  • If you want to get your new orders, you have to request wih Accepted status.
  • 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.

GET getClaimPackages

Service Statu

ServiceDefinition
AcceptedIt returns when the return orders approved.

Service Parameters

  • When the claimIds parameter is given, all other parameters are not processed and only the values of the respective claimId will be returned.
  • The "orderShipmentPackageId" value is the id value of the return package.
ParameterDefinitonType
claimIdsSee the details of the respective claim packages, singular or plural.string
claimItemStatusIt is the shipping code of the claim package.string
endDateIt works according to the creation date of the claim package.integer
startDateIt works according to the creation date of the claim package.integer
orderNumberThe order number of the claim package.string
sizeSpecifies the maximum number of items to be listed on a page.integer
pageReturns only information on the specified page.integer

Sample Service Response

{
    "totalElements": 1,
    "totalPages": 1,
    "page": 0,
    "size": 1,
    "content": [
        {
            "id": "47111d10-6c8e-41bf-ac66-2a295fe75a55", //claimId
            "claimId": "47111d10-6c8e-41bf-ac66-2a295fe75a55",
            "orderNumber": "8523345234",
            "orderDate": 1708585439316,
            "customerFirstName": "Erhan",
            "customerLastName": "Harmankaya",
            "claimDate": 1710497520503,
            "cargoProviderName": "",
            "orderShipmentPackageId": 2061131651,
            "items": [
                {
                    "orderLine": {
                        "id": 2913115089,
                        "productName": "Leopar T-Shirt",
                        "barcode": "BRCD52",
                        "merchantSku": "STCK52",
                        "productColor": "Weiß",
                        "productSize": "2XL",
                        "price": 29.99,
                        "vatBaseAmount": 10,
                        "vatRate": 10,
                        "salesCampaignId": 61,
                        "productCategory": "T-Shirt",
                        "lineItems": null
                    },
                    "claimItems": [
                        {
                            "id": "412fcefe-101f-4880-839a-a1ed1aa16e2b",  // claimItem.Id
                            "orderLineItemId": 3115518273,
                            "customerClaimItemReason": {
                                "id": 2039,
                                "name": "Satıcı Talebi İle İade",
                                "externalReasonId": 2039,
                                "code": "SELLERREQUEST"
                            },
                            "trendyolClaimItemReason": {
                                "id": 2039,
                                "name": "Satıcı Talebi İle İade",
                                "externalReasonId": 2039,
                                "code": "SELLERREQUEST"
                            },
                            "claimItemStatus": {
                                "name": "Accepted"
                            },
                            "note": "",
                            "resolved": true,
                            "autoAccepted": false, //Returns which are waiting in actions for 48 hours are automatically accepted by the system and can be checked from this area.
                            "acceptedBySeller": true, //Returns accepted by the seller can be checked from this area
                            "acceptDetail": // "SUPPLIER" / "DISPUTE" / "SYSTEM"
                        }
                    ]
                }
            ],
            "lastModifiedDate": 1710497520682
        }
    ]
}