Ozon平台JSON格式商品数据规范详解

Ozon作为俄罗斯最大电商平台之一，其API对接强制要求使用结构化JSON格式上传商品信息。准确编写符合Ozon Schema v2.1规范的JSON是上架成功率、搜索曝光及合规运营的前提。

Ozon一对一入驻运营辅导，联系电话13122891139

JSON结构核心要素与官方强制字段

Ozon官方文档（Ozon Seller API v2.1, 2024年7月更新版）明确规定：所有通过/v2/product/import接口提交的商品数据必须为UTF-8编码的JSON对象数组，单次请求≤1000条。关键字段分三类：

• 必填字段（12项）：包括name（俄语，≤255字符）、offer_id（卖家自定义SKU，唯一且不可含空格/特殊符号）、price（含税，单位RUB，精度2位）、currency_code（固定为"RUB"）、visible（布尔值，true/false）、category_id（需从Ozon类目树API实时获取，非静态ID）、barcode（GTIN-13或EAN-13，无则填""）、weight（kg，精度3位）、length/width/height（cm，精度1位）、images（数组，首图URL必须可公开访问且≥800×800px）；
• 条件必填字段（依类目而定）：如服装类需color和size，电子类需model_number和manufacturer；Ozon类目规则库（Seller Help Center, 2024 Q2更新）显示，约68%的类目存在额外属性强制要求；
• 推荐字段（影响转化率）：description（俄语HTML富文本，含关键词密度≥3%，据Ozon 2023卖家白皮书，完整描述商品点击率提升22%）、video（MP4链接，带字幕者加权曝光+15%）、attributes（键值对数组，如{"id": 12345, "values": ["LED"]}，ID须来自/v1/category/attribute接口返回）。

数据验证与错误规避实操指南

据Ozon官方错误日志统计（2024年1–6月平台后台数据），73.6%的JSON导入失败源于格式硬伤。最常见问题包括：JSON语法非法（如尾逗号、单引号代替双引号）、字段类型错配（如price传字符串"1999.00"而非数字1999.00）、嵌套层级错误（如images写成{"url":"..."}而非[{"url":"..."}]）。实测验证建议采用三步法：① 使用JSONLint校验基础语法；② 调用/v2/product/import/validate预检接口（响应含具体错误行号与字段名）；③ 对俄语字段启用Yandex.Translate API v2批量校验拼写与术语合规性（Ozon要求禁用机器直译，如"smartphone"必须译为"смартфон"，而非"умный телефон"）。

本地化适配与高转化JSON优化策略

中国卖家需特别注意俄语本地化深度。Ozon 2024年Q2《跨境卖家运营报告》指出：含本地化属性（如country_of_origin填"CN"、packaging_type选"коробка"而非"box"）且描述中嵌入地域词（如"для России"、"бесплатная доставка по РФ"）的商品，平均停留时长延长41秒，加购率提升18.3%。技术层面，推荐使用Python jsonschema库加载Ozon官方Schema文件（GitHub公开仓库）进行自动化校验；对于多属性变体（如颜色+尺寸），必须使用variants数组并确保offer_id全局唯一——实测显示，未拆分变体导致的库存同步失败占类目投诉量的31%（数据来源：Ozon Seller Support 2024年内部通报）。

常见问题解答（FAQ）

哪些类目对JSON格式要求最严格？

医疗器械、儿童用品、化妆品三类目执行Ozon GOST-R强制认证字段校验。例如儿童玩具必须提供age_group（值域限定为"0-3", "3-6", "6+"）、certification_number（12位俄文证书编号）及certification_date（ISO 8601格式）。2024年H1数据显示，该三类目JSON拒收率高达42.7%，远超平台均值11.2%（Ozon合规中心《2024上半年类目审核报告》）。

JSON文件如何通过Ozon后台手动上传？是否支持Excel转JSON？

Ozon Seller后台不支持直接上传JSON文件，仅开放API对接。但官方提供免费工具JSON Converter，可将Excel（.xlsx）按模板映射生成合规JSON——需严格遵循其列名规范（如"Наименование"→name，"Артикул"→offer_id），且Excel必须保存为UTF-8编码。注意：该工具不校验俄语内容质量，仍需人工复核。

JSON中图片URL有哪些硬性限制？

所有images URL必须满足：① HTTPS协议；② 域名已添加至Ozon白名单（需在Seller后台「设置→API→域名管理」提交）；③ 图片服务器响应头含Access-Control-Allow-Origin: *；④ 单图大小≤10MB。实测发现，使用阿里云OSS直链但未配置CORS会导致92%的图片加载失败（2024年深圳某大卖A/B测试数据）。

如何处理多语言JSON？Ozon是否接受中英俄三语混传？

Ozon仅接受俄语字段值。任何非俄语内容（含中文、英文）将触发自动拦截。正确做法是：所有文本字段（name, description, attributes.values）必须为纯俄语，且使用西里尔字母。Ozon明确禁止在description中插入隐藏HTML注释或meta标签作弊（《Ozon Platform Rules v3.4, Section 7.2》）。

JSON提交后状态为"processing"超2小时未完成，应如何排查？

第一步立即调用/v2/product/import/info接口查询任务详情，重点检查errors数组。若返回"error_code": "VALIDATION_ERROR"，需根据field_path定位字段（如"items.0.attributes.2.values.0"）；若为"TIMEOUT"，说明单次提交量超限（>1000条）或网络波动，应拆分为500条/批重试。切勿重复提交相同offer_id，否则触发Ozon幂等保护机制导致后续操作冻结24小时。

掌握Ozon JSON规范是高效入驻与稳定运营的技术基石。