新增/更新
- 接口 /account/personal/save
- Method:POST
- 数据格式:JSON
- 接口说明:用于同步员工银行卡信息
参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
employeeId | string | Y | Y | 员工工号 | |
payeeCardNo | string | Y | Y | 银行卡号 当personPaymentType=cash 非必须 | |
payeeName | string | Y | 户名 当personPaymentType=cash 非必须 | ||
defaultBankCard | boolean | N | false | 该银行卡是否是该员工的默认银行卡 | |
bankBranchNo | string | Y | 开户行联行号;当customBranchFlag为true时,非必须;当personPaymentType=cash 非必须 | ||
bankBranchName | string | N | 开户行分支行名称;当customBranchFlag为true时,必须;当personPaymentType=cash 非必须 | ||
certificationType | string | 居民身份证 | 员工证件号码类型, 可选的值参考下表 | ||
identification | string | Y | 证件号码 当personPaymentType=cash 非必须 | ||
customBranchFlag | boolean | N | false | 是否自定义开户行分支行 | |
bankCityName | string | N | 开户省市,例:浙江/杭州市;当customBranchFlag为true时,必须 | ||
bankName | string | N | 银行名称,例:工商银行;当customBranchFlag为true时,必须 | ||
personPaymentType | string | N | 导入类型,默认银行卡,传入'cash'表示现金 |
返回
参数 | 类型 | 描述 |
---|---|---|
code | string | 每刻系统内唯一编码 |
errorData | string | 错误原因 |
注意
1.需要先在每刻控制中心-开启‘使用每刻开放接口维护员工收款银行卡’开关,但是属于例外部门的这些员工银行卡只能在每刻系统里维护;
2.控制中心开启'编辑中国的银行账户时允许手动录入分支行'开关
3.当customBranchFlag为false时,bankBranchNo、bankName、bankBranchName三个参数提供两种模式,模式一:只传入bankBranchNo,该联行号必须在每刻银行库存在;模式二:
三个参数同时传入,接口保存时以接口传入的银行名称和分支行名称为准;
当customBranchFlag为true时,bankName、bankCityName必填并且符合定义的格式,bankBranchNo、bankBranchName按传入的数据为准;
证件类型
证件类型 |
---|
台湾居民来往大陆通行证 |
户口簿 |
军人身份证 |
武装警察身份证 |
外交人员身份证 |
外国人居留许可证 |
对私其它 |
边民出入境通行证 |
企业营业执照 |
企业法人营业执照 |
华机构登记证 |
个体工商户营业执照 |
港澳居民来往内地通行证(香港) |
组织机构代码证 |
港澳居民来往内地通行证(澳门) |
临时身份证 |
居民身份证 |
护照 |
返回参数
该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(employeeId-payeeCardNo)会被放在errorData里面;
errorData为结构体, 包含出错记录主键(employeeId-payeeCardNo), 以及与之对应的出错信息; 类似 {"employeeId-payeeCardNo": "错误信息"}; 具体参见失败实例;
为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;
示例:
请求数据
{
"data":[
{
"employeeId":"10001",
"payeeCardNo":"1234567890123456",
"payeeName":"测试",
"defaultBankCard":false,
"bankBranchNo":"1023310002171",
"bankBranchName":"铜山县农村信用社合作联社铜电信用分社",
"certificationType":"居民身份证",
"identification":"1231242424441124242"
},
{
"employeeId":"10002",
"payeeCardNo":"1234567890123457",
"payeeName":"测试2",
"defaultBankCard":false,
"bankBranchNo":"102331000217",
"bankBranchName":"铜山县农村信用社合作联社铜电信用分社",
"certificationType":"居民身份证",
"identification":"1231242424441124243"
},
{
"employeeId":"E1",
"payeeCardNo":"999999",
"payeeName":"测试",
"bankBranchNo":"110110110",
"bankBranchName":"分支行名称",
"defaultBankCard":false,
"certificationType":"居民身份证",
"identification":"1231242424441124242",
"customBranchFlag":true,
"bankCityName":"陕西/西安市",
"bankName":"工商银行"
}
],
"timestamp":1513932010586
}
返回数据(成功)
{
"code": "ACK",
"message": ""
}
返回数据(失败)
{
"code": "NACK",
"errorData": {"10001-1234567890123456": "未找到银行(1023310002171)"}
}