新增/更新员工海外银行卡
- 接口 /account/personal/abroad/save
- Method:POST
- 数据格式:JSON
- 接口说明:用于同步员工海外银行卡信息
参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
employeeId | string | Y | Y | 员工工号 | |
payeeCardNo | string | Y | Y | 银行卡号 | |
payeeName | string | Y | 户名 | ||
bankCountry | string | Y | 该银行卡所属国,目前只支持香港,值固定为"HONG_KONG" | ||
swiftCode | string | Y |
返回
参数 | 类型 | 描述 |
---|---|---|
code | string | 每刻系统内唯一编码 |
errorData | string | 错误原因 |
注意
需要先在每刻控制中心-开启‘使用每刻开放接口维护员工收款银行卡’开关,但是属于例外部门的这些员工银行卡只能在每刻系统里维护!
返回参数
该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(employeeId-payeeCardNo)会被放在errorData里面;
errorData为结构体, 包含出错记录主键(employeeId-payeeCardNo), 以及与之对应的出错信息; 类似 {"employeeId-payeeCardNo": "错误信息"}; 具体参见失败实例;
为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;
示例:
请求数据
{
"data": [
{
"employeeId":"005",
"payeeCardNo":"1234567890123456",
"payeeName":"测试",
"bankCountry":"HONG_KONG",
"swiftCode":"UBHKHKHH"
},
{
"employeeId":"006",
"payeeCardNo":"1234567890123457",
"payeeName":"测试2",
"bankCountry":"HONG_KONG",
"swiftCode":"UBHKHKHH"
}
],
"timestamp": 1537941352859
}
返回数据(成功)
{
"code": "ACK",
"message": ""
}
返回数据(失败)
{
"code": "NACK",
"errorData": {"10001-1234567890123456": "未找到银行(1023310002171)"}
}