保存往来单位账户

说明

一、当已经在每刻系统中维护好了往来单位后，可以使用该接口导入往来单位账户信息。

1. 银行账户的账号在所属往来单位下不存在，会新增；已存在则更新。
2. 支付宝账户的账号在所属往来单位下不存在，会新增；已存在则更新。
3. 现金账户的账户名在所属往来单位下不存在，会新增；已存在则更新。
4. 账户编码在所属公司下下不存在，会新增；已存在则更新。
   

二、重复数据处理：

1. 批量数据中往来单位存在重复的businessCode，接口以排序靠后的数据为准。
2. 同一往来单位下的银行账户信息存在重复的账号，支付宝账户信息存在重复的账号，现金账户存在重复的账户名，以靠后的数据为准。

三、入参数据格式说明：

1. 国内收款账户的bankBranchName（分支行名称）、bankBranchNo（联行号）支持以下几种模式：
   a. 模式一：只传bankBranchNo（联行号），且该联行号在每刻存在，则系统会自动匹配bankName（开户行）、bankLocation（开户省市）、bankBranchName（分支行）。如果传入的bankBranchNo（联行号）不匹配会导入失败（报错提示）；
   b. 模式二：只传bankBranchName（分支行名称），以传入的bankBranchName（分支行名称）为准，且其他参数不会自动带出（bankName（开户行）、bankLocation（开户省市）），如需显示则需要传相应字段；
   c. 模式三：两个参数同时传入，以传入的bankBranchName（分支行）、bankBranchNo（联行号）为准，且其他参数不会自动带出（如bankName（开户行）、bankLocation（开户省市）），如需显示则需要传相应字段。如果传入的bankBranchNo（联行号）、bankBranchName（分支行）不存在也会导入成功。
   
2. （不推荐使用）仅上传accountNumber（账户）时，接口会自动识别并填充开户行等信息。（由于识别接口限制，部分账户可以同步成功但仅能识别部分信息，部分账户无法识别会导致无法同步至每刻，暂时不支持国外银行识别）
   
3. 海外/其他地区银行若需显示开户行信息，则必传bankName（银行名称）、countryName（国家/地区名称）。
4. 部分资金系统对接会需要开户银行地址参数，国内请填写bankLocation，国外请填写abroadBankAddress。
5. 此接口为部分失败模式，异常数据会返回每条具体异常提示。
6. 企业账户表单开启 IBAN 正则校验后，银行账户传入的非空 ibanNumber 必须符合已配置的正则；未开启时不新增格式校验。

接口限制

单次最多导入150条数据

接口地址

/api/openapi/tradingPartner/batch/account/save

请求类型

POST

请求参数

参数说明

Account

证件类型certificationType

参数样例

[
   {
      "businessCode": "MK001",
      "updateCustomObject": false,
      "accounts": [
         {
            "countryName": "阿拉伯联合酋长国",
            "bankName": "ABU DHABI COMMERCIAL BANK",
            "accountName": "Meeting Point Tourism LLC",
            "accountNumber": "123456789",
            "accountType": "BANK",
            "swiftCode": "test",
            "ibanNumber": "AE070331234567890123456",
            "abroadBankCode":"122312",
            "bankNameEn": "",
            "customObject": {
               "CF30": 333
            }
         },
         {
            "accountType": "BANK",
            "accountName": "每刻",
            "accountNumber": "6225807142412381",
            "bankName": "工商银行",
            "bankLocation": "石家庄市/河北",
            "bankBranchName": "中国工商银行石家庄东风支行",
            "bankBranchNo": "1021210000371",
            "countryName": "中国",
            "certificationType": "居民身份证",
            "identification": "33031820191111321X",
            "accountBizCode": "BANKBIZCODE",
            "defaultAccount": true,
            "bankNameEn": "",
            "updateCustomObject": true,
            "customObject": {
               "CF31": 444
            }
         },
         {
            "accountType": "ALIPAY",
            "accountName": "每刻",
            "accountNumber": "12345679876",
            "accountBizCode": "ALIPAYBIZCODE",
            "bankNameEn": ""
         },
         {
            "accountType": "CASH",
            "accountName": "每刻",
            "accountBizCode": "CASHBIZCODE",
            "bankNameEn": ""
         }
      ]
   }
]

响应参数

响应参数说明

参数样例

{
  "code":"ACK",
  "message":"操作成功！",
  "data":[
    {
      "businessCode":"MK001",
      "status":"PART_FAIL",
      "message":"accounts[0]分支行联行号错误"
    },
    {
      "businessCode":"MKgongxb001",
      "status":"SUCCESS",
      "message":""
    }
  ],
  "errorCode":null,
  "success":true
}

修改记录

2023-02-08  新增导入往来单位账户接口
2025-10-15  新增是否为往来单位默认账户字段
2025-12-09  请求参数新增中国账户跨境汇款字段
2026-01-15  请求参数新增selfEmployeeIsPersonal账户性质字段
2026-07-15  请求参数新增customObject自定义字段、updateCustomObject比较更新
2026-09-18  往来单位银行账户按企业账户表单配置校验IBAN格式