往来单位账号删除接口
说明
用户可以通过改接口删除维护在每刻系统中的往来单位账号。
接口限制
1. 同一往来单位下的银行账户信息存在重复的账号,支付宝账户信息存在重复的账号,现金账户存在重复的账户名,以靠后的数据为准。
2. 接口支持按照账户编码删除账号、以及账户编码参数之外的参数组合删除,如果一个请求参数两者都有,则优先按照账户编码删除。
接口地址
/api/openapi/tradingPartner/accounts
请求类型
DELETE
请求参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| bizCode | String(80) | 是 | 往来单位编码 |
| accounts | List<Account> | 是 | 往来单位账号 |
Account 往来单位账户
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| accountType | String(20) | 是 | 账户类型: BANK 银行卡 ALIPAY 支付宝 CASH 现金 |
| accountBizCode | String(100) | 条件必填 | 账户编码。传入后优先按该字段删除,accountName、accountNumber、bankName 均不再必填。 |
| accountName | String(100) | 条件必填 | 未传 accountBizCode 时必填。BANK、ALIPAY 为账户名/户名;CASH 为现金账户名称。 |
| accountNumber | String(200) | 条件必填 | 未传 accountBizCode 时,BANK 为银行卡号、ALIPAY 为支付宝账号,均必填;CASH 不需要传。 |
| bankName | String(200) | 条件必填 | 未传 accountBizCode 且 accountType=BANK 时必填,填写银行名称。 |
删除账号可使用以下任一定位方式:
- 账户编码:传入
accountBizCode。- 字段组合:不传
accountBizCode时,BANK 必须传accountName、accountNumber、bankName;ALIPAY 必须传accountName、accountNumber;CASH 必须传accountName。
参数样例
使用账户编码删除:
{
"bizCode": "bizCode",
"accounts": [
{
"accountType": "BANK",
"accountBizCode": "BANKBIZCODE"
}
]
}
使用字段组合删除:
{
"bizCode": "bizCode",
"accounts": [
{
"accountType": "CASH",
"accountName": "1234"
},
{
"accountType": "ALIPAY",
"accountNumber": "1234",
"accountName": "支付宝"
},
{
"accountType": "BANK",
"accountNumber": "123456789",
"accountName": "bankAccountName",
"bankName": "工商银行"
}
]
}
响应参数
响应参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| businessCode | String(80) | 是 | 往来单位编码 |
| status | String(20) | 是 | 删除结果, SUCCESS 成功 PART_FAIL 部分失败 ALL_FAIL 全部失败 |
| message | String(100) | 是 | 结果描述 |
参数样例
- 正常响应参数示例
2.存在收款账户错误时的异常数据示例: 错误的数据会返回{ "code": "ACK", "message": "操作成功", "data": { "hasErrorMsg":false, "errorMsgDetail":[] } }NACK及对应的可读错误信息。因为往来单位有多个账户,账户的错误信息会在信息前加account[index],每个账户的错误信息使用英文逗号,隔开。 ```json { "code": "NACK", "message": "保存失败", "data": { "hasErrorMsg": true, "errorMsgDetail": [ {
} ] } }"bizCode": "bizCode", "errorMsg": [ "account[0]账号不能为空,银行名称不能为空" ]
## 修改记录
```text
2023-02-08 新增往来单位账户删除接口文档
2026-08-11 明确删除账号的条件必填字段及失败响应