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 Status
| Service | Definition |
|---|---|
| Accepted | It returns when the returned 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.
| Parameter | Definiton | Type |
|---|---|---|
| claimIds | See the details of the respective claim packages, singular or plural. | string |
| claimItemStatus | It is the status of the returned order 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 waitingIn Action.
"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 waitingIn Action.
"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.
}
}
]
}J4Lc8b0TghZh0EqQIl08
Updated 8 days ago
Did this page help you?