Skip to main content

员工信息同步接口

新增员工​

参数名参数类型备注是否必填示例值
cardIdString公司卡号是VCENTCRM1016431348
cardPassWordString公司秘钥是123321a
bookIdString员工归企业卡号否VCENTCRM1016431348
statusCodeString状态否I：在职; Q：离职
此字段为非必填，不传值则用户状态默认为在职；
userNumberString员工编号是员工编号生成后不可变更，代表唯一身份
userNameString用户姓名是
userDepString员工部门否
costCenterString员工成本中心否
rankString职级否
leaderString上级领导员工编号否
mobileString员工手机号是
emailString员工邮箱否
certificateNumberString证件号码否
certificateTypeString证件类型否
customerDictionaryString扩展字段。客户可以传递需要的信息，后期方便对账。
查询订单接口会按原样返回这个字段。后台下载的账单可以根据配置返回指定的字段。
目前支持下面2个Key值，客户可以选择对应的Key使用：
Subsidiary：子公司
EmpUniqueId：员工唯一标识		否{ "Subsidiary":"CP1", "EmpUniqueId":"E130001" }
isBookApprovalBoolean是否免出差申请单预订否
permissionsList<PermissionsRequest>员工权限否
baseCityListList<String>base城市code否支持最多10个（若有多个则按照英文逗号分隔）
若传输此字段，则必须关联有效的“base城市code”；若关联不是有效的base城市code，则提示“base城市code不存在，请检查参数！”

PermissionsRequest：

参数名参数类型备注是否必填传值
hasPermissionBoolen是否有效是默认传值true
permissionCodeString权限code是预订权限:Emp_Reserve_Authority
permissionValueString权限值是同预订权限对应vlalue:
Emp_Reserve_Authority_Just:只能为自己预订
Emp_Reserve_Authority_Company：为全部员工预订
Emp_Reserve_Authority_All：可以为全部员工和非员工预订
ReserveModelString预订模式是预订模式:
COHABITANT:预订人模式
OCCUPANT：入住人模式
travelTypeString差旅类型是差旅类型:
COMPANY:因公
PERSON：因私

证件类型：

证件编号证件类型
C01居民身份证（内宾）
C02户口簿（内宾）
C03军官证（内宾）
C04警官证（内宾）
C05士兵证（内宾）
C06护照
C54中华人民共和国旅行证
C55台湾居民来往大陆通行证
C59中华人民共和国入出境通行证
C62港澳居民来往内地通行证
C65驾驶证
  • 入参示例：
{
  "cardId": "VCENTCRM1016431348",
  "bookId": "VCENTCRM1016431348",
  "statusCode": "I",
  "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","ReserveModel":"OCCUPANT","travelType":"COMPANY"}]
}
  • 出参说明：
参数名参数类型备注
codeString状态码
200
成功!500 应用程序繁忙，请稍后再试!
521 企业V卡号或者验证码错误!
4001 员工编号重复!
messageString响应消息
contentbooleantrue：成功，false:失败

出参示例：

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

员工信息修改​

参数名参数类型备注是否必填示例值
cardIdString公司卡号是VCENTCRM1016431348
bookIdString员工归企业卡号否VCENTCRM1016431348
statusCodeString状态否I：在职; Q：离职
此字段为非必填，不传值则不改变用户状态；
cardPassWordString公司秘钥是123321a
userNumberString员工编号是员工编号生成后不可变更，代表唯一身份
userNameString用户姓名是
userDepString员工部门否
costCenterString员工成本中心否
rankString职级否
leaderString上级领导员工编号否
mobileString员工手机号是
emailString员工邮箱否
certificateNumberString证件号码否
certificateTypeString证件类型否具体含义请查看新增员工接口
customerDictionaryString扩展字段否
isBookApprovalBoolean是否免出差申请单预订否
permissionsList< PermissionsRequest >员工权限否
baseCityListList<String>base城市code否支持最多10个（若有多个则按照英文逗号分隔）
若传输此字段，则必须关联有效的“base城市code”；若关联不是有效的base城市code，则提示“base城市code不存在，请检查参数！”

PermissionsRequest：

