FBA库存API使用案例指南

亚马逊SPAPI

# 什么是FBA Inventory API?

FBA Inventory API让您在市场层面上跟踪您的库存在亚马逊履约网络中的实时可用性.您可以获得诸如上市条件和库存数量的详细信息,如可填充进货保留不可填充,和研究.该API在全球范围内可用.

# 如何使用FBA库存API

FBA库存API需要有产品清单角色 (opens new window).

**getInventorySummaries (opens new window)操作返回库存摘要列表.返回的摘要取决于是否有startDateTimesellerSkus查询参数

1.当startDateTime'和sellerSkus'参数被省略时,所有的库存摘要和所有可用的细节都会返回.

  1. 当提供startDateTime'时,操作会返回在指定日期和时间之后发生变化的库存摘要. 忽略sellerSkus'参数.

  2. 当提供了sellerSkus'参数时,该操作只返回指定的sellerSkus'的库存汇总表.

# Tutorial: 获取所有可用的库存摘要与所有可用的细节

本教程向您展示如何使用FBA库存API来返回所有可用的库存摘要及全部细节.这对应于如何使用FBA库存API.中的第1条

先决条件

要完成本教程,你需要

-要返回库存摘要的市场ID.

# 获取所有可用的库存摘要的完整细节.

要返回所有可用的库存摘要和完整的细节,请调用FBA库存API的*getInventorySummaries (opens new window)操作,传递以下查询参数

Parameter Description Required
<代码>详细信息</代码 设置为true,以返回带有额外汇总库存细节和数量的库存摘要.否则,仅返回库存摘要(默认值). 是.必须设置为true.
<代码>granularityType</代码 库存聚集水平的颗粒度类型.
可能的值Marketplace.
是的.
granularityId 指定的颗粒度类型的颗粒度ID.当granularityTypeMarketplace时,您必须指定marketplaceId. 是的.
<代码>marketplaceIds</代码 用于返回库存摘要的市场ID.只允许一个市场ID. 是的.

请求示例:

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?details=true&amp;granularityType=Marketplace&amp;granularityId=ATVPDKIKX0DER&amp;marketplaceIds=ATVPDKIKX0DER
1

一个成功的响应在每个sellerSku的有效载荷中包括以下内容

名称 Description
<代码>sellerSku</代码 该物品的卖方库存单位(SKU)_,.
<代码>fnSku</代码 亚马逊的履行网络SKU标识.履行网络库存单位(FNSKUs)是亚马逊分配给存储在亚马逊履行中心并由其履行的产品的唯一标识.
asin 商品的亚马逊标准识别码(ASIN),你可以在商品详情页上找到ASIN.
<代码>产品名称</代码 在指定市场内的项目的本地化语言产品名称.
<代码>lastUpdatedTime</代码 任何数量最后被更新的日期和时间.
totalQuantity(总数量) 入库货物或在亚马逊履行中心的单位总数.
<代码>fulfillableQuantity</代码 可以被拣选、包装和装运的物品数量.
<代码>inboundWorkingQuantity</代码 您已通知亚马逊的进货数量.
<代码>inboundShippedQuantity</代码> 您已经通知亚马逊并提供了追踪号码的进货数量.
<代码>inboundReceivingQuantity</代码 尚未在亚马逊履行中心收到处理的单位数量,但属于进货货物的一部分,其中有一些单位已经收到并处理.
totalReservedQuantity 亚马逊履行网络中的单位总数,这些单位目前正在被采摘、包装和运输;或因测量、采样或其他内部流程而被搁置.
pendingCustomerOrderQuantity 为客户订单保留的单位数量.
pendingTransshipmentQuantity 正在从一个执行中心转移到另一个执行中心的单位数量.
<代码>fcProcessingQuantity</代码 被搁置在履行中心进行额外处理的单位数量.
<代码>totalUnfulfillableQuantity</代码 亚马逊履约网络中处于无法销售状态的单位总数.
customerDamagedQuantity(客户损坏数量) 客户受损处置中的单位数量.
<代码>warehouseDamagedQuantity</代码> 仓库受损处置中的单位数量.
distributorDamagedQuantity 分销商受损处置的单位数量.
carrierDamagedQuantity 承运人受损处置的单位数量.
defectiveQuantity 处于缺陷处置中的单位数量.
<代码>过期数量</代码 过期处置的单位数量.
totalResearchingQuantity 目前在亚马逊的履行网络中正在研究的单位总数.
researchingQuantityBreakdown 目前正在研究的项目的数量细节列表,包括
  • researchingQuantityInShortTerm (1-10 days)
  • researchingQuantityInMidTerm (11-20 days)
  • researchingQuantityInLongTerm (21天或更长).

