第一次申请 Amazon SP-API

1

先申请开发者资格和角色

注册私有 SP-API 开发者

本步完成标志“开发人员资料”已经点击“注册”提交；Amazon 审核通过后，所需角色显示为已批准。

实际操作入口解决方案提供商门户（Solution Provider Portal） https://solutionproviderportal.amazon.com/

本步官方说明注册私有 SP-API 开发者 https://developer-docs.amazon.com/sp-api/docs/register-as-a-private-developer

登录解决方案提供商门户，进入设置 → 开发人员资料；如果仍在卖家平台，则进入应用和服务 → 开发应用程序。
第一次进入会显示“解决方案提供商资料”注册表。按下表从上到下填写，不要选择公开开发者路线。

卖家平台左侧菜单中应用和服务下的开发应用程序入口 — 尚未迁移到解决方案提供商门户时，可以从卖家平台的“应用和服务 → 开发应用程序”进入注册页面。

先识别实际注册表

进入后先看到“解决方案提供商资料”页面

先对照下图确认已经进入正确页面，再根据后面的填写表逐项完成。组织身份和联系人信息均已遮蔽。

1/4 联系信息与数据访问：填写真实资料；“数据访问”选择“私人解决方案提供商”。

页面区域	选择或填写什么	提交前检查
联系信息Contact Information	填写真实经营主体、国家/地区、实际网站（页面要求时）和主联系人。	联系人邮箱能收到 Amazon case（支持案例）通知。
数据访问Data Access	选择“私人解决方案提供商：我开发的应用程序是为了将我的组织与亚马逊 API 整合”。	不要选择公开解决方案提供商。
角色Roles	勾选下方 7 个非受限卖家角色。	不申请买家个人身份信息或其他受限角色。
使用案例Use Cases	说明工具只供自己公司内部使用、读取哪些非受限数据、用于哪些经营分析。	按真实业务改写，不要照抄 Amazon 政策。
安全控制Security Controls	根据公司当前实际安全措施逐题回答。	不要为了通过审核虚构加密、审计或制度。
协议确认Agreements	阅读并勾选解决方案提供商协议、可接受使用政策和数据保护政策。	确认后点击“注册”。

卖家Skill基础数据功能申请这 7 个卖家角色

财务与会计核算
洞察销售伙伴
定价
库存和订单追踪
品牌分析
亚马逊物流
商品信息

角色只代表 API 权限范围；品牌、报告或站点数据仍可能要求店铺本身具备相应业务资格。

“使用案例”填写框架（先替换方括号，再按真实情况调整）

本应用是仅供[公司名称]内部使用的私有卖家应用，用于读取本公司卖家平台账户的非受限 SP-API 数据，并在本地生成库存、订单、销售、定价、商品、FBA、财务和品牌分析报表，以支持内部经营分析与补货决策。应用不向其他公司提供服务，不读取或保存买家个人身份信息，也不向第三方转授个人身份信息访问权限。授权凭据仅保存在公司控制的本地设备中，并限制为必要人员访问。

继续向下填写

完成角色、使用案例和安全控制，最后点击“注册”

以下三张图接续上方的 1/4 页面，只用于识别页面区域；浏览器信息和已选安全答案均已清除。

2/4 角色：勾选本说明列出的 7 个非受限角色；不要额外勾选红色“受限”角色。

3/4 使用案例与安全控制：使用案例按真实业务填写；每一道安全问题都按组织当前实际情况选择，不存在统一的推荐答案。

4/4 最终提交：完成剩余安全问题和外部方说明，阅读并勾选三项政策协议，最后点击“注册”。

2

角色获批后再创建应用

新建私有 SP-API 应用

本步开始条件第一步已经提交，所需角色已获 Amazon 批准；然后才进入“开发应用程序”注册私有应用。

实际操作入口登录后选择“开发应用程序” https://solutionproviderportal.amazon.com/

本步官方说明注册应用程序 https://developer-docs.amazon.com/sp-api/docs/registering-your-application