参数名参数类型备注是否必填传值
hasPermissionBoolen是否有效是默认传值true
permissionCodeString权限code是预订权限:Emp_Reserve_Authority
permissionValueString权限值是不同预订权限对应vlalue:
Emp_Reserve_Authority_Just:只能为自己预订
Emp_Reserve_Authority_Company：为全部员工预订
Emp_Reserve_Authority_All：可以为全部员工和非员工预订
ReserveModelString预订模式是预订模式:
COHABITANT:预订人模式
OCCUPANT：入住人模式
travelTypeString差旅类型是差旅类型:
COMPANY:因公
PERSON：因私
  • 入参示例：
{
  "cardId": "VCENTCRM1016431348",
  "bookId": "VCENTCRM1016431348",
  "statusCode": "I",
  "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","ReserveModel":"OCCUPANT","travelType":"COMPANY"}]
}
  • 出参说明：
参数名参数类型备注
codeString状态码
200 成功!
500 应用程序繁忙，请稍后再试!
521 企业V卡号或者验证码错误!
400 员工编号不存在!
messageString响应消息
contentbooleantrue：成功，false:失败
  • 出参示例：
{
  "code": "200",
  "message": "成功!",
  "content": true,
  "echoToken": "581171fc-5054-4a28-a7a1-6a5668055c77"
}

员工信息删除​

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

员工信息查询​

参数名参数类型备注是否必填示例值
cardIdString公司卡号是VCENTCRM1016431348
bookIdString员工归企业卡号否VCENTCRM1016431348
cardPassWordString公司秘钥是123321a
userNumberString员工编号是员工编号生成后不可变更，代表唯一身份
  • 入参示例：
{
  "cardId": "VCENTCRM1016431348",
  "bookId": "VCENTCRM1016431348",
  "cardPassWord": "123321a",
  "userNumber": "HZTW123"
}
  • 出参说明：
参数名参数类型备注
codeString状态码
200 成功!
400 员工编号不存在
500 应用程序繁忙，请稍后再试!
521 企业V卡号或者验证码错误!
messageString响应消息
contentQueryUserResponseDTOtrue：成功

QueryUserResponseDTO:

参数名参数类型备注是否必填示例值
cardIdString公司卡号是VCENTCRM1016431348
cardPassWordString公司秘钥是123321a
statusCodeString状态否I：在职; Q：离职
userNumberString员工编号是员工编号生成后不可变更，代表唯一身份
userNameString用户姓名是
userDepString员工部门否
costCenterString员工成本中心否
rankString职级否
leaderString上级领导员工编号否
mobileString员工手机号是
emailString员工邮箱否
certificateNumberString证件号码否
certificateTypeString证件类型否
customerDictionaryString扩展字段否
isBookApprovalBoolean是否免出差申请单预订否
permissionsList< PermissionsRequest >员工权限否
baseCityListList<BaseCityListDTO>“base城市code”和“城市名称”否

PermissionsRequest：

参数名参数类型备注是否必填传值
hasPermissionBoolen是否有效是默认传值true
permissionCodeString权限code是预订权限:Emp_Reserve_Authority
permissionValueString权限值是不同预订权限对应vlalue:
Emp_Reserve_Authority_Just:只能为自己预订
Emp_Reserve_Authority_Company：为全部员工预订
Emp_Reserve_Authority_All：可以为全部员工和非员工预订
ReserveModelString预订模式是预订模式:
COHABITANT:预订人模式
OCCUPANT：入住人模式
travelTypeString差旅类型是差旅类型:
COMPANY:因公
PERSON：因私

BaseCityListDTO

参数名参数类型备注是否必填传值
cityIdString城市code否
cityNameString城市名称否
  • 出参示例：
{
  "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"
}

新增员工-新增成本中心内容​

说明：新增成本中心内容不是独立接口，请将参数添加在员工信息修改接口中，单个成本中心Code中最多允许传入50个内容（比如一个CostContent中sonContentList不能超过50个,或多个CostContent中下的sonContentList总和不能超过50个）

参数名参数类型备注是否必填示例值
code1List< CostContent >当前成本中心所需要导入的内容否
code2List< CostContent >当前成本中心所需要导入的内容否
code3List< CostContent >当前成本中心所需要导入的内容否
code4List< CostContent >当前成本中心所需要导入的内容否
code5List< CostContent >当前成本中心所需要导入的内容否
code6List< CostContent >当前成本中心所需要导入的内容否
code7List< CostContent >当前成本中心所需要导入的内容否
code8List< CostContent >当前成本中心所需要导入的内容否
code9List< CostContent >当前成本中心所需要导入的内容否
code10List< CostContent >当前成本中心所需要导入的内容否

CostContent：

参数名参数类型备注是否必填示例值
preContentString上级成本中心内容，最大长度20字符
必须按照关联关系传值，如果存在上级但未传入上级内容，会报错，如果不存在上级但传入，会报错		否
sonContentListList< SonContent >当前层级成本中心内容集合否

