新增/更新

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

results matching ""

    No results matching ""