接 Amazon FBA：只同步 FBA 库存

最后更新 2026-11-01

与 Amazon SP-API 是两个连接、同一套凭证：把同样的八个字段填进 Integration，测试、核对 SKU 映射、激活——进来的只有 FBA 库存，别的不进来。

这是与 Amazon SP-API 分开的第二个连接——同一个卖家账号、同一套凭证、干的活不同。Amazon FBA 连接只把亚马逊替您存放和履约的库存（FBA 库存）同步进您的库存视图。它不拉订单、不推发货：订单和发货仍归 Amazon SP-API 连接管。如果您已经接了那个连接，不用再备新凭证——同一套 Seller ID、LWA 凭证对、refresh token 和 AWS 密钥在这里再填一次即可。

Amazon FBA 接入步骤：先确认 Fulfillment 角色，再填共用的那套凭证，测试，核对 SKU 映射，激活。

前置条件#

一个能登录 Seller Central 的亚马逊卖家账号，且已有库存发入 FBA（亚马逊物流）。
硬性前提：您的 SP-API 应用必须已获授权 Amazon Fulfillment 角色。没有这个角色，FBA 库存调用会被拒绝——这是最常见的失败点，填任何字段之前先确认角色。
与 Amazon SP-API 连接同一套凭证：Seller ID、Marketplace ID、LWA Client ID 与 secret、refresh token，以及用于 SigV4 签名的 AWS 访问密钥对。已有 Amazon SP-API 连接，就说明这套凭证已经备齐——直接复用。
先确认 FBA 库存属于哪个站点——Marketplace ID 必须与站点对应（美国站：ATVPDKIKX0DER）。

拿凭证#

Seller ID：在 Seller Central 进 Settings → Account info，复制 Merchant token。这就是 Seller ID，以 A 开头。
Fulfillment 角色：在 Seller Central 打开您的 SP-API 应用（Apps & Services → Develop apps），确认应用已获授权 Amazon Fulfillment 角色。缺这个角色就现在补上并完成授权——没有它，FBA 库存读不到。
LWA 凭证：在同一个应用页面，复制 LWA Client ID（以 amzn1.application-oa2-client. 开头）和 LWA Client Secret。
Refresh token：把应用授权给您的卖家账号（Seller Central → Apps & Services → Authorize），复制拿到的 refresh token，以 Atzr| 开头。
AWS 密钥：在 AWS 控制台（IAM）创建或复制用于 SigV4 签名的访问密钥对——access key ID（以 AKIA 开头）和它的 secret access key。
Role ARN（可选）：只有经 STS AssumeRole 用 IAM 角色签名时，才记下该角色的 ARN（arn:aws:iam::…:role/…）。直接用访问密钥对签名就不需要。

填进 Integration#

打开 Integration → 连接器市场 → Amazon FBA → 新建连接。
Seller ID（Merchant token）——必填：Seller Central → Settings → Account info 里的 Merchant token，以 A 开头。
Marketplace ID——必填：FBA 库存所属站点的 ID。美国站填 ATVPDKIKX0DER；其他站点查 Amazon SP-API 文档。
LWA Client ID——必填：SP-API 应用的 LWA Client ID，在 Seller Central → Apps & Services → Develop apps 复制，以 amzn1.application-oa2-client. 开头。
LWA Client Secret——必填：与该 Client ID 配对的 secret，在同一个应用页面复制。按密钥存储，永不回显。
Refresh Token——必填：把应用授权给卖家账号后拿到的 refresh token，以 Atzr| 开头。
AWS Access Key ID——必填：用于 SigV4 签名的访问密钥 ID，以 AKIA 开头。
AWS Secret Access Key——必填：与该访问密钥配对的 secret。按密钥存储，永不回显。
IAM Role ARN (optional)——可选：只有签名经 STS AssumeRole 走 IAM 角色时才填（示例：arn:aws:iam::123456789012:role/…）。直接用访问密钥对签名就留空——留空是常态。

测试连接#

测试结果要看仔细——"通过"分两种。没填凭证时，测试走的是模拟库存（一小组固定的示例 SKU），报的成功是模拟成功：那只能证明页面流程能跑，不证明真的连上了亚马逊。填了凭证后，测试会用 refresh token 换取访问、完成签名，并真实向亚马逊核对您的站点参与状态。只有不带模拟字样的通过，才算真连通——激活前务必填好凭证再测一次。

配 Mapping / 选模板#

这个连接没有订单 Mapping——这里的 Mapping 只关乎库存。FBA 库存按卖家 SKU 对应：FBA 库存汇总里的每个亚马逊 SKU，都配到您在库产品中 SKU 相同的产品上，它的 FBA 数量就落到统一库存视图里那个产品上。激活前先看映射预览：没配上产品的亚马逊 SKU，数量无处可落——先把这些 SKU 配到正确的产品上；不要只在某一边改 SKU 名字，否则下一次同步对应关系就断了。

FBA 库存同步：汇总按 SKU 进来，数量落到您的产品上——没有订单，没有发货。

激活#

激活后，Integration 按您设的频率同步 FBA 库存汇总，让统一库存视图里的 FBA 数量保持最新——看库存和看补货提醒时，亚马逊替您存的货也算在内。其他什么都不变：不拉 FBA 订单、不推履约——那些流量仍走 Amazon SP-API 连接。先在运行监控 / 日志里盯头几次同步，抽几个 SKU 和 Seller Central 对一下数，确认无误再放手。

常见问题#

FBA 库存调用被拒——应用缺 Amazon Fulfillment 角色

原因：这是本连接的头号失败点。凭证本身可能完全没问题——同一套凭证在 Amazon SP-API 连接上好好的——但 SP-API 应用从来没有获授权 Amazon Fulfillment 角色，亚马逊没有这个角色就拒绝 FBA 库存读取。

解决办法：在 Seller Central 打开您的 SP-API 应用（Apps & Services → Develop apps），加上 Amazon Fulfillment 角色，并对卖家账号完成授权。如果授权后发了新的 refresh token，把新 token 也粘贴到本连接里。然后重新测试。

测试通过了，但真实 FBA 库存一直不出现

原因：您看到的通过是模拟的那种。没填凭证时，测试走模拟库存——一小组固定的示例 SKU——报成功时根本没有联系亚马逊，后面自然不会有真实库存进来。

解决办法：把凭证字段全部填好（从 Seller ID 到 AWS Secret Access Key），保存后重新测试。只有填了真实凭证、且不带模拟字样的通过，才代表真的连上了亚马逊。然后激活，去运行监控 / 日志里看第一次同步。

有些 SKU 同步不到数量

原因：FBA 库存按卖家 SKU 落位。某个亚马逊 SKU 没配到您在库产品里的产品——或者 SKU 只在一边改了名——它的数量就没有产品可落，会被跳过。

解决办法：打开映射预览，找到未配对的亚马逊 SKU，逐个配到正确的产品上。之后两边的 SKU 名字保持一致，再跑一次同步，确认数量落上了。

同步到的是别的站点的库存

原因：填的 Marketplace ID 与 FBA 库存实际所属的站点对不上。连接测试可能照样通过，但亚马逊只返回您所填站点下的 FBA 库存。

解决办法：确认 FBA 库存属于哪个站点，填该站点的 Marketplace ID——美国站是 ATVPDKIKX0DER，其他站点查 Amazon SP-API 文档。保存后跑一次同步，确认进来的是对的库存。