批量同步接口

接口：common/supplieraccounts/v2/batch
Method：POST
数据格式：JSON
限流信息：150次每天和50次每小时
多语言环境：在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
接口说明：该接口用作供应商银行的批量同步，在整批数据中如果只有几条数据因为其他原因失败，那么只有这几条数据不会被处理，其他数据仍会被正常处理
其他补充信息：单次数据量过大时候(超过200条)会全部转为异步处理，具体参考回调示例

参数:

请求参数

字段名称	字段类型	字段描述	是否必填	长度限制(字节)
bizId	String	当前次接口同步的唯一标识	TRUE	36
timestamp	long	当前次接口同步对应的时间戳	TRUE	13
full_data	String	是否禁用这批数据所有账号(Y/N,默认为N)	FALSE	1
data	Array	当前次接口同步的数据集合	TRUE	无
data.code	String	供应商银行账号	TRUE	255
data.supplier_code	String	供应商编码	TRUE	64
data.bank_name	String	供应商银行所属开户行	TRUE	255
data.bank_branch	String	供应商银行所属分行	FALSE	255
data.account_name	String	供应商银行账户名称	FALSE	255
data.bank_code	String	供应商银行代码	FALSE	255
data.account_type	String	账户类型, 可选项: exp_public_account(对公), exp_private_account(对私), 不传默认对公	FALSE	255
data.bank_swift_id	String	供应商银行swift代码	FALSE	255
data.bank_address	String	供应商银行地址	FALSE	255
data.state	String	供应商银行所在省	FALSE	255
data.city	String	供应商银行所在城市	FALSE	255
data.enabled_flag	String	供应商银行启用标志(Y/N新建时默认为Y)	FALSE	1
data.primary_flag	String	是否为默认账号(默认账号自动调整为启动,Y/N新建时默认为Y,更新时如果当前账号为默认账号，则不能更新为N)	FALSE	1
data.currency_code	Array	币种	FALSE	0
data.payment_type	Array	支付方式	FALSE	0

返回参数

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

示例：

请求数据

{
  "bizId" : "2b60562c-2b1d-4f98-b486-c04ad35096f3",
  "timestamp" : 1591591947384,
  "data" : [ {
    "city" : "上海",
    "code" : "62217762300040657",
    "supplier_code" : "S002",
    "account_name" : "n1",
    "bank_name" : "上海银行",
    "bank_swift_id" : "1902",
    "bank_address" : "上海浦西",
    "state" : "上海",
    "currency_code":["CYN","CNN"],
    "payment_type":["01","02"],
    "primary_flag" : "Y"
  }]
}

返回数据

{
  "resCode" : 200000,
  "resMsg" : "success",
  "bizId" : "2b60562c-2b1d-4f98-b486-c04ad35096f3",
  "data" : {
    "validatorErrors" : {
      "2341245690288" : [ "供应商的开户银行不能为空" ]
    },
    "created" : "此次请求新建成功了0条数据",
    "dbErrors" : [ ],
    "updated" : "此次请求更新成功了1条数据"
  }
}

results matching ""

No results matching ""