feat(edit): 定价试算开发、SKU 样式功能修改
This commit is contained in:
R524809
+7
-7
@@ -10,8 +10,8 @@
|
||||
需要已认证工作空间。返回 `{data: PricingCatalog}`：
|
||||
|
||||
- `store`：门店 ID、名称及报价币种（CNY / RUB）。
|
||||
- `rate_cards[]`：该门店平台、RU / rFBS 的有效费率卡及运输方式。正式环境必须 active、在有效期内、有审核时间及审核人。`development_only=true` 表示本地开发模式临时可选的 draft 卡。
|
||||
- `pending_rate_cards[]`：该平台 RU / rFBS 待审核草稿的名称、版本和状态，仅用于说明阻断原因，不作为方案或报价可选项。
|
||||
- `rate_cards[]`：该门店平台、RU / rFBS 的可用费率卡及运输方式，包含已审核且在有效期内的 active 卡，以及配置允许时的 draft 卡。`development_only=true` 为兼容现有 DTO 保留，表示所选卡尚未审核，并不代表禁止首次上架。
|
||||
- `pending_rate_cards[]`：该平台 RU / rFBS 待审核草稿的名称、版本和状态；在允许草稿报价时也可能同时出现在 `rate_cards[]`，用于展示审核状态。
|
||||
- `policies[]`：该门店活动方案，默认方案优先，包含完整参数和 revision。
|
||||
- `exchange_rate`：CBR 最新 CNY→RUB 官方参考汇率，包含 ID、日期和 stale；缺少数据时为 null。超过 72 小时提示过期参考，不自动代填其他来源。
|
||||
|
||||
@@ -46,7 +46,7 @@
|
||||
```
|
||||
|
||||
- 独立试算 `binding=null`；SKU 必须提供 profile，已有 variant_id 与新建 client_key 二选一。验证资源归属，已上架 SKU 不接受新报价。
|
||||
- 包装输入是编辑草稿合并后的有效 g/mm 值，必须已确认；尺寸最多三位小数，重量至少 1 g。保存时从实际持久化草稿重新合并并核对，不能仅信任客户端摘要。
|
||||
- 包装输入是编辑草稿合并后的有效 g/mm 值，必须已确认；接口为兼容历史值允许最多三位小数，重量至少 1 g，当前编辑页与试算界面只接受正整数。保存时从实际持久化草稿重新合并并核对，不能仅信任客户端摘要。
|
||||
- `mode=target_markup`：目标利润=采购成本×加价率；求解销售价。`fixed_sale`：selling_price 必填，按该售价核算利润。
|
||||
- 百分比费用以销售额为基数；除加价率外每项小于 1、最多六位小数。引擎拒绝总扣费率≥1。划线价=销售价÷(1−折扣率)。
|
||||
- 枚举运输方式×产品类型×佣金档，按最终币种舍入后回验货值、佣金、重量和体积重边界。默认运输不可用时 recommended_option_id=null，不替换为另一方式。
|
||||
@@ -93,13 +93,13 @@ context 保存规则版本、实际汇率与来源，以及系统汇率记录 ID
|
||||
| DELETE | `/pricing-policies/{id}` | Idempotency-Key；归档并清除默认标志，返回 `{id,archived:true}` |
|
||||
|
||||
写入 `{name,note,parameters,allow_commission_override}`。只保存费用、加价、折扣、固定/系统汇率与运输偏好；采购价、包装、手动售价及临时佣金不属于方案持久字段。
|
||||
方案的默认和比较运输必须属于同一可用费率卡；正式环境仅允许已审核卡。历史快照不会被方案修改；尚未确认的预览因方案版本改变要求重算。
|
||||
方案的默认和比较运输必须属于同一可用费率卡；正式环境默认允许有效草稿卡；可通过 `PRICING_ALLOW_DRAFT_RATES=false` 仅使用已审核卡。历史快照不会被方案修改；尚未确认的预览因方案版本改变要求重算。
|
||||
|
||||
## 5. 数据启用与错误
|
||||
|
||||
迁移中的 CEL 目录为 `draft`，覆盖六种产品类型、三种运输方式，香港空运不纳入。真实账单复核、有效日期/审核人以及平台类目佣金映射仍是正式使用前置条件，接口不会回退到示例费率或固定佣金。
|
||||
迁移中的 CEL 目录为 `draft`，覆盖六种产品类型、三种运输方式，香港空运不纳入。平台类目佣金映射仍是正式试算所需数据；草稿物流费率可按上述配置参与报价，页面保留费率来源标识，接口不会回退到未选定的固定佣金。物流费率审核用于形成有证据的已审核版本，不再是草稿报价上架预检的前置条件。
|
||||
|
||||
商品编辑联调期间，API 在 `NODE_ENV=development` 时默认允许 draft 费率卡参与方案保存、预览与草稿报价确认；可设 `PRICING_ALLOW_DRAFT_RATES=false` 关闭。测试环境只有显式设 `PRICING_ALLOW_DRAFT_RATES=true` 才开启；生产环境始终关闭。该模式不修改费率卡状态、不生成审核记录。目录的 `rate_cards[].development_only` 和预览的 `context.development_only` 标识试算性质；基于此类预览确认的 SKU 报价可在编辑页查看，但首次上架校验必须返回 `PRICING_RATE_REVIEW_REQUIRED`，直至使用已审核费率重新试算确认。佣金和汇率仍按现有输入规则处理。
|
||||
API 在开发与生产环境默认允许 draft 费率卡参与方案保存、预览和 SKU 报价确认；`PRICING_ALLOW_DRAFT_RATES=false` 可显式关闭。测试环境默认关闭，仅显式设为 `true` 才开启。使用草稿卡不会修改费率卡状态或生成审核记录；目录的 `rate_cards[].development_only` 和预览的 `context.development_only` 保留来源标识，供页面和报价快照展示。已确认的草稿卡报价满足定价确认要求，首次上架预检不再因卡片未审核返回 `PRICING_RATE_REVIEW_REQUIRED`；其他报价输入、利润和发布字段校验照常执行。佣金和汇率仍按现有输入规则处理。此变更由维护者于 2026-09-29 要求，影响 Web、API、现有响应说明和发布预检，不改变审核端点。
|
||||
|
||||
### 系统管理员审核 CEL 费率
|
||||
|
||||
@@ -121,7 +121,7 @@ context 保存规则版本、实际汇率与来源，以及系统汇率记录 ID
|
||||
|---|---|
|
||||
| 422 VALIDATION_ERROR | 修正输入格式或缺项 |
|
||||
| 422 PRICING_RULES_UNAVAILABLE | 配置并审核物流费率 |
|
||||
| 422 PRICING_COMMISSION_UNAVAILABLE | 配置正式映射，或使用允许临时佣金的方案 |
|
||||
| 422 PRICING_COMMISSION_UNAVAILABLE | 配置正式映射；缺少正式规则时，可在允许临时佣金的方案或本次自定义参数中填写已核实的临时佣金率 |
|
||||
| 422 PRICING_FX_UNAVAILABLE | 等待 CBR 同步，或明确采用临时/方案固定汇率 |
|
||||
| 409 PRICING_PREVIEW_STALE | 重算、比较并重新应用，或显式仅保存草稿 |
|
||||
| 409 VERSION_CONFLICT | 重新读取版本后修改 |
|
||||
|
||||
Reference in New Issue
Block a user