员工信息同步接口
新增员工
- 请求路径:userInfo/addUser
- 请求方式:POST
- 请求参数说明:
参数名 | 参数类型 | 备注 | 是否必填 | 示例值 |
---|---|---|---|---|
cardId | String | 公司卡号 | 是 | VCENTCRM1016431348 |
cardPassWord | String | 公司秘钥 | 是 | 123321a |
bookId | String | 员工归企业卡号 | 否 | VCENTCRM1016431348 |
userNumber | String | 员工编号 | 是 | |
userName | String | 用户姓名 | 是 | |
userDep | String | 员工部门 | 否 | |
costCenter | String | 员工成本中心 | 否 | |
rank | String | 职级 | 否 | |
leader | String | 上级领导员工编号 | 否 | |
mobile | String | 员工手机号 | 是 | |
String | 员工邮箱 | 否 | ||
certificateNumber | String | 证件号码 | 否 | |
certificateType | String | 证件类型 | 否 | |
customerDictionary | String | 扩展字段。客户可以传递需要的信息,后期方便对账。 查询订单接口会按原样返回这个字段。后台下载的账单可以根据配置返回指定的字段。 目前支持下面2个Key值,客户可以选择对应的Key使用: Subsidiary:子公司 EmpUniqueId:员工唯一标识 | 否 | { "Subsidiary":"CP1", "EmpUniqueId":"E130001" } |
isBookApproval | Boolean | 是否免审批 | 否 | |
permissions | List<PermissionsRequest> | 员工权限 | 否 |
PermissionsRequest:
参数名 | 参数类型 | 备注 | 是否必填 | 传值 |
---|---|---|---|---|
hasPermission | Boolen | 是否有效 | 是 | 默认传值true |
permissionCode | String | 权限code | 是 | 预定权限:Emp_Reserve_Authority |
permissionValue | String | 权限值 | 是 | 同预定权限对应vlalue: Emp_Reserve_Authority_Just:只能为自己预定 Emp_Reserve_Authority_Company:为全部员工预定 Emp_Reserve_Authority_All:可以为全部员工和非员工预定 |
证件类型:
证件编号 | 证件类型 |
---|---|
C01 | 居民身份证(内宾) |
C02 | 户口簿(内宾) |
C03 | 军官证(内宾) |
C04 | 警官证(内宾) |
C05 | 士兵证(内宾) |
C06 | 护照 |
C54 | 中华人民共和国旅行证 |
C55 | 台湾居民来往大陆通行证 |
C59 | 中华人民共和国入出境通行证 |
C62 | 港澳居民来往内地通行证 |
C65 | 驾驶证 |
- 入参示例:
{
"cardId": "VCENTCRM1016431348",
"bookId": "VCENTCRM1016431348",
"cardPassWord": "123321a",
"userNumber": "HAZ123",
"userName": "李红",
"userDep": "科技中心",
"costCenter": "海康",
"rank": "L1`",
"leader": "张三",
"mobile": "13472444100",
"email": "22@163.com",
"certificateType": "C01",
"certificateNumber": "610502198201128132",
"permissions":[{"hasPermission":true,"id":"","permissionCode":"Emp_Reserve_Authority","permissionValue":"Emp_Reserve_Authority_Just"}]
}
- 出参说明:
参数名 | 参数类型 | 备注 |
---|---|---|
code | String | 状态码 200 成功!500 应用程序繁忙,请稍后再试! 511 企业V卡号或者验证码错误! 4001 员工编号重复! |
message | String | 响应消息 |
content | boolean | true:成功,false:失败 |
出参示例:
{
"code": "200",
"message": "成功!",
"content": true,
"echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}
员工信息修改
- 请求路径:userInfo/modifyUser
- 请求方式:POST
- 请求参数说明:
参数名 | 参数类型 | 备注 | 是否必填 | 示例值 |
---|---|---|---|---|
cardId | String | 公司卡号 | 是 | VCENTCRM1016431348 |
bookId | String | 员工归企业卡号 | 否 | VCENTCRM1016431348 |
cardPassWord | String | 公司秘钥 | 是 | 123321a |
userNumber | String | 员工编号 | 是 | |
userName | String | 用户姓名 | 是 | |
userDep | String | 员工部门 | 否 | |
costCenter | String | 员工成本中心 | 否 | |
rank | String | 职级 | 否 | |
leader | String | 上级领导员工编号 | 否 | |
mobile | String | 员工手机号 | 是 | |
String | 员工邮箱 | 否 | ||
certificateNumber | String | 证件号码 | 否 | |
certificateType | String | 证件类型 | 否 | 具体含义请查看新增员工接口 |
customerDictionary | String | 扩展字段 | 否 | |
isBookApproval | Boolean | 是否免审批 | 否 | |
permissions | List< PermissionsRequest > | 员工权限 | 否 |
PermissionsRequest:
参数名 | 参数类型 | 备注 | 是否必填 | 传值 |
---|---|---|---|---|
hasPermission | Boolen | 是否有效 | 是 | 默认传值true |
permissionCode | String | 权限code | 是 | 预定权限:Emp_Reserve_Authority |
permissionValue | String | 权限值 | 是 | 不同预定权限对应vlalue: Emp_Reserve_Authority_Just:只能为自己预定 Emp_Reserve_Authority_Company:为全部员工预定 Emp_Reserve_Authority_All:可以为全部员工和非员工预定 |
- 入参示例:
{
"cardId": "VCENTCRM1016431348",
"bookId": "VCENTCRM1016431348",
"cardPassWord": "123321a",
"userNumber": "HAZ123",
"userName": "李红",
"userDep": "科技中心",
"costCenter": "海康",
"rank": "L1`",
"leader": "张三",
"mobile": "13472444100",
"email": "22@163.com",
"certificateType": "C01",
"certificateNumber": "610502198201128132",
"permissions":[{"hasPermission":true,"id":"","permissionCode":"Emp_Reserve_Authority","permissionValue":"Emp_Reserve_Authority_Just"}]
}
- 出参说明:
参数名 | 参数类型 | 备注 |
---|---|---|
code | String | 状态码 200 成功! 500 应用程序繁忙,请稍后再试! 511 企业V卡号或者验证码错误! 4002 员工编号不存在! |
message | String | 响应消息 |
content | boolean | true:成功,false:失败 |
- 出参示例:
{
"code": "200",
"message": "成功!",
"content": true,
"echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}
员工信息删除
- 请求路径:userInfo/deleteUser
- 请求方式:POST
- 请求参数说明:
参数名 | 参数类型 | 备注 | 是否必填 | 示例值 |
---|---|---|---|---|
cardId | String | 公司卡号 | 是 | VCENTCRM1016431348 |
bookId | String | 员工归企业卡号 | 否 | VCENTCRM1016431348 |
cardPassWord | String | 公司秘钥 | 是 | 123321a |
userNumber | String | 员工编号 | 是 |
- 入参示例:
{
"cardId": "VCENTCRM1016431348",
"bookId": "VCENTCRM1016431348",
"cardPassWord": "123321a",
"userNumber": "HAZ123"
}
- 出参说明:
参数名 | 参数类型 | 备注 |
---|---|---|
code | String | 状态码 200 成功! 4002 员工编号不存在 500 应用程序繁忙,请稍后再试! 511 企业V卡号或者验证码错误! 4002 员工编号不存在! |
message | String | 响应消息 |
content | boolean | true:成功 |
- 出参示例:
{
"code": "200",
"message": "成功!",
"content": true,
"echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}
员工信息查询
- 请求路径:userInfo/queryUser
- 请求方式:POST
- 请求参数说明:
参数名 | 参数类型 | 备注 | 是否必填 | 示例值 |
---|---|---|---|---|
cardId | String | 公司卡号 | 是 | VCENTCRM1016431348 |
bookId | String | 员工归企业卡号 | 否 | VCENTCRM1016431348 |
cardPassWord | String | 公司秘钥 | 是 | 123321a |
userNumber | String | 员工编号 | 是 |
- 入参示例:
{
"cardId": "VCENTCRM1016431348",
"bookId": "VCENTCRM1016431348",
"cardPassWord": "123321a",
"userNumber": "HZTW123"
}
- 出参说明:
参数名 | 参数类型 | 备注 |
---|---|---|
code | String | 状态码 200 成功! 4002 员工编号不存在 500 应用程序繁忙,请稍后再试! 511 企业V卡号或者验证码错误! 4002 员工编号不存在! |
message | String | 响应消息 |
content | QueryUserResponseDTO | true:成功 |
QueryUserResponseDTO:
参数名 | 参数类型 | 备注 | 是否必填 | 示例值 |
---|---|---|---|---|
cardId | String | 公司卡号 | 是 | VCENTCRM1016431348 |
cardPassWord | String | 公司秘钥 | 是 | 123321a |
userNumber | String | 员工编号 | 是 | |
userName | String | 用户姓名 | 是 | |
userDep | String | 员工部门 | 否 | |
costCenter | String | 员工成本中心 | 否 | |
rank | String | 职级 | 否 | |
leader | String | 上级领导员工编号 | 否 | |
mobile | String | 员工手机号 | 是 | |
String | 员工邮箱 | 否 | ||
certificateNumber | String | 证件号码 | 否 | |
certificateType | String | 证件类型 | 否 | |
customerDictionary | String | 扩展字段 | 否 | |
isBookApproval | Boolean | 是否免审批 | 否 | |
permissions | List< PermissionsRequest > | 员工权限 | 否 |
PermissionsRequest:
参数名 | 参数类型 | 备注 | 是否必填 | 传值 |
---|---|---|---|---|
hasPermission | Boolen | 是否有效 | 是 | 默认传值true |
permissionCode | String | 权限code | 是 | 预定权限:Emp_Reserve_Authority |
permissionValue | String | 权限值 | 是 | 不同预定权限对应vlalue: Emp_Reserve_Authority_Just:只能为自己预定 Emp_Reserve_Authority_Company:为全部员工预定 Emp_Reserve_Authority_All:可以为全部员工和非员工预定 |
- 出参示例:
{
"code": "200",
"message": "成功!",
"content": {
"cardId": "VCENTCRM1016431348",
"userNumber": "HZTW123",
"userName": "常建国",
"userDep": null,
"costCenter": "测试成本中心",
"rank": null,
"leader": null,
"mobile": "15036222256",
"email": "changjianguo001@huazhu.com",
"certificateType": null,
"certificateNumber": null,
"positionId": null,
"statusCode": "I",
"customerDictionary": null,
"isBookApproval": false,
"permissions": null
},
"echoToken": "6bc11f4c-6a17-4ed1-9667-ea6e6a5c766f"
}