SonContent：

参数名参数类型备注是否必填示例值
contentString成本中心内容，最大长度20字符否
isDefaultboolean是否默认
无上级成本中心才能设置默认，否则不管，如一个成本中心下传有多个默认 以第一个为准		否
  • 入参示例：
{
  "code1": [
    {
      "preContent": "",
      "sonContentList": [
        {
          "content": "科技部",
          "isDefault": false
        },
        {
          "content": "事业部",
          "isDefault": true
        }
      ]
    }
  ],
  "code2": [
    {
      "preContent": "上海",
      "sonContentList": [
        {
          "content": "浦东",
          "isDefault": false
        },
        {
          "content": "嘉定",
          "isDefault": false
        }
      ]
    },
    {
      "preContent": "湖南",
      "sonContentList": [
        {
          "content": "长沙",
          "isDefault": false
        },
        {
          "content": "永州",
          "isDefault": false
        }
      ]
    }
  ],
  "code3": [
    {
      "preContent": "",
      "sonContentList": [
        {
          "content": "北京",
          "isDefault": true
        }
      ]
    }
  ],
  "code4": null,
  "code5": null,
  "code6": null,
  "code7": null,
  "code8": null,
  "code9": null,
  "code10": null
}
  • 出参说明：
参数名参数类型备注
codeString状态码
200
成功!500 应用程序繁忙，请稍后再试!
521 企业V卡号或者验证码错误!
4001 员工编号重复!
messageString响应消息
contentbooleantrue：成功，false:失败

出参示例：

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

员工信息修改-修改成本中心内容​

说明：修改成本中心内容不是独立接口，请将参数添加在员工信息修改接口中，单个成本中心Code中最多允许传入50个内容（比如一个CostContent中sonContentList不能超过50个,或多个CostContent中下的sonContentList总和不能超过50个），修改成本中心是覆盖操作会清除以前同步的成本中心内容

参数名参数类型备注是否必填示例值
code1List< CostContent >当前成本中心所需要导入的内容否
code2List< CostContent >当前成本中心所需要导入的内容否
code3List< CostContent >当前成本中心所需要导入的内容否
code4List< CostContent >当前成本中心所需要导入的内容否
code5List< CostContent >当前成本中心所需要导入的内容否
code6List< CostContent >当前成本中心所需要导入的内容否
code7List< CostContent >当前成本中心所需要导入的内容否
code8List< CostContent >当前成本中心所需要导入的内容否
code9List< CostContent >当前成本中心所需要导入的内容否
code10List< CostContent >当前成本中心所需要导入的内容否

CostContent：

参数名参数类型备注是否必填示例值
preContentString上级成本中心内容，最大长度20字符
必须按照关联关系传值，如果存在上级但未传入上级内容，会报错，如果不存在上级但传入，会报错		否
sonContentListList< SonContent >当前层级成本中心内容集合否

SonContent：

参数名参数类型备注是否必填示例值
contentString成本中心内容，最大长度20字符否
isDefaultboolean是否默认
无上级成本中心才能设置默认，否则不管，如一个成本中心下传有多个默认 以第一个为准		否
  • 入参示例：
{
  "code1": [
    {
      "preContent": "",
      "sonContentList": [
        {
          "content": "科技部",
          "isDefault": false
        },
        {
          "content": "事业部",
          "isDefault": true
        }
      ]
    }
  ],
  "code2": [
    {
      "preContent": "上海",
      "sonContentList": [
        {
          "content": "浦东",
          "isDefault": false
        },
        {
          "content": "嘉定",
          "isDefault": false
        }
      ]
    },
    {
      "preContent": "湖南",
      "sonContentList": [
        {
          "content": "长沙",
          "isDefault": false
        },
        {
          "content": "永州",
          "isDefault": false
        }
      ]
    }
  ],
  "code3": [
    {
      "preContent": "",
      "sonContentList": [
        {
          "content": "北京",
          "isDefault": true
        }
      ]
    }
  ],
  "code4": null,
  "code5": null,
  "code6": null,
  "code7": null,
  "code8": null,
  "code9": null,
  "code10": null
}
  • 出参说明：
参数名参数类型备注
codeString状态码
200
成功!500 应用程序繁忙，请稍后再试!
521 企业V卡号或者验证码错误!
4001 员工编号重复!
messageString响应消息
contentbooleantrue：成功，false:失败

出参示例：

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