成员管理

新增员工信息

接口URL

/adduserinfo

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"，
MsgID	唯一标识	Y	String		1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
Employee	员工信息	Y	Employee
LoginCorpCode	登录企业账号	N	String			相对于CorpCode参数，如果LoginCorpCode不存在，则CorpCode既为对接企业账号也为登录企业账号，如果LoginCorpCode存在，则，则CorpCode为对接企业账号，LoginCorpCode为登录企业账号。登录企业账号：用户实际归属的企业的账号

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败。注意重复创建的处理逻辑：系统直接返回，不做处理
Description	描述	Y	String		Success	描述信息，出错时为错误信息即错误原因。

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "Employee": {
    "LoginName": "10215118",
    "Name": "颜敏",
    "Surname": "YAN",
    "GivenName": "MIN",
    "Gender": "M",
    "Type": "0",
    "Nationality": "156",
    "Birthday": "19881111",
    "Mailbox": "yanmin@**.com",
    "Cellphone": "18500000001",
    "Telephone": null,
    "CertificateInfoList": [{
      "CertificateType": "1",
      "CertificateNum": "110101********1018"
    }],
    "DeptList": [{
      "DeptNum": "1",
      "DeptName": "产品与解决方案"
    }],
    "EmployeeNum": "10234118",
    "EmployeeUID": "1011118",
    "Role": 2,
    "RoleGroupList": [{
      "Name": "职级",
      "RoleList": [{
        "Name": "领导"
      }]
    }],
    "EmployeeLevel": "1",
    "EmployeeVIPLevel": null,
    "Remark": null,
    "ExtInfo": "{\"settlementUnitCode\":\"112233\",\"settlementUnitName\":\"结算单位\"}",
    "BaseLocation": null
  },
  "LoginCorpCode": "0008"
}

{
    "ResultCode": "0",
    "Description": "成功"
}

修改员工信息

接口URL

/modiuserinfo

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"，
MsgID	唯一标识	Y	String		1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
Employee	员工信息	Y	Employee
LoginCorpCode	登录企业账号	N	String			相对于CorpCode参数，如果LoginCorpCode不存在，则CorpCode既为对接企业账号也为登录企业账号，如果LoginCorpCode存在，则，则CorpCode为对接企业账号，LoginCorpCode为登录企业账号。登录企业账号：用户实际归属的企业的账号

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败。
Description	描述	Y	String		Success	描述信息，出错时为错误信息即错误原因。

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "Employee": {
    "LoginName": "10215118",
    "Name": "颜敏",
    "Surname": "YAN",
    "GivenName": "MIN",
    "Gender": "M",
    "Type": "0",
    "Nationality": "156",
    "Birthday": "19881111",
    "Mailbox": "yanmin@**.com",
    "Cellphone": "18500000001",
    "Telephone": null,
    "CertificateInfoList": [{
      "CertificateType": "1",
      "CertificateNum": "110101********1018"
    }],
    "DeptList": [{
      "DeptNum": "1",
      "DeptName": "产品与解决方案"
    }],
    "EmployeeNum": "10234118",
    "EmployeeUID": "1011118",
    "Role": 2,
    "RoleGroupList": [{
      "Name": "职级",
      "RoleList": [{
        "Name": "领导"
      }]
    }],
    "EmployeeLevel": "1",
    "EmployeeVIPLevel": null,
    "Remark": null,
    "ExtInfo": "{\"settlementUnitCode\":\"112233\",\"settlementUnitName\":\"结算单位\"}",
    "BaseLocation": null
  },
  "LoginCorpCode": "0008"
}

{
    "ResultCode": "0",
    "Description": "成功"
}

删除员工信息

调用该接口后，员工信息会被软删除。

接口URL

/deluserinfo

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"
MsgID	唯一标识	Y	String		1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
EmployeeLoginName	员工登陆华为云数字化差旅系统的帐号	Y	String		HW_000001	登陆到华为云数字化差旅系统使用的邮箱，唯一区分员工
LoginCorpCode	登录企业账号	N	String			相对于CorpCode参数，如果LoginCorpCode不存在，则CorpCode既为对接企业账号也为登录企业账号，如果LoginCorpCode存在，则，则CorpCode为对接企业账号，LoginCorpCode为登录企业账号。登录企业账号：用户实际归属的企业的账号

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败。
Description	描述	Y	String		Success	描述信息，出错时为错误信息即错误原因。

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "EmployeeLoginName":  "10215118",
  "LoginCorpCode": "0008"
}

{
    "ResultCode": "0",
    "Description": "成功"
}

查询员工信息

通过该接口查询用户详情。

接口URL

/employee/detail/query

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
LoginCorpCode	登录企业账号	Y	String		1000	系统提供的企业账号。
CorpCode	企业账号	Y	String		1000	系统提供的企业账号。
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"。
MsgID	唯一标识	Y	String		1000020150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
EmployeeNum	企业内部工号	N	String		12345
Mobile	企业员工手机号	N	String		13055051111

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
EmployeeDetailList	员工详情	Y	List<EmployeeDetail>		包含LoginName /Name/EmployeeNum/EmployeeUID等字段

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "EmployeeNum": "10234118",
  "Mobile": "18500000001",
  "LoginCorpCode": "0008"
}

