预算科目导入接口
说明
该接口用于导入预算科目(与费用类型的映射),支持批量导入,如果预算科目不存在,则在系统中新增该预算科目,存在bizcode则更改科目信息。
一次最多写入100条预算科目
接口限制
接口地址
/api/openapi/budget/subject/import
请求类型
POST
请求参数
参数说明
参数名称 | 类型 | 是否必填 | 参数说明 | 默认值 |
---|---|---|---|---|
nameZh | String | 与英文选一必填 | 预算科目名称(中文) | |
nameEn | String | 与中文选一必填 | 预算科目名称(英文) | |
bizCode | String | 否 | 科目编码 | |
parentCode | String | 否 | 上级分类bizCode String | |
externalReferenceDataBizCode | String | 否 | 外部档案套编码 | |
externalReferenceDataDetailBizCodes | List<String> | 否 | 外部档案选项编码集合 | |
expenseTypeBizCodes | List<String> | 是 | 费用类型code集合 | |
referenceDataDetailBizCodes | List<String> | 否 | 自定义档案code集合 | |
statisticalDimension | Map<String, String> | 否 | 自定义档案统计维度,key:档案套bizCode; value:档案选 bizCode |
参数样例
{
"budgetSubjectReq": [
{
"nameZh":"xx的科目",
"nameEn":"xxxx",
"expenseTypeBizCodes":["2009_01", "2001_01"],
"statisticalDimension": {
"BA202":"BA2022",
"BA203":"BA2023"
}
},
{
"nameZh":"我的预算科目",
"bizCode":"xxxxx",
"referenceDataDetailBizCodes":["xxxx","xxxx"],
"parentCode":"xxxx"
}
]
}
响应参数
响应参数说明
参数样例
正确示例返回
{
"code": "ACK",
"message": "",
"success": true
}
错误示例返回
当有数据发生错误时,code返回NACK,data里会包含错误对象,此接口错误数据的bizCode为科目编码
{
"code": "NACK",
"message": "",
"data": {
"ack": "NACK",
"message": null,
"budgetSubjectErrorInfos": [
{
"bizCode": null,
"budgetSubjectName": "测试科目",
"errorInfo": "该费用类型不存在:01.00"
}
]
},
"errorCode": null,
"success": false
}
外部档案套不存在的情况
{
"code": "NACK",
"message": "",
"data": {
"ack": "NACK",
"message": "外部档案套不存在[xxxx]",
"budgetSubjectErrorInfos": []
},
"errorCode": null,
"success": false
}
外部档案选项不存在的情况
{
"code": "NACK",
"message": "",
"data": {
"ack": "NACK",
"message": null,
"budgetSubjectErrorInfos": [
{
"bizCode": "xxxxx",
"budgetSubjectName": null,
"errorInfo": "外部档案选项不存在[xxxx]"
}
]
},
"errorCode": null,
"success": false
}