在解决方案提供商门户顶部选择“开发应用程序”，进入开发者中心后点击“添加新的应用客户端”。
先对照下图确认页面中的 API 类型、企业实体、角色和 RDT 转授区域，再按后面的填写表完成应用注册。

先识别实际应用表单

确认进入“应用注册”页面后再填写

截图中的应用名称和账号信息已经清除；只用于确认字段位置和需要选择的项目。

已隐藏应用名称的 Amazon SP API 应用注册表，选择卖家、七个卖家角色并将 RDT 转授设为否 — 已脱敏：应用名称为空。API 类型选 SP API；实体只选“卖家”；勾选 7 个角色；RDT 转授选“否”。

再逐项填写

按照下表选择，最后点击“保存并退出”

字段	应该填写或选择	不要这样选
应用名称	填写你自己容易识别的内部工具名称，例如“内部经营数据工具”。	不要填写密码、店铺邮箱或敏感账号信息。
API 类型	SP API	不要选广告 API。
支持的企业实体	勾选“卖家”。	本说明不勾选“供应商”。
角色	勾选与“开发人员资料”已批准的同一组 7 个角色。	不要额外申请受限角色或买家个人身份信息权限。
RDT 转授	选择否，我不会将 PII 访问权限授予另一个开发者的应用程序。	不要选择“是”。

3

从应用中取得前两项

查看 LWA Client ID 与 Client Secret

本步获得① Client ID　② Client Secret

实际操作入口开发应用程序 → LWA 凭证 → 查看 https://solutionproviderportal.amazon.com/

本步官方说明查看应用程序信息与凭证 https://developer-docs.amazon.com/sp-api/docs/viewing-your-application-information-and-credentials

进入“开发应用程序”，在应用列表找到刚才创建的应用。
在“LWA 凭证”一栏点击“查看”。
仅在当前电脑临时复制“客户端编码”和“客户端密钥”，稍后分别填入卖家Skill的 Client ID、Client Secret。

页面预览

先点击“查看”，再在弹窗中识别两项 LWA 凭证

已隐藏真实值的 LWA 客户端编码与客户端密钥弹窗 — 真实 Client ID 与 Client Secret 已隐藏；“轮换截止日期”指 Client Secret 的轮换信息，不是 Refresh Token 的有效期。

4

从自授权中取得第三项

授权私有应用并复制 Refresh Token

本步获得③ Refresh Token（每次授权会显示一个新的 Token）

实际操作入口开发应用程序 → 授权 https://solutionproviderportal.amazon.com/

本步官方说明授权私有应用程序 https://developer-docs.amazon.com/sp-api/docs/self-authorization

先识别授权页面

确认目标卖家账号和区域，再点击“授权应用”

应用 ID 已遮蔽；如果同一应用连接多个区域，页面可能显示多个授权入口。

应用 ID 已遮蔽的 Amazon 私有应用管理授权页面和授权应用按钮 — 已脱敏：应用 ID 已遮蔽。合并了多个区域账号时，Amazon 可能分别显示“授权应用”按钮；请保存每个授权对应的 Refresh Token。

再按顺序授权

每个需要接入的卖家账号都分别完成以下操作

1
打开授权
在应用旁边打开操作菜单，选择“授权”。
2
选择账号
对需要接入的卖家账号点击“授权应用”。
3
本人确认
由主账号本人完成 Amazon 登录和授权确认。
4
立即复制
复制页面显示的 Refresh Token，并记录它对应的账号/区域。

直接显示 Refresh Token

私有应用自授权完成后，页面会直接显示 Refresh Token。

当前不会自动过期

Amazon 当前官方说明为 Refresh Token 不过期；但撤销授权或权限变更仍可能要求重新授权。

新 Token 不会自动作废旧 Token

重新生成后应在卖家Skill中替换为确认有效的新值，并妥善处理不再使用的旧授权。

5

只在自己的电脑上操作

