SP-API 申请第 3 步：开发者资料逐栏填写（角色 · 用例 · 安全问卷）
开发者资料决定你能拿到哪些数据、审核要多久。原则只有两条：只申请用得到的角色；用例按事实写清楚谁在用、怎么用、数据放在哪里。
Developer Profile 逐栏演示（可点击任一步）
字段顺序按官方 Step 3 文档排列；示例值均为占位，请替换成你的真实信息。
SP-API 角色怎么选？琼仁智度用到的数据与对应角色
官方规则：每个接口列出的角色中，具备任意一个即可调用 [6]。下表按官方角色映射（接口与报告两份文档）整理，右列是我们建议勾选的最少组合。
| 琼仁智度用到的数据 | 对应接口 / 报告 | 官方映射中可用的角色（任一） | 建议勾选 |
|---|---|---|---|
| 订单报告（金额、SKU、ASIN） | Reports API：按下单日期的全部订单报告 | Inventory and Order Tracking、Amazon Fulfillment、Pricing [5] | Inventory and Order Tracking |
| 退款（财务事件） | Finances API | Finance and Accounting；旧版财务事件接口 Amazon Fulfillment 也可 [6] | Finance and Accounting |
| FBA 库存报告 | Reports API：FBA 库存类报告 | Amazon Fulfillment、Pricing [5] | Amazon Fulfillment |
| FBA 退货报告 | Reports API：FBA 客户退货报告 | Amazon Fulfillment、Pricing [5] | Amazon Fulfillment |
| 业务报告（会话与转化） | Reports API：Sales and Traffic 报告 | Brand Analytics（只认这一个）[5] | Brand Analytics |
| 价格与促销价（读取与修改） | Listings Items API | Product Listing、Inventory and Order Tracking [6] | Product Listing |
| 费用预估 | Product Fees API | Product Listing、Pricing 等多个角色 [6] | Product Listing |
| 商品目录 | Catalog Items API | Product Listing [6] | Product Listing |
| 推荐报价（Featured Offer）价格 | Product Pricing API | Pricing [6] | Pricing |
| A+ 内容 | A+ Content Management API | Product Listing、Brand Analytics [6] | Product Listing |
依据官方 Role Mappings 文档（2026-09 版本）整理。亚马逊会调整映射，申请时以 Solution Provider Portal 中的角色说明为准；Brand Analytics 能否获批、报告覆盖范围，以审核结果为准。
SP-API 用例（Use Cases）怎么写？如实填写范本
官方审核看应用功能以及是否符合 AUP/DPP，数据安全优先 [4]；申请须原创、少于 500 词、不得照抄政策原文 [2]。下面的范本约 300 词，按事实写清三件事：谁在用、用哪些数据、数据与凭证放在哪里。
你使用 PPCWISER 软件，就要写明使用了第三方软件。AUP 要求对数据用途清楚、诚实地说明，提交给亚马逊的材料须准确 [3]。范本中方括号的内容替换成你的真实信息；你的实际情况与范本不同的地方，按实际改写。
英文范本（可复制后按实际修改）
We are [Your Company Name], a professional seller on Amazon.com (United States). We are registering as a private developer to connect only our own seller account to the Selling Partner API.
How we use the SP-API: we use PPCWISER, a third-party advertising automation software, to manage the advertising of our own store. The software client runs on our own Windows computer. Our SP-API credentials (LWA client ID, client secret and refresh token) are stored encrypted only on that computer and are never sent to the software provider. All API requests are sent from our own network.
Data we use: order reports (amounts, SKUs and ASINs, without buyer personal information), financial events for refunds, FBA inventory and returns reports, the Sales and Traffic business report, listings (to read and update our own prices and promotions), product fee estimates, catalog items, featured offer pricing and A+ content. Our advertising and order data is processed by the PPCWISER hosted service only for our own store, to calculate product profit, compare advertising and organic orders, monitor inventory, and adjust our own advertising and prices.
Roles: we request only non-restricted roles: Product Listing, Pricing, Inventory and Order Tracking, Amazon Fulfillment, Finance and Accounting, and Brand Analytics. We do not request any restricted role, and we do not access or store buyer personally identifiable information such as names, addresses, phone numbers or email addresses. The data is used only for our own business; it is not sold, and it is not shared with anyone other than the PPCWISER hosted service that processes it for our store.
中文对照（仅供理解，提交请用英文）
我们是 [你的公司名称]，亚马逊美国站的专业卖家，以私有开发者身份注册，只把我们自己的卖家账户接入 SP-API。
用途：我们使用第三方广告自动化软件 PPCWISER 管理自己店铺的广告。软件客户端运行在我们自己的 Windows 电脑上；SP-API 凭证（LWA Client ID、Client Secret、Refresh Token）只加密保存在这台电脑上，从不发送给软件提供方；所有 API 请求从我们自己的网络发出。
使用的数据：订单报告（金额、SKU、ASIN，不含买家个人信息）、退款相关财务事件、FBA 库存与退货报告、Sales and Traffic 业务报告、Listings（读取与修改自己的价格和促销）、费用预估、商品目录、推荐报价价格与 A+ 内容。广告与订单数据由 PPCWISER 托管服务仅为本店处理，用于核算产品利润、对比广告与自然订单、监控库存、调整自己的广告与价格。
角色：只申请非受限角色（6 个，见上）；不申请任何受限角色，不访问、不存储买家姓名、地址、电话、邮箱等个人信息。数据只用于我们自己的业务，不出售，除为本店处理数据的 PPCWISER 托管服务外不与任何人共享。
凭证归属、数据流向的完整说明见 API 授权与数据说明。
SP-API 安全问卷（Security Controls）怎么答？
问卷考察的是你的实际做法，并要能对应数据保护政策（DPP）与官方关键安全控制指南 [10][12]。下表是作答要点，不是答案：没做到的先做到，再如实写。
| 控制项 | 官方要求（摘要） | 你这边要做到并如实说明的 | 与琼仁智度相关的设计 |
|---|---|---|---|
| 凭证管理 | 所有账号启用 MFA；API 密钥等程序凭证加密存储、定期轮换 [10] | 卖家中心、SPP 开启两步验证；Client Secret 每 180 天轮换 [11] | 凭证只在你电脑上的中转客户端加密保存，云端不接收、不存储 |
| 访问管理 | 每人独立账号、最小权限 [12] | 员工各用独立的卖家中心子账号；离职及时回收权限 | — |
| 网络防护 | 防火墙、防恶意软件等网络与终端防护 [12] | 中转电脑开启系统防火墙与杀毒软件、设置自动锁屏 | 中转客户端只主动外连，不开放入站端口 |
| 传输加密 | 传输使用 TLS 1.2 及以上 [10] | — | 中转与云端之间、调用亚马逊端点均使用 HTTPS |
| 事件响应 | 发现安全事件 24 小时内报告亚马逊 [10] | 写下你的处置流程：轮换 Secret、撤销授权、按时报告 | 停掉中转客户端，云端即无法再操作你的账户 |
官方建议安全控制问题由负责数据安全的技术人员作答 [2]。请勿照抄本表或政策原文。
SP-API 开发者资料填写步骤
打开 Developer Profile
SPP → Settings（齿轮）→ Developer Profile已迁移用户从 Solution Provider Portal 的 Settings → Developer Profile 进入 [4]。
填写 Contact Information
Developer Profile → Contact Information填写组织名称、网站、国家与主要联系人 [1]。组织名称与身份验证时一致。网站的硬性质量要求只写在公共开发者页面 [13]。
Data Access 选 Private Developer
Developer Profile → Data Access选择 Private Developer: I build application(s) that integrate my own company with Amazon Services APIs [4]。
勾选 6 个非受限角色
Developer Profile → Roles按上方角色表勾选 Product Listing、Pricing、Inventory and Order Tracking、Amazon Fulfillment、Finance and Accounting、Brand Analytics，不勾任何受限角色 [7]。
等待审核，5 天内回复追问
SPP / Develop Apps 页面横幅 + 管理员邮箱审核期间页面显示注册审核中的横幅 [14]。亚马逊来信追问须在 5 天内回复，否则案件结案 [4]。获批后进入 第 4 步：创建应用与自授权。
下一步：创建应用并自授权
SP-API 凭证到手后，琼仁智度用它帮你做什么？
SP-API 提供的是订单、退款、库存、价格与费用这类经营数据，广告数据则来自 Amazon Ads API；两者按 ASIN 关联，才能算出广告花费占总销售的比例这类总账指标 [15]。PPCWISER 琼仁智度把两边的数据放进同一本账：
- 按实付价、退款与费用核算每个产品的净利，出价上限受利润约束——见 真实净利账本
- 广告订单与自然订单放在同一本账里看，用总账衡量投入产出——见 广告订单 vs 自然订单
- 有库存无订单、购物车丢失、断货预警，避免没货还在烧广告——见 库存与购物车预警
系统的算法按统一的广告结构运行：接入时你可以重构正在跑的广告系列（方案 A），或保留原系列另建一套标准结构（方案 B），见 广告结构说明。自己申请卡住了？可以选择 API 申请协助（¥499/次）：你本人登录并亲自操作，我们远程指导填写。
SP-API 开发者资料常见问题
用琼仁智度需要申请哪些 SP-API 角色？
SP-API 用例写多少字合适？
没有品牌备案，Brand Analytics 角色能批吗？
凭证准备好，就可以开始 30 天免费试用
全部功能开放，试用期不收订阅费；之后入门版 ¥99/月/店铺（含 10 个产品），每多 1 个产品 +¥10/月。API 不想自己摸索？申请协助 ¥499/次，你本人操作、我们远程指导。
相关功能
建应用与自授权
草稿应用即可自授权：拿到 Client ID、Secret、Refresh Token 与两个 ID。
查看 →SP-API · 第 2 步注册与身份验证
SPP 注册 → 企业信息 → PIN → 联系人证件 → 身份核验，逐页演示。
查看 →透明说明API 授权与数据说明
凭证归属、调用方式、处理哪些数据与用途、申请表如何如实填写。
查看 →服务API 申请协助
¥499/次：你本人操作，我们远程指导 SP-API 与 Ads API 申请。
查看 →SP-APISP-API 申请
SP-API 私有应用申请 5 步：准备、注册验证、开发者资料、建应用自授权、轮换。
查看 →参考资料与权威来源
本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文；访问日期 2026-09。
- [1]官方Step 3: Create a Developer Profile — Amazon Selling Partner API Docs · 2026开发者资料包括联系信息、数据访问类型、角色、用例与安全控制问答；标准（非受限）角色审核通常 1–2 周，受限角色需经过业务、安全、技术三段审核。
- [2]官方SP-API Registration Overview — Amazon Selling Partner API Docs · 2026开发 SP-API 私有卖家应用需要专业销售账户（个人账户不行）；必须由主账号用户完成注册；开发者资料申请须原创、少于 500 词，不得照抄 AUP/DPP；安全控制问题应由负责数据安全的技术人员作答。
- [3]官方Acceptable Use Policy（SP-API） — Amazon Seller Central · 2026SP-API AUP：2.2 须对授权用户清楚、诚实地说明访问哪些数据及用途；提交给亚马逊的材料须准确；3.1 不得共享访问密钥或密码；3.2 不得出于任何目的索取或接收授权用户的访问密钥；3.3 不得索要卖家中心用户名密码；3.5 连续 90 天无成功调用的访问密钥会被删除；3.8 不得申请应用功能用不到的数据。
- [4]官方Register as a Private SP-API Developer — Amazon Selling Partner API Docs · 2026私有开发者只把本公司接入亚马逊 API；Data Access 选择 Private Developer；已迁移用户从 Solution Provider Portal 的 Settings → Developer Profile 进入；亚马逊来信追问须在 5 天内回复，否则案件结案。
- [5]官方Role Mappings for SP-API Types — Amazon Selling Partner API Docs · 2026列出每类报告所需角色：销售与流量业务报告需 Brand Analytics；FBA 库存、费用预估、退货报告需 Amazon Fulfillment 或 Pricing；订单报告可用 Inventory and Order Tracking 等非受限角色。
- [6]官方Role Mappings for SP-API Operations — Amazon Selling Partner API Docs · 2026列出每个 API 操作可由哪些角色调用：如订单查询可由 Inventory and Order Tracking 等非受限角色调用，财务事件需 Finance and Accounting 等角色，竞争价格摘要需 Pricing 角色。
- [7]官方Selling Partner API Roles — Amazon Selling Partner API Docs · 2026SP-API 按角色授权数据访问；Direct-to-Consumer Shipping、Tax Invoicing、Tax Remittance、Professional Services 四个角色为受限角色，可能涉及个人身份信息（PII）。
- [8]官方Access Orders PII — Amazon Selling Partner API Docs · 2026没有受限角色时，美国订单的买家姓名、地址、电话、邮箱等 PII 字段不会返回；订单金额、SKU、ASIN 等非 PII 数据不受影响。
- [9]官方Update Your Developer Profile in Solution Provider Portal — Amazon Selling Partner API Docs · 2026需要增加角色时，在 Solution Provider Portal 更新开发者资料并重新提交审核。
- [10]官方Data Protection Policy（SP-API） — Amazon Seller Central · 2026SP-API DPP：所有账号启用 MFA、API 密钥等程序凭证加密存储并至少每 12 个月轮换、传输使用 TLS 1.2 以上、发现安全事件 24 小时内报告亚马逊。
- [11]官方Rotate your Application's LWA Credentials — Amazon Selling Partner API Docs · 2026所有 SP-API 应用必须每 180 天轮换一次 LWA client secret，到期前 90 天收到通知；只有主账号用户能轮换；旧 secret 在生成新 secret 后 7 天失效；逾期未轮换调用会报错。
- [12]官方Key Security Control Guidance — Amazon Selling Partner API Docs · 2026官方关键安全控制指南：网络防护、每人独立账号、最小权限、启用 MFA、凭证加密存储与定期轮换、传输加密、事件响应等，并对应 DPP 条款。
- [13]官方Register as a Public SP-API Developer — Amazon Selling Partner API Docs · 2026公共开发者须有公开可访问、介绍其服务的网站（不能在建设中、有安全警告或只有登录页），并须按 SPP 协议把应用上架 Selling Partner Appstore。
- [14]官方Developer Registration Request Status — Amazon Selling Partner API Docs · 2026审核期间页面显示注册审核中的横幅；未通过时页面会列出未满足的问题与控制项，修改后可重新提交开发者资料。
- [15]官方Ads + Selling Partner APIs Onboarding and Best Practices — Amazon Ads API Knowledge Hub · 2024TACOS = 广告花费 ÷ 总销售额（广告 + 自然），需要结合 Ads API 与 Selling Partner API 数据计算。
- [16]官方Authorize Applications — Amazon Selling Partner API Docs · 2026私有应用只有在新增角色时才需要重新自授权；公共应用由卖家通过 OAuth 授权。