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. Confirm availability

Call getOrderPreview to confirm item availability.

Step 2. Create the order

Call createOrder with a unique orderId and multiple line items, or a single item with quantity greater than one.

Step 3. Confirm the status

Call getOrder and confirm status is PROCESSING.

Step 4. Subscribe to notifications

Subscribe to the FULFILLMENT_ORDER_STATUS notification to receive status change updates.

Step 5. Verify the unfulfillable amount

When the order reaches COMPLETE_PARTIAL, call getOrder and check unfulfillableAmount on each line item:

"lineItems": [
  {
    "lineItemId": "item-001",
    "amount": { "unit": "EACHES", "value": "5" },
    "cancelledAmount": { "unit": "EACHES", "value": "0" },
    "unfulfillableAmount": { "unit": "EACHES", "value": "2" }
  }
]

Step 6. Track packages

Locate tracking numbers at shipments[].packages[].tracking.carrier.trackingNumber. Call the getShipmentTracking operation of the Tracking API for granular carrier events.