新增/更新

  • 接口:/account/corp/save
  • Method:POST
  • 数据格式:JSON
  • 接口说明:用于同步公司用于支付的银行账号等信息

请求参数

参数 类型 必须 默认值 主键 描述
paymentCode string Y Y 编码,用于唯一确定该支付方式
payerName string Y 支付账号名称
account string Y 银行账号
bankBranchNo string Y 银行分行联行号;当customBranchFlag为true时,非必须
bankBranchName string N 开户行分支行名称;当customBranchFlag为true时,必须
status string ACTIVE 账号状态, 可选ACTIVE,INACTIVE
subsidiaryBizCode string 账号所属业务实体编码,不提供,则会和企业默认业务实体管理
paymentScope array N 支付方式适用类型,三选一:supplier, pay_employee, collection_employee
customBranchFlag boolean N false 是否自定义开户行分支行
bankCityName string N 开户省市,例:浙江/杭州市;当customBranchFlag为true时,必须
bankName string N 银行名称,例:工商银行;当customBranchFlag为true时,必须

返回

参数 类型 描述
code string 每刻系统内唯一编码
errorData string 错误原因

注意

控制中心需开启'编辑中国的银行账户时允许手动录入分支行'开关

当customBranchFlag为false时,bankBranchNo、bankName、bankBranchName三个参数提供两种模式,模式一:只传入bankBranchNo,该联行号必须在每刻银行库存在;模式二: 三个参数同时传入,接口保存时以接口传入的银行名称和分支行名称为准;

当customBranchFlag为true时,bankName、bankCityName必填并且符合定义的格式,bankBranchNo、bankBranchName按传入的数据为准;

返回参数

该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(employeeId-payeeCardNo)会被放在errorData里面;

errorData为结构体, 包含出错记录主键(bankBranchNo), 以及与之对应的出错信息; 类似 {"bankBranchNo": "错误信息"}; 具体参见失败实例;

为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;

示例:

请求数据

{
    "timestamp": 1513932010586,
    "data": 
  [
    {
      "account": "101280001010628000",
      "bankBranchNo": "402303301063",
      "payerName": "农商银行-农商银行古里支行",
      "paymentCode": "100201161010",
      "bankBranchName": "铜山县农村信用社合作联社铜电信用分社",
      "status": "ACTIVE",
      "subsidiaryBizCode": "SI18070220ITVO51",
      "paymentScope": ["supplier", "pay_employee"]
    },
    {
      "account": "101280001010628002",
      "bankBranchNo": "102100000021",
      "payerName": "工商银行-工商银行古里支行",
      "paymentCode": "100201161010",
      "bankBranchName": "铜山县农村信用社合作联社铜电信用分社",
      "status": "ACTIVE",
      "subsidiaryBizCode": "SI18070220ITVO51"
    },
    {
      "account": "101280001010628001",
      "bankBranchNo": "110110110",
      "bankBranchName":"分支行名称",
      "payerName": "支付帐号名称",
      "paymentCode": "1002999889899",
      "status": "ACTIVE",
      "paymentScope": ["supplier", "pay_employee"],
      "customBranchFlag":true,
      "bankName":"工商银行",
      "bankCityName":"浙江/杭州市"
    }
  ]
}

返回数据(成功)

{
    "code": "ACK",
    "message": "",
}

返回数据(失败)

{
    "code": "NACK",
    "errorData": {"402303301063": "未找到银行(1023310002171)"}
}

获取支付方式列表

接口 /account/corp/list GET JSON

返回

参数 类型 描述
code string 每刻系统内唯一主键
paymentCode string 支付方式业务编码
payerName string 支付账号名称
account string 支付方式银行账号
bankCode string 支付方式银行缩写,如BOC
bankName string 支付方式银行名称,如中国银行
bankBranchNo string 银行分行联行号
bankBranchName string 银行分行
updatedAt date 支付方式记录更新时间
subsidiaryName string 支付方式业务实体
subsidiaryBizCode string 支付方式业务实体编码

results matching ""

    No results matching ""