Spendia开放接口

创建员工信用卡信息

接口描述

此接口用于创建员工的信用卡信息

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/credit-cards

请求方式

POST

请求体示例

{
    "employeeId": "EMP-001",
    "creditCardUserId": "xxx123456",
    "creditCardCompanyCode": "JC",
    "userCompanyCode": "TIS",
    "isEnabled": true
}

请求体字段

字段名 类型 必填 主键 约束 说明
employeeId String 是 ○ 最大长度 32 员工工号
creditCardUserId String 是 ○ 最大长度 20 信用卡用户ID
creditCardCompanyCode String 是 ○ 固定长度 2 信用卡公司代码
userCompanyCode String 是 ○ 最大长度36 员工公司代码
isEnabled Boolean 否 默认：true 状态
true：有效
false：无效

接口返回示例

成功

{
    "message": "success",
    "key": "xxx123456"
}

失败示例

{
    "message": "信用卡用户ID已存在:xxx123456",
    "errorCode": "xxxxx"
}

字段说明

字段名称 类型 说明
message String 返回信息说明
key String 信用卡用户ID
errorCode String 返回错误编码

错误代码

errorCode message 说明
0013 参数:{0},最大长度{1}
120003 缺少必填项:{0}
120016 参数长度非法:{0}长度必须为{1}个字符
1202071 员工不存在:{0}
6047055 无效的公司编码
CREDIT_CARD_005 信用卡公司代码不存在:{0}
CREDIT_CARD_006 信用卡用户ID已存在:{0}
CREDIT_CARD_008 公司对信用卡服务未开通或者已关闭:{0}

← 更新员工信用卡信息 →