Track an order with an item's serial number

For select products, a seller might need to know which instance of an item was sold to a particular customer. If the items are uniquely tracked with a serial number, the fulfillment centers can add steps to scan and record the serial numbers both going out and being returned.

After an item is shipped out, the getFulfillmentOrder operation has the serial number in the response for the seller to keep a record of it.

Prerequisites

• The seller needs to share the Regex of the generated serial numbers with Amazon.
• The seller needs to paste the generated unique serial number on every item when inbounding the inventory to Amazon.
• If the customer is using the Amazon Labeling Service, in addition to registering an ASIN, the FNSKU associated with the item must also be registered using the same process.
• 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. Create a fulfillment order with serial numbered items

Call createOrder with line items for serial-number-enabled SKUs.

Step 2. Get the fulfillment order to validate the order details

Call getOrder and confirm fulfillmentConfiguration.action is SHIP and status is PROCESSING.

Step 3. Get the fulfillment order to track status changes

Subscribe and listen to FULFILLMENT_ORDER_STATUS notifications to be aware of status changes. When the order is shipped, the serial number of the item is scanned and validated to match the shared regex.

Step 4. Validate the order status and line item quantities

Call getOrder after shipping is confirmed. Check shipments[].items[].unitIdentifiers for the scanned serial number. Confirm shipments[].status is SHIPPED.