Files
atlas-seller-kit/docs/integrations/ozon-seller-api/SUMMARY.md
T
2026-09-20 15:23:44 +08:00

2.9 KiB
Raw Blame History

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 当前目录与发布边界

  1. 类目树、类型属性和字典候选值按 platform_id 维护,同平台所有门店共享;本阶段没有门店差异层。
  2. 类目树固定每 7 天自动同步。类型属性和字典不做周期性全量扫描,由管理员操作、普通用户访问或发布预检触发 Worker 任务。
  3. 类型属性和字典默认 14 天内 fresh、14~21 天(含 21 天)stale、严格超过 21 天 expired;missing/expired 使用高优先级任务,stale 使用低优先级任务。
  4. POST /api/product-platform-profiles/{profile_id}/publish-preflights 已实现,只刷新当前类型和所选 SKU 实际使用的字典,并执行本地发布校验。
  5. 真正的 product_publish_job、发布快照、Ozon /v3/product/import 提交和结果轮询尚未实现;预检 ready 不表示商品已经提交或发布。
  6. 发布预检目前只校验本地类目仍活动,尚未判断整棵类目树缓存是否过期;该边界需在真正发布 job 接入前确认或补齐。

当前应阅读的实现文档