删除员工收款账户

说明

用户可以通过该接口删除维护在每刻系统中的员工收款账户。

  • 当账户类型、账号(现金类型非必填)、账户名称三个字段全部匹配时,会对账户进行删除。
  • 该接口为部分失败接口,例如需要删除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 初始化
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""