2. Getting Returned Orders
This method enables you to retrieve information about returned orders from the Trendyol system.
- You need to send "storeFrontCode" as Header Parameter.
Rejected Package Information:
- 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.
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 getClaims
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 status of the returned item | 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",
"channelId": 1,
"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": 2207284754,
"packageId": 92248304,
"cargoProviderName": "FANCOURIER",
"cargoTrackingLink": "https://stage-tracking.trendyol.com/?trackingId=f78aee0b-6755-3c89-bf8c-129c4304ec71",
"items": [
"26889877-203a-468a-abb8-6b8e05497c0b"
],
"shipmentAddress": {
"address1": "Tsakaraki5",
"address2": "",
"city": "Tympaki",
"district": ""
},
"dontShipBack": false,
"sellerOtp": "234433", // In case sellerDeliveryMethod is LOCKER, this field returns PIN code to open BoxNow compartement to drop the rejected return package .Otherwise returns null. It returns value when "claimItemStatus" is waitingInAction.
"sellerDeliveryMethod": "LOCKER" // In case it is LOCKER, rejected return package needs to be dropped to the BoxNow locker.Otherwise returns null
},
"items": [
{
"orderLine": {
"id": 28717254,
"productName": "Erkek Bebek Sandalet 8S5280Z1/GREEN CS4, 21",
"barcode": "99999999999",
"merchantSku": "2083667",
"productColor": "GREEN CS4",
"productSize": " 21",
"price": 12.95,
"totalSgrFee": 1.5,
"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,
"totalSgrFee": 1.5,
"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,
"sellerOtp": "234523", // In case sellerDeliveryMethod is LOCKER, this field returns PIN code to open BoxNow compartement to take the return package .Otherwise returns null. It returns value when "claimItemStatus" is waitingInAction.
"sellerDeliveryMethod": "LOCKER", // In case it is LOCKER, package needs to be taken from the BoxNow locker.Otherwise returns null
"sellerCollectionPointDetails": {
"collectionPointId": "12b4b7dd-049a-41de-afc9-c49c37dd03ee"// ID be checked at the BoxNow website for collection point. Website for GR: https://boxnow.gr/en/locker-finder. Website for BG: https://boxnow.bg/en/locker-finder. It returns value when "claimItemStatus" is waitingInAction.
}
}
]
}| claimItemStatus | 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. |
| Accepted | This status is used for orders where the return request has been approved. |
| Unresolved | Return orders in disputed status. After the process of reporting a problem, the order becomes a disputed status. |
| Rejected | This status is used for orders where the return request has been rejected |
| Cancelled | This status is used for orders where the return request has been cancelled. |
| InAnalysis | This status is Used for returns that are under analysis. |
Please follow the logic below:
- If "dontShipBack": true: You do not need to ship the package back to the customer.
- If "dontShipBack": false: You must ship the package back to the customer only if your rejection request has been accepted by Trendyol.
- You can track the status of your rejection requests via the Get Returned Order service on "claimItemStatus" status.
Box Now Returned Order Flow
In case a returned order package to be taken from BoxNow locker, below 3 fields in the response body to be used to progress:
-
“sellerDeliveryMethod”: “LOCKER”
In case it is LOCKER, package needs to be taken from the BoxNow locker.Otherwise returns null
-
“sellerOtpCode”: “2342345"
In case sellerDeliveryMethod is LOCKER, this field returns PIN code to open BoxNow compartment .Otherwise returns null. It returns value when "claimItemStatus" is waitingInAction.
-
"sellerCollectionPointDetails": collectionPointId
In case sellerDeliveryMethod is LOCKER, this field returns locker point that you need to take returned order package from. It returns value when "claimItemStatus" is waitingInAction. You can check correspondence of the id via BoxNow website as below:
- In Greece https://boxnow.gr/en/locker-finder
Then you can follow below steps:
Step1: Pick up the return package from the BoxNow locker indicated in the sellerCollectionPointDetails field.
Step 2: Use the PIN code (sellerOtpCode) to open a compartment.
Box Now Rejected Returned Order Flow
If the seller rejects a return, the package must be dropped off at any BoxNow locker to be shipped back to the customer. You can use the following two fields under the rejectedPackageInfo array to proceed:
-
“sellerDeliveryMethod”: “LOCKER”
In case it is LOCKER, package needs to be dropped to the BoxNow locker.Otherwise returns null
-
“sellerOtpCode”: “2342345"
In case sellerDeliveryMethod is LOCKER, this field returns PIN code to open BoxNow compartment. In some cases this field cannot be fulfilled once the returned order rejected, if "sellerDeliveryMethod” field is “LOCKER” then you need to refetch returned order package until get this value. If "sellerDeliveryMethod” field is not “LOCKER” than this field returns null.
You can check Box Now locker address via below website in order to decide which locker point you will be dropped the package:
In Greece https://boxnow.gr/en/locker-finder
Then you can follow below steps:
Step 1: Print your shipping label.
Step 2: Drop off the package at any BoxNow locker you have chosen for
Step 3: Use the PIN code (sellerOtpCode) to open a compartment.
Step 4: Place the package inside and close the locker door.
Each package must be placed in a separate locker compartment. Multiple packages in the same compartment may result in lost packages or unprocessed returns.
Updated 8 days ago