R524809
35 lines
2.9 KiB
Markdown
35 lines
2.9 KiB
Markdown
# Ozon Seller API 文档状态摘要
|
||
|
||
> 本文件只汇总当前仓库中的 Ozon 资料和 Atlas 实施状态，不代表 Ozon 官方接口已经全部接入。官方行为以各接口文档与 Ozon 官方文档为准，Atlas 实现进度以 [`../../project/HANDOFF.md`](../../project/HANDOFF.md) 为准。
|
||
|
||
## 已整理资料
|
||
|
||
| 文档 | 主题 | Atlas 当前状态 |
|
||
|---|---|---|
|
||
| [01-authentication.md](./01-authentication.md) | Client-Id、Api-Key 和错误处理 | 平台参考源凭据已由系统管理员配置并仅供 Worker 使用 |
|
||
| [02-category-tree.md](./02-category-tree.md) | 类目/商品类型树 | 平台级共享缓存已实现；每 7 天自动同步并支持管理员手动同步 |
|
||
| [03-category-attributes.md](./03-category-attributes.md) | 类型属性与字典值 | 平台级缓存、14/21 天状态机、管理员批次、按需刷新和发布预检已实现 |
|
||
| [04-product-import.md](./04-product-import.md) | `/v3/product/import` | 仅作为外部接口资料；Atlas 真正的发布 job 尚未实现 |
|
||
| [05-product-info.md](./05-product-info.md) | 商品信息查询 | 资料文档；实现状态以在线商品模块交接为准 |
|
||
| [06-product-list.md](./06-product-list.md) | 商品列表 | 资料文档；仓库同步 Worker 尚未完成 |
|
||
| [09-stocks.md](./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 接入前确认或补齐。
|
||
|
||
## 当前应阅读的实现文档
|
||
|
||
- [平台商品参考目录](../../architecture/platform-product-reference-catalog.md)
|
||
- [平台目录缓存刷新方案](../../architecture/platform-catalog-cache-refresh-plan.md)
|
||
- [平台类目与属性管理 API](../../api/platform-catalog-admin.md)
|
||
- [商品编辑与发布 API](../../api/product-editor-and-publishing.md)
|
||
- [项目交接](../../project/HANDOFF.md)
|