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

CreateFulfillmentOrder

Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination address.

Description

The CreateFulfillmentOrder operation generates a request for Amazon to ship items from the seller's inventory in Amazon's fulfillment network to a destination address.
Note: If you attempt to create a fulfillment order for which you do not have sufficient inventory in Amazon's fulfillment network, the service returns an error.

Putting an order hold on a fulfillment order

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.

Note: An order hold stays in effect for two weeks. After two weeks, if you have not shipped or cancelled the fulfillment order, it is automatically cancelled. At that point your inventory items in the fulfillment order can be used for FBA orders on Amazon’s retail website.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

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.

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 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:
  • Ship - The fulfillment order ships now.
  • Hold - An order hold is put on the fulfillment order.

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:
  • Standard - Standard shipping method.
  • Expedited - Expedited shipping method.
  • Priority - Priority shipping method.
  • ScheduledDelivery - Scheduled Delivery shipping method. For more information, see Scheduled Delivery.
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:
  • 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: 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:
  • The StartDateTime and EndDateTime values of the DeliveryWindow request parameter must be specified exactly as they were returned by your previous call to the GetFulfillmentPreview operation. If you specify StartDateTime and EndDateTime values that were not returned by a previous call to the GetFulfillmentPreview operation, the service returns an error.
  • It is possible that delivery windows that were available when you called the GetFulfillmentPreview operation will not be available when call the CreateFulfillmentOrder operation. If this happens the service returns an error. In this case you need to call the GetFulfillmentPreview operation again to get the currently-available delivery windows.

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

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

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

↑ Top