更新预算行信息(不包含编制金额)
说明
该接口用于预算分控模式下,通过接口新建/更新预算行的配置信息(不包含更新预算的编制额信息)
注:此接口为全部失败模式,即一条失败,则整批失败
接口限制
接口地址
/api/openapi/budget/budget/line
请求类型
POST
请求参数
参数说明
参数名称 | 类型 | 是否必填 | 参数说明 | 默认值 |
---|---|---|---|---|
budgetPlanBizCode | String | 是 | 预算方案编码 | |
controlType | String | 是 | 预算控制 | BUDGET_LINE_CONTROL |
budgets | Map |
是 | 预算行信息 | |
code | String | 否 | 预算行编码,当orgBizCode和subjectBizCode不为空时,预算行编码为非必填,(当预算行编码空时,会先根据orgBIzCode和subjectCode匹配预算行,若匹配到,则更新,否则新增) (当预算行编码非空时,会根据预算行编码去更新)。) |
|
orgBizCode | String | 否 | 预算组织编码,预算行编码为空时,必填 | |
subjectBizCode | String | 否 | 预算科目编码 | |
startDay | String | 否 | 预算方案开始时间 格式:yyyymmdd 新建方案时必填 更新方案时非必填 (若更新时填写了该字段需与新建时保持一致,否则将更新失败) |
|
endDay | String | 否 | 预算方案结束时间 格式:yyyymmdd 新建方案时必填 更新方案时非必填 (若更新时填写了该字段需与新建时保持一致,否则将更新失败) |
|
carryOver | boolean | 否 | 是否结转 新建预算行必填 |
false |
forbid | boolean | 否 | 控制力度(强) 新建预算行必填 |
false |
weakControl | boolean | 否 | 控制力度(弱) 新建预算行必填 |
false |
warn | boolean | 否 | 是否预警 新建预算行必填 |
false |
weakControlPercent | int | 否 | 弱控百分比 控制力度(弱控)有值时,新建预算行时该项必填 |
100 |
forbidPercent | int | 否 | 强控百分比 控制力度(弱控)有值时,新建预算行时该项必填 |
100 |
controlDimension | String | 否 | 控制周期:月度 MONTHLY 季度 QUARTERLY 半年度 HALFYEARL 年度 YEARLY 起止日期整段为一期(全段) INTACT 新建方案时必填 更新方案时非必填 |
参数样例
{
"budgetPlanBizCode": "BDG2302011OFCGWE8",
"controlType": "BUDGET_LINE_CONTROL",
"budgets": [
{
"code": "BDG2302011TA20H34",
"orgBizCode": "xl_org_biz_code",
"subjectBizCode": "xl_subject_biz_code",
"startDay": 20230201,
"endDay": 20230331,
"carryOver": true,
"controlDimension": "YEARLY",
"weakControl": true,
"weakControlPercent": 70,
"warn": false,
"warnThresholdPercent": 60,
"forbid": true,
"forbidPercent": 40
},
{
"code": "",
"orgBizCode": "BDG2112101C3KP5HC",
"subjectBizCode": "13244",
"startDay": 20230201,
"endDay": 20230331,
"carryOver": false,
"controlDimension": "MONTHLY",
"weakControl": false,
"weakControlPercent": 100,
"warn": false,
"warnThresholdPercent": 100,
"forbid": false,
"forbidPercent": 100
}
]
}
响应参数
响应参数说明
参数名称 | 类型 | 是否必填 | 参数说明 | 默认值 |
---|---|---|---|---|
code | String | 接口状态码,ACK/NACK | ||
success | booloon | 成功失败标识,true/false | ||
message | String | 是 | 错误信息 |
常见报错及解决方案
报错信息 | 异常说明/解决方案 | |
---|---|---|
一次最多支持传入50条预算行信息 | 单批次导入数据<=50 | |
预算方案编码不能为空 | 预算方案内“预算控制”项,选择分控-预算行设置预算控制力度 | |
该预算方案的控制模式非下放模式,请调整后重试 | 预算方案内“预算控制”项,选择分控-预算行设置预算控制力度 | |
根据预算方案编码未查询到预算信息 | 预算编码、预算组织、预算科目等信息无匹配数据 | |
方案编制周期非全段,不支持修改预算期间 | startDay、endDay必须和预算方案的“预算期间”配置一致 | |
控制周期需要大于编制周期 | 预算行的“控制周期”需要大于预算方案的“编制周期”(除全段) | |
预算方案控制周期为全段,预算行上控制周期不支持修改为非全段 | 当预算方案的“控制周期”设置为起止日期整段为一期时,预算行的控制周期也必须保持一致 | |
根据预算组织编码未查询到预算组织信息 | 预算组织编码错误 | |
根据预算科目编码未查询到预算科目信息 | 预算科目编码错误 | |
预算行弱控百分比不能小于0 | 控制百分比>=0 | |
预算行强控百分比不能小于0 | 控制百分比>=0 | |
预算行预警百分比不能小于0 | 控制百分比>=0 | |
当前批次存在重复的预算组织和预算科目编码 | 一批数据内不允许存在对同一预算行做多次修改 | |
预算方案需要按照科目控制,预算行科目编码不能为空 | 预算方案按照预算科目编制时,科目编码必须 | |
方案编制周期非全段,不支持修改预算期间 | 此配置下,预算行的预算期间需要和方案的保持一致 | |
方案编制周期为全段,预算期间结束日期不能小于方案上的是预算期间结束日期 | 此配置下,预算行的预算期间的结束时间>=预算方案的预算期间结束日期 | |
方案编制周期为全段,预算期间结束日期不能小于方案上的是预算期间结束日期 | 更新预算行信息时,预算期间开始时间不允许修改,结束时间允许>=预算方案的结束时间 |