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.
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. |
General information about the availability of inventory for a single SKU.
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:
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 |
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.
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:
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 |
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.
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:
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 |