Track a partially fulfilled order

Learn how to track a partially fulfilled order for items that are low inventory.

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 a fulfillment preview

Call the getFulfillmentPreview operation with two line items and make sure they are available for a given shipping option (Standard, Expedited, or Priority).

An unsuccessful response has a non-2xx code and includes the following objects. If the PackageNumber does not exist, a 404 response provides the ineligibility errors.

Step 2. Create an MCF outbound order

Call the createFulfillmentOrder operation with a unique Order ID and at least two line items, or one line item with a quantity greater than 1 for the same shipping option.

Step 3. Validate the order details

Call the getFulfillmentOrder operation to validate that fulfillmentAction is equal to Ship and fulfillmentOrderStatus is equal to Received.

Step 4. Order status changes

The order goes through status changes from Planning to Processing to Complete, in case one or more items do not have enough inventory as requested in the createFulfillmentOrder operation. To get status change updates, subscribe and listen to FULFILLMENT_ORDER_STATUS notifications.

Step 5. Get the fulfillment order to view the latest order details

After the order is Shipped, the order status notification for Complete is triggered. Now call the getFulfillmentOrder operation to view the latest order details.

Step 6. Validate the order status and line item quantities

Validate that fulfillmentShipmentStatus is equal to Shipped and fulfillmentOrderStatus is equal to CompletePartialled. If there are items that have unfulfillableQuantity not equal to 0, then the order is partially fulfilled.

Step 7. Get the package number

Copy the package number of the order from the getFulfillmentOrder response from Step 5. There could be multiple package numbers based on the number of Amazon shipments for that order.

Step 8. Get the tracking details

Call the getPackageTrackingDetails operation using the package number from Step 7 and get the complete tracking details of the package.

An unsuccessful response has a non-2xx code and includes the following objects. If the PackageNumber does not exist, a 404 response provides the ineligibility errors.