层级预算组织写入接口
说明
该接口用于设置层级预算组织。支持批量导入，如果预算组织不存在，则在系统中新增该预算组织，存在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 |
参数样例
{
"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
},
{
"bizCode": "BA2020061871",
"nameZh": "组织中文名称1",
"nameEn": "Org English Name1",
"parentBizCode": "BA2020061881",
"owners": [
"UID1001",
"UID1002"
],
"priority": 1,
"desc": "描述",
"sourceType": "REFERENCE_DETAIL",
"sourceCode": "BA202006188",
"withChildDept": false
}
]
}
响应参数
响应参数说明
参数样例
正确示例返回
{
"code": "ACK",
"message": "",
"success": true
}
错误示例返回
当有数据发生错误时，code返回NACK，data里会包含错误对象，此接口错误数据的key为组织编码
{
"success": false,
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"key": "BA202006187",
"errorMessage": "根节点不存在"
}
]
}
}