Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

Inventory Datatypes

The following datatypes are used in the response elements of the Amazon Marketplace Web Service (Amazon MWS) Fulfillment Inventory API section:

Datatype Description
InventorySupply General information about the availability of inventory for a single SKU.
InventorySupplyDetail Specific information about the availability of inventory for a single SKU, including the number of units that are in an Amazon fulfillment center, in an inbound shipment, or being transferred between fulfillment centers.
Timepoint Indicates whether inventory is immediately available for picking, whether inventory availability is unknown, or whether inventory is expected to be available for picking by a specific date.

InventorySupply

General information about the availability of inventory for a single SKU.

Operations

The InventorySupply datatype is used in a response element of the following operations:

Datatype content

The following table shows the elements of the InventorySupply datatype:

Name Description Required Values
SellerSKU The Seller SKU of the item. No Type: xs:string
FNSKU The Fulfillment Network SKU (FNSKU) of the item. The FNSKU is a unique identifier for each inventory item stored in an Amazon fulfillment center. Yes Type: xs:string
ASIN The Amazon Standard Identification Number (ASIN) of the item. No Type: xs:string
Condition The condition of the item. No Condition values:
  • NewItem
  • NewWithWarranty
  • NewOEM
  • NewOpenBox
  • UsedLikeNew
  • UsedVeryGood
  • UsedGood
  • UsedAcceptable
  • UsedPoor
  • UsedRefurbished
  • CollectibleLikeNew
  • CollectibleVeryGood
  • CollectibleGood
  • CollectibleAcceptable
  • CollectiblePoor
  • RefurbishedWithWarranty
  • Refurbished
  • Club

Type: xs:string

TotalSupplyQuantity The total item quantity that a seller has in Amazon's fulfillment network supply chain. This includes inventory that is available for shipping, inventory in inbound shipments, and inventory being transferred between Amazon fulfillment centers. TotalSupplyQuantity is equivalent to the sum of the afn-inbound-shipped-quantity, afn-inbound-receiving-quantity, and afn-fulfillable-quantity fields of the FBA Manage Inventory Report (_GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA_) and the Reserved - FC transfer field of the FBA Reserved Inventory Report (_GET_RESERVED_INVENTORY_DATA_). Yes Type: xs:int
InStockSupplyQuantity The item quantity that a seller has in Amazon fulfillment centers that is available for shipping. InStockSupplyQuantity is equivalent to the afn-fulfillable-quantity field in the FBA Manage Inventory Report (_GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA_). Yes Type: xs:int
EarliestAvailability The earliest date that your inventory is expected to be available for picking. No

If the value of TotalSupplyQuantity is zero, then the EarliestAvailability element is not returned.

Type: Timepoint
SupplyDetail Detailed information about the availability of inventory for a specific item and its current location in Amazon's fulfillment network supply chain. No Type: List of InventorySupplyDetail

InventorySupplyDetail

Specific information about the availability of inventory for a single SKU, including the number of units that are in an Amazon fulfillment center, in an inbound shipment, or being transferred between fulfillment centers.

Operations

The InventorySupplyDetail datatype is used in a response element of the following operations:

Datatype content

The following table shows the elements of the InventorySupplyDetail datatype:

Name Description Required Values
Quantity The quantity of inventory for a specific item. Yes Type: xs:int
SupplyType The current inventory status for a specific item. Yes SupplyType values:
  • InStock - Inventory is in an Amazon fulfillment center
  • Inbound - Inventory is in an inbound shipment to an Amazon fulfillment center
  • Transfer - Inventory is being transferred from one Amazon fulfillment center to another
Note: InStock inventory items might not be immediately available for picking. For example, inventory in a reserve location in an Amazon fulfillment center might take up to 12 hours to become available for picking.

Type: xs:string

EarliestAvailableToPick The earliest date that your inventory is expected to be available for picking. Yes In ISO 8601 date time format.

Type: Timepoint

LatestAvailableToPick The latest date that your inventory is expected to be available for picking. Yes In ISO 8601 date time format.

Type: Timepoint

Timepoint

Indicates whether inventory is immediately available for picking, whether inventory availability is unknown, or whether inventory is expected to be available for picking by a specific date.

Operations

The Timepoint datatype is used in a response element of the following operations:

Datatype content

The following table shows the elements of the Timepoint datatype:

Name Description Required Values
TimepointType Indicates whether inventory is immediately available for picking, whether inventory availability is unknown, or whether inventory is expected to be available for picking by a specific date. Yes TimepointType values:
  • Immediately - The seller's inventory is immediately available for picking.
  • DateTime - The seller's inventory is expected to be available for picking at a specific date, represented by the DateTime element.
  • Unknown - The seller's inventory is expected to be available for picking at some point in the future, but it is not known with confidence when that will be.

Type: xs:string

DateTime The date and time by which inventory is expected to be available for picking, in ISO 8601 date time format. No

If the value of the TimepointType element is DateTime, then the DateTime element is required.

If the value of the TimepointType element is Immediately or Unknown, then the value of the DateTime element is null.

Type: xs:dateTime