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

UpdateFulfillmentOrder

Updates and/or requests shipment for a fulfillment order with an order hold on it.

Description

With the UpdateFulfillmentOrder operation, you can update and/or ship a fulfillment order with an order hold on it. For information about putting an order hold on a fulfillment order, see CreateFulfillmentOrder.

Shipping a fulfillment order

To ship a fulfillment order with an order hold on it, call the UpdateFulfillmentOrder operation for the order and specify FulfillmentAction = Ship.
Note: After you ship a fulfillment order you can no longer update the order using the UpdateFulfillmentOrder operation.

Updating a fulfillment order

To update a fulfillment order with an order hold on it, call the UpdateFulfillmentOrder operation for the order and specify your updated information using the optional parameters. Use the FulfillmentAction parameter to specify whether you want to ship your updated order.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The UpdateFulfillmentOrder 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
MarketplaceId The marketplace the fulfillment order is placed against. No MarketplaceId values: see Amazon MWS endpoints and MarketplaceId values.

Type: xs:string

SellerFulfillmentOrderId Identifies the fulfillment order that you want to update. Created with a previous call to the CreateFulfillmentOrder operation. Yes Maximum: 40 characters

Type: xs:string

FulfillmentAction Specifies whether the fulfillment order should ship now or should remain on hold. No FulfillmentAction values:
  • Ship - The fulfillment order ships now.
  • Hold - The order hold remains on the fulfillment order.

Default: Hold

Type: xs:string

DisplayableOrderId A fulfillment order identifier that you create. This value displays as the order identifier in recipient-facing materials such as the outbound shipment packing slip. The value of DisplayableOrderId should match the order identifier that you provide to your customer. You can use the SellerFulfillmentOrderId for this value or you can specify an alternate value if you want your customer to reference an alternate order identifier. No An alpha-numeric or ISO 8859-1 compliant string from one to 40 characters in length. Cannot contain two spaces in a row. Leading and trailing white space is removed.

Default: The value that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation.

Type: xs:string

DisplayableOrderDateTime The date of your fulfillment order. Displays as the order date in customer-facing materials such as the outbound shipment packing slip. No Default: The value that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation.

In ISO 8601 date time format.

Type: xs:dateTime

DisplayableOrderComment Order-specific text that appears in customer-facing materials such as the outbound shipment packing slip. No Maximum: 1000 characters

Default: The value that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation.

Type: xs:string

ShippingSpeedCategory The shipping method for your fulfillment order. No ShippingSpeedCategory values:
  • Standard - Standard shipping method.
  • Expedited - Expedited shipping method.
  • Priority - Priority shipping method.
Note: Shipping method service level agreements vary by marketplace. See the Amazon Seller Central website in your marketplace for shipping method service level agreements and fulfillment fees.

Default: The value that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation.

Type: xs:string

DestinationAddress The destination address for the fulfillment order. No If you do not include the DestinationAddress parameter, then the DestinationAddress values from your previous call to CreateFulfillmentOrder are used. If you do include the DestinationAddress parameter, then only the values that you specify are used. None of the DestinationAddress values that you specified with your previous call to CreateFulfillmentOrder are used.

Default: The value that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation.

Type: Address

FulfillmentPolicy Indicates how unfulfillable items in a fulfillment order should be handled. No FulfillmentPolicy values:
  • FillOrKill - If an item in a fulfillment order is determined to be unfulfillable before any shipment in the order moves to the Pending status (the process of picking units from inventory has begun), then the entire order is considered unfulfillable. However, if an item in a fulfillment order is determined to be unfulfillable after a shipment in the order moves to the Pending status, Amazon cancels as much of the fulfillment order as possible. See the FulfillmentShipment datatype for shipment status definitions.
  • FillAll - All fulfillable items in the fulfillment order are shipped. The fulfillment order remains in a processing state until all items are either shipped by Amazon or cancelled by the seller.
  • FillAllAvailable - All fulfillable items in the fulfillment order are shipped. All unfulfillable items in the order are cancelled by Amazon.

Default: If you specified a value with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation, then that value is the default. Otherwise the default is FillOrKill.

Type: xs:string

NotificationEmailList A list of email addresses that you provide that are used by Amazon to send ship-complete notifications to your customers on your behalf. No Maximum: 64 characters per email address

Default: If you specified a value with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation, then that value is the default. Otherwise the default is null.

Type: List of Type: xs:string

Items A list of items to include in the fulfillment order preview, including quantity. No Updating an Items value for a fulfillment order item does not affect the Items values for other fulfillment order items that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder.

Default: The values that you specified with a previous call to the CreateFulfillmentOrder or UpdateFulfillmentOrder operation.

Type: List of UpdateFulfillmentOrderItem

Response elements

This operation only returns the standard response elements.

Examples

Example query request

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

Show example code Hide example code

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/   
  ?Action=UpdateFulfillmentOrder   
  &Version=2010-10-01   
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA   
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE   
  &SignatureVersion=2   
  &SignatureMethod=HmacSHA256   
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D   
  &Timestamp=2014-01-02T02:40:36Z   
  &SellerId=A2NKEXAMPLEF53  
  &MarketplaceId=ATVPDKIKX0DER
  &SellerFulfillmentOrderId=mws-test-query-20100713023203751   
  &DisplayableOrderId=mws-test-query-20100713023203751   
  &ShippingSpeedCategory=Standard   
  &DestinationAddress.Name=Amazon%20Taro   
  &DestinationAddress.Line1=Meguro-ku%20Shimomeguro%2012-34-56   
  &DestinationAddress.Line2=XXX%20building%20101   
  &DestinationAddress.CountryCode=JP   
  &DestinationAddress.StateOrProvinceCode=Tokyo   
  &DestinationAddress.PostalCode=1500002   
  &DisplayableOrderComment=Seller%20comment%20here   
  &DisplayableOrderDateTime=2014-01-02   
  &FulfillmentAction=Ship   
  &Items.member.1.DisplayableComment=Seller%20comment%20here   
  &Items.member.1.GiftMessage=Gift%20comment%20here   
  &Items.member.1.PerUnitDeclaredValue.CurrencyCode=JPY   
  &Items.member.1.PerUnitDeclaredValue.Value=30   
  &Items.member.1.Quantity=1   
  &Items.member.1.SellerFulfillmentOrderItemId=mws-test-1   
  &Items.member.2.DisplayableComment=Seller%20comment%20here   
  &Items.member.2.GiftMessage=Gift%20comment%20here   
  &Items.member.2.PerUnitDeclaredValue.CurrencyCode=JPY   
  &Items.member.2.PerUnitDeclaredValue.Value=20.00   
  &Items.member.2.Quantity=2   
  &Items.member.2.SellerFulfillmentOrderItemId=mws-test-2   
  &NotificationEmailList.member.1=test1%40amazon.com   
  &NotificationEmailList.member.2=test2%40amazon.com

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<UpdateFulfillmentOrderResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/">
    <ResponseMetadata>
        <RequestId>d95be26c-16cf-4bbc-ab58-dce89fd4ac53</RequestId>
    </ResponseMetadata>
</UpdateFulfillmentOrderResponse>

↑ Top