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