新增/更新员工海外银行卡

  • 接口 /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)"}
}

results matching ""

    No results matching ""