新增/更新

  • 接口：/common/companyAccounts/v2/batch(付款账号)
  • 接口：/common/companyDeliveryAccounts/v2/batch(收款账号)
  • Method：POST
  • 数据格式：JSON
  • 限流信息：100次每天和50次每小时
  • 多语言环境：该接口用作公司银行的批量同步，在整批数据中如果只有几条数据因为其他原因失败，那么只有这几条数据不会被处理，其他数据仍会被正常处理
  • 其他补充信息：单次数据量过大时候(超过200条)会全部转为异步处理，具体参考回调示例

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 TRUE 36
timestamp long 当前次接口同步对应的时间戳 TRUE 13
data Array 当前次接口同步的数据集合 TRUE 无
data.code String 银行账号 TRUE 255
data.department_code String 公司代码 TRUE 255
data.bank_name String 银行名称 TRUE 255
data.bank_code String 银行代码 TRUE 255
data.state String 省 FALSE 255
data.city String 市 FALSE 255
data.bank_address String 银行地址 FALSE 255
data.bank_branch String 支行名称 FALSE 255
data.internal_type String 账户类型 FALSE 255
data.bank_swift_id String 银行Swift代码 FALSE 255
data.primary_flag String 是否为默认银行(Y/N,默认为Y) FALSE 255
data.enabled_flag String 启用标志 FALSE 255
data.payer_account_area_code String 招行地区码 FALSE 16
data.tax_number String 税号 FALSE 100

返回参数

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
created String 创建成功的条数
updated String 更新成功的条数
validatorErrors Array 字段强校验不合格的数据
dbErrors Array 数据持久化时出现错误的数据
warnings Array 字段弱校验不合格的数据，任会做同步处理

示例：

请求数据

{
  "bizId" : "639fc90a-d383-4537-b98a-456594916d52",
  "timestamp" : 1591266599229,
  "data" : [ {
    "code":"A9003",
    "department_code" : "D001",
    "bank_name" : "中国招商银行",
    "bank_code" : "105100000017",
    "account_name" : "王海波",
    "bank_branch" : "招商银行",
    "internal_type": "A"
  },{
    "code":"A9001",
    "department_code" : "D00211111",
    "bank_name" : "中国农业银行",
    "bank_code" : "105100000017",
    "account_name" : "王海",
    "bank_branch" : "招商银行",
    "internal_type": "A"
  },{
    "code":"A9002",
    "department_code" : "D003",
    "bank_name" : "中国银行",
    "bank_code" : "105100000017",
    "account_name" : "王波",
    "bank_branch" : "中国银行分行",
    "internal_type": "A"
  },{
    "code":"A9004",
    "department_code" : "D005",
    "bank_name" : "中国123银行",
    "bank_code" : "105100000017",
    "account_name" : "哈哈",
    "bank_branch" : "中国123银行分行",
    "internal_type": "A"
  }]
}

返回数据

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "639fc90a-d383-4537-b98a-456594916d52",
  "data": {
    "validatorErrors": [
      {
        "code": "D005",
        "messages": [
          "该D005不是公司"
        ]
      },
      {
        "code": "D00211111",
        "messages": [
          "该公司D00211111不存在"
        ]
      }
    ],
    "created": "此次请求新建成功了0条数据",
    "warnings": [],
    "dbErrors": [],
    "updated": "此次请求更新成功了2条数据"
  }
}

results matching ""

    No results matching ""