wx/hl-api-changelog

派生 0

文件

T

yaosutu和Claude Opus 4.8 5025f8d69b

changelog-filename-gate / validate (push) Failing after 2s

详情

docs(changelog): 财务域账期/费用分类/业务外分类/收款账户/资金流水/资金互转/资金日报 7 篇入 changelogs-v2

- 09_6951_财务账期设置：page/开新账期/封账 3 端点
- 09_7129_费用分类：tree/增/改/停用/启用 5 端点（DISABLED 统一+幂等）
- 09_7052_业务外收支分类：查询/增/改/停用/启用 5 端点（自动生码 NONBIZ_）
- 09_7003_收款账户：page/增/改/设默认/停用 5 端点
- 09_7003_资金流水：page/详情 2 端点（只读，含 remark）
- 09_7003_资金互转：page/发起 2 端点（双边成对记账+幂等）
- 09_7003_资金日报：daily 1 端点（closing=opening+收入−支出勾稽）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-09-09 16:25:37 +08:00

3.6 KiB

原始文件 Blame 文件历史

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	7052	业务外收支分类（查询 + 增改 + 停用/启用）	admin	yst	新增接口	deployed	verified	pending	hl-admin			2026-09-09	后端已合 dev-v3 并部署测试服。新增 code 留空后端自动生码（NONBIZ_ 前缀，#7052）；按方向组各自一套含已停用；停用/启用幂等。	2026-09-09	dev-v3

业务外收支分类

1. 接口背景

财务域「业务外收支分类」：与旅游主业无关的其他收入/支出归类（如房租、工资、理财收益等），按方向（IN 收入 / OUT 支出）各成一套。用于业务外流水（nonbiz）归集。

2. 变更清单

类型	接口	说明
新增	GET `/admin/finance/nonbiz-categories`	按方向查分类列表（含已停用）
新增	POST `/admin/finance/nonbiz-categories`	新增分类（code 可留空自动生码）
新增	PUT `/admin/finance/nonbiz-categories/{code}`	改名称/排序
新增	POST `/admin/finance/nonbiz-categories/{code}/disable`	停用（幂等）
新增	POST `/admin/finance/nonbiz-categories/{code}/enable`	启用（幂等）

3. 接口详情

3.1 查询 GET /

入参（Query）：direction 必填：IN 收入组 / OUT 支出组。返回该方向组全部分类（含已停用）。

出参 List<NonbizCategoryRespVO>：

字段	类型	说明
code	String	类别码（如 AGENT_SALARY；业务主键）
name	String	分类名
direction	String	IN / OUT
status	String	NORMAL / DISABLED
sort	Integer	排序

3.2 新增 POST /

入参：direction（必填 IN/OUT）/ code（可选 ≤50；留空后端自动生码 NONBIZ_ 前缀全局唯一）/ name（必填 ≤50）/ sort（缺省 0）。

出参：Result<String>，data=最终落库的类别码（自动生码时返回生成值）。

3.3 改 PUT /{code}

入参：name（必填 ≤50）/ sort。（code 建后不可改；历史单据快照不追溯。）

3.4 / 3.5 停用 / 启用

POST /{code}/disable、POST /{code}/enable，均幂等。

4. 枚举 / 数据字典

direction：IN 收入 / OUT 支出
status：NORMAL 正常 / DISABLED 停用

5. 错误码（段位 598200-598299）

码	含义
598201	类别码已存在（code 全局唯一，创建跨方向查重；自动生码序号耗尽同码）
598202	类别不存在
598203	方向组非法，须为 IN 或 OUT

6. 示例

新增（自动生码）

POST /admin/finance/nonbiz-categories  {"direction":"OUT","name":"办公室租金"}
→ 200 data="NONBIZ_7"（自动生成的类别码）

新增（指定 code 撞码，异常）

POST /admin/finance/nonbiz-categories  {"direction":"IN","code":"RENT","name":"租金"}
→ 598201 类别码已存在（即使 RENT 在 OUT 组已存在也报）

查询支出组

GET /admin/finance/nonbiz-categories?direction=OUT
→ 200 [{"code":"RENT","name":"租金","direction":"OUT","status":"NORMAL","sort":0},...]

7. 注意事项

code 全局唯一（跨方向），创建时后端跨方向查重。
code 建后不可改；前端展示以 name 为准。
推荐新增时留空 code 走自动生码。

8. 关联 / 联系人

Issue：https://git.1814.love:8443/wx/HL/issues/7052（自动生码）
Commit：https://git.1814.love:8443/wx/HL/commit/fc87029a68
负责人：腰苏图（yst）

3.6 KiB 原始文件 Blame 文件历史 Unescape Escape