摘要：在俄罗斯跨境 ERP 系统开发过程中，很多开发者会踩一个大坑：Ozon Seller 没有单一接口返回完整商品卡片，基础信息、类目属性、长描述分散在不同接口。想要完成商品同步、草稿生成、库存价格同步，需要做多接口联合调用、数据合并组装。本文结合实际 ERP 项目开发经验，梳理鉴权、接口清单、标准调用流程、Python 实现、数据库设计以及线上踩坑，适合做 Ozon 跨境系统的后端开发者阅读。
一、业务背景
搭建 Ozon 模块的 ERP 系统，经常需要完成：全店商品同步、商品信息回显、生成刊登草稿、库存价格同步、商品数据统计。
开发过程中遇到典型问题：
/v3/product/info/list拿到的属性是精简子集，缺少类目完整必填参数，不能直接用于刊登；- HTML 长描述、部分视频信息需要额外接口获取；
- 多变体商品，变体 SKU 与属性分散在不同返回结果，需要做映射对齐；
- 批量拉取商品，要处理分页、分片、接口限流 429；
- FBO 平台仓、FBS 自发货两套库存，需要区分可售、锁定预留库存；
- 商品下架、审核中状态识别，过滤无效数据，避免脏数据入库。
想要拿到完整商品实体，必须多个 Seller 接口配合，做数据合并组装。
二、接口鉴权基础
- 鉴权方式：请求头携带
Client‑Id，从 Ozon 卖家后台 API页面生成获取 - 请求方式：全部 POST，
Content‑Type: application/json - 权限限制：Seller API仅可读取当前密钥所属店铺商品，不能读取第三方竞品，竞品数据需要第三方聚合接口。
- 批量上限：大部分查询接口单次最多传入 20 个
product_id，大批量任务必须分片处理。
