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