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 the createFulfillmentOrder operation to create an MCF order with line items that have serial numbers enabled while inbounding to Amazon. The createFulfillmentOrder request doesn't need any exclusive attributes in the request for this type of order.

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

After successfully creating the order, call the getFulfillmentOrder operation to validate that fulfillmentAction is equal to Ship and fulfillmentOrderStatus is equal to Received on the order.

Step 3. Get the fulfillment order to track status changes

The order goes through status changes, from Planning to Processing to Complete. Subscribe and listen to FULFILLMENT_ORDER_STATUS notifications to be aware of these status changes. When the order is shipped, the serial number of the item is scanned and validated to match the shared regex.

Call the getFulfillmentOrder operation with the sellerFulfillmentOrderId to view the latest order details and check if the serial number of the item was shipped.

Step 4. Validate the order status and line item quantities

Validate that fulfillmentShipmentStatus is equal to Shipped and that the serialNumber in fulfillmentShipmentItem is the same as what was generated during the inbound process.