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.
Updates and/or requests shipment for a fulfillment order with an order hold on it.
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.
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.
This operation is available in all marketplaces except Brazil.
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.
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:
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.
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:
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:
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 |
This operation only returns the standard response elements.
For information about standard request requirements, see Required request parameters.
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
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <UpdateFulfillmentOrderResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/"> <ResponseMetadata> <RequestId>d95be26c-16cf-4bbc-ab58-dce89fd4ac53</RequestId> </ResponseMetadata> </UpdateFulfillmentOrderResponse>