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.
Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination address.
With the CreateFulfillmentOrder operation, you can put an order hold on a fulfillment order when you want to delay fulfillment for any reason, such as verifying payment. An order hold not only prevents a fulfillment order from being shipped, it also prevents the inventory items in the fulfillment order from being used for Fulfillment by Amazon (FBA) orders on Amazon’s retail website. This can help you avoid overselling your FBA inventory that is available both on Amazon’s retail website and through Multi-Channel Fulfillment.
To create a fulfillment order with an order hold on it, call the CreateFulfillmentOrder operation and specify FulfillmentAction = Hold. For information about shipping or updating a fulfillment order with an order hold on it, see UpdateFulfillmentOrder.
This operation is available in all marketplaces except Brazil.
The CreateFulfillmentOrder 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 | A fulfillment order identifier that you create to track your fulfillment order. The SellerFulfillmentOrderId must be unique for each fulfillment order that you create. If your system already creates unique order identifiers, then these might be good values to use for your SellerFulfillmentOrderId values. | Yes | Maximum: 40 characters Type: xs:string |
FulfillmentAction | Specifies whether the fulfillment order should ship now or have an order hold put on it. | No | FulfillmentAction values:
Default: Ship 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. | Yes | 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. 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. | Yes | 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. | Yes | Maximum: 1000 characters Type: xs:string |
ShippingSpeedCategory | The shipping method for your fulfillment order. | Yes | 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.
Type: xs:string |
DestinationAddress | The destination address for the fulfillment order. | Yes | Type: Address |
FulfillmentPolicy | Indicates how unfulfillable items in a fulfillment order should be handled. | No | FulfillmentPolicy values:
Default: 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 Type: List of type: xs:string |
CODSettings | The COD (Cash On Delivery) charges for a COD order. | No | The CODSettings request parameter is valid only in Japan (JP).
Specifying CODSettings in marketplaces
other than Japan returns an error. Type: CODSettings |
Items | A list of items to include in the fulfillment order preview, including quantity. | Yes | Type: List of CreateFulfillmentOrderItem |
DeliveryWindow | Specifies the time range within which your Scheduled Delivery
fulfillment order should be delivered. Important:
For more information, see Scheduled Delivery. |
No. Required only if ShippingSpeedCategory = ScheduledDelivery. | The DeliveryWindow request parameter is
valid only in Japan (JP). Specifying
DeliveryWindow in marketplaces other
than JP returns an error. Type: DeliveryWindow |
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=CreateFulfillmentOrder &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=ScheduledDelivery &DeliveryWindow.StartDateTime=2014-01-03T03:00:00Z &DeliveryWindow.EndDateTime=2014-01-03T05:00:00Z &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=2013-12-29 &FulfillmentAction=Hold &CODSettings.IsCODRequired=true &CODSettings.CODCharge.CurrencyCode=JPY &CODSettings.CODCharge.Value=10.00 &CODSettings.CODChargeTax.CurrencyCode=JPY &CODSettings.CODChargeTax.Value=2.00 &CODSettings.ShippingCharge.CurrencyCode=JPY &CODSettings.ShippingCharge.Value=5.00 &CODSettings.ShippingChargeTax.CurrencyCode=JPY &CODSettings.ShippingChargeTax.Value=3.00 &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.PerUnitPrice.CurrencyCode=JPY &Items.member.1.PerUnitPrice.Value=40.00 &Items.member.1.PerUnitTax.CurrencyCode=JPY &Items.member.1.PerUnitTax.Value=2.00 &Items.member.1.Quantity=1 &Items.member.1.SellerFulfillmentOrderItemId=mws-test-1 &Items.member.1.SellerSKU=Sample_SKU_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.PerUnitPrice.CurrencyCode=JPY &Items.member.2.PerUnitPrice.Value=22.00 &Items.member.2.PerUnitTax.CurrencyCode=JPY &Items.member.2.PerUnitTax.Value=6.00 &Items.member.2.Quantity=2 &Items.member.2.SellerFulfillmentOrderItemId=mws-test-2 &Items.member.2.SellerSKU=Sample_SKU_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"?> <CreateFulfillmentOrderResponse xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/"> <ResponseMetadata> <RequestId>d95be26c-16cf-4bbc-ab58-dce89fd4ac53</RequestId> </ResponseMetadata> </CreateFulfillmentOrderResponse>