店铺授权
普通用户四个平台的授权要求、凭证获取、填写步骤与成功检查。
普通用户支持哪些平台
当前普通用户的店铺授权入口为 Amazon、Ozon、Wildberries、Mercado Libre（美客多）。SHEIN、Etsy 当前不对普通用户开放；本手册不将它们列为可操作的平台。平台入口以当前账号实际权限为准。
普通用户维护自己拥有的店铺；共享给你的店铺可以用于上架，但凭证由所有者维护。授权只是建立平台连接，不等于开通卖家资格、经营站点或获得品牌 / 品类销售许可。
| 平台 | 授权方式 | 需要从平台取得什么 |
|---|---|---|
| Amazon | 公共应用 OAuth（推荐） / 私人应用凭证 | 公共应用：卖家账号同意，系统接收凭证；私人应用：LWA Client ID、LWA Client Secret、Seller ID、Refresh Token |
| Ozon | API 密钥 | 同一店铺的 Client ID + Seller API Key；可用仓库 |
| Wildberries | API 密钥 | 适用于当前集成的 API Token，填入 API Key；无需 Client ID |
| Mercado Libre | OAuth 跳转 | 卖家主账号同意；系统接收并维护 Token，无需手抄 |
授权前的共同准备
- 准备已开通目标业务的卖家账号，以及平台允许管理 API 或授权应用的账号权限。登录密码不等于 API Key。
- 明确真实经营站点、主体国家与店铺类型（跨境 / 本土），不要为了通过校验随意填写。
- OAuth 平台使用店铺日常登录浏览器和网络；允许打开授权窗口，核对平台域名与登录店铺后同意。
- 只在授权表单录入凭证；问题反馈截图遮盖 API Key、Secret、Token。截图均为本系统演示表单，不包含真实凭证或伪造的平台授权页。
Amazon：公共应用授权（推荐）
准备条件：可正常登录的 Seller Central 卖家账号、已开通的经营站点，以及该账号允许授权应用的权限。先核对要连接的是哪一个卖家和区域。公共应用模式不要求普通用户自己创建开发者应用或复制 Token。
- 进入“店铺授权 → Amazon → 绑定”，填写店铺名称、经营站点、主体国家和店铺类型。
- 选择“公共应用授权（推荐）”，保存店铺；按系统提示确认授权环境。未完成时可编辑店铺，从对应区域发起授权。
- 在 Amazon 打开的授权页面核对卖家、应用与请求权限，完成同意并等待返回。不要把另一个已登录卖家账号误授权给当前店铺。
- 在本系统检查每个所需区域的授权和站点同步状态。美国 / 加拿大 / 墨西哥对应北美区域，德国 / 英国等对应欧洲区域，日本 / 新加坡等对应远东区域；按表单列出的所需区域分别处理。
Amazon：检查区域与站点结果
- 编辑已绑定店铺，在“区域授权”查看区域名、Seller ID 和授权状态。
- 仍未授权或已失效时，使用该区域的授权操作；出现环境提醒时先确认日常登录环境。
- 返回店铺列表检查站点同步。如果授权成功但同步失败，先核对卖家区域、站点开通情况与反馈，不要直接上架。
Amazon：私人应用凭证
适用于已经具备 SP-API 私人应用的卖家。需要有效的开发者资料、所需 API 角色权限和自己的应用；自授权需要卖家主账号。普通用户没有这套资料时应使用公共应用路径。
- 在绑定 / 编辑表单选择“私人应用凭证”，填写 LWA Client ID 和 Secret。
- 为页面列出的每个区域填写 Seller ID 和对应 Refresh Token，保存后使用区域验证操作核对状态。
- 若改为公共应用，先保存授权方式变更，再重新完成各区域授权；以页面提示为准，旧私人凭证会被清除。
| 字段 | 从哪里取得 / 用途 |
|---|---|
| LWA Client ID / LWA Client Secret | 在 Amazon 开发者应用的 LWA 凭证中查看；两者必须属于同一应用，不是 AWS Access Key。 |
| Seller ID / Merchant Token | 从目标卖家账号的账户信息中查看，核对对应区域的卖家。 |
| Refresh Token | 在该私人应用的 Authorize app / 授权应用页面，对目标卖家账号自授权获得；按本系统所需区域填写。 |
| Access Token | 系统使用上述凭证自动换取，不需要手填。 |
Ozon：取得 Client ID、API Key 并绑定仓库
准备条件：有效的 Ozon Seller 店铺、可管理 Seller API 密钥的账号权限，以及业务使用的仓库。Client ID 与 API Key 必须来自同一个店铺。
- 登录目标 Ozon Seller 店铺，进入“设置（Настройки）→ Seller API / API 密钥”。入口名称可能随语言变化，可通过下方 Seller API 入口进入。
- 复制 Client ID，创建并保存 Seller API Key。按本次上架业务授予商品、价格、库存及仓库查询所需权限；只有读取权限不能完成写入上架。不要使用广告 Performance API 的凭证。
- 在本系统“店铺授权 → Ozon → 绑定”，填写真实店铺资料与经营站点，将 Client ID 和 API Key 分别粘贴到对应字段。
- 在表单查询仓库，选择本店铺实际使用的仓库，按业务配置物流渠道和规格，再保存。
- 检查店铺与站点状态，确认仓库配置和目标上架店铺一致。查询失败时先检查密钥、所属店铺与权限；新建仓库和业务开通须先在平台完成。
Wildberries：API Token 与权限
准备条件：有效的 WB 卖家账号、API 集成管理权限，以及适用于当前集成方式的 Token。本系统填写一个 API Key，不需要 Client ID。
- 进入 WB 卖家后台的“API Integrations / API 集成”，创建用于当前服务的 Token。若平台提供该服务的目录入口，按服务入口创建；其他类型先核对平台规则及当前部署的支持情况。
- 核对商品卡和图片所需 Content（内容）、价格所需 Prices and Discounts（价格与折扣），使用 Read and Write（读写）权限；涉及库存 / 仓库操作时另需 Marketplace 类别。
- 复制完整 Token 并安全保存；平台创建窗口关闭后可能无法再次查看。不要使用测试 Token 连接真实业务，也不要拿其他服务的 Token 混用。
- 进入本系统“店铺授权 → Wildberries → 绑定”，填店铺资料、实际经营站点，将 Token 粘贴到“API Key”并保存。
- 检查授权 / 同步状态。401 或过期提示先核对 Token；403 先核对类别、读写权限和服务适用性。有权限报错时联系支持并提供脱敏错误，不反复提交同一商品。
Mercado Libre：先选跨境 / 本土，再 OAuth 授权
准备条件：有效且完成平台所需身份验证的卖家主账号、实际经营站点，以及正确的店铺类型。平台操作员 / 协作者账号不能替代主账号完成此授权。无需普通用户创建开发者应用或手填 Client Secret、Access Token、Refresh Token。
- 进入“店铺授权 → Mercado Libre → 绑定”，填写店铺名称、主体国家，选择实际经营站点和店铺类型。
- 跨境店走 Global Selling 授权；本土店只配置一个经营站点，系统按该站点打开对应国家授权。不要把跨境账号选成本土店。
- 保存后按环境提醒继续授权；未完成时在店铺列表或编辑页面点击“授权 / 重新授权”。
- 在平台授权页面登录正确的卖家主账号，核对应用权限并同意，等待返回本系统。系统接收授权码并换取、维护 Token。
- 检查授权及站点同步状态，再去店铺管理核对经营站点。授权窗口打不开时允许弹窗；invalid_operator_user_id 使用主账号；账号身份验证或被限制问题在平台处理。
OAuth：确认环境后再进入平台
Amazon 公共应用与 Mercado Libre 在打开平台前会展示授权环境提醒。确认自己处于店铺日常登录环境后继续；到平台页面仍需核对账号、应用和权限，完成同意并返回。截图是本系统的提醒，不是平台已授权的证明。
授权完成的验收与维护
- 保存成功、授权成功、站点同步成功是不同阶段；以对应状态及平台反馈检查，不凭“绑定成功”判断可上架。
- 缺少平台：先核对账号当前权限；缺少店铺：核对所有者与共享使用权限。
- 密钥失效、Token 到期或平台撤销授权：所有者更新凭证或重新授权后，先核对原任务是否已提交，再决定重试。
- 出现应用配置、回调地址或服务认证错误时，记录平台、店铺、时间和脱敏错误，联系支持处理；普通用户无需自行修改应用配置。
- 解绑或变更授权前先核对依赖该店铺的任务。