docs: 更新文档

2026-09-20 15:23:44 +08:00
parent 880e441bc6
commit e0e07be4ea
19 changed files with 164 additions and 312 deletions
@@ -210,6 +210,8 @@ Body：`{ "variant_ids": ["uuid", "uuid"] }`，最多 100 个且不能重复。

 `refreshing` 时客户端使用相同 SKU 集合重新预检；不得退回过期缓存。`blocked` 表示目录资源可用但商品草稿仍有业务校验问题；`ready` 才能进入未来的发布快照创建事务。Ozon 最终仍可能拒绝 payload，该错误属于具体商品/门店的发布结果，不能据此创建门店级目录副本。

+当前预检只对 profile 引用的类目执行本地活动状态校验，并对该类目的 schema 与实际使用字典执行新鲜度刷新；它尚未判断整棵类目树缓存是否过期，也不会因树过期先创建树同步任务。若本地类目不存在、已停用或不属于当前平台，API 返回 Atlas 自己的 `422 CATEGORY_INVALID`，这不是 Ozon 接口响应。后续真正发布 job 接入前，需要明确补齐树级新鲜度保护或确认“每周同步 + 本地活动状态”足以作为发布边界。
+
 ## 4. SKU 定价确认

 `POST /api/product-platform-profiles/{profile_id}/variants/{variant_id}/pricing-confirms`