保证金台账外部凭证号更新接口
说明
该接口用于批量更新保证金/押金台账的外部凭证号。接口只更新台账外部凭证号，不处理退还、转费用、坏账、收据上传等内部业务操作。
接口地址
/api/openapi/account-book/deposit/external-voucher/update
请求类型
POST
请求参数
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| items |
List<Item> |
是 |
更新明细，单次最多 50 条 |
Item
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| reimburseCode |
String |
是 |
单据号 |
| depositNo |
String |
是 |
保证金编号 |
| externalVoucherNo |
String |
否 |
外部凭证号，长度不超过 256；传空可清空外部凭证号 |
参数样例
{
"items": [
{
"reimburseCode": "MK26040032",
"depositNo": "MK26040032-A1",
"externalVoucherNo": "EXT26050001"
}
]
}
响应参数
| 字段名称 |
字段类型 |
字段说明 |
| successData |
List<SuccessData> |
更新成功的数据 |
| errorData |
List<OpenApiErrorData> |
更新失败的数据 |
SuccessData
| 字段名称 |
字段类型 |
字段说明 |
| idx |
Integer |
请求明细下标，从 0 开始 |
| reimburseCode |
String |
单据号 |
| depositNo |
String |
保证金编号 |
| externalVoucherNo |
String |
更新后的外部凭证号 |
参数样例
{
"code": "ACK",
"message": null,
"data": {
"successData": [
{
"idx": 0,
"reimburseCode": "MK26040032",
"depositNo": "MK26040032-A1",
"externalVoucherNo": "EXT26050001"
}
],
"errorData": []
},
"requestId": null,
"errorCode": null,
"success": true
}
修改记录
2026-05-29 新增保证金台账外部凭证号更新接口文档