Skip to main content

员工信息同步接口

新增员工

  • 请求路径:userInfo/addUser
  • 请求方式:POST
  • 请求参数说明:
参数名参数类型备注是否必填示例值
cardIdString公司卡号VCENTCRM1016431348
cardPassWordString公司秘钥123321a
bookIdString员工归企业卡号VCENTCRM1016431348
userNumberString员工编号
userNameString用户姓名
userDepString员工部门
costCenterString员工成本中心
rankString职级
leaderString上级领导员工编号
mobileString员工手机号
emailString员工邮箱
certificateNumberString证件号码
certificateTypeString证件类型
customerDictionaryString扩展字段。客户可以传递需要的信息,后期方便对账。
查询订单接口会按原样返回这个字段。后台下载的账单可以根据配置返回指定的字段。
目前支持下面2个Key值,客户可以选择对应的Key使用:
Subsidiary:子公司
EmpUniqueId:员工唯一标识
{ "Subsidiary":"CP1", "EmpUniqueId":"E130001" }
isBookApprovalBoolean是否免审批
permissionsList<PermissionsRequest>员工权限

PermissionsRequest:

参数名参数类型备注是否必填传值
hasPermissionBoolen是否有效默认传值true
permissionCodeString权限code预定权限:Emp_Reserve_Authority
permissionValueString权限值同预定权限对应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"}]
}
  • 出参说明:
参数名参数类型备注
codeString状态码
200
成功!500 应用程序繁忙,请稍后再试!
511 企业V卡号或者验证码错误!
4001 员工编号重复!
messageString响应消息
contentbooleantrue:成功,false:失败

出参示例:

{
"code": "200",
"message": "成功!",
"content": true,
"echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}

员工信息修改

  • 请求路径:userInfo/modifyUser
  • 请求方式:POST
  • 请求参数说明:
参数名参数类型备注是否必填示例值
cardIdString公司卡号VCENTCRM1016431348
bookIdString员工归企业卡号VCENTCRM1016431348
cardPassWordString公司秘钥123321a
userNumberString员工编号
userNameString用户姓名
userDepString员工部门
costCenterString员工成本中心
rankString职级
leaderString上级领导员工编号
mobileString员工手机号
emailString员工邮箱
certificateNumberString证件号码
certificateTypeString证件类型具体含义请查看新增员工接口
customerDictionaryString扩展字段
isBookApprovalBoolean是否免审批
permissionsList< PermissionsRequest >员工权限

PermissionsRequest:

参数名参数类型备注是否必填传值
hasPermissionBoolen是否有效默认传值true
permissionCodeString权限code预定权限:Emp_Reserve_Authority
permissionValueString权限值不同预定权限对应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"}]
}
  • 出参说明:
参数名参数类型备注
codeString状态码
200 成功!
500 应用程序繁忙,请稍后再试!
511 企业V卡号或者验证码错误!
4002 员工编号不存在!
messageString响应消息
contentbooleantrue:成功,false:失败
  • 出参示例:
{
"code": "200",
"message": "成功!",
"content": true,
"echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}

员工信息删除

  • 请求路径:userInfo/deleteUser
  • 请求方式:POST
  • 请求参数说明:
参数名参数类型备注是否必填示例值
cardIdString公司卡号VCENTCRM1016431348
bookIdString员工归企业卡号VCENTCRM1016431348
cardPassWordString公司秘钥123321a
userNumberString员工编号
  • 入参示例:
{
"cardId": "VCENTCRM1016431348",
"bookId": "VCENTCRM1016431348",
"cardPassWord": "123321a",
"userNumber": "HAZ123"
}
  • 出参说明:
参数名参数类型备注
codeString状态码
200 成功!
4002 员工编号不存在
500 应用程序繁忙,请稍后再试!
511 企业V卡号或者验证码错误!
4002 员工编号不存在!
messageString响应消息
contentbooleantrue:成功
  • 出参示例:
{
"code": "200",
"message": "成功!",
"content": true,
"echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}

员工信息查询

  • 请求路径:userInfo/queryUser
  • 请求方式:POST
  • 请求参数说明:
参数名参数类型备注是否必填示例值
cardIdString公司卡号VCENTCRM1016431348
bookIdString员工归企业卡号VCENTCRM1016431348
cardPassWordString公司秘钥123321a
userNumberString员工编号
  • 入参示例:
{
"cardId": "VCENTCRM1016431348",
"bookId": "VCENTCRM1016431348",
"cardPassWord": "123321a",
"userNumber": "HZTW123"
}
  • 出参说明:
参数名参数类型备注
codeString状态码
200 成功!
4002 员工编号不存在
500 应用程序繁忙,请稍后再试!
511 企业V卡号或者验证码错误!
4002 员工编号不存在!
messageString响应消息
contentQueryUserResponseDTOtrue:成功

QueryUserResponseDTO:

参数名参数类型备注是否必填示例值
cardIdString公司卡号VCENTCRM1016431348
cardPassWordString公司秘钥123321a
userNumberString员工编号
userNameString用户姓名
userDepString员工部门
costCenterString员工成本中心
rankString职级
leaderString上级领导员工编号
mobileString员工手机号
emailString员工邮箱
certificateNumberString证件号码
certificateTypeString证件类型
customerDictionaryString扩展字段
isBookApprovalBoolean是否免审批
permissionsList< PermissionsRequest >员工权限

PermissionsRequest:

参数名参数类型备注是否必填传值
hasPermissionBoolen是否有效默认传值true
permissionCodeString权限code预定权限:Emp_Reserve_Authority
permissionValueString权限值不同预定权限对应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"
}