不匹配数据映射写入
业务场景说明
凭证不匹配数据映射写入接口,当每刻中的基础数据和财务系统中的不一致时可以同步不匹配数据映射功能将每刻中的数据映射为财务系统中对应的编码和名称。本文档说明如何通过接口请求方式,将不匹配的映射关系写入每刻报销内。
注:financeCode 请查看编码对照表
接口说明
请求方式
POST
一、员工
接口地址
/openapi/voucher/mapping/employee/import
请求参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
financeCode |
财务系统版本编码编码对照表 |
是 |
String |
mappingSetBizCode |
映射集编码 |
是 |
String |
dataList |
导入的员工工号映射关系 |
是 |
List<object> |
bizCode |
员工工号业务编码 |
是 |
String |
mappingCode |
映射后编码 |
是 |
String |
mappingName |
映射后名称 |
是 |
String |
参数示例
{
"financeCode": "F02",
"mappingSetBizCode": "VMS200413Y261USG",
"dataList": [
{
"bizCode": "MK003",
"mappingCode": "0417001",
"mappingName": "员工A"
},
{
"bizCode": "MK004",
"mappingCode": "0417002",
"mappingName": "员工B"
}
]
}
响应参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
businessCode |
导入的业务编码 |
是 |
String |
status |
导入状态(成功为true,失败为false) |
是 |
boolean |
messageList |
错误信息(仅导入失败时返回) |
否 |
List<string> |
参数示例
{
"code": "ACK",
"message": "message.success",
"data": [
{
"businessCode": "MK003",
"status": true,
"messageList": []
},
{
"businessCode": "MK004",
"status": false,
"messageList": [
"未查询到匹配的业务编码"
]
}
],
"success": true
}
二、部门
接口地址
api/openapi/voucher/mapping/department/import
请求参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
financeCode |
财务系统版本编码编码对照表 |
是 |
String |
mappingSetBizCode |
映射集编码 |
是 |
String |
groupList |
导入的部门映射关系 |
是 |
List<object> |
bizCodes |
部门业务编码 |
是 |
List<string> |
mappingCode |
映射后编码 |
是 |
String |
mappingName |
映射后名称 |
是 |
String |
includeChildDept |
是否包含子部门(false-不包含,true-包含 如果不填,默认是false) |
是 |
Boolean |
参数示例
{
"financeCode": "F02",
"mappingSetBizCode": "VMS20041611X6EIRN",
"groupList": [
{
"mappingCode": "0417-001",
"mappingName": "0417部门A",
"bizCodes": [
"DI1805221OYZHJK6",
"DI1908071UXF1NGH",
"DI2001061HIX0IYR"
],
"includeChildDept":true
}
]
}
响应参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
businessCode |
导入的业务编码 |
是 |
String |
status |
导入状态(成功为true,失败为false) |
是 |
boolean |
messageList |
错误信息(仅导入失败时返回) |
否 |
List<string> |
参数示例
{
"code": "ACK",
"message": "message.success",
"data": [
{
"businessCode": "DI2001061HIX0IYR",
"status": true,
"messageList": []
},
{
"businessCode": "DI1805221OYZHJK6",
"status": true,
"messageList": []
},
{
"businessCode": "DI1908071UXF1NGH",
"status": true,
"messageList": []
}
],
"success": true
}
三、自定义档案(选项组)组别
接口地址
api/openapi/voucher/mapping/optiongroup/import
请求参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
financeCode |
财务系统版本编码编码对照表 |
是 |
String |
mappingSetBizCode |
映射集编码 |
是 |
String |
dataList |
导入的选项组映射关系 |
是 |
List<object> |
bizCode |
选项组业务编码 |
是 |
String |
mappingCode |
映射后编码 |
是 |
String |
mappingName |
映射后名称 |
是 |
String |
参数示例
{
"financeCode": "F02",
"mappingSetBizCode": "VMS200413Y261URW",
"dataList": [
{
"bizCode": "RD1808111P2FW9OG",
"mappingCode": "0417-001",
"mappingName": "0417测试选项组A"
},
{
"bizCode": "EC1803221E22UHXD_CT1804161M4OYRY8",
"mappingCode": "0417-002",
"mappingName": "0417测试选项组B"
}
]
}
响应参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
businessCode |
导入的业务编码 |
是 |
String |
status |
导入状态(成功为true,失败为false) |
是 |
boolean |
messageList |
错误信息(仅导入失败时返回) |
否 |
List<string> |
参数示例
{
"code": "ACK",
"message": "message.success",
"data": [
{
"businessCode": "EC1803221E22UHXD_CT1804161M4OYRY8",
"status": true,
"messageList": []
},
{
"businessCode": "RD1808111P2FW9OG",
"status": true,
"messageList": []
}
],
"success": true
}
四、选项
接口地址
api/openapi/voucher/mapping/optionitem/import
请求参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
financeCode |
财务系统版本编码编码对照表 |
是 |
String |
mappingSetBizCode |
映射集编码 |
是 |
String |
groupList |
导入的选项映射关系 |
是 |
List<object> |
bizCodes |
选项业务编码 |
是 |
List<string> |
mappingCode |
映射后编码 |
是 |
String |
mappingName |
映射后名称 |
是 |
String |
groupCode |
选项所属的选项组业务编码 |
是 |
String |
参数示例
{
"financeCode": "F02",
"mappingSetBizCode": "VMS2004161EZQ31FK",
"groupList": [
{
"mappingCode": "0417-001",
"mappingName": "0417选项单位A",
"groupCode":"RD2004151N01OB9C",
"bizCodes": [
"RDD2004151N0EST1C",
"RDD2004151N091U68",
"DI2001061HIX0IYR"
]
}
]
}
响应参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
businessCode |
导入的业务编码 |
是 |
String |
status |
导入状态(成功为true,失败为false) |
是 |
boolean |
messageList |
错误信息(仅导入失败时返回) |
否 |
List<string> |
参数示例
{
"code": "ACK",
"message": "message.success",
"data": [
{
"businessCode": "RDD2004151N0EST1C",
"status": true,
"messageList": []
},
{
"businessCode": "RDD2004151N091U68",
"status": true,
"messageList": []
},
{
"businessCode": "DI2001061HIX0IYR",
"status": false,
"messageList": [
"未查询到匹配的业务编码"
]
}
],
"success": true
}
五、币种
接口地址
api/openapi/voucher/mapping/currency/import
注意事项
目前系统仅支持传“CNY”类型
请求参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
financeCode |
财务系统版本编码编码对照表 |
是 |
String |
mappingSetBizCode |
映射集编码 |
是 |
String |
dataList |
导入的币种映射关系 |
是 |
List<object> |
bizCode |
币种业务编码 |
是 |
String |
mappingCode |
映射后编码 |
是 |
String |
mappingName |
映射后名称 |
是 |
String |
参数示例
{
"financeCode": "F02",
"mappingSetBizCode": "VMS200413Y261URY",
"dataList": [
{
"bizCode": "CNY2",
"mappingCode": "0419-001",
"mappingName": "币种1"
},
{
"bizCode": "CNY3",
"mappingCode": "0419-003",
"mappingName": "币种2"
}
]
}
响应参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
businessCode |
导入的业务编码 |
是 |
String |
status |
导入状态(成功为true,失败为false) |
是 |
boolean |
messageList |
错误信息(仅导入失败时返回) |
否 |
List<string> |
参数示例
{
"code": "ACK",
"message": "message.success",
"data": [
{
"businessCode": "CNY3",
"status": true,
"messageList": []
},
{
"businessCode": "CNY2",
"status": true,
"messageList": []
}
],
"success": true
}
六、往来单位
接口地址
api/openapi/voucher/mapping/tradingpartner/import
请求参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
financeCode |
财务系统版本编码编码对照表 |
是 |
String |
mappingSetBizCode |
映射集编码 |
是 |
String |
groupList |
导入的往来单位映射关系 |
是 |
List<object> |
bizCodes |
往来单位业务编码 |
是 |
List<string> |
mappingCode |
映射后编码 |
是 |
String |
mappingName |
映射后名称 |
是 |
String |
参数示例
{
"financeCode": "F02",
"mappingSetBizCode": "VMS20041611X6EIRO",
"groupList": [
{
"mappingCode": "0417-001",
"mappingName": "0417往来单位A",
"bizCodes": [
"DI1805221OYZHJK6",
"DI1908071UXF1NGH",
"DI2001061HIX0IYR"
]
}
]
}
响应参数
参数说明
字段名称 |
字段说明 |
必有 |
字段类型 |
businessCode |
导入的业务编码 |
是 |
String |
status |
导入状态(成功为true,失败为false) |
是 |
boolean |
messageList |
错误信息(仅导入失败时返回) |
否 |
List<string> |
参数示例
{
"code": "ACK",
"message": "message.success",
"data": [
{
"businessCode": "DI1805221OYZHJK6",
"status": true,
"messageList": []
},
{
"businessCode": "DI2001061HIX0IYR",
"status": true,
"messageList": []
}
],
"success": true
}
修改记录:
2021-09-08 部门不匹配数据映射写入接口新增 是否包含子部门-includeChildDept 参数
2022-07-27 币种不匹配数据映射写入接口放开仅人民币的限制