预算组织匹配查询列表接口
说明
该接口用于根据编码直接匹配到层级组织的本级和父级相关信息。在调用该接口时，可以选择性传入组织树根节点、部门编码、人员工号、选项列表、公司抬头编码等信息。
接口地址
/api/openapi/budget/org/v2/match/list
请求类型
POST
请求参数
参数说明
四个业务参数中，至少需要传一个，如果全部均不传会报出参数错误。
| 字段名称 |
类型 |
是否必填 |
字段说明 |
默认值 |
| rootCode |
String |
否 |
组织树根节点 |
|
| departmentBizCode |
List<String> |
否 |
部门的业务编码 |
|
| employeesNo |
List<String> |
否 |
员工工号 |
|
| legalEntityBizCode |
List<String> |
否 |
公司抬头 |
|
| references |
List<referencesDto> |
否 |
自定义选项 |
|
| pageNo |
Integer |
否 |
分页页码，默认为1 |
| pageSize |
Integer |
否 |
每页大小，默认为20，最大为50 |
自定义选项参数说明referencesDto
| 字段名称 |
类型 |
是否必填 |
字段说明 |
默认值 |
| detailBusinessCode |
String |
是 |
选项编码 |
|
| businessCode |
String |
是 |
选项组编码 |
参数样例
{
"rootCode": "123456",
"departmentBizCode": ["部门业务编码001"],
"employeesNo": ["工号001"],
"legalEntityBizCode": ["公司抬头001"],
"references": [{
"detailBusinessCode": "xxx",
"businessCode":"xxx"
}]
}
响应参数
响应参数说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
默认值 |
| bizCode |
String |
|
预算组织编码 |
|
| nameZh |
String |
|
预算组织中文名 |
|
| nameEn |
String |
|
预算组织英文名 |
|
| parentBizCode |
String |
|
上级预算组织编码 |
|
| parentName |
String |
|
上级预算组织名称 |
|
| resourceBizCode |
String |
|
来源数据编码 |
|
| resourceName |
String |
|
来源数据名称 |
|
| resourceType |
String |
|
来源数据类型 |
|
| resourceStatus |
String |
|
来源数据状态 |
|
| desc |
String |
|
预算组织描述 |
|
| priority |
Integer |
|
预算组织优先级 |
|
| enabled |
Boolean |
是 |
预算组织是否启用；true 表示启用，false 表示禁用 |
参数样例
{
"code": "ACK",
"message": "",
"data": {
"list": [
{
"bizCode": "NBDG2410231I4V9PJ4",
"nameZh": "科技有限公司",
"nameEn": "",
"parentBizCode": "NBDG24082911M8ZIIO",
"parentName": "xx科技有限公司",
"resourceName": "科技有限公司",
"resourceType": "DEPARTMENT",
"resourceBizCode": "DI2304281EROXQJN",
"resourceStatus": "已启用",
"desc": "描述",
"priority": 1,
"enabled": false
}
],
"hasNextPage": false
},
"errorCode": null,
"success": true
}
兼容说明
enabled 是分页列表项的新增响应字段；旧响应消费者可以忽略，灰度期间字段缺失时可按 true 理解。- 禁用是软下线，接口仍可返回禁用组织及其原有字段。
- 原接口路径和分页结构不变，本次变更仅适用于层级预算组织 V2；经典预算组织 V1 不变。
- 预算冻结、释放、占用、转占、预算方案和预算金额写入接口不因本次变更新增组织启停校验。
修改记录
2026-02-02 新增组织匹配查询列表接口
2026-02-25 修改参数列表
2026-07-28 响应新增预算组织启用状态