删除员工收款账户
说明
用户可以通过该接口删除维护在每刻系统中的员工收款账户。
- 当账户类型、账号(现金类型非必填)、账户名称三个字段全部匹配时,会对账户进行删除。
- 该接口为部分失败接口,例如需要删除A、B、C三个银行账户,则在进行删除时,如果账户B删除失败,则会返回对应的失败信息,并将账户A、C删除。
- 其他和现金类型的账户删除时,按照账户户名删除,如果已存在同名账户,一次请求里只有一个账户参数则只会删除一个账号。
接口限制
1. 10次/秒;
2. 一次最多支持100个。
接口地址
/api/openapi/personal/account
请求类型
DELETE
请求参数
参数说明
字段名 |
字段类型 |
是否必填 |
字段字段说明 |
employeeId |
String |
是 |
员工工号 |
accounts |
List<Account> |
是 |
员工账户数组 |
Account收款账户信息参数说明:
字段名 |
字段类型 |
是否是 |
字段字段说明 |
paymentType |
String |
是 |
账户类型,包括银行卡、支付宝和现金单选,可选值为BANK、ALIPAY和CASH |
accountName |
String |
是 |
账户名 |
accountNumber |
String |
否 |
银行对应银行卡号,支付宝对应支付宝账号,现金类型否 |
参数样例
{
"employeeId":"员工工号",
"accounts":[{
"paymentType":"CASH",
"accountName":"线下财务支付"
},{
"paymentType":"ALIPAY",
"accountNumber":"1234",
"accountName":"支付宝"
},{
"paymentType":"BANK",
"accountNumber":"123456789",
"accountName":"bankAccountName"
}]
}
响应参数
参数样例
全部正常保存数据示例
{
"code": "ACK",
"message": "操作成功",
"data": {
}
}
存在收款账户错误时的异常数据示例
错误的数据会返回对应的错误信息。因为员工有多个账户,账户的错误信息在errorMessage中,idx为第几个员工的收款账户错误。不同的异常,errorCode字段也会不同
{
"success": false,
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"idx": 1,
"errorCode": "200001",
"errorMessage": "缺少参数,账号"
}
]
}
}
error code说明
errorCode |
含义 |
200001 |
缺少参数,账号 |
200002 |
缺少参数,账户名称 |
200003 |
该账户不存在! |
200004 |
请填写正确的账户类型 |
修改记录
2023-03-07 初始化