响应的例子:

{
  "pagination": {
    "nextToken": "种子"
  },
  "payload": {
    "granularity": {
      "granularityType": "Marketplace",
      "granularityId": "atvpdkikx0der"
    },
    " inventorySummaries": [
      {
        "asin": "B00T9QONN1",
        "fnSku": "B00T9QONN1",
        "sellerSku": "msku314best",
        "条件": "NewItem",
        " inventoryDetails": {
          "可实现数量": 66,
          "inboundWorkingQuantity": 21,
          "进货出货量": 0,
          "进货接收数量": 0,
          "reservedQuantity": {
            "totalReservedQuantity": 0,
            "pendingCustomerOrderQuantity": 0,
            "pendingTransshipmentQuantity": 0,
            "fcProcessingQuantity": 0
          },
          "researchingQuantity": {
            "totalResearchingQuantity": 0,
            "researchingQuantityBreakdown": [
              {
                "名称": "researchingQuantityInShortTerm",
                "数量": 0
              },
              {
                "名称": "ResearchingQuantityInMidTerm"
                "数量": 0
              },
              {
                "名称": "ResearchingQuantityInLongTerm",
                "数量": 0
              }
            ]
          },
          "unfulfillableQuantity": {
            "totalUnfulfillableQuantity": 0,
            "customerDamagedQuantity": 0,
            "WarehouseDamagedQuantity": 0,
            "distributorDamagedQuantity": 0,
            "承运人损坏的数量": 0,
            "defectiveQuantity": 0,
            "过期数量": 0
          }
        },
        "lastUpdatedTime": "2018-03-31t23: 40: 39z"
        "productName": "CalciumPowder",
        "totalQuantity": 87
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Tutorial: 获取所有已更改的可用库存汇总表

本教程告诉您如何使用FBA库存API来返回自指定开始日期和时间以来发生变化的所有可用库存摘要.这与如何使用FBA库存API.中的第2条对应

先决条件

要完成本教程,你需要

  1. 要返回库存摘要的市场ID.

  2. 开始的日期和时间,以作为返回已经改变的库存摘要的基础.

# 获取所有已变更的可用库存汇总表

要返回所有已更改的可用库存摘要,请调用FBA库存API的getInventorySummaries (opens new window)操作,传递以下查询参数

Parameter Description Required
<代码>详细信息</代码 设置为true,以返回带有额外汇总库存细节和数量的库存摘要.否则,仅返回库存摘要(默认值). 没有.
<代码>granularityType</代码 库存聚集水平的颗粒度类型.
可能的值Marketplace.
是的.
granularityId 指定的颗粒度类型的颗粒度ID.当granularityTypeMarketplace时,您必须指定marketplaceId. 是的.
<代码>startDateTime</代码

一个ISO 8601格式的开始日期和时间.如果指定了,所有从那时起发生变化的库存摘要都会被返回.你必须指定一个不早于请求的日期和时间的18个月的日期和时间.

注意:不检测以下内容的变化

  • inboundWorkingQuantity
  • inboundShippedQuantity
  • <代码>入库收货数量</代码>

是的.
<代码>marketplaceIds</代码 用于返回库存摘要的市场ID.只允许一个市场ID. 是的.

请求示例:

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?granularityType=Marketplace&amp;granularityId=ATVPDKIKX0DER&amp;startDateTime=2018-03-27T23:40:39Z&amp;marketplaceIds=ATVPDKIKX0DER
1

一个成功的响应在每个 "sellerSku "的有效载荷中包括以下内容.注意,由于在请求示例中没有指定 "detail "参数,并且默认为 "false",额外的汇总库存细节和数量没有返回.

名称 Description
<代码>sellerSku</代码 该物品的卖方库存单位(SKU)_,.
<代码>fnSku</代码 亚马逊的履行网络SKU标识.履行网络库存单位(FNSKUs)是亚马逊分配给存储在亚马逊履行中心并由其履行的产品的唯一标识.
asin 商品的亚马逊标准识别码(ASIN),你可以在商品详情页上找到ASIN.
<代码>产品名称</代码 在指定市场内的项目的本地化语言产品名称.
<代码>lastUpdatedTime</代码 任何数量最后被更新的日期和时间.
totalQuantity(总数量) 入库货物或在亚马逊履行中心的单位总数.

响应的例子:

{
  "pagination": {
    "nextToken": "种子"
  },
  "payload": {
    "granularity": {
      "granularityType": "Marketplace",
      "granularityId": "atvpdkikx0der"
    },
    " inventorySummaries": [
      {
        "asin": "B00T9QONN1",
        "fnSku": "B00T9QONN1",
        "sellerSku": "msku314best",
        "条件": "NewItem",
        "lastUpdatedTime": "2018-03-31t23: 40: 39z"
        "productName": "CalciumPowder",
        "totalQuantity": 87
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# Tutorial: 获取指定卖家SKU的库存汇总表

本教程告诉您如何使用FBA库存API来返回一个或多个(最多50)指定的sellerSkus.的库存摘要,这对应于如何使用FBA库存API.中的第3点

先决条件

要完成本教程,你需要

  1. 需要返回库存摘要的市场ID.

  2. 一个最多五十个 "sellerSku "的列表,用于返回库存摘要.

# 为指定的卖方SKU获取带有额外细节的库存摘要.

要返回指定SKU的完整细节的库存摘要,请调用FBA库存API的getInventorySummaries (opens new window)操作,传递以下查询参数

Parameter Description Required
<代码>详细信息</代码 设置为true,以返回带有额外汇总库存细节和数量的库存摘要.否则,仅返回库存摘要(默认值). 是.必须设置为true.
<代码>granularityType</代码 库存聚集水平的颗粒度类型.
可能的值Marketplace.
是的.
granularityId 指定的颗粒度类型的颗粒度ID.当granularityTypeMarketplace时,您必须指定marketplaceId. 是的.
<代码>sellerSkus</代码 返回库存摘要的卖方SKU列表. 您最多可以指定50个SKU. 是的.
<代码>marketplaceIds</代码 用于返回库存摘要的市场ID.只允许一个市场ID. 是的.

请求示例:

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?details=true&amp;granularityType=Marketplace&amp;granularityId=ATVPDKIKX0DER&amp;sellerSkus=msku314best%2Cmsku271good&amp;marketplaceIds=ATVPDKIKX0DER
1

一个成功的响应在每个指定的**卖家Skus的有效载荷中包括以下内容

名称 Description
<代码>sellerSku</代码 该物品的卖方库存单位(SKU)_,.
<代码>fnSku</代码 亚马逊的履行网络SKU标识.履行网络库存单位(FNSKUs)是亚马逊分配给存储在亚马逊履行中心并由其履行的产品的唯一标识.
asin 商品的亚马逊标准识别码(ASIN),你可以在商品详情页上找到ASIN.
<代码>产品名称</代码 在指定市场内的项目的本地化语言产品名称.
<代码>lastUpdatedTime</代码 任何数量最后被更新的日期和时间.
totalQuantity(总数量) 入库货物或在亚马逊履行中心的单位总数.
<代码>fulfillableQuantity</代码 可以被拣选、包装和装运的物品数量.
<代码>inboundWorkingQuantity</代码 您已通知亚马逊的进货数量.
<代码>inboundShippedQuantity</代码> 您已经通知亚马逊并提供了追踪号码的进货数量.
<代码>inboundReceivingQuantity</代码 尚未在亚马逊履行中心收到处理的单位数量,但属于进货货物的一部分,其中有一些单位已经收到并处理.
totalReservedQuantity 亚马逊履行网络中的单位总数,这些单位目前正在被采摘、包装和运输;或因测量、采样或其他内部流程而被搁置.
pendingCustomerOrderQuantity 为客户订单保留的单位数量.
pendingTransshipmentQuantity 正在从一个执行中心转移到另一个执行中心的单位数量.
<代码>fcProcessingQuantity</代码 被搁置在履行中心进行额外处理的单位数量.
<代码>totalUnfulfillableQuantity</代码 亚马逊履约网络中处于无法销售状态的单位总数.
customerDamagedQuantity(客户损坏数量) 客户受损处置中的单位数量.
<代码>warehouseDamagedQuantity</代码> 仓库受损处置中的单位数量.
distributorDamagedQuantity 分销商受损处置的单位数量.
carrierDamagedQuantity 承运人受损处置的单位数量.
defectiveQuantity 处于缺陷处置中的单位数量.
<代码>过期数量</代码 过期处置的单位数量.
totalResearchingQuantity 目前在亚马逊的履行网络中正在研究的单位总数.
researchingQuantityBreakdown 目前正在研究的项目的数量细节列表,包括
  • researchingQuantityInShortTerm (1-10 days)
  • researchingQuantityInMidTerm (11-20 days)
  • researchingQuantityInLongTerm (21天或更长).

响应的例子:

{
  "pagination": {
    "nextToken": "种子"
  },
  "payload": {
    "granularity": {
      "granularityType": "Marketplace",
      "granularityId": "atvpdkikx0der"
    },
    " inventorySummaries": [
      {
        "asin": "B00T9QONN1",
        "fnSku": "B00T9QONN1",
        "sellerSku": " msku314best",
        "条件": "NewItem",
        "inventoryDetails": {
          "可实现数量": 66,
          "inboundWorkingQuantity": 21,
          "进货出货量": 0,
          "进货接收数量": 0,
          "reservedQuantity": {
            "totalReservedQuantity": 0,
            "pendingCustomerOrderQuantity": 0,
            "pendingTransshipmentQuantity": 0,
            "fcProcessingQuantity": 0
          },
          "researchingQuantity": {
            "totalResearchingQuantity": 0,
            "researchingQuantityBreakdown": [
              {
                "名称": "researchingQuantityInShortTerm",
                "数量": 0
              },
              {
                "名称": "ResearchingQuantityInMidTerm"
                "数量": 0
              },
              {
                "名称": "ResearchingQuantityInLongTerm",
                "数量": 0
              }
            ]
          },
          "unfulfillableQuantity": {
            "totalUnfulfillableQuantity": 0,
            "customerDamagedQuantity": 0,
            "WarehouseDamagedQuantity": 0,
            "distributorDamagedQuantity": 0,
            "承运人损坏的数量": 0,
            "defectiveQuantity": 0,
            "过期数量": 0
          }
        },
        "lastUpdatedTime": "2018-03-31t23: 40: 39z"
        "productName": "CalciumPowder",
        "totalQuantity": 87
      },
      {
        "asin": "B00T9QONN2",
        "fnSku": "B00T9QONN2",
        "sellerSku": " msku271good",
        "条件": "NewItem",
        "inventoryDetails": {
          "可实现数量": 6,
          "inboundWorkingQuantity": 2,
          "进货出货量": 0,
          "进货接收数量": 0,
          "reservedQuantity": {
            "totalReservedQuantity": 0,
            "pendingCustomerOrderQuantity": 0,
            "pendingTransshipmentQuantity": 0,
            "fcProcessingQuantity": 0
          },
          "researchingQuantity": {
            "totalResearchingQuantity": 0,
            "researchingQuantityBreakdown": [
              {
                "名称": "researchingQuantityInShortTerm",
                "数量": 0
              },
              {
                "名称": "ResearchingQuantityInMidTerm"
                "数量": 0
              },
              {
                "名称": "ResearchingQuantityInLongTerm",
                "数量": 0
              }
            ]
          },
          "unfulfillableQuantity": {
            "totalUnfulfillableQuantity": 0,
            "customerDamagedQuantity": 0,
            "WarehouseDamagedQuantity": 0,
            "distributorDamagedQuantity": 0,
            "承运人损坏的数量": 0,
            "defectiveQuantity": 0,
            "过期数量": 0
          }
        },
        "lastUpdatedTime": "2018-04-01t23: 40: 39z"
        "productName": "CalciumPowder",
        "totalQuantity": 8
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

# 一般建议

# GetInventorySummariesResponse中的分页方法

当调用[getInventorySummaries](https: //spapi.cyou/zh/references/fbainventory-api-v1-reference.html#get-fbainventoryv1summaries)操作产生一个nextToken那么有一些库存还没有被遇到,你可以在随后的调用中得到它们. 你使用连续响应中提供的nextToken'令牌遍历库存. 所有的库存都被遍历了,只有在响应中返回pagination'之后. 这意味着inventorySummaries'列表可能是空的,但仍然产生一个nextToken`.

例子:

即使inventorySummaries'列表中没有库存,也有一个nextToken'

{
  "响应": {
    "分页": {
      "nextToken": "XXXXXXXX"
    },
    "payload": {
      "granularity": {
        ...
      },
      " inventorySummaries": []
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

getInventorySummaries'操作只有在响应中没有返回pagination'时才被认为完成

{
  "响应": {
    "payload": {
      "颗粒度": {
        ...
      },
      " inventorySummaries": []
    }
  }
}
1
2
3
4
5
6
7
8
9
10
Last Updated: 2022/10/20 下午11:58:42