批量导入员工收款账号

说明

用户可以通过该接口批量维护员工的收款账号信息。

新增与修改字段说明

1. 员工若不存在银行账户的账号，会新增；已存在则更新。
2. 员工若不存在支付宝账户的账号，会新增；已存在则更新。
3. 员工若不存在现金账户的账户名，会新增；已存在则更新。
4. bankBranchName（分支行名称）、bankBranchNo（联行号）提供了几种模式：
   a. 模式一：只传bankBranchNo（联行号），该联行号必须在每刻存在，系统会自动匹配bankName（开户行）、bankLocation（开户省市）、bankBranchName（分支行），如果传入的bankBranchNo（联行号）不匹配会导入失败（报错提示）；
   c. 模式二：bankBranchNo（联行号）、bankBranchName（分支行名称）同时传入，系统会自动匹配bankName（开户行）、bankLocation（开户省市）。
   
5. （不推荐使用）仅上传accountNumber（账户）时，接口会自动识别并填充开户行等信息。（由于识别接口限制，部分账户可以同步成功但仅能识别部分信息，部分账户无法识别会导致无法同步至每刻，暂时不支持国外银行识别）
6. 海外银行账户导入时，会校验对应国家模板字段的必填值，若有缺失，会导入失败，并返回相应的错误信息
7. 支持部分失败，即一条数据失败不影响其他正确数据导入。

接口限制

 1. 10次/秒;
 2. 一次最多支持100个。

接口地址

/api/openapi/personal/account/detail

请求类型

POST

请求参数

参数说明

accountList

证件类型名称certificateTypeName

参数样例

[
  {
    "empId": "190013",
    "accountList": [
      {
        "paymentType": "BANK",
        "accountName": "银行户名",
        "accountNumber": "6225807142412381",
        "bankName": "工商银行",
        "bankLocation": "石家庄市/河北",
        "bankBranchName": "中国工商银行石家庄东风支行",
        "bankBranchNo": "102121000037",
        "certificateTypeName": "居民身份证",
        "identification": "33031820191111321X",
        "defaultAccount": false
      },
      {
        "paymentType": "ALIPAY",
        "accountName": "支付宝账户名",
        "accountNumber": "12345679876",
        "defaultAccount": true
      },
      {
        "paymentType": "CASH",
        "accountName": "现金户名",
        "defaultAccount": false
      },
      {
        "paymentType": "BANK",
        "country": "美国",
        "accountName": "海外银行导入账户",
        "accountNumber": "62217717120201218001",
        "bankName": "Amalgamated Bank",
        "swiftCode": "012345",
        "abroadPayeeAddress": "海外银行的收款人地址",
        "payeeAccountType": "PERSONAL",
        "routingNumber": "1234567"
      }
    ]
  }
]

响应参数

参数说明

PersonalAccountResult 说明

员工账号错误信息

参数样例

{
  "code": "ACK",
  "message": "保存成功",
  "data": {
    "hasErrorMsg": true,
    "errorMsgDetail": [
      {
        "empId": "190013",
        "errorMsg": [
          "银行账户_每刻_证件类型不能为空;银行账户_每刻_分支行和开户行不匹配",
          "支付宝_null_账户名不能为空"
        ]
      }
    ]
  },
  "success": true
}

修改记录

2022-12-15 收款币种支持多币种