2.9 KiB
2.9 KiB
Ozon Seller API 文档状态摘要
本文件只汇总当前仓库中的 Ozon 资料和 Atlas 实施状态,不代表 Ozon 官方接口已经全部接入。官方行为以各接口文档与 Ozon 官方文档为准,Atlas 实现进度以
../../project/HANDOFF.md为准。
已整理资料
| 文档 | 主题 | Atlas 当前状态 |
|---|---|---|
| 01-authentication.md | Client-Id、Api-Key 和错误处理 | 平台参考源凭据已由系统管理员配置并仅供 Worker 使用 |
| 02-category-tree.md | 类目/商品类型树 | 平台级共享缓存已实现;每 7 天自动同步并支持管理员手动同步 |
| 03-category-attributes.md | 类型属性与字典值 | 平台级缓存、14/21 天状态机、管理员批次、按需刷新和发布预检已实现 |
| 04-product-import.md | /v3/product/import |
仅作为外部接口资料;Atlas 真正的发布 job 尚未实现 |
| 05-product-info.md | 商品信息查询 | 资料文档;实现状态以在线商品模块交接为准 |
| 06-product-list.md | 商品列表 | 资料文档;仓库同步 Worker 尚未完成 |
| 09-stocks.md | 库存管理 | 资料文档;不属于当前平台目录与首次发布预检范围 |
跟卖、独立图片更新和价格批量更新尚未形成当前仓库文档。
Atlas 当前目录与发布边界
- 类目树、类型属性和字典候选值按
platform_id维护,同平台所有门店共享;本阶段没有门店差异层。 - 类目树固定每 7 天自动同步。类型属性和字典不做周期性全量扫描,由管理员操作、普通用户访问或发布预检触发 Worker 任务。
- 类型属性和字典默认 14 天内 fresh、14~21 天(含 21 天)stale、严格超过 21 天 expired;missing/expired 使用高优先级任务,stale 使用低优先级任务。
POST /api/product-platform-profiles/{profile_id}/publish-preflights已实现,只刷新当前类型和所选 SKU 实际使用的字典,并执行本地发布校验。- 真正的
product_publish_job、发布快照、Ozon/v3/product/import提交和结果轮询尚未实现;预检ready不表示商品已经提交或发布。 - 发布预检目前只校验本地类目仍活动,尚未判断整棵类目树缓存是否过期;该边界需在真正发布 job 接入前确认或补齐。