增量更新预算科目适用范围
- 接口:/budget/account/scopes/save
- Method:POST
- 数据格式:JSON
- 描述:接口为增量更新,更新之后的适用范围是历史适用范围和本次新增适用范围的并集,所以适用全部预算单位的科目无法通过接口更新为适用部分预算单位;
- 请求参数:N/A
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
budgetaryAcctBizCode | String | Y | 预算三级科目业务编码 |
budgetType | String | Y | 预算维度,支持"项目、员工、部门、业务实体",可选值:AUX_ACCOUNTING、PERSONAL、DEPARTMENT、SUBSIDIARY |
isApplicableAll | Boolean | Y | 适用全部单位 可选值:true/false,默认false |
scopeItemBizCode | String[] | N | 适用的预算单位编码,辅助核算选项业务编码集合 |
containsSub | Boolean | Y | 是否适用下级部门,可选值:true/false,默认true |
- 请求示例
{
"budgetaryAccountScopeDtos": [
{
"budgetaryAcctBizCode": "BGTA21041212KEBN6S",
"budgetType": "SUBSIDIARY",
"isApplicableAll": false,
"scopeItemBizCode": [
"12677"
]
},
{
"budgetaryAcctBizCode": "BGTA21041212KEBN6S",
"budgetType": "DEPARTMENT",
"isApplicableAll": false,
"scopeItemBizCode": [
"1234567",
"DI2101041IJUWTMO"
],
"containsSub": true
},
{
"budgetaryAcctBizCode": "BGTA21041212KEBN6S",
"budgetType": "AUX_ACCOUNTING",
"isApplicableAll": false,
"scopeItemBizCode": [
"allocation english"
]
},
{
"budgetaryAcctBizCode": "BGTA21041212KEBN6S",
"budgetType": "PERSONAL",
"isApplicableAll": false,
"scopeItemBizCode": [
"011","010"
]
}
]
}
- 返回数据:
字段 | 类型 | 描述 |
---|---|---|
budgetaryAcctBizCode | String | 预算三级科目业务编码 |
budgetType | String | 预算维度,仅支持"项目",可选值:AUX_ACCOUNTING |
isApplicableAll | Boolean | 适用全部单位 可选值:true/false |
scopeItemBizCode | String[] | 适用的预算单位编码 |
containsSub | Boolean | 是否适用下级部门,可选值:true/false,默认true |
errorMsg | String | 错误提示信息 |
- 该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据会被放在errorData里面errorData为结构体,包含出错记录, 以及与之对应的出错信息; 具体参见失败实例;
返回示例:
{ "code": "ACK", "message": "操作成功!", "data": null, "args": null, "linkDetail": false, "nonBizError": false }
失败示例
{ "code": "NACK", "message": "存在不合法数据,请求修改后重新提交", "data": [ { "budgetaryAcctBizCode": "BGTA-3", "budgetType": "AUX_ACCOUNTING", "scopeItemBizCode": [ "1" ], "applicableAll": false, "errorMsg": "预算科目不存在;" }, { "budgetaryAcctBizCode": "", "budgetType": "", "scopeItemBizCode": [ "engli" ], "applicableAll": false, "errorMsg": "预算科目编码为空;预算维度为空;预算单位[engli]不存在;" } ], "args": null, "linkDetail": false, "nonBizError": false }
系统异常提示对照表
异常提示 | 描述 |
---|---|
* 预算科目编码为空 | 预算科目编码(budgetaryAcctBizCode)为空时抛出 |
* 预算科目不存在 | 预算科目编码(budgetaryAcctBizCode)不存在时抛出 |
* 预算科目不是三级科目 | 预算科目编码(budgetaryAcctBizCode)的级别不是3级科目时抛出 |
* 预算维度为空 | 预算维度(budgetType)为空时抛出 |
* 预算维度不正确 | 预算维度(budgetType)值不正确时抛出,目前仅支持项目维度(AUX_ACCOUNTING) |
*预算单位["xx1","xx2"]不存在 | 适用的预算单位编码(scopeItemBizCode)中有的某些预算单位不存在时抛出,xx1,xx2为不存在的预算单位编码 |