创建员工银行账户

接口描述

本接口用于创建员工银行账户

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/bank-accounts

请求方式

POST

请求体示例

{
    "employeeId": "EMP-001",
    "bankCode": "0000",
    "bankBranchCode": "001",
    "bankAccountType": "1",
    "bankAccountNo": "1234567",
    "bankAccountName": "员工账户",
    "bankAccountFbName": "ABC",
    "isTransferFeeAfforded": false,
    "isDebitAccount": true,
    "isPrimary": true,
    "isEnabled": true
}

请求体字段

字段名	类型	必填	主键	约束	说明
employeeId	String	是	○		员工工号
bankCode	String	是	○		银行编码
bankBranchCode	String	是	○		支行编码
bankAccountType	String	是		1：活期存款 2：无息存款 4：定期存款 9：其它	账户类型
bankAccountNo	String	是	○	数字，最大长度7位	银行账号
bankAccountName	String	是		文字，最大长度50位	账户名称
bankAccountFbName	String	是		半角文字，最大长度30位	账户名称(FB用)
isTransferFeeAfforded	Boolean	是			银行手续费负担方 true:对方 false:本方
isDebitAccount	Boolean	是			是否扣款账户
isPrimary	Boolean	是			是否主账户
isEnabled	Boolean	是			是否启用

接口返回示例

成功

{
    "message": "success",
    "oid": "7a02401e-11d7-438c-b9a3-ed9761719505"
}

失败示例

{
    "message": "银行编码必填",
    "errorCode": "xxxxx"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误码
oid	UUID	银行账户oid

错误代码

errorCode	message	说明
0013	参数:{0},最大长度{1}
120003	缺少必填项:{0}
121716	银行账号已被占用
240014	银行账户不能设置禁用默认
240050	银行账号只允许数字且7位以内
240054	账户名（半角假名）只允许半角文字且30位以内
1202071	员工不存在:{0}
5018003	无效的银行代码或支行代码
5269001	无效的{0}
VALIDATION_ERROR	Invalid value {0} for property :{1}	boolean值格式校验