接 Amazon SP-API：拉订单进来，推履约出去

在 Seller Central 拿 Seller ID、LWA 凭证和 refresh token，再备好 AWS IAM 签名密钥，八个字段填进 Integration，测试、配 Mapping、激活。

Amazon SP-API 连接器把您的亚马逊订单拉进 OMS，再把履约、产品和库存推回亚马逊，还能拉退货。它面向卖家自发货（MFN）订单——由您自己发货的订单。一个连接对应一个卖家账号、一个站点。

前置条件#

• 一个能登录 Seller Central 的亚马逊卖家账号，且在做卖家自发货（MFN）订单。
• 在 Seller Central 有开发应用并授权应用的权限（Apps & Services → Develop apps）。
• 一个能用 IAM 的 AWS 账号，能创建访问密钥并挂上 SP-API 的 IAM 策略用于签名。
• 先确认店铺属于哪个站点——Marketplace ID 必须与站点对应（美国站：ATVPDKIKX0DER）。

拿凭证#

1. 第 1 步——Seller ID：在 Seller Central 进 Settings → Account info，复制 Merchant token。这就是 Seller ID，以 A 开头。
2. 第 1 步——应用凭证：在 Seller Central 进 Apps & Services → Develop apps，打开您的应用，复制 LWA Client Identifier（以 amzn1.application-oa2-client. 开头）和 LWA Client secret。
3. 第 1 步——Refresh token：把应用授权给您的卖家账号，复制拿到的 refresh token。它是长期刷新令牌，以 Atzr| 开头。

1. 第 2 步——AWS 访问密钥：在 AWS 控制台进 IAM → Security credentials，创建一个访问密钥。Access key ID 以 AKIA 开头。
2. 第 2 步——密钥：在同页复制 AWS secret access key。它只显示一次。
3. 第 2 步——IAM 策略：确认该密钥背后的 IAM 用户或角色已挂上 SP-API 的 IAM 策略——没挂的话签名能做、但亚马逊会返回 403。
4. 第 2 步——Role ARN（可选）：如果经跨账号 IAM 角色签名，记下它的 role ARN；直接用访问密钥签名就不用管。

填进 Integration#

1. 打开 Integration → 连接器市场 → Amazon SP-API → 新建连接。
2. Seller ID（Merchant token）——必填：Seller Central → Settings → Account info 里的 Merchant token，以 A 开头。
3. Marketplace ID——必填：您店铺站点的 ID。美国站填 ATVPDKIKX0DER；其他站点查 Amazon SP-API 文档。
4. LWA Client ID——必填：Seller Central → Apps & Services → Develop apps 里的 LWA Client Identifier，以 amzn1.application-oa2-client. 开头。
5. LWA Client secret——必填：同页（Develop apps）显示的 secret。加密存储，永不回显。
6. Refresh token——必填：授权应用后拿到的长期刷新令牌，以 Atzr| 开头。
7. AWS access key ID——必填：用于 SigV4 签名的 IAM 访问密钥 ID，以 AKIA 开头。
8. AWS secret access key——必填：与该访问密钥配对的 secret，在 IAM → Security credentials 复制。它只显示过一次。
9. IAM role ARN——可选：跨账号 IAM 角色 ARN。填了，签名会先经 STS AssumeRole 换临时凭证；留空则直接用访问密钥签名。

测试连接#

测试分两级：连通性（LWA 授权和 SigV4 签名都通）+ 单据级预览（真实拉一个订单，展示"平台字段 → 标准订单"对照）。店铺里还没有订单时，先在亚马逊下个测试订单——预览需要一条真实单据。测试失败时先记下确切报错，对照下面的常见问题排查，不要乱改字段。

配 Mapping / 选模板#

选 Amazon SP-API 标准模板。它映射卖家自发货订单的订单号、行 SKU、数量、收货地址和履约状态。激活前先拿一个真实订单核对映射预览——重点看 SKU 匹配，确保每个亚马逊 SKU 都配到正确的 OMS 产品。

激活#

激活后，Integration 按您设的频率拉新的卖家自发货订单和退货，并把带追踪号的履约、以及产品和库存更新推回亚马逊。先在 运行监控 / 日志里盯几单，确认无误再放手跑。

常见问题#

测试报 403

原因：多半是签名问题。AWS 访问密钥或 secret 填错了，或者密钥背后的 IAM 用户/角色没有挂 SP-API 的 IAM 策略，亚马逊拒绝了签名请求。

解决办法：从 IAM → Security credentials 重新复制 AWS access key ID（以 AKIA 开头）和 secret；再在 IAM 里确认 SP-API 策略已挂到该用户或角色上。如果填了 role ARN，确认该角色存在且可被 AssumeRole。然后重新测试。

Refresh token 被拒或授权未完成

原因：refresh token 与 LWA Client ID、secret 对不上，或者应用对卖家账号的授权根本没有走完，亚马逊无法用这个 token 换取访问。

解决办法：在 Seller Central → Apps & Services → Develop apps 里把应用对卖家账号的授权走完，复制新拿到的 refresh token（以 Atzr| 开头），并确认 LWA Client ID 和 secret 来自同一个应用。三个一起重新粘贴，再测试。

拉到别的站点的订单，或根本拉不到订单

原因：Marketplace ID 与店铺实际在卖的站点对不上。连接测试可能照样通过，但亚马逊只返回您所填站点下的订单。

解决办法：确认店铺属于哪个站点，填该站点的 Marketplace ID——美国站是 ATVPDKIKX0DER，其他站点查 Amazon SP-API 文档。保存后手动拉一次，确认订单进来。

Seller ID 不被接受

原因：填进去的不是 Merchant token——比如填了店铺名、邮箱或其他账号 ID。亚马逊要的 Seller ID 是账号信息里的 Merchant token。

解决办法：在 Seller Central 进 Settings → Account info，把 Merchant token 原样复制（以 A 开头），粘贴为 Seller ID，再重新测试。