Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

CreateFulfillmentReturn

Creates a fulfillment return.

Description

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.

Availability

This operation is only available in the US, Germany, France, Italy, UK, Japan, and Australia marketplaces.

Throttling

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.

Request parameters

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

Response elements

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

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top