把三项 LWA 凭证配置到卖家Skill

本步完成标志站点选择正确，三项凭证校验通过并保存到本机。

先启动本地配置工具

双击“第1步_配置卖家信息.bat”

只需要按文件名找到并双击第1步；下图已经移除电脑磁盘和文件夹的绝对路径。

已移除绝对路径的卖家Skill基础数据包文件列表，正式红色圆角框标出第1步配置卖家信息批处理文件 — 在解压后的“基础数据包”文件夹中，双击**“第1步_配置卖家信息.bat”**。不要点击第2步或第3步。

自动弹出的填写页面

先选择经营站点，再填写对应区域的三项凭证

下图就是双击第1步后自动打开的页面；仅用于确认填写顺序，凭证输入框没有展示任何真实值。

卖家Skill 本地配置向导中的经营站点选择 — 先选择实际经营站点，不经营的站点不要勾选。

卖家Skill 本地配置向导中的 Client ID、Client Secret 和 Refresh Token 字段 — 再填写 Client ID、Client Secret、Refresh Token 三项凭证。

再按顺序操作

配置、校验并保存到当前电脑

将卖家Skill基础数据包完整解压到自己容易找到的文件夹。
进入解压后的“基础数据包”，双击“第1步_配置卖家信息.bat”。
等待浏览器自动打开本地配置向导；配置完成前保持命令窗口开启。
只勾选实际经营的 Amazon 站点；页面会按区域显示 SP-API 配置区。
填写同一应用的 Client ID、Client Secret，以及对应卖家授权生成的 Refresh Token。
点击“校验并保存配置”，确认页面显示校验成功。

卖家Skill字段	从哪里获得	格式检查
Client ID	步骤 3 的 LWA“客户端编码”。	完整粘贴，不要多空格或换行。
Client Secret	步骤 3 的 LWA“客户端密钥”。	完整粘贴；不要截图或转发。
Refresh Token	步骤 4 对卖家账号完成自授权后显示。	通常以 `Atzr\|` 开头；按账号/区域对应填写。

✓

最终验收

你应该已经拿到并保存这些内容

开发者资格

私人解决方案提供商已注册，7 个角色已经获批。

私有应用

SP API + 卖家 + 7 个角色 + RDT 转授“否”。

三项凭证

Client ID、Client Secret、Refresh Token 均来自同一应用和正确卖家授权。

本机配置

经营站点正确，校验并保存成功。

校验失败或返回 HTTP 403 时，按这个顺序检查

“开发人员资料”中的目标角色是否已批准，而不是仍在审核。
具体应用是否勾选并保存了同样角色。
角色变更后是否重新自授权，并替换为新的 Refresh Token。
Refresh Token 是否属于当前卖家账号/区域，站点是否选择正确。
店铺是否具备目标报告、品牌或业务数据的资格；403 不能当成“没有数据”。

配置验证通过后：

运行“第2步_初始化基础数据.bat”。
再运行“第3步_打开并补充基础数据.bat”。
蓝色内容来自 Amazon；黄色单元格按实际业务补充。

Amazon 官方说明

以下均为 Amazon 官方页面。Amazon 可能调整后台名称或位置；如画面不同，以官方最新说明为准。

注册总览https://developer-docs.amazon.com/sp-api/docs/sp-api-registration-overview
注册私有卖家开发者https://developer-docs.amazon.com/sp-api/docs/register-as-a-private-developer
SP-API 角色https://developer-docs.amazon.com/sp-api/lang-zh_CN/docs/roles-in-the-selling-partner-api
注册应用https://developer-docs.amazon.com/sp-api/docs/registering-your-application
查看 LWA 凭证https://developer-docs.amazon.com/sp-api/docs/viewing-your-application-information-and-credentials
私有应用自授权https://developer-docs.amazon.com/sp-api/docs/self-authorization
各站点 Seller Centralhttps://developer-docs.amazon.com/sp-api/docs/seller-central-urls