跳到主要内容

Amazon 集成

概览​

注册私有 SP-API 应用,即可将 Amazon Seller 账号连接到 Frevana。本指南将帮助您获取 LWA Client ID、LWA Client Secret、Refresh Token 和 Merchant Token。

**预计时间:**约 5 分钟

开始之前​

您需要 Amazon Seller Central 账号,并具有该账号的 Primary User(主用户)权限;子账号无法注册应用。

第 1 步:打开 Seller Central Developer Console​

登录 Seller Central Developer Console。几秒后页面会跳转,Amazon 将询问要进入哪个账号。请选择 Sell on Amazon,因为我们需要店铺集成,而不是 Solution Provider。

打开 Seller Central Developer Console

选择 Sell on Amazon

第 2 步:验证电子邮件(仅首次使用)​

如果首次使用 Developer Console,Amazon 会显示 Solution Provider Portal 引导页面。在 Step 1: Authenticate all emails associated with your previous developer profiles 下,确认当前登录邮箱显示在 Developer Profiles 中,然后继续进入 Home Page。

提示

如果看到 “You already have SPP account(s), please continue to Home Page”,说明引导已完成,选择 Home Page 即可。

现在您应位于 Solution Provider Portal 首页。

第 3 步:注册新应用​

在 Solution Provider Portal 首页选择 + Add new app client。

添加 Amazon 应用客户端

填写应用注册表单:

字段值
App nameFrevana for Amazon(可使用任何 2–40 个字符的名称)
API TypeSP API
App TypeProduction
Business entities supported选择 Sellers,其他选项不勾选

填写 Amazon 应用注册表单

在角色选择中勾选以下角色,覆盖订单、库存、定价和刊登:

  • Selling Partner Insights — 账号信息与表现。
  • Pricing — 标价与自动定价。
  • Inventory and Order Tracking — 订单与库存分析。
  • Amazon Fulfillment — FBA 发货。
  • Product Listing — 刊登与 A+ 内容管理。

除非确有需要,否则不要勾选 Buyer Communication 和 Brand Analytics。

接下来处理 PII 委派。对于“Will you delegate access to PII to another developer's application?”,选择 No, I will not delegate access to PII to another developer's application.,然后选择 Save and exit。

选择 Amazon 应用角色和 PII 委派设置

第 4 步:复制 LWA 凭据​

返回首页,在表格中找到新应用,在 LWA credentials 列选择 View。在弹窗中复制:

  1. Client identifier(amzn1.application-oa2-client.…):这是 LWA Client ID。
  2. 展开 Client secret(amzn1.oa2-cs.…):这是 LWA Client Secret。

请记下弹窗显示的 Client Secret 轮换期限;轮换后需要在 Frevana 中更新密钥。

查看 LWA 凭据

复制 LWA Client ID 和 Client Secret

第 5 步:授权应用并复制 Refresh Token​

在应用所在行选择 Edit App 旁的下拉菜单,然后选择 Authorize。

打开 Amazon 应用授权菜单

选择 Authorize

在 Manage Authorizations 页面找到卖家名称,为目标市场组选择 Authorize app(例如北美的 Mexico、Canada、Brazil、United States)。

为目标市场组授权应用

Amazon 会引导您完成同意流程并返回。Refresh Token 列将显示以 Atzr|… 等字符开头的令牌。选择令牌旁的 Copy,这就是您的 Refresh Token。

备注

请立即保存令牌。每次再次选择 Authorize app 时都会生成新的刷新令牌。请妥善保管;如果访问被撤销或令牌停止工作,可能需要重新授权。

复制 Amazon Refresh Token

第 6 步:复制 Merchant Token(Seller ID)​

Merchant Token 位于 Seller Central 的常规设置中。

  1. 打开 Seller Central,在新界面中进入右上角 More → Settings(齿轮图标)→ Account settings。

打开 Seller Central 账号设置

  1. 在 Business Information 下选择 Your Merchant Token。

查找 Merchant Token

  1. 您会看到按区域分组的市场列表(Americas、Europe、Far East)。在销售所在区域的任一市场旁选择 Copy。

Merchant Token 与卖家账号而不是单个市场关联。同一区域内的市场共享同一令牌;例如,北美的美国、加拿大、墨西哥和巴西显示的值相同。复制首先使用的市场对应的值即可,它也适用于该区域的其他市场。

如果您跨不同区域销售(例如美国和英国),每个区域都有独立的卖家账号和 Merchant Token,请为每个区域分别完成设置。

第 7 步:向 Frevana 提供四个值​

按提示将以下信息粘贴到 Frevana 聊天中:

LWA Client ID: amzn1.application-oa2-client.xxxxxxxx...
LWA Client Secret: amzn1.oa2-cs.v1.xxxxxxxx...
Refresh Token: Atzr|IwEBIxxxxxxxx...
Merchant Token: A1B2C3D4E5F6G7

Frevana 还会询问您的销售市场(例如 US、CA、UK、DE 或 JP)。输入要连接的市场即可。

重要说明​

  • 凭据保存在每个 Frevana 隔离的本地 data/amazon-connect/ 目录中,不会发送给第三方。
  • 不同智能体团队可以连接不同的 Amazon Seller 账号。
  • Frevana 根据需要将刷新令牌交换为访问令牌;如果连接被撤销或停止工作,请重新授权。
  • 您可以随时通过 Seller Central → Develop Apps → 您的应用 → Authorize → Revoke 撤销访问权限。