层级预算组织写入接口
说明
该接口用于设置层级预算组织。支持批量导入，如果预算组织不存在，则在系统中新增该预算组织，存在bizCode则更改组织信息。
一次最多写入100条预算组织
接口限制
接口地址
/api/openapi/budget/v2/org/save
请求类型
PUT
请求参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 | 默认值 |
|---|---|---|---|---|
| budgetOrgRootCode | String | 是 | 预算组织树根节点编码，新增或修改的预算组织只允许在该根节点下 | |
| budgetOrgs | List<BudgetOrgDto> | 是 | 配置对象 |
BudgetOrgDto参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 | 默认值 |
|---|---|---|---|---|
| bizCode | String | 否 | 预算组织编码，不填系统自动生成，这类预算组织不能作为同批次导入的其他预算组织的上级节点；已存在系统时进行更新操作 | |
| nameZh | String | 是 | 预算组织中文名称 | |
| nameEn | String | 否 | 预算组织英文名称 | |
| parentBizCode | String | 是 | 上级节点编码 | |
| owners | List<String> | 否 | 预算组织负责人 | |
| desc | String | 否 | 预算组织描述 | |
| priority | Integer | 是 | 优先级，>0且<100的整数，数字越小，优先级越高 | |
| sourceType | String | 是 | 来源数据纬度，可选值 DEPARTMENT(承担部门),LEGAL_ENTITY(公司抬头),COVER_USER(承担人),REFERENCE_DETAIL(自定义档案) | |
| sourceCode | String | 是 | 来源数据编码 | |
| withChildDept | boolean | 否 | 部门是否含下级，当来源数据维度为“承担部门“时该字段必填 | false |
| enabled | Boolean | 否 | 预算组织是否启用；true 表示启用，false 表示禁用 |
true |
参数样例
{
"budgetOrgRootCode":"BUDGET_ROOT_CODE",
"budgetOrgs": [
{
"bizCode": "BA202006187",
"nameZh": "组织中文名称",
"nameEn": "Org English Name",
"parentBizCode": "BA202006188",
"owners": [
"UID1001",
"UID1002"
],
"priority": 1,
"desc": "描述",
"sourceType": "DEPARTMENT",
"sourceCode": "BA202006188",
"withChildDept": false,
"enabled": true
},
{
"bizCode": "BA2020061871",
"nameZh": "组织中文名称1",
"nameEn": "Org English Name1",
"parentBizCode": "BA2020061881",
"owners": [
"UID1001",
"UID1002"
],
"priority": 1,
"desc": "描述",
"sourceType": "REFERENCE_DETAIL",
"sourceCode": "BA202006188",
"withChildDept": false,
"enabled": false
}
]
}
响应参数
响应参数说明
参数样例
正确示例返回
{
"code": "ACK",
"message": "",
"success": true
}
错误示例返回
当有数据发生错误时，code返回NACK，data里会包含错误对象，此接口错误数据的key为组织编码
{
"success": false,
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"key": "BA202006187",
"errorMessage": "根节点不存在"
}
]
}
}
上级预算组织已禁用、重新启用时数据源被其他启用组织占用等校验失败，也沿用上述逐行错误结构返回。
兼容说明
enabled缺失或为null时按true保存，旧调用方无需修改请求。- 禁用是软下线，不会删除预算组织及其历史预算数据。
- 本次变更仅适用于层级预算组织 V2；经典预算组织 V1 不变。
- 预算冻结、释放、占用、转占、预算方案和预算金额写入接口不因本次变更新增组织启停校验。
修改记录
2026-07-28 新增预算组织启用状态