Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档

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.

亚马逊 MWS 文档

库存数据类型

以下是用于亚马逊商城网络服务 (亚马逊 MWS) “配送库存 API”部分响应元素的数据类型:

数据类型 描述
InventorySupply 关于单个 SKU 库存状况的基本信息。
InventorySupplyDetail 关于单个 SKU 库存状况的基本信息,包括亚马逊配送中心内、入库货件中或亚马逊配送中心间调拨的单位数量。
Timepoint 指明是否可以立刻对库存进行拣货、库存状况是否未知或者是否可预计在特定日期对库存进行拣货。

InventorySupply

关于单个 SKU 库存状况的基本信息。

操作

InventorySupply 数据类型用于以下操作的 响应元素:

数据类型内容

下表显示 InventorySupply 数据类型的元素:

名称 描述 必填项 有效值
SellerSKU 商品的卖家 SKU。 类型:xs:string
FNSKU 商品的配送网络 SKU (FNSKU): FNSKU 是存储在的 亚马逊配送中心的每个库存商品的唯一编码。 类型:xs:string
ASIN 商品的亚马逊标准识别号 (ASIN)。 类型:xs:string
Condition 商品的状况。 Condition 值:
  • NewItem
  • NewWithWarranty
  • NewOEM
  • NewOpenBox
  • UsedLikeNew
  • UsedVeryGood
  • UsedGood
  • UsedAcceptable
  • UsedPoor
  • UsedRefurbished
  • CollectibleLikeNew
  • CollectibleVeryGood
  • CollectibleGood
  • CollectibleAcceptable
  • CollectiblePoor
  • RefurbishedWithWarranty
  • Refurbished
  • Club

类型:xs:string

TotalSupplyQuantity 亚马逊物流供应链中的商品总量。此处 包括当前位于亚马逊配送中心的商品数量、 当前在入库货件中的商品数量 以及在亚马逊物流亚马逊配送中心之间 转移的商品数量。 类型:xs:int
InStockSupplyQuantity 当前位于的商品数量。此处不 包括当前在入库 货件中的商品数量,也不包括在亚马逊物流亚马逊配送中心之间转移的商品数量。 类型:xs:int
EarliestAvailability 您的库存可供应取货的最早日期。

如果 TotalSupplyQuantity 的值为零, 则不返回 EarliestAvailability 元素。

类型:Timepoint
SupplyDetail 结构列表为选填项,列表中 指明了在亚马逊物流供应链 中某种特定商品的库存 当前所在的位置。 类型:InventorySupplyDetail 列表

InventorySupplyDetail

关于单个 SKU 库存状况的基本信息,包括亚马逊配送中心内、入库货件中或亚马逊配送中心间调拨的单位数量。

操作

InventorySupplyDetail 数据类型用于以下操作的响应 元素:

数据类型内容

下表显示 InventorySupplyDetail 数据类型的元素:

名称 描述 必填项 有效值
Quantity 某种特定商品的库存数量。 类型:xs:int
SupplyType 某种特定商品的库存在亚马逊物流供应链中的当前所在位置。 SupplyType 值:
  • InStock - 库存位于亚马逊配送中心
  • Inbound - 库存位于运至亚马逊配送中心 的入库货件中
  • Transfer - 库存正在从一个亚马逊配送中心 向另一个转移
注: InStock 库存商品可能不能及时供应取货。例如,位于亚马逊配送中心预留位置的库存可能需要 12 小时才能供应取货。

类型:xs:string

EarliestAvailableToPick 您的库存可进行取货的最早日期,日期的格式为 ISO 8601。 类型:Timepoint
LatestAvailableToPick 您的库存可供应取货的最晚日期,日期的格式为 ISO 8601。 类型:Timepoint

Timepoint

指明是否可以立刻对库存进行拣货、库存状况是否未知或者是否可预计在特定日期对库存进行拣货。

操作

Timepoint 数据类型用于以下操作的响应元素:

数据类型内容

下表显示 Timepoint 数据类型的元素:

名称 描述 必填项 有效值
TimepointType 指明是否可以立刻对库存进行拣货、库存状况是否未知或者是否可预计在特定日期对库存进行拣货。 TimepointType 值:
  • Immediately - 卖家的库存能够及时供应取货。
  • DateTime - 卖家的库存在指定的日期能够供应取货,日期表示为 DateTime 元素。
  • Unknown - 卖家的库存在将来的某一时刻能够供应取货,但具体时间并不确定。

类型:xs:string

DateTime 库存可供应取货的日期和时间格式为 ISO 8601。

如果 TimepointType 元素的值为 DateTime,则 DateTime 元素为必填项。

如果 TimepointType 元素的值为 ImmediatelyUnknown,则 DateTime 元素的值为空。

类型:xs:dateTime