Create an order in hold status and then move it to shipped

Learn how an order can move from a fulfillment status of HOLD to SHIP. Orders in HOLD status do not proceed to further fulfillment actions until the status is updated to SHIP.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
• The Amazon Fulfillment role assigned to your developer profile.
• The Amazon Fulfillment role selected in the App registration page for your application.

Step 1. Get the fulfillment preview

Call the getFulfillmentPreview operation on the order to ensure the SKUs are eligible and fulfillable for the requested ship options (Standard, Expedited, Priority).

An unsuccessful response has a non-2xx code and includes the following objects. A 404 response provides the ineligibility errors, if any.

Step 2. Create a fulfillment order on hold

Call the createFulfillmentOrder operation with one or more line items with fulfillmentAction set equal to Hold. Doing so keeps the order in Hold status and further fulfillment actions don't run on that order.

Step 3. Update the order fulfillment action to ship

Call the updateFulfillmentOrder operation to update the order with fulfillmentAction equal to Ship to move the order from Hold to Ship.

Request example

PUT "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
{
  "fulfillmentAction": "Ship"
}

Step 4. Get the fulfillment order to validate the changes

On the successful update of the order, call the getFulfillmentOrder operation to validate that fulfillmentAction is updated to Ship. After the order moves to the Ship action, the next fulfillment steps start running on the order.