docs(api): note resource settle type default

这个提交包含在:
API Changelog Bot 2026-07-06 15:06:10 +08:00
父节点 67e50e3d1e
当前提交 849c4987dd

查看文件

@ -14,6 +14,7 @@
- 备品没有价格日历,备品主表新增 `settlementPrice`(结算价)。
- 六类资源主数据新增/统一 `settleType`(结算方式)。
- 结算方式字典统一为 `resource_settle_type`,不要再使用旧的 `hotel_settle_type`
- `settleType` 不传时后端默认写入 `cash`(现付);历史资源主表空值也会回填为 `cash`
- 备品的协议价字段名仍是 `basePrice`,但页面文案统一叫“协议价”,不要再叫“基础单价”。
兼容规则:`settlementPrice` 不传时后端默认等于协议价。现有报价和订单固化逻辑仍继续使用 `protocolPrice`,本次不改报价/订单金额来源。
@ -27,7 +28,7 @@
| 价格日历设置页 | 在“协议价”旁新增“结算价”输入框,字段 `settlementPrice`;不填可省略,后端默认取 `protocolPrice`。 |
| 价格日历查询页 | 每日项响应新增 `settlementPrice`,用于回显结算价。 |
| 备品新建/编辑/详情/列表 | 新增 `settlementPrice``basePrice` 字段保留,但 UI 文案改为“协议价”。 |
| 六类资源基础信息 | 新增/回显 `settleType`,使用字典 `resource_settle_type`。 |
| 六类资源基础信息 | 新增/回显 `settleType`,使用字典 `resource_settle_type`;新建不传默认 `cash`(现付)。 |
| 酒店管理 | 原已有 `settleType`,字典来源需从 `hotel_settle_type` 改为 `resource_settle_type`。 |
字典值:
@ -112,7 +113,7 @@
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `settleType` | String | 否 | 结算方式,字典 `resource_settle_type``cash` / `sign` / `company`。 |
| `settleType` | String | 否 | 结算方式,字典 `resource_settle_type``cash` / `sign` / `company`;不传默认 `cash`。 |
### 4.2 备品新增 `settlementPrice`
@ -122,7 +123,7 @@
|------|------|------|------|
| `basePrice` | BigDecimal | 否 | 协议价。字段名兼容保留,页面文案叫“协议价”。 |
| `settlementPrice` | BigDecimal/String | 否 | 结算价;新建不传时默认等于 `basePrice`。响应按 String 处理。 |
| `settleType` | String | 否 | 结算方式,字典 `resource_settle_type`。 |
| `settleType` | String | 否 | 结算方式,字典 `resource_settle_type`;不传默认 `cash`。 |
备品请求示例:
@ -153,7 +154,9 @@
- 存量价格日历:`settlementPrice` 已按 `protocolPrice` 回填。
- 存量备品:`settlementPrice` 已按 `basePrice` 回填。
- 存量六类资源主表:`settleType` 为空或空白字符串时已按 `cash`(现付)回填。
- 前端不传 `settlementPrice`:后端默认等于协议价。
- 前端不传 `settleType`:后端默认 `cash`(现付)。
- 前端传负数 `settlementPrice`:后端返回参数错误。
- 修改价格日历状态、删除价格日历、批量启停接口路径不变。
- 报价、订单、签单等订单侧固化金额仍使用协议价 `protocolPrice`,不读取本次新增的 `settlementPrice`