docs: 更新文档

2026-09-20 15:23:44 +08:00
parent 880e441bc6
commit e0e07be4ea
19 changed files with 164 additions and 312 deletions
@@ -1,6 +1,6 @@
 # Ozon Seller API 文档总览

-> 本目录整理 Ozon Seller API 的核心接口文档，供 ozon-seller-kit 项目集成使用。
+> 本目录整理 Ozon Seller API 的核心接口资料，并补充 Atlas 当前适配状态。Ozon 接口说明与 Atlas 实现状态必须区分：真正的 Ozon 商品导入 job 尚未实现。
 > 官方文档：https://docs.ozon.ru/api/seller/zh/

 ---
@@ -15,10 +15,9 @@
 | [04-product-import.md](./04-product-import.md) | 商品导入（创建/更新） |
 | [05-product-info.md](./05-product-info.md) | 商品信息查询 |
 | [06-product-list.md](./06-product-list.md) | 商品列表 |
-| [07-import-by-sku.md](./07-import-by-sku.md) | 跟卖（按 SKU 复制） |
-| [08-pictures.md](./08-pictures.md) | 图片更新 |
 | [09-stocks.md](./09-stocks.md) | 库存管理 |
-| [10-prices.md](./10-prices.md) | 价格更新 |
+
+跟卖、独立图片更新和价格批量更新尚未形成当前仓库文档，不能使用旧目录链接推断已经实现。

 ---

@@ -85,18 +84,15 @@

 ---

-## V2 项目集成清单
+## Atlas 当前集成状态

-| 接口 | 用途 | 实现状态 |
+| Ozon 接口 | Atlas 用途 | 当前状态 |
 |---|---|---|
-| `/v1/description-category/tree` | 类目树 | ✅ API 已建（categories.py） |
-| `/v1/description-category/attribute` | 类目属性 | ✅ API 已建 |
-| `/v1/description-category/attribute/values` | 属性值字典 | ✅ API 已建 |
-| `/v3/product/import` | 商品导入 | ✅ API 已建（publish.py） |
-| `/v1/product/import/info` | 导入状态 | ✅ API 已建 |
-| `/v3/product/list` | 商品列表 | 🟡 待建 |
-| `/v3/product/info/list` | 商品详情 | 🟡 待建 |
-| `/v1/product/import-by-sku` | 跟卖 | 🟡 待建（二期） |
-| `/v1/product/pictures/import` | 图片更新 | 🟡 待建（二期） |
-| `/v2/products/stocks` | 库存 | 🟡 待建（二期） |
-| `/v1/product/import/prices` | 价格 | 🟡 待建（二期） |
+| `/v1/description-category/tree` | 平台级类目/商品类型树 | 已实现 Worker 同步；每 7 天自动同步并支持管理员手动同步 |
+| `/v1/description-category/attribute` | 平台级类型属性 | 已实现管理员批次、用户按需刷新和发布预检刷新 |
+| `/v1/description-category/attribute/values`、`values/search` | 平台级字典候选值 | 已实现单字典同步、按需读取和关键词补齐 |
+| `/v3/product/import` | 首次商品导入 | 尚未实现；当前只完成 `publish-preflights` |
+| `/v1/product/import/info` | 导入结果轮询 | 尚未实现 |
+| 商品列表、详情、库存、价格、跟卖、图片更新 | 后续商品运营能力 | 以对应模块交接状态为准，不在平台目录第 1～4 步范围内 |
+
+Atlas 的平台目录接口、状态机和系统后台契约见[平台类目与属性管理 API](../../api/platform-catalog-admin.md)、[商品编辑与发布 API](../../api/product-editor-and-publishing.md)及[缓存刷新方案](../../architecture/platform-catalog-cache-refresh-plan.md)。