Picking Returned Orders (getClaims)

Picking Returned Orders

You can get orders with Trendyol system with this method.

  • 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.

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,
            "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": [
                            {
                                "id": 29815493,
                                "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": [
                            {
                                "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.