feat(pricing): 开发定价方案

docs/api/product-editor-and-publishing.md

@@ -1,6 +1,6 @@
 # 商品编辑与首次上架 API
 
-> M3.0～M3.4 已实现编辑上下文、草稿、SKU、来源素材、类目和动态属性。平台目录刷新方案第 1～4 步已把类目树、类型属性、字典读取及发布预检迁至平台级缓存：编辑器按需刷新，首次发布预检只刷新当前类型和实际使用的字典。AI 填报任务已实现；定价确认和真正调用 Ozon 的首次发布 job 仍未实现。
+> M3.0～M3.4 已实现编辑上下文、草稿、SKU、来源素材、类目和动态属性。平台目录刷新方案第 1～4 步已把类目树、类型属性、字典读取及发布预检迁至平台级缓存：编辑器按需刷新，首次发布预检只刷新当前类型和实际使用的字典。AI 填报任务及随商品保存的定价确认已实现；真正调用 Ozon 的首次发布 job 仍未实现。
 
 > 此处的商品始终是采集箱内的 Atlas 草稿。所有平台范围接口要求 `X-Atlas-Platform-Id`。商品通用资料可以跨平台复用；`product_platform_profile`、SKU 首次导入状态和在线商品不能跨平台/门店复用。
 
@@ -248,17 +248,13 @@ Body：`{ "variant_ids": ["uuid", "uuid"] }`，最多 100 个且不能重复。
 
 ## 4. SKU 定价确认
 
-`POST /api/product-platform-profiles/{profile_id}/variants/{variant_id}/pricing-confirms`
+定价确认与 `PUT /api/products/{product_id}/editor-draft` 同一事务完成。每个 SKU 可携带 `pricing_draft` 和 `pricing_selection: { preview_id, option_id, input_hash }`；新 SKU 使用 `client_key` 绑定预览，保存时映射为真实 ID。独立试算不能直接确认到 SKU。
 
-Headers：`Idempotency-Key` 必填。Body：
+服务端核对预览归属、15 分钟有效期、当前采购价、有效包装、类目、门店、币种及规则版本，再写入不可变 `pricing_quotes`、全部候选和 listing 价格。任何一个明确选择的报价失效，整个商品保存回滚。客户端可提示用户重新计算，或经用户选择清除本次确认意图后仅保存草稿。
 
-```json
-{ "preview_id": "opaque-id", "selected_option_id": "candidate-1", "one_time_overrides": null }
-```
+没有报价时仍可保存商品，但首次发布预检返回 `PRICING_REQUIRED`。已确认报价不会随预览到期而失效；采购、包装、目标门店/类目、履约或门店币种改变后须重新确认。调整默认方案、汇率或费率不会反向改写历史快照。详见[定价 API](./pricing.md)。
 
-服务端重新解析 SKU 的有效包装规格、验证预览仍未过期且配置/汇率/规则未变化，重新计算后写入 `pricing_quotes`、全部 `pricing_quote_options` 和当前平台 listing 的售价/划线价/币种/报价引用。成功返回 `201` 与不可变报价摘要。
-
-包装规格缺失或 `ambiguous`、预览失效、候选不属于预览、目标店铺不一致、物流不适用时返回 `422`，不覆盖既有价格。临时更换方案或运输方式仅写入本次报价，不改门店默认方案。
+开发环境可按定价 API 的草稿费率模式完成商品编辑联调；这种报价即使已保存，也会在首次发布预检返回 `PRICING_RATE_REVIEW_REQUIRED`。费率完成正式审核后，须用已审核卡重新试算并确认 SKU。
 
 ## 5. 素材选择与水印派生
 
@@ -319,3 +315,10 @@ Headers：`Idempotency-Key` 必填。Body：
 ## 8. 已替代的旧草案
 
 本文替代 [`../product/api.md`](../product/api.md) 中与商品编辑有关的路径。旧草案保留为历史背景，实施以本文件、[`pricing.md`](./pricing.md) 与 [`collection-and-extension.md`](./collection-and-extension.md) 为准。
+
+### 2026-09-28 SKU 定价确认修订
+
+草稿的每个 variant 可携带 `pricing_draft` 和 `pricing_selection`，与商品保存原子提交。
+读取 listing 返回 `pricing_draft`、`pricing_result` 和 `pricing_valid`。
+确认失败整笔回滚并定位 SKU；无报价允许保存，但发布预检返回 `PRICING_REQUIRED`。
+输入变化使报价失效；已确认快照保留。具体 DTO 与错误见 pricing.md 实施修订。