hl-api-changelog/changelogs-v2/2026-09/09_6951_财务系统参数设置-新增接口-管理后台.md

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	6951	财务系统参数设置（查询 + 改值）	admin	yst	新增接口	deployed	verified	verified	mmg	21540997		2026-09-09	后端已合 dev-v3（param 参数设置域）并部署测试服。参数键后端预置不开放增删，仅查询+按键改值，valueType 格式校验。	2026-09-09	dev-v3

财务系统参数设置（查询 + 改值）

1. 接口背景

财务域「参数设置」：财务侧预置的业务参数（如封账日、限额、开关等），后端预置键不开放增删，管理后台只提供「查询全部 + 按键改值」两个端点。属 Epic 财务域 param 参数设置域。

2. 变更清单

类型	接口	说明
新增	GET /admin/finance/params	查询全部财务系统参数（不分页，一次返回全量预置键）
新增	PUT /admin/finance/params/{paramKey}	按参数键修改参数值（valueType 格式校验）

3. 接口详情

3.1 查询全部参数

• 路径：GET /admin/finance/params
• 入参：无
• 出参：Result<List<AccountParamRespVO>>，元素字段：

字段	类型	说明
id	String	参数ID（Long 序列化为字符串，防 JS 精度丢失）
paramKey	String	参数键（预置，唯一）
paramValue	String	参数值（字符串存储，按 valueType 解析）
valueType	String	值类型：DATE / BOOL / AMOUNT / STRING
paramName	String	参数中文名
remark	String	口径备注
updatedByName	String	最近操作人姓名快照

3.2 修改参数值

• 路径：PUT /admin/finance/params/{paramKey}
• 路径参数：paramKey（String，要修改的参数键）
• 入参（AccountParamUpdateReqVO）：

字段	类型	必填	说明
paramValue	String	是	新参数值（按 valueType 校验格式：DATE 须日期格式、BOOL 须 true/false、AMOUNT 须数值）
remark	String	否	修改说明

• 出参：Result<AccountParamRespVO>（返回改后完整参数行）

4. 枚举 / 数据字典

• valueType：DATE（日期）/ BOOL（布尔）/ AMOUNT（金额数值）/ STRING（字符串）
• 参数键 paramKey 由后端预置，前端不增删键，仅展示 + 改值。

5. 错误码

码	含义
598001	参数键不存在
598002	参数值与 valueType 格式不符

6. 示例

典型：查询全部

GET /admin/finance/params
→ { "code":200, "data":[ {"id":"...","paramKey":"close_day","paramValue":"25","valueType":"DATE","paramName":"封账日","remark":"...","updatedByName":"腰苏图"} ] }

改值（金额）

PUT /admin/finance/params/pay_limit  {"paramValue":"50000.00","remark":"上调付款限额"}
→ 200，data.paramValue="50000.00"

异常：值类型不符

PUT /admin/finance/params/close_day  {"paramValue":"abc"}
→ { "code":598002, "msg":"参数值与 valueType 格式不符" }

7. 注意事项

• 参数键为后端预置集合，PUT 仅改值，不新增/删除键。
• paramValue 一律字符串传输，前端按 valueType 渲染对应控件（日期/开关/数字输入）。
• 全部长整型 ID 已序列化为字符串。

8. 关联 / 联系人

• Issue：https://git.1814.love:8443/wx/HL/issues/6951
• Commit：https://git.1814.love:8443/wx/HL/commit/fc87029a68
• 负责人：腰苏图（yst）