银行流水发布
状态机
原始状态 |
可更新状态 |
待处理-pending |
待认领-delivering |
已退回-returned |
待认领-delivering |
注意
- 已退回状态的流水是由员工将待认领的流水点击退回操作而产生
- 银行流水发布接口与手工发布银行流水效果完全相同
- 接口返回报错dbErrors表示流水id对应的银行流水以及后续的银行流水都没有发布成功
单条发布
- 接口:common/transSerialDeliveries/v2/publish
- Method:PUT
- 数据格式:JSON
- 接口说明:银行流水发布(单条)接口
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
业务唯一识别码 |
是 |
64 |
timestamp |
long |
时间戳 |
是 |
13 |
data.biz_key |
String |
流水唯一标识 |
是 |
64 |
data.code |
String |
交易流水号 |
否 |
64 |
data.user_codes |
Array |
待认领人员工号,一条流水最多可传50个员工号。认领人员工号、用户名必填其一,若都填则以员工号匹配 |
否 |
|
data.user_names |
Array |
待认领人用户名,一条流水最多可传50个用户名。认领人员工号、用户名必填其一,若都填则以员工号匹配 |
否 |
|
data.comment |
String |
备注,展示在的流水操作历史 |
否 |
64 |
示例
{
"biz_id": "3ec9758b-8f4c-4f27-9e56-15134e4b6013",
"timestamp": 1671757473000,
"data": {
"code": "xxxxxxxxxx",
"user_names": [
"xxxxxxxxxx@cloudpense.com"
],
"comment": "openapi发布流水"
}
}
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
String |
状态码 |
resMsg |
String |
描述 |
bizId |
String |
业务唯一标识 |
data.dbErrors |
String |
数据库错误信息 |
data.updated |
String |
更新数据信息 |
data.validatorErrors |
String |
错误信息 |
data.validatorErrors.code |
String |
警告数据编码 code表示的是错误数据的银行流水号code或biz_key |
publishCount |
String |
发布银行流水条数 |
示例
{
"resCode": 200000,
"resMsg": "success",
"data": {
"validatorErrors": {},
"updated": "此次请求更新成功了1条数据",
"publishCount": 1
}
}
批量发布
- 接口:common/transSerialDeliveries/v2/batchPublish
- Method:PUT
- 数据格式:JSON
- 接口说明:银行流水发布(批量)接口
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
业务唯一识别码 |
是 |
64 |
timestamp |
long |
时间戳 |
是 |
13 |
data.biz_key |
String |
流水唯一标识 |
是 |
64 |
data.code |
String |
交易流水号 |
否 |
64 |
data.user_codes |
Array |
待认领人员工号,一条流水最多可传50个员工号。认领人员工号、用户名必填其一,若都填则以员工号匹配 |
否 |
|
data.user_names |
Array |
待认领人用户名,一条流水最多可传50个用户名。认领人员工号、用户名必填其一,若都填则以员工号匹配 |
否 |
|
data.comment |
String |
备注,展示在的流水操作历史 |
否 |
64 |
示例
{
"bizId": "3ec9758b-8f4c-4f27-9e56-15134e4b6013",
"timestamp": 1671757473000,
"data": [
{
"code": "3102800000NNPS2AS7U",
"user_names": [
"zmpafr51392@chacuo.net"
],
"comment": "openapi发布流水"
},
{
"code": "3102800000NEP6TGQJZ",
"user_names": [
"zmpafr51392@chacuo.net"
],
"comment": "openapi发布流水"
}
]
}
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
String |
状态码 |
resMsg |
String |
描述 |
bizId |
String |
业务唯一标识 |
data.dbErrors |
String |
数据库错误信息 |
data.updated |
String |
更新数据信息 |
data.validatorErrors |
String |
错误信息 |
data.validatorErrors.code |
String |
警告数据编码 code表示的是错误数据的银行流水号code或biz_key |
publishCount |
String |
发布银行流水条数 |
示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "3ec9758b-8f4c-4f27-9e56-15134e4b6013",
"data": {
"validatorErrors": {},
"updated": "此次请求更新成功了2条数据",
"publishCount": 2
}
}