华住商旅API对接
基础接口列表
员工信息同步接口

员工信息同步接口

测试环境：
鉴权接口地址：https://test-oauth2-api.huazhu.com
业务接口地址：https://test-htravelserver.huazhu.com

正式环境：
鉴权接口地址：https://oauth2-api.huazhu.com
业务接口地址：https://htravelserver.huazhu.com

获取token的方式

第一步，通过“鉴权对接流程”获取访问token
第二步，将获取的token放到请求头的“Authorization”
第三步，调用员工信息同步接口

新增员工

请求路径：userInfo/addUser
请求方式：POST
请求参数说明：

参数名	参数类型	备注	是否必填	示例值
cardId	String	公司卡号	是	VCENTCRM1016431348
cardPassWord	String	公司秘钥	是	123321a
bookId	String	员工归企业卡号	否	VCENTCRM1016431348
statusCode	String	状态	否	I：在职; Q：离职此字段为非必填，不传值则用户状态默认为在职；
userNumber	String	员工编号	是	员工编号生成后不可变更，代表唯一身份
userName	String	用户姓名	是
userDep	String	员工部门	否
costCenter	String	员工成本中心	否
rank	String	职级	否
leader	String	上级领导员工编号	否
mobile	String	员工手机号	是
email	String	员工邮箱	否
certificateNumber	String	证件号码	否
certificateType	String	证件类型	否
customerDictionary	String	扩展字段。客户可以传递需要的信息，后期方便对账。查询订单接口会按原样返回这个字段。后台下载的账单可以根据配置返回指定的字段。目前支持下面2个Key值，客户可以选择对应的Key使用： Subsidiary：子公司 EmpUniqueId：员工唯一标识	否	{ "Subsidiary":"CP1", "EmpUniqueId":"E130001" }
isBookApproval	Boolean	是否免出差申请单预订	否
permissions	List<PermissionsRequest>	员工权限	否
baseCityList	List<String>	base城市code	否	支持最多10个（若有多个则按照英文逗号分隔）若传输此字段，则必须关联有效的“base城市code”；若关联不是有效的base城市code，则提示“base城市code不存在，请检查参数！”
multiBodyCode	String	企业主体code，企业主体code必须先提交配置信息给到华住商旅商务，再由华住商旅中台配置生效后才可使用。	否

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：可以为全部员工和非员工预订
ReserveModel	String	预订模式	是	预订模式: COHABITANT:预订人模式 OCCUPANT：入住人模式
travelType	String	差旅类型	是	差旅类型: 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"}]
}

                                                    
                                                

出参说明：

参数名	参数类型	备注
code	String	状态码 200 成功!500 应用程序繁忙，请稍后再试! 521 企业V卡号或者验证码错误! 4001 员工编号重复!
message	String	响应消息
content	boolean	true：成功，false:失败

出参示例：

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

                                                    
                                                

员工信息修改

正式环境业务接口地址：https://htravelserver.huazhu.com
测试环境业务接口地址：https://test-htravelserver.huazhu.com
请求路径：userInfo/modifyUser
请求方式：POST
请求参数说明：

参数名	参数类型	备注	是否必填	示例值
cardId	String	公司卡号	是	VCENTCRM1016431348
bookId	String	员工归企业卡号	否	VCENTCRM1016431348
statusCode	String	状态	否	I：在职; Q：离职此字段为非必填，不传值则不改变用户状态；
cardPassWord	String	公司秘钥	是	123321a
userNumber	String	员工编号	是	员工编号生成后不可变更，代表唯一身份
userName	String	用户姓名	是
userDep	String	员工部门	否
costCenter	String	员工成本中心	否
rank	String	职级	否
leader	String	上级领导员工编号	否
mobile	String	员工手机号	是
email	String	员工邮箱	否
certificateNumber	String	证件号码	否
certificateType	String	证件类型	否	具体含义请查看新增员工接口
customerDictionary	String	扩展字段	否
isBookApproval	Boolean	是否免出差申请单预订	否
permissions	List< PermissionsRequest >	员工权限	否
baseCityList	List<String>	base城市code	否	支持最多10个（若有多个则按照英文逗号分隔）若传输此字段，则必须关联有效的“base城市code”；若关联不是有效的base城市code，则提示“base城市code不存在，请检查参数！”
multiBodyCode	String	企业主体code，企业主体code必须先提交配置信息给到华住商旅商务，再由华住商旅中台配置生效后才可使用。	否

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：可以为全部员工和非员工预订
ReserveModel	String	预订模式	是	预订模式: COHABITANT:预订人模式 OCCUPANT：入住人模式
travelType	String	差旅类型	是	差旅类型: 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"}]
}

                                                    
                                                

出参说明：

参数名	参数类型	备注
code	String	状态码 200 成功! 500 应用程序繁忙，请稍后再试! 521 企业V卡号或者验证码错误! 400 员工编号不存在!
message	String	响应消息
content	boolean	true：成功，false:失败

出参示例：

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

                                                    
                                                

员工信息删除

正式环境业务接口地址：https://htravelserver.huazhu.com
测试环境业务接口地址：https://test-htravelserver.huazhu.com
请求路径：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 成功! 400 员工编号不存在 500 应用程序繁忙，请稍后再试! 521 企业V卡号或者验证码错误!
message	String	响应消息
content	boolean	true：成功