{
  "ResultCode": "0",
  "Description": "成功",
  "EmployeeDetailList": [
    {
      "CorpCode": "0008",
      "EmployeelList": [
        {
          "LoginName": "10215118",
          "Name": "颜敏",
          "Surname": "YAN",
          "GivenName": "MIN",
          "Gender": "M",
          "Type": "0",
          "Nationality": "156",
          "Birthday": "19881111",
          "Mailbox": "yanmin@**.com",
          "Cellphone": "18500000001",
          "Telephone": null,
          "CertificateInfoList": [
            {
              "CertificateType": "1",
              "CertificateNum": "110101********1018"
            }
          ],
          "DeptList": [
            {
              "DeptNum": "1",
              "DeptName": "产品与解决方案"
            }
          ],
          "EmployeeNum": "10234118",
          "EmployeeUID": "1011118",
          "Role": 2,
          "RoleGroupList": [
            {
              "Name": "职级",
              "RoleList": [
                {
                  "Name": "领导"
                }
              ]
            }
          ],
          "EmployeeLevel": "1",
          "EmployeeVIPLevel": null,
          "Remark": null,
          "ExtInfo": "{\"settlementUnitCode\":\"112233\",\"settlementUnitName\":\"结算单位\"}",
          "BaseLocation": null
        }
      ]
    }
  ]
}

变更员工归属子公司

此接口专用于集团公司中员工切换不同子公司使用，此集团中的不同子公司在系统中可能有不同企业账号、企业密码和证书。

如果是同一个公司内的员工信息变更，必须使用“修改员工信息接口”，不能使用本接口进行变更。

接口URL

/changesubcompany

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	企业账号；发起申请员工切换的子公司，可以是原子公司发起，也可以是新子公司发起。不同子公司的证书、密码可能不同，此企业账号需与消息使用的签名算法中的企业账号、密码、证书对应。
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	默认“sysadmin”
MsgID	唯一标识	Y	String		1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
OldLoginName	旧员工登录账号	Y	String	50		原子公司的员工LoginName
OldCorpCode	旧企业账号	Y	String		1000	变更前的企业账号
Employee	新员工信息	Y	Employee			在新子公司的员工信息，包括LoginName、部门、工号、vip信息等。1、员工的新老LoginName取值可以相同也可以不同，根据企业自身要求提供，保证全局唯一即可。如果企业是使用工号去拼装LoginName，切换子公司导致员工工号改变，LoginName取值可能也要发生变更。2、该信息将完全覆盖系统系统中的员工信息。如果级别、工号等变更，需要重新提供，否则员工此部分数据将缺失，可能影响对账。3、部门信息必要要传入新部门的信息，不传信息也会清空原有部门信息4、员工证件信息列表为空，则保持员工证件信息不变，如需要更新则传递指定证件类型的证件信息。
NewCorpCode	新企业账号	Y	String		1000	变更后的企业账号

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败。
Description	描述	Y	String		Success	描述信息，出错时为错误信息即错误原因。

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "OldLoginName": "10215118",
  "OldCorpCode": "0007",
  "Employee": {
    "LoginName": "10215118",
    "Name": "颜敏",
    "Surname": "YAN",
    "GivenName": "MIN",
    "Gender": "M",
    "Type": "0",
    "Nationality": "156",
    "Birthday": "19881111",
    "Mailbox": "yanmin@**.com",
    "Cellphone": "18500000001",
    "Telephone": null,
    "CertificateInfoList": [{
      "CertificateType": "1",
      "CertificateNum": "110101********1018"
    }],
    "DeptList": [{
      "DeptNum": "1",
      "DeptName": "产品与解决方案"
    }],
    "EmployeeNum": "10234118",
    "EmployeeUID": "1011118",
    "Role": 2,
    "RoleGroupList": [{
      "Name": "职级",
      "RoleList": [{
        "Name": "领导"
      }]
    }],
    "EmployeeLevel": "1",
    "EmployeeVIPLevel": null,
    "Remark": null
  },
  "NewCorpCode": "0008"
}

{
    "ResultCode": "0",
    "Description": "成功"
}

新增部门审批人信息

接口URL

/adddeptapproverinfo

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"
MsgID	唯一标识	Y	String		1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
DeptNum	部门编号	Y	String		1234	该部门信息必须已经在系统创建
ApproverLoginNameList	审批人信息	Y	`List<String>`			至少提供一个审批人信息，审批人必须已提前注册

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败。只要有一个处理成功，则值为0
Description	描述	Y	String		Success	描述信息，出错时为错误信息即错误原因。

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "DeptNum": "1",
  "ApproverLoginNameList": ["10215118"]
}

{
    "ResultCode": "0",
    "Description": "成功"
}

删除部门审批人信息

接口URL

/deldeptapproverinfo

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"
MsgID	唯一标识	Y	String		1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
DeptNum	部门编号	Y	String		1234	该部门信息必须已经在系统创建
ApproverLoginNameList	审批人信息	Y	`List<String>`			至少提供一个审批人信息

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败。只要有一个处理成功，则值为0
Description	描述	Y	Sting		Success	描述信息，出错时为错误信息即错误原因。

样例

请求

{
  "CorpCode": "0008",
  "Timestamp": "20220929100252",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "0008120220929071248283828",
  "DeptNum": "1",
  "ApproverLoginNameList": ["10215118"]
}

{
    "ResultCode": "0",
    "Description": "成功"
}

成员管理

# 成员管理

# 新增员工信息

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 修改员工信息

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 删除员工信息

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 查询员工信息

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 变更员工归属子公司

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 新增部门审批人信息

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

# 删除部门审批人信息

# 接口URL

# 请求参数定义

# 响应参数定义

# 样例

成员管理

新增员工信息

接口URL

请求参数定义

响应参数定义

样例

修改员工信息

接口URL

请求参数定义

响应参数定义

样例

删除员工信息

接口URL

请求参数定义

响应参数定义

样例

查询员工信息

接口URL

请求参数定义

响应参数定义

样例

变更员工归属子公司

接口URL

请求参数定义

响应参数定义

样例

新增部门审批人信息

接口URL

请求参数定义

响应参数定义

样例

删除部门审批人信息

接口URL

请求参数定义

响应参数定义

样例