十六、Ozon 店铺绑定教程
将 Ozon 店铺连接到海云星 ERP，需要先在 Ozon 卖家后台获取 Client-Id 和 Api-Key，再到 ERP 绑定，并设置用于后续库存推送的默认仓库。
操作顺序：登录 Ozon 卖家后台 → 获取 Client-Id → 生成 Api-Key → 在 ERP 绑定店铺 → 核对授权结果 → 设置默认仓库。
1. 绑定前准备
- 登录 Ozon Seller 卖家后台，切换到本次需要绑定的店铺，使用有权管理 API 密钥的账号操作。
- 登录 海云星 ERP，确认当前公司正确，账号有查看、绑定和设置 Ozon 店铺的权限。
- 每个 Ozon 卖家账号对应一个 Client-Id。多店铺请分别获取各店铺的凭证，逐店绑定。
2. 在 Ozon 后台获取 Client-Id 和 Api-Key
- 点击 Ozon 卖家后台右上角的 头像 / 个人中心 → 设置（Settings / Настройки）。
- 进入 API 密钥（API keys / API ключи），找到 Seller API。也可登录后直接打开 Ozon API 密钥页面。不同语言版本的入口名称可能略有不同。
- 复制页面上的 Client ID，它对应 ERP 中的 Client-Id，填写纯数字。
- 点击 生成密钥（Generate key / Сгенерировать ключ），填写便于识别用途的名称，例如 海云星 ERP。
- 选择密钥的访问角色：商品刊登需要 商品、价格与库存、仓库相关的读写权限，也可选择 Admin（管理员）。需要使用订单 / 发货功能时，还应具备对应角色。仅有只读权限的密钥无法完成商品发布和库存更新。
- 点击 生成，立即复制并妥善保存 Api-Key。密钥只在生成时显示一次；关闭后未保存，需要重新生成。
Client-Id 与 Api-Key 必须来自同一个 Ozon 卖家账号。 这里使用 Seller API 的凭证；请勿填写 Performance API 广告凭证、登录密码或其他店铺的密钥。不要将明文 Api-Key 放进群聊、公开文档或问题截图。
3. 在海云星 ERP 绑定店铺
进入 店铺管理 → 店铺账号，切换到 Ozon 店铺 页签，点击 绑定新店铺。
| 字段 | 填写说明 |
|---|---|
| 店铺名称 | 自己容易辨认的名称，仅用于 ERP 内区分店铺，最多 100 个字符。 |
| Client-Id | 从 Ozon Seller API 页面复制的 Client ID，填写纯数字。 |
| Api-Key | 同一家店铺生成的完整 Seller API 密钥。 |
填写完成后点击弹窗右下角 确认，等待校验。系统向 Ozon 核对凭证后完成绑定，Api-Key 校验通过后加密保存，不会回显。
提交后 Api-Key 输入框会清空。如果提示绑定失败，按错误提示处理，再重新复制密钥填写并提交。
绑定成功后，有店铺设置权限的账号会自动打开 Ozon 店铺设置，继续选择默认仓库。提示“已绑定，但仓库同步失败”或“Ozon 没有返回仓库”时，店铺绑定已经完成，按下一步处理仓库即可。
4. 核对授权结果与密钥权限
回到 Ozon 店铺 列表，逐项检查：
| 检查项 | 应核对的结果 |
|---|---|
| 店铺名称、Client-Id | 与本次要绑定的店铺一致。 |
| 授权状态 | 显示 已授权。 |
| 店铺状态 | 需要使用时应为 启用。 |
| 密钥到期 | 以平台返回及页面显示的时间为准，临近到期时提前更新。 |
| 密钥权限 | 完整 表示已覆盖系统检查的发布必需接口；提示缺少权限时先补齐角色，提示未能校验时稍后重试 校验，再检查结果。 |
| 结算币种 | 与 Ozon 店铺一致；提示 暂不支持 时，该币种暂不能用于定价发布，店铺仍可查看和设置。 |
需要重新核对已保存的密钥时，在该店铺所在行点击 校验；详细信息可在 更多 → 详情 查看。
角色覆盖检查针对发布必需接口，使用订单 / 发货功能时还需核对相应权限。店铺已授权后，商品仍需另行提交刊登并跟进平台审核与在售状态。
5. 设置默认仓库
在店铺所在行点击 店铺设置：
- 确认 店铺名称，开启 启用店铺，按实际业务核对 增值税率。
- 点击 同步仓库，读取这家店铺在 Ozon 的仓库。
- 在 默认仓库 下拉框选择实际用于该店铺库存的可用仓库。
- 点击 确认 保存，返回列表核对默认仓库名称。
没有仓库时，先在 Ozon 卖家后台创建并完成仓库配置，再回到 ERP 点击 同步仓库。原默认仓库显示不可用或下拉项置灰时，核对平台侧状态，重新同步并选择可用仓库。
普通新商品刊登前必须设置可用的默认仓库。 尚未选仓时可以先保存店铺设置，准备发布前再补齐；默认仓库用于后续库存推送。
6. 已绑定店铺怎样更新密钥？
授权状态显示 需更新密钥、密钥临近到期，或已在 Ozon 更换密钥时：
- 在 Ozon 后台为原店铺生成具备所需角色的新 Api-Key。
- 回到 ERP 原店铺所在行，点击 更新密钥。
- 核对店铺名称和 Client-Id，粘贴新 Api-Key，点击 确认。
- 校验通过后，新密钥会替换旧密钥。返回列表检查授权状态、到期时间和角色覆盖，再继续业务操作。
更新密钥时 Client-Id 不能修改。要连接另一家 Ozon 店铺，请使用 绑定新店铺；原店铺密钥过期时，直接更新原记录即可。
7. 绑定常见问题
找不到 API 密钥或 Seller API 入口怎么办？
先核对登录的卖家账号与当前店铺，再从设置进入 API 密钥页面。账号无权管理密钥时，请店铺管理员操作；仍没有入口时，联系 Ozon 核实 API 使用权限。
提示 Client-Id / Api-Key 无效或密钥已过期怎么办？
检查两项凭证是否来自同一家店铺、Api-Key 是否复制完整，以及密钥是否已过期或停用。需要重新生成时，在 ERP 原店铺 更新密钥；首次尚未绑定成功时，重新填写绑定表单。
提示缺少角色或接口权限怎么办？
按提示为密钥配置商品、价格与库存、仓库等所需读写角色；需要重新生成密钥时，回到原店铺 更新密钥，再点击 校验。订单 / 发货接口缺权限时，还需补齐相应角色，不能只检查发布角色覆盖。
提示 Client-Id 已绑定怎么办？
先在当前公司的 Ozon 店铺列表查找原记录，已有店铺通过 更新密钥 恢复。提示绑定在其他公司时，核对当前登录的公司，并联系原绑定公司的管理员处理。
绑定成功但认领或发布时选不到店铺怎么办？
检查授权状态和 店铺设置 → 启用店铺。子账号还需由管理员核对角色及店铺访问权限，参阅 角色与权限设置。发布前还需确认结算币种受支持、默认仓库可用。
仓库同步失败或请求触发限流怎么办？
绑定已经成功时，在 店铺设置 中重试 同步仓库。遇到限流或临时网络错误，按提示稍后再试；持续失败时，将操作时间、目标店铺及错误提示提供给管理员，并遮挡明文密钥。
删除 ERP 店铺会删除 Ozon 商品或停用密钥吗？
ERP 的 删除 会移除本系统内的店铺绑定、密钥和仓库数据，Ozon 上的商品和平台侧 Api-Key 仍保留。不再使用该密钥时，请到 Ozon 卖家后台删除或停用。
8. 官方参考
- Ozon 官方 Seller API 密钥生成教程（俄文）：设置入口、生成密钥、角色类型与允许访问网络的设置说明。
- Ozon Seller API 官方文档：鉴权、角色与接口说明。