Amazon 库存管理 API 是亚马逊官方提供的程序化库存操作接口，基于最新 Selling Partner API（SP-API）体系，可实现库存查询、数量更新、FBA 库存管理、入库计划与多渠道库存同步等自动化能力，替代人工后台操作，支撑 ERP、WMS、自研系统与亚马逊平台无缝对接。

本文聚焦可直接落地的接入流程、核心接口、调用示例与避坑要点，适用于自发货、FBA、多渠道配送卖家。

---

一、API 基础认知

1. 核心定位

• 替代 MWS 旧版接口，全面迁移至SP-API
• 支持自发货库存与FBA 库存统一管理
• 支持批量、实时、定时同步，避免超卖 / 断货
• 对接入库、配送、价格、订单全链路

2. 主要库存相关 API 模块

• FBA Inventory API：查询 FBA 库存、可售、预留、库龄
• Listings Items API：更新自发货 SKU 库存数量
• Fulfillment Inbound API：创建 / 管理 FBA 入库计划
• External Fulfillment Inventory API：多渠道库存同步
• Feed API：批量上传库存、价格、商品数据

---

二、接入准备（必做）

1. 账号与权限

1. 注册亚马逊卖家账户
2. 开通开发者账户（Developer Profile）
3. 创建SP-API 应用，获取：
   • Client ID
   • Client Secret
   • AWS IAM Role ARN
4. 申请权限：Inventory, Listings, FBA Inventory, Fulfillment Inbound

2. 必备凭证

• Seller ID（卖家 ID）
• Marketplace ID（站点 ID，如美国 ATVPDKIKX0DER）
• Refresh Token / Access Token
• AWS 访问密钥（用于签名）

3. 开发环境

• 支持 HTTP/HTTPS、JSON
• 需实现AWS SigV4 签名
• 需处理 Token 刷新与限流

---

三、核心流程与接口实战

1. 获取 FBA 库存摘要（最常用）

接口：GET /fba/inventory/v1/summaries

作用：查询 FBA 可售、不可售、预留、库龄、仓储位置等。

必传参数

• granularityType：Marketplace
• marketplaceIds：站点 ID
• sellerSkus：可选，指定 SKU 查询
• startDateTime：可选，按变更时间筛选

返回关键字段

• inventorySummaries.availableQuantity：可售数量
• reservedQuantity：预留数量
• inboundQuantity：在途数量
• sellerSKU、asin、condition

---

2. 更新自发货库存数量

接口：PUT /listings/2021-08-01/items/{sellerId}/skus/{sku}

作用：直接修改自发货 SKU 库存，支持单笔 / 批量。

请求体片段

json

{
  "productType": "PRODUCT",
  "requirements": "LISTING",
  "attributes": {
    "quantity": [{"value": 100}]
  }
}

---

3. 批量库存更新（Feed API）

适合大批量 SKU 同步：

1. 构造库存文本 / XML 文件
2. 上传 Feed：POST /feeds/2021-06-30/documents
3. 查询处理状态：GET /feeds/2021-06-30/feeds/{feedId}
4. 获取结果报告

---

4. FBA 入库计划管理

1. 创建入库计划：createInboundPlan
2. 设置入库商品：putInboundPlanItems
3. 获取仓库配置：getInboundPlanPlacementOptions
4. 确认并打印标签：getInboundPlanLabels

---

四、通用调用步骤（标准化）

1. 获取 Access Token（用 Refresh Token 刷新）
2. 构造请求（URL、参数、Body）
3. SigV4 签名（必须，否则 403）
4. 发送请求
5. 处理响应（成功 / 错误 / 限流）
6. 日志与重试

---

五、关键规则与避坑

1. 限流规则

• 接口有QPS 限制，超量返回 429
• 建议：队列 + 重试 + 退避
• 批量优先用 Feed，减少 API 调用

2. 常见错误

• 401：Token 过期 / 签名错误
• 403：权限不足 / ARN 错误
• 404：SKU / 站点不存在
• 429：触发限流
• 500：亚马逊服务端异常，重试即可

3. 最佳实践

• 先沙箱测试，再切生产
• 库存变更先查后更，避免覆盖
• 大促前提前压测，启用限流保护
• 定时同步 + 实时触发结合
• 记录每一次变更日志，便于回溯

---

六、典型业务场景落地

1. ERP 库存同步：每 15 分钟拉取 FBA 库存，推送自发货库存
2. 大促稳库存：实时扣减，防止超卖
3. 智能补货：根据库龄 + 销量自动创建入库计划
4. 多渠道统一：Shopify、独立站与亚马逊库存实时一致
5. 库存健康度报表：库龄、滞销、缺货自动统计

---

七、总结

Amazon 库存管理 API 是亚马逊卖家自动化运营的核心基建，从简单的库存查询到复杂的 FBA 全流程管理均可覆盖。接入时优先使用 SP-API、做好签名与限流、采用批量策略，即可稳定实现系统对接，大幅提升效率、降低人工错误。