新增/更新
- 接口:/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 | 支付方式业务实体编码 |