本文介绍如何在 Ozon 卖家后台取得 Seller API 凭证,并在 Linkfox 添加店铺账号。完成后,可在账号列表核对店铺名称、Client ID 和授权状态。
操作路径:Ozon 卖家后台获取 Client ID 和 API Key → Linkfox 工作台 → 账号授权管理 → 添加授权账号 → 店铺账号 / Ozon 店铺 → 填写凭证 → 校验凭证 → 核对成功结果与账号列表。
当前 Ozon 店铺接入采用凭证校验方式:填写 Client ID 和 API Key,校验通过后自动保存店铺关联。无需复制授权链接、回填授权码或再点击一次“完成授权”。
登录目标店铺的 Ozon 卖家后台,从右上角头像进入设置 → API 集成 → Seller API。先核对当前店铺,再复制页面中的 Client ID,然后点击右侧蓝色“生成密钥”按钮。

注意左侧同时可能出现 Performance API。本文应始终停留在 Seller API;广告服务账号的 Client ID 与 Client Secret 不能作为店铺凭证填入。
在生成密钥面板中,填写便于识别的密钥名称,例如 Linkfox 店铺接入;用途选择外部服务或应用,服务名称填写 Linkfox。按计划接入的店铺业务选择相应角色,确认后点击“生成”。
角色决定该密钥能访问哪些店铺业务。参考资料中的完整店铺接入方案采用勾选全部权限;实际选择范围应由店铺管理员按要使用的业务确认。若只授予部分角色,后续可用能力也受该范围限制。

生成后,在平台展示密钥的窗口中复制完整 API Key,用于下一步粘贴到 Linkfox。Client ID 和 API Key 必须来自同一个店铺,不要把密钥名称或掩码当成完整密钥。
密钥有效期:Ozon 官方已更新规则,自 2026 年 9 月 3 日起新建密钥有效期为 90 天。以上两张图片直接取自官方规则文章,但配图仍包含旧的“6 个月 / 180 天”示例文字;本次仅翻译红色教学标注,未更改平台原生期限和日期。请以官方更新的文字规则及实际后台显示的到期日期为准,并在到期前更新接入凭证。
打开 Linkfox 工作台,点击右上方“账号授权管理”。普通成员打开后的面板标题可能显示为“我的账号”。

在打开的账号面板中点击“添加授权账号”。已有其他账号也可继续添加,无需先删除原有账号。

在“授权新账号”弹窗中,账号类型选择“店铺账号”,授权平台选择“Ozon 店铺”,然后点击“下一步”。

确认表单顶部的当前授权对象为“Ozon 店铺 / 店铺账号”,再填写以下三个必填项。

| 字段 | 填写内容 | 核对重点 |
|---|---|---|
| 账号名称 | 自定义便于识别的店铺名称,例如“Ozon 俄罗斯店” | 用于在 Linkfox 识别账号,可按团队命名习惯填写。 |
| Client ID | Ozon 卖家后台 Seller API 页面复制的 Client ID | 对应当前要接入的店铺,不使用广告服务账号标识。 |
| API Key | 该店铺生成的完整 API Key | 与 Client ID 来自同一店铺;粘贴完整值。输入后以掩码显示。 |
三个字段填完后,右下角“校验凭证”按钮可点击。若仍不可点击,先检查是否有未填写或只有空格的必填项。

点击“校验凭证”后,等待系统完成校验和保存。处理期间不要重复提交;校验或保存未通过时,页面会保留在填写页并提示原因。
看到“Ozon 店铺授权成功”后,核对提示中的账号名称和 Client ID。当前流程在校验并保存成功后直接进入此页,无需另行确认保存。

结果表中的“官方授权:已授权”表示当前接入已成功;“数据同步:进行中”是独立显示的同步状态,不代表商品、订单等数据已经全部同步完成。请以实际业务页面的数据和同步提示为准。
管理员可点击“返回账号列表”,普通成员对应按钮可能为“返回我的账号”。如需继续添加其他店铺,可点击“添加其他授权账号”。
返回账号面板,将账号类型筛选为“店铺账号”、平台筛选为“Ozon”。核对目标账号名称、Client ID 和“已授权”状态;未立即看到时,可点击“刷新”或使用搜索框查找。

需要让其他成员使用店铺时,由团队创建者或管理员在该行“更多 → 成员权限”中管理。普通成员完成接入后,成功页会提示已自动授予当前账号使用权限;团队成员权限管理与平台凭证授权分别处理。
若 API Key 输入框下方出现红色错误提示,先按页面原因排查。表单内容会保留,修正后点击“重新校验”。

先确认列表中的目标店铺为“已授权”,并核对是否选中了正确店铺和业务范围。授权结果页出现“数据同步:进行中”时,可稍后再查看业务页面;持续异常时,保留账号名称、Client ID、发生时间和错误提示,联系支持人员核查。
其他 ERP 教程里的固定同步间隔、历史订单回溯天数和功能限制不直接适用于 Linkfox。本文不对首次同步耗时作固定承诺。
在 Ozon 后台为同一店铺生成新密钥,再按店铺配置提供的凭证更新入口重新录入和校验。新密钥需要覆盖实际使用的业务角色。若列表已显示“授权失效”,应先恢复凭证有效性,再核对业务数据是否恢复。
普通成员如没有更新或管理入口,请联系团队创建者或管理员处理;不要为更换密钥误建另一家店铺。
店铺 Seller API 授权与广告 Performance API 授权使用不同凭证。本文只完成 Ozon 店铺账号接入;需要广告能力时,另按 Ozon Ads 的账号授权流程办理。