出参示例：

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

                                                    
                                                

员工信息查询

正式环境业务接口地址：https://htravelserver.huazhu.com
测试环境业务接口地址：https://test-htravelserver.huazhu.com
请求路径：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 成功! 400 员工编号不存在 500 应用程序繁忙，请稍后再试! 521 企业V卡号或者验证码错误!
message	String	响应消息
content	QueryUserResponseDTO	true：成功

QueryUserResponseDTO:

参数名	参数类型	备注	是否必填	示例值
cardId	String	公司卡号	是	VCENTCRM1016431348
cardPassWord	String	公司秘钥	是	123321a
statusCode	String	状态	否	I：在职; Q：离职
userNumber	String	员工编号	是	员工编号生成后不可变更，代表唯一身份
userName	String	用户姓名	是
userDep	String	员工部门	否
costCenter	String	员工成本中心	否
rank	String	职级	否
leader	String	上级领导员工编号	否
mobile	String	员工手机号	是
email	String	员工邮箱	否
certificateNumber	String	证件号码	否
certificateType	String	证件类型	否
customerDictionary	String	扩展字段	否
isBookApproval	Boolean	是否免出差申请单预订	否
permissions	List< PermissionsRequest >	员工权限	否
baseCityList	List<BaseCityListDTO>	“base城市code”和“城市名称”	否
multiBodyCode	String	企业主体code，企业主体code必须先提交配置信息给到华住商旅商务，再由华住商旅中台配置生效后才可使用。	否
multiBodyName	String	企业主体名称	否

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：可以为全部员工和非员工预订
ReserveModel	String	预订模式	是	预订模式: COHABITANT:预订人模式 OCCUPANT：入住人模式
travelType	String	差旅类型	是	差旅类型: COMPANY:因公 PERSON：因私

BaseCityListDTO

参数名	参数类型	备注	是否必填	传值
cityId	String	城市code	否
cityName	String	城市名称	否

出参示例：

{
  "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个）

正式环境业务接口地址：https://htravelserver.huazhu.com
测试环境业务接口地址：https://test-htravelserver.huazhu.com
请求路径：userInfo/addUser
请求方式：POST
请求参数说明：

参数名	参数类型	备注	是否必填
code1	List< CostContent >	当前成本中心所需要导入的内容	否
code2	List< CostContent >	当前成本中心所需要导入的内容	否
code3	List< CostContent >	当前成本中心所需要导入的内容	否
code4	List< CostContent >	当前成本中心所需要导入的内容	否
code5	List< CostContent >	当前成本中心所需要导入的内容	否
code6	List< CostContent >	当前成本中心所需要导入的内容	否
code7	List< CostContent >	当前成本中心所需要导入的内容	否
code8	List< CostContent >	当前成本中心所需要导入的内容	否
code9	List< CostContent >	当前成本中心所需要导入的内容	否
code10	List< CostContent >	当前成本中心所需要导入的内容	否

CostContent：

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

SonContent：

参数名	参数类型	备注	是否必填	示例值
content	String	成本中心内容，最大长度20字符	否
isDefault	boolean	是否默认无上级成本中心才能设置默认，否则不管，如一个成本中心下传有多个默认以第一个为准	否

入参示例：

{
  "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
}

                                                    
                                                

出参说明：

参数名	参数类型	备注
code	String	状态码 200 成功!500 应用程序繁忙，请稍后再试! 521 企业V卡号或者验证码错误! 4001 员工编号重复!
message	String	响应消息
content	boolean	true：成功，false:失败

出参示例：

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

                                                    
                                                

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

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

正式环境业务接口地址：https://htravelserver.huazhu.com
测试环境业务接口地址：https://test-htravelserver.huazhu.com
请求路径：userInfo/modifyUser
请求方式：POST
请求参数说明：

参数名	参数类型	备注	是否必填
code1	List< CostContent >	当前成本中心所需要导入的内容	否
code2	List< CostContent >	当前成本中心所需要导入的内容	否
code3	List< CostContent >	当前成本中心所需要导入的内容	否
code4	List< CostContent >	当前成本中心所需要导入的内容	否
code5	List< CostContent >	当前成本中心所需要导入的内容	否
code6	List< CostContent >	当前成本中心所需要导入的内容	否
code7	List< CostContent >	当前成本中心所需要导入的内容	否
code8	List< CostContent >	当前成本中心所需要导入的内容	否
code9	List< CostContent >	当前成本中心所需要导入的内容	否
code10	List< CostContent >	当前成本中心所需要导入的内容	否

CostContent：

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

SonContent：

参数名	参数类型	备注	是否必填	示例值
content	String	成本中心内容，最大长度20字符	否
isDefault	boolean	是否默认无上级成本中心才能设置默认，否则不管，如一个成本中心下传有多个默认以第一个为准	否

入参示例：

{
  "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
}

                                                    
                                                

出参说明：

参数名	参数类型	备注
code	String	状态码 200 成功!500 应用程序繁忙，请稍后再试! 521 企业V卡号或者验证码错误! 4001 员工编号重复!
message	String	响应消息
content	boolean	true：成功，false:失败

出参示例：

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

                                                    
                                                

新增员工​

员工信息修改​

员工信息删除​

员工信息查询​

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

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

新增员工

员工信息修改

员工信息删除

员工信息查询

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

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