Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Returns a list of return reason codes for a seller SKU in a given marketplace.
The ListReturnReasonCodes operation returns a list of valid return reasons codes for a seller SKU in a given marketplace. Valid reason codes are required in subsequent calls to the CreateFulfillmentReturn operation. See Creating a fulfillment return.
This operation is only available in the US, Germany, France, Italy, UK, Japan, and Australia marketplaces.
The ListReturnReasonCodes operation has a maximum request quota of 30 and a restore rate of two requests every second. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.
Name | Description | Required | Values |
---|---|---|---|
MarketplaceId | The marketplace for which the seller wants return reason codes. | No. Not required if SellerFulfillmentOrderId is specified. | MarketplaceId values: see
Amazon MWS endpoints and MarketplaceId values. Type: xs:string |
SellerFulfillmentOrderId | The identifier assigned to the item by the seller when the fulfillment order was created. The service uses this value to determine the marketplace for which the seller wants return reason codes. | No. Not required if MarketplaceId is specified. | Type: xs:string |
SellerSKU | The seller SKU for which return reason codes are required. | Yes | Type: xs:string |
Language | The language that the TranslatedDescription element of the ReasonCodeDetails response element should be translated into. | No | The
ISO 639-1 format
language code. Example: fr_CA Type: xs:string |
Name | Description |
---|---|
ReasonCodeDetailsList | Type: List of ReasonCodeDetails |
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/ ?Action=ListReturnReasonCodes &Version=2010-10-01 &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D &Timestamp=2016-09-29T02:40:36Z &SellerId=A2NKEXAMPLEF53 &MarketplaceId=A13V1IB3VIYZZH &SellerSKU=DV-001 &Language=fr_FR
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ListReturnReasonCodesResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/"> <ListReturnReasonCodesResult> <ReasonCodeDetailsList> <ReasonCodeDetails> <ReturnReasonCode>REASON-CODE</ReturnReasonCode> <Description>This is a description of the reason code.</Description> <TranslatedDescription>This is an optional translated description of the reason code.</TranslatedDescription> </ReasonCodeDetails> </ReasonCodeDetailsList> </ListReturnReasonCodesResult> <ResponseMetadata> <RequestId>5e5e5694-8e76-11df-929f-87c80302f8f6</RequestId> </ResponseMetadata> </ListReturnReasonCodesResponse>