预算OpenAPI接口说明
1、 适用版本：EAS9.0SP1及以上版本
2、 预算数据接口总览
3、 预算数据读取接口
1、接口信息
接口名称：预算数据查询接口
接口编码： MbgOpenAPIFacade-queryBudgetData
接口描述：通过该接口可以从EAS中读取预算数和实际数。
2、入参
参数 | 描述 | 数据类型 | 示例 |
api | 接口名称 | String | MbgOpenAPIFacade-queryBudgetData |
data | 参数 | Json | [‘bgSchemeNumber’,{xxx}] |
bgSchemeNumber | 预算模型编码 | String | TTTC08 |
orgNumber | 组织编码 | String | JMC00 |
version | 预算版本编码 | String | Ve |
bgElementNumber | 预算要素编码 | String | 01 |
bgScenarioNumber | 预算情景编码 | String | BgData |
bgCurrencyNumber | 币别编码 | String | BB01 |
bgPeriodNumber | 预算期间编码 | String | MONT.2023Y.10M |
bgItemList | 预算科目编码和辅助维度编码 | List | [‘Acc:1012.01’,‘Prd:P.01’,‘TC1:BEL01’] |
3、出参
参数 | 描述 | 数据类型 | 示例 |
bgSchemeNumber | 预算模型编码 | String | TTTC08 |
orgNumber | 组织编码 | String | JMC00 |
version | 预算版本编码 | String | Ve |
bgElementNumber | 预算要素编码 | String | 01 |
bgScenarioNumber | 预算情景编码 | String | BgData |
bgCurrencyNumber | 币别编码 | String | BB01 |
bgPeriodNumber | 预算期间编码 | String | MONT.2023Y.10M |
bgItemList | 预算科目编码和辅助维度编码 | List | [‘Acc:1012.01’,‘Prd:P.01’,‘TC1:BEL01’] |
value | 值（预算数/实际数，根据预算情景区分） | BigDecimal | 100 |
isBgData | 是否为预算数情景（true为预算数情景，false为实际数情景） | Boolean | True |
allBgItemList | 预算科目编码和辅助维度编码（系统补全的） | List | [‘Acc:1012.01’,‘Prd:P.01’,‘TC1:BEL01’] |
4、示例说明
1）入参示例
{
"api": "MbgOpenAPIFacade-queryBudgetData",
"data": ['TTTC08', /*预算模型编码*/
[
{
'orgNumber': 'JMC00', /*组织编码*/
'version': 'Ve', /*预算版本编码*/
'bgElementNumber': '01', /*预算要素编码*/
'bgScenarioNumber': 'BgData', /*预算情景编码*/
'bgCurrencyNumber': 'BB01', /*币别编码*/
'bgPeriodNumber': 'MONT.2023Y.10M', /*预算期间编码*/
'bgItemList': ['Acc:1012.01','Prd:P.01','TC1:BEL01'] /*预算科目编码和辅助维度编码*/
},
{'orgNumber': 'JMC00','version': 'Ve','bgElementNumber': '01',
'bgScenarioNumber': 'BgData','bgCurrencyNumber': 'BB01',
'bgPeriodNumber': 'MONT.2023Y.10M',
'bgItemList': ['Acc:1012.01','Prd:P.01','TC1:BEL01']},
{'orgNumber': 'JMC01','version': 'Ve','bgElementNumber': '01',
'bgScenarioNumber': 'BgData','bgCurrencyNumber': 'BB01',
'bgPeriodNumber': 'MONT.2023Y.10M',
'bgItemList': ['Acc:1012.01','Prd:P.01','TC1:BEL01']}
]]
}
2）出参示例
{
"errCode":0,
"errMsg":null,
"errStackTrace":null,
"data":
"{
\"taskId\":null,
\"result\":
{
\"code\":0,
\"data\":
{
\"bgSchemeNumber\":\"TTTC08\",
\"list\":
[
{\"orgNumber\":\"JMC00\",\"version\":\"Ve\",\"bgElementNumber\":\"01\",\"bgScenarioNumber\":\"BgData\",\"bgCurrencyNumber\":\"BB01\",\"bgPeriodNumber\":\"MONT.2023Y.10M\",\"bgItemList\":[\"Acc:1012.01\",\"Prd:P.01\",\"TC1:BEL01\"],\"value\":20.88888889,\"orgUnitID\":\"c6oAAAAAF3LM567U\",\"isBgData\":true,\"allBgItemList\":null},
{\"orgNumber\":\"JMC00\",\"version\":\"Ve\",\"bgElementNumber\":\"01\",\"bgScenarioNumber\":\"BgData\",\"bgCurrencyNumber\":\"BB01\",\"bgPeriodNumber\":\"MONT.2023Y.10M\",\"bgItemList\":[\"Acc:1012.01\",\"Prd:P.01\",\"TC1:BEL01\"],\"value\":20.88888889,\"orgUnitID\":\"c6oAAAAAF3LM567U\",\"isBgData\":true,\"allBgItemList\":null},
{\"orgNumber\":\"JMC01\",\"version\":\"Ve\",\"bgElementNumber\":\"01\",\"bgScenarioNumber\":\"BgData\",\"bgCurrencyNumber\":\"BB01\",\"bgPeriodNumber\":\"MONT.2023Y.10M\",\"bgItemList\":[\"Acc:1012.01\",\"Prd:P.01\",\"TC1:BEL01\"],\"value\":5.88888889,\"orgUnitID\":\"c6oAAAAAJKLM567U\",\"isBgData\":true,\"allBgItemList\":null}
]
},
\"message\":\"\"
}
}",
"description":null,
"description_cn":null
}
4、 预算数据写入接口
预算数据写入接口有两个，具体如下：
接口名称 | 接口编码 | 接口描述 |
预算数据写入接口（写入编制中数据） | MbgOpenAPIFacade-writeBudgetData | 1、通过该接口可以将外部系统的数据写入到EAS的预算数中，写入数据状态为编制中。 2、只支持写入预算情景类型为“预算数”的明细数据。 3、写入的预算数据默认为“编制中”状态，如果数据已存在，进行更新但不改变数据状态，已审批的数据变更时，自动生成差异记录。 |
预算数据写入接口（写入已审批数据） | MbgOpenAPIFacade-writeBudgetDataSupportDelete | 1、通过该接口可以将外部系统的数据写入到EAS的预算数中，写入数据状态为已审批。 2、只支持写入预算情景类型为“预算数”的明细数据。 3、写入的预算数据默认为“已审批”状态，如果数据已存在，进行更新但不改变数据状态，已审批的数据变更时，自动生成差异记录。 |
4.1预算数据写入接口（写入编制中数据）
1、入参
参数 | 描述 | 数据类型 | 示例 |
api | 接口名称 | String | MbgOpenAPIFacade-writeBudgetData |
data | 参数 | Json | [‘bgSchemeNumber’,{xxx}] |
bgSchemeNumber | 预算模型编码 | String | TTTC08 |
orgNumber | 组织编码 | String | JMC00 |
version | 预算版本编码 | String | Ve |
bgElementNumber | 预算要素编码 | String | 01 |
bgScenarioNumber | 预算情景编码 | String | BgData |
bgCurrencyNumber | 币别编码 | String | BB01 |
bgPeriodNumber | 预算期间编码 | String | MONT.2023Y.10M |
bgItemList | 预算科目编码和辅助维度编码 | List | [‘Acc:1012.01’,‘Prd:P.01’,‘TC1: BEL01’] |
value | 预算数 | BigDecimal | 1000.00 |
2、示例说明
1）入参示例
{
"api": "MbgOpenAPIFacade-writeBudgetData",
"data":
['TTTC08',
[
{
'orgNumber': 'JMC03',
'version': 'Ve-MONT.2024Y.01M',
'bgElementNumber': '01',
'bgScenarioNumber': 'BgData',
'bgCurrencyNumber': 'BB01',
'bgPeriodNumber': 'MONT.2024Y.01M',
'bgItemList': ['Acc:2221.01.01','Prd:P.01','TC1:BEL01'] ,
'value':'88'
}
]
]
}
2）出参示例
{
"errCode":0,
"errMsg":null,
"errStackTrace":null,
"data":
"{
\"taskId\":null,
\"result\":
{
\"code\":0,
\"data\":{},
\"message\":\"\"
}
}",
"description":null,
"description_cn":null
}
4.2预算数据写入接口（写入已审批数据）
1、入参
参数 | 描述 | 数据类型 | 示例 |
api | 接口名称 | String | MbgOpenAPIFacade- writeBudgetDataSupportDelete |
data | 参数 | Json | [‘bgSchemeNumber’,{xxx}] |
bgSchemeNumber | 预算模型编码 | String | TTTC08 |
orgNumber | 组织编码 | String | JMC00 |
version | 预算版本编码 | String | Ve |
bgElementNumber | 预算要素编码 | String | 01 |
bgScenarioNumber | 预算情景编码 | String | BgData |
bgCurrencyNumber | 币别编码 | String | BB01 |
bgPeriodNumber | 预算期间编码 | String | MONT.2023Y.10M |
bgItemList | 预算科目编码和辅助维度编码 | List | [‘Acc:1012.01’,‘Prd:P.01’,‘TC1:BEL01’] |
value | 预算数 | BigDecimal | 1000.00 |
2、示例说明
1）入参示例
{
"api": "MbgOpenAPIFacade-writeBudgetDataSupportDelete",
"data":
['TTTC08',
[
{
'orgNumber': 'JMC03',
'version': 'Ve-MONT.2024Y.01M',
'bgElementNumber': '01',
'bgScenarioNumber': 'BgData',
'bgCurrencyNumber': 'BB01',
'bgPeriodNumber': 'MONT.2024Y.01M',
'bgItemList': ['Acc:2221.01.01','Prd:P.01','TC1:BEL01'] ,
'value':'88'
}
]
]
}
2）出参示例
{
"errCode":0,
"errMsg":null,
"errStackTrace":null,
"data":
"{
\"taskId\":null,
\"result\":
{
\"code\":0,
\"data\":{},
\"message\":\"\"
}
}",
"description":null,
"description_cn":null
}
预算OpenAPI接口说明
本文2024-09-22 19:53:36发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-110115.html
