预算方案写入
说明
该接口用于批量导入、更新预算方案，也支持层级预算下方案的写入操作。
接口限制
预算方案列表，目前控制批量导入最大30条
接口地址
/api/openapi/budget/plan/batch/update
请求类型
PUT
请求参数
参数说明
| 参数名称 | 类型 | 参数说明 | 默认值 |
|---|---|---|---|
| budgetPlans | Array<String> | 预算方案列表 | |
| bizCode | String | 预算方案编码 新建方案时非必填（新建方案时未填写则自动生成） 更新方案内容时必填 |
|
| controlType | String | 预算控制：总控 BUDGET_PLAN_CONTROL 分控 BUDGET_LINE_CONTROL 新建方案时必填 更新方案时非必填（若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
BUDGET_LINE_CONTROL |
| startDay | String | 预算方案开始时间 格式：yyyymmdd 新建方案时必填 更新方案时非必填 （若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
|
| endDay | String | 预算方案结束时间 格式：yyyymmdd 新建方案时必填 更新方案时非必填 （若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
|
| currency | String | 币种类型 新建方案时未填时接口默认值为CNY 更新方案时非必填 （若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
CNY |
| carryOver | boolean | 是否结转 新建/更新方案必填 |
|
| forbid | boolean | 控制力度（强） 新建/更新方案必填 |
|
| weakControl | boolean | 控制力度（弱） 新建/更新方案必填 |
|
| warn | boolean | 是否预警 新建/更新方案必填 |
|
| subjectConfigure | boolean | 是否需要按照预算科目编制 新建方案时必填 更新方案时非必填 （若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
|
| weakControlPercent | int | 弱控百分比 控制力度（弱控）有值时，该项必填 |
|
| forbidPercent | int | 强控百分比 控制力度（强控）有值时，该项必填 |
|
| warnThresholdPercent | int | 预警百分比 预警有值时 该项必填 |
|
| formSubTypeBizCodes | Array<String> | 需填写单据编码（目前：支持报销单、申请单、合同单） | |
| categoryBizCode | String | 预算方案所属分类编码 新建方案时必填 更新方案时非必填 |
|
| nameZh | String | 方案中文名称 新建方案时必填 更新方案时非必填（若更新时填写了该字段需与新建时保持一致，否则将更新失败）, 长度限制0-100 |
|
| nameEn | String | 方案英文名称 新建方案时必填 更新方案时非必填（若更新时填写了该字段需与新建时保持一致，否则将更新失败）, 长度限制0-100 |
|
| controlDimension | String | 控制周期：月度 MONTHLY 季度 QUARTERLY 半年度 HALFYEARL 年度 YEARLY 起止日期整段为一期（全段） INTACT 新建方案时必填 更新方案时非必填 （若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
|
| compilationDimension | String | 编制周期：月度 MONTHLY 季度 QUARTERLY 半年度 HALFYEARL 年度 YEARLY 起止日期整段为一期（全段） INTACT 新建方案时必填 更新方案时非必填 （若更新时填写了该字段需与新建时保持一致，否则将更新失败） |
|
| enabled | boolean | 预算方案启用状态 不填默认未启用 此参数仅新增有效 |
|
| legalEntityBizCodes | Array<String> | 方案所属组织编码列表，非必填，为空/OPEN时该方案属于所有组织 |
参数样例
{
"budgetPlans": [
{
"startDay": "20220906",
"endDay": "20220907",
"currency": "CNY",
"compilationDimension": "HALFYEARLY",
"subjectConfigure": true,
"carryOver": false,
"forbid": true,
"warn": true,
"weakControl":true,
"weakControlPercent" : 33,
"forbidPercent": 33,
"warnThresholdPercent": 33,
"formSubTypeBizCodes":["FT2107291YEU8CN4"],
"categoryBizCode": "BUDGET_PLAN_CATEGORY2208161HS7EMF4",
"nameZh": "新增openapi",
"nameEn": "新增openapi",
"bizCode": "createopenapi",
"controlDimension": "HALFYEARLY",
"controlType":"BUDGET_LINE_CONTROL",
"enabled":false,
"legalEntityBizCodes":["OPEN"]
}
]
}
响应参数
响应参数说明
如果方案导入失败，errorInfos会存放对应方案的错误信息
参数样例
{
"code": "ACK",
"message": null,
"data": {
"ack": "ACK",
"message": "success",
"errorInfos": []
},
"errorCode": null,
"success": true
}