预算信息查询接口V2
查询预算接口说明
该接口以分页的形式查询预算的信息,其中包含预算单元中的占用金额,冻结金额,预算金额,可用金额(包含结转),以及预算计划信息。
接口地址
/api/openapi/budget/page
请求类型
POST
请求参数
请求参数示例
{
"budgetPlanBizCodes": ["预算方案编码001", "预算方案编码002"],
"budgetBizCodes": ["预算行编码001", "预算行编码002"],
"budgetOrgBizCodes": ["预算组织编码001", "预算组织编码002"],
"budgetSubjectBizCodes": ["预算科目编码001", "预算科目编码002"],
"pageNo": 1,
"pageSize": 50
}
请求参数说明
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
budgetPlanBizCodes | List<String> | 必填其一 | 预算方案编码 |
budgetBizCodes | List<String> | 必填其一 | 预算行编码 |
budgetOrgBizCodes | List<String> | 必填其一 | 预算组织编码 |
budgetSubjectBizCodes | List<String> | 必填其一 | 预算科目编码 |
pageNo | Integer | 否 | 分页页码,默认为1 |
pageSize | Integer | 否 | 每页大小,默认为50 |
响应参数
响应参数示例
{
"code":"ACK",
"message":"",
"data":{
"list":[
{
"bizCode":"BDG2308171AQTPH8G",
"code":"BDG2308171AQTPH8G",
"entCode":"EC210721WV7V5EB",
"budgetPlanCode":"BDG230817XPMFR0G",
"budgetPlanBizCode":"BDG230817XPMFR0G",
"subjectCode":"BDG230704YMZ5YF4",
"subjectBizCode":"BDG230704YMZ5YF4",
"subjectName":"zwl预算科目",
"subjectNameZh":"zwl预算科目",
"subjectNameEn":"",
"orgCode":"BDG230817YPEIWOW",
"orgBizCode":"YZL2623",
"orgName":"测试编码",
"orgNameZh":"测试编码",
"orgNameEn":"",
"budgetUnits":[
{
"code":"BDG2308171AQTPSAO",
"startDay":20230801,
"endDay":20230831,
"compilationDimension":"MONTHLY",
"currency":{
"code":"CNY",
"symbol":"¥",
"name":"人民币"
},
"periodNum":1,
"budgetAmount":500,
"usableAmount":370,
"carryOverUsableAmount":370,
"freezeAmount":110,
"occupyAmount":20
},
{
"code":"BDG2308171AQTQ074",
"startDay":20230901,
"endDay":20230930,
"compilationDimension":"MONTHLY",
"currency":{
"code":"CNY",
"symbol":"¥",
"name":"人民币"
},
"periodNum":2,
"budgetAmount":500,
"usableAmount":480,
"carryOverUsableAmount":480,
"freezeAmount":0,
"occupyAmount":20
}
],
"startDay":20230801,
"endDay":20230930,
"carryOver":false,
"compilationDimension":"MONTHLY",
"controlDimension":"MONTHLY",
"weakControl":false,
"weakControlPercent":90,
"warn":true,
"warnThresholdPercent":90,
"forbid":true,
"forbidPercent":90
}
],
"hasNextPage":false
},
"errorCode":null,
"success":true
}
响应参数说明
预算行信息
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
bizCode | string | 是 | 预算行编码(外码) |
code | string | 是 | 预算行内码 |
budgetPlanCode | string | 是 | 预算方案内码 |
budgetPlanBizCode | string | 是 | 预算方案外码 |
subjectCode | string | 是 | 预算科目内码 |
subjectBizCode | string | 是 | 预算科目外码 |
subjectName | string | 是 | 预算科目名称 |
subjectNameZh | string | 是 | 预算科目名称(中文) |
subjectNameEn | string | 是 | 预算科目名称(英文) |
orgCode | string | 是 | 预算组织内码 |
orgBizCode | string | 是 | 预算组织外码 |
orgName | string | 是 | 预算组织名称 |
orgNameZh | string | 是 | 预算组织名称(中文) |
orgNameEn | string | 是 | 预算组织名称(英文) |
startDay | string | 是 | 预算行的预算期间开始时间 |
endDay | string | 是 | 预算行的预算期间结束时间 |
currency | string | 是 | 币种 |
compilationDimension | string | 是 | 预算编制周期: 月度 MONTHLY 季度 QUARTERLY 半年度 HALFYEARLY 年度 YEARLY 起止日期整段为一期(全段) INTACT |
carryOver | Boolean | 是 | 是否结转 |
enabled | Boolean | 是 | 是否启用 |
weakControl | Boolean | 是 | 控制力度(弱) |
weakControlPercent | Boolean | 是 | 弱控百分比 控制力度(弱控)有值时,该项必填 |
warn | Boolean | 是 | 是否预警 |
warnThresholdPercent | Boolean | 是 | 预警百分比 预警有值时 该项必填 |
forbidPercent | Boolean | 是 | 强控百分比 控制力度(强控)有值时,该项必填 |
forbid | Boolean | 是 | 控制力度(强) |
controlDimension | Boolean | 是 | 控制周期: 月度 MONTHLY 季度 QUARTERLY 半年度 HALFYEARL 年度 YEARLY 起止日期整段为一期(全段) INTACT |
budgetUnits | List<budgetUnitsDto> | 是 | 预算单元信息 |
budgetUnitsDto 预算单元信息
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
code | string | 是 | 预算单元编码,唯一标识 |
startDay | string | 是 | 预算单元的开始时间 |
endDay | string | 是 | 预算单元的结束时间 |
periodNum | BigDecimal | 是 | 期号 |
budgetAmount | BigDecimal | 是 | 预算金额 |
freezeAmount | BigDecimal | 是 | 冻结金额 |
occupyAmount | BigDecimal | 是 | 占用金额 |
usableAmount | BigDecimal | 是 | 可用余额(usableAmount=budgetAmount-freezeAmount-occupyAmount) |
carryOverUsableAmount | BigDecimal | 是 | 可用余额包含结转(carryOverUsableAmount=budgetAmount+结转额-freezeAmount-occupyAmount) |
currency | currencyDto | 是 | 币种 |
currencyDto 币种
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
code | string | 是 | 币种标识,如CNY |
symbol | string | 是 | 币种符合,如¥ |
name | string | 是 | 币种名称,如“人民币” |