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.
Creates a fulfillment return.
The CreateFulfillmentReturn operation creates a fulfillment return for items that were fulfilled using the CreateFulfillmentOrder operation. For calls to CreateFulfillmentReturn you must include ReturnReasonCode values returned by a previous call to the ListReturnReasonCodes operation. For definitions, see Terminology. For more information, see Creating a fulfillment return.
This operation is only available in the US, Germany, France, Italy, UK, Japan, and Australia marketplaces.
The CreateFulfillmentReturn 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 |
---|---|---|---|
SellerFulfillmentOrderId | An identifier assigned by the seller to the fulfillment order at the time it was created. The seller uses their own records to find the correct SellerFulfillmentOrderId value based on the buyer's request to return items. See Creating a fulfillment return. | Yes | Type: xs:string |
Items | A list of items to be returned. | Yes | Type: CreateReturnItem |
Name | Description |
---|---|
ReturnItemList | A list of items that Amazon accepted for return. Returns empty if no items were
accepted for return. Type: List of ReturnItem |
InvalidReturnItemList | A list of items that are invalid for return. Returns empty if no items are invalid
for return. Type: List of InvalidReturnItem |
ReturnAuthorizationList | A list of return authorizations. Type: List of ReturnAuthorization |
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/ ?Action=CreateFulfillmentReturn &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 &SellerFulfillmentOrderId=extern_id_1154539615776 &Items.member.1.SellerReturnItemId=16a6a142EXAMPLE &Items.member.1.SellerFulfillmentOrderItemId=order-item-1 &Items.member.1.AmazonShipmentId= DLHg36GDN &Items.member.1.ReturnReasonCode=REASON-CODE &Items.member.1.ReturnComment=Did%20not%20like%20color &Items.member.2.SellerReturnItemId=20a6a142EXAMPLE &Items.member.2.SellerFulfillmentOrderItemId=order-item-2 &Items.member.2.AmazonShipmentId= DLHg36GDN &Items.member.2.ReturnReasonCode=REASON-CODE &Items.member.2.ReturnComment=Size%20does%20not%20fit
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <CreateFulfillmenReturnResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/"> <CreateFulfillmentReturnResult> <ReturnItemList> <ReturnItem> <SellerReturnItemId>16a6a142EXAMPLE</SellerReturnItemId> <SellerFulfillmentOrderItemId>order-item-1 </SellerFulfillmentOrderItemId> <AmazonShipmentId>DLHg36GDN</AmazonShipmentId > <SellerReturnReasonCode>REASON-CODE</SellerReturnReasonCode> <ReturnComment>Did not like color</ReturnComment> <AmazonReturnReasonCode>OTHER-REASON-CODE</AmazonReturnReasonCode> <Status>Processed</Status> <StatusChangedDate>2016-09-29T02:40:36Z</StatusChangedDate> <ReturnAuthorizationId>amzn-rma-id</ReturnAuthorizationId> <ReturnReceivedCondition>Sellable</ReturnReceivedCondition> <FulfillmentCenterId>FC123</FulfillmentCenterId> </ReturnItem> </ReturnItemList> <InvalidReturnItemList> <InvalidReturnItem> <SellerReturnItemId>20a6a142EXAMPLE</SellerReturnItemId> <SellerFulfillmentOrderItemId>order-item-2</SellerFulfillmentOrderItemId> <InvalidItemReason> <InvalidItemReasonCode>DuplicateRequest</InvalidItemReasonCode> <Description>There are duplicate return requests for this item.</Description> </InvalidItemReason> </InvalidReturnItem> </InvalidReturnItemList> <ReturnAuthorizationList> <ReturnAuthorization> <ReturnAuthorizationId>amzn-rma-id</ReturnAuthorizationId> <FulfillmentCenterId>FC123</FulfillmentCenterId> <ReturnToAddress> <Name>Amazon FC</Name> <Line1>123 Main Street</Line1> <City>Anywhere</City> <StateOrRegionCode>WA</StateOrRegionCode> <PostalCode>98122</PostalCode> <CountryCode>US</CountryCode> </ReturnToAddress> <AmazonRmaId>test123</AmazonRmaId> <RmaPageURL>https://sellercentral.amazon.com/URL</RmaPageURL> </ReturnAuthorization> </ReturnAuthorizationList> </CreateFulfillmentReturnResult> <ResponseMetadata> <RequestId>5e5e5694-8e76-11df-929f-87c80302f8f6</RequestId> </ResponseMetadata> </CreateFulfillmenReturnResponse>