Getting Returned Orders (getClaims)
Getting Returned Orders
This method enables you to retrieve information about returned orders from the Trendyol system.
Rejected Package Information:
- Information about exchange packages will be available in the "replacementOutboundpackageinfo" field within the response.
- 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.
- 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.
- If the return is rejected with the reasonId from Claim issue service "2101" (change request from the order question (it should not be used if the customer does not have a request)), the exchange will be approved.
Statuses and Status Updates:
- Available statuses for request include: Created, WaitingInAction, Accepted, Cancelled, Rejected, Unresolved, InAnalysis.
- You can use a query similar to the following: suppliers/(supplierid)/claims?claimItemStatus=Created
- Returned orders, with updated status in return services, will be provided to you in the order of lastModifiedDate.
- To obtain information about new orders, you should request with the "Created" status.
Date Information:
- 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.
Cargo Tracking Link:
- 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.
GET getShipmentPackages
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.
| 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 |
Sample Service Response
{
"totalElements": 2099,
"totalPages": 2099,
"page": 0,
"size": 1,
"content": [
{
"id": "f9da2317-876b-4b86-b8f7-0535c3b65731",//claimId
"claimId": "f9da2317-876b-4b86-b8f7-0535c3b65731",
"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": //It will return empty if there is no replacement.
{
"cargoTrackingNumber":72602420957047272632,
"cargoProviderName":"Aras Kargo Marketplace",
"cargoSenderNumber": "733861966410",
"cargoTrackingLink": "https"://kargotakip.araskargo.com.tr/mainpage.aspx?code=90909090909",
"packageid": 28717254,// replacement packet id information
items: [
b71461e3-d1a0-4c1d-9a6d-18ecbcb5432d// claimItem.Id
]"
"rejectedpackageinfo":
{
"cargoTrackingNumber":72602420957047272632,
"cargoSenderNumber": "12345754875355",
"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,
"vatRate": 8,
"salesCampaignId": 183631,
"productCategory": "Sandalet",
},
"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,
"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"
}
]
},
{
"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,
"vatRate": 8,
"salesCampaignId": 183631,
"productCategory": "Çorap",
},
"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,
"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": 1723275767111,
"orderOutboundPackageId": 58835111
}
]
}| 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. |
| WaitingFraudCheck | This status returns if the order whose return is approved is subject to fraud control. |
| Accepted | 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 claims that are cancelled. |
| InAnalysis | This status is Used for returns that are under analysis. |
Updated 10 days ago