员工列表查询

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/searchUserList

请求参数：

参数名 描述 数据类型 必填 字节长度
page
pageNum 第几页 int 是
pageSize 每页条数 int 是
param
departmentUuid 部门uuid String 否 50
positionUuid 职务uuid String 否 50
freezeStatusFlag 是否冻结 Boolean 否
name 员工姓名 String 否 20
employeeNo 员工编码 String 否 20
mobilePhone 手机号 String 否 20
idCard 身份证 String 否 18
joinDateStart 入职开始时间 String 否 20
joinDateEnd 入职结束时间 String 否 20
quitDateStart 离职开始时间 String 否 20
quitDateEnd 离职结束时间 String 否 20
statuses 员工状态
{
  正式,
  试用,
  实习,
  离职
} 		List<String> 否
userWorkFlowStatusList 审批状态
{
  entryApproving: 入职审批中,
  entryApproved: 入职审批通过,
  entryRejected: 入职审批驳回,
  quitApproving: 离职审批中,
  quitApproved: 离职审批通过,
  quitRejected: 离职审批驳回
}		 List<String> 否

请求示例：

{
"page": {
  "pageNum": 1,
  "pageSize": 20
},
"param": {
  "departmentUuid": "0b6bba424ad34e238a4e515ca7dcc4c8",
  "employeeNo": "GXZH2",
  "freezeStatusFlag": false,
  "idCard": "310112199001011234",
  "joinDateEnd": "2021-09-30 09:46:21",
  "joinDateStart": "2018-09-29 09:46:21",
  "mobilePhone": "13800000001",
  "name": "张三",
  "positionUuid": "f25e4301fde240fa9e04978fb5c57a8b",
  "quitDateEnd": "2021-09-30 09:46:21",
  "quitDateStart": "2021-09-29 09:46:21",
  "statuses": [
    "正式",
    "试用"
  ],
  "userWorkFlowStatusList": [
    "entryApproving",
    "quitApproving"
  ]
} 
}

返回参数：List

参数名 描述 数据类型 必填 字节长度
name 员工姓名 String 是 20
employeeUuid 员工uuid String 是 50
employeeNo 员工编号 String 是 50
freezeStatusFlag 是否冻结
true 是  false 否		 Boolean 是
deleted 是否已删除
true 是  false 否		 Boolean 是
deptName 部门名称 String 是 50
deptUuid 部门uuid String 是 50
gender 性别 String 是 10
polity 政治面貌 String 是 10
education 最高学历 String 是 10
workAge 工龄 String 是 10
newJoinDate 最新一次入职时间(时间戳精确到毫秒) Date 否
managerFlag 是否管理员
true 是  false 否		 Boolean 否
positionUuid 职务uuid String 否 50
photoUrl 头像地址 String 否 100
quitDate 离职时间(时间戳精确到毫秒) Date 否 20
status 员工状态
{
  正式,
  试用,
  实习,
  离职
}		 String 是 10
roleName 角色名称 String 是 20
workflowStatus 审核状态
{
  entryApproving: 入职审批中,
  entryApproved: 入职审批通过,
  entryRejected: 入职审批驳回,
  quitApproving: 离职审批中,
  quitApproved: 离职审批通过,
  quitRejected: 离职审批驳回
}		 String 否 20

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "name": "张三",
      "employeeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
      "employeeNo": "88888888",
      "freezeStatusFlag": false,
      "deleted": false,
      "deptName": "系统管理组",
      "deptUuid": "99",
      "gender": "男",
      "polity": "党员",
      "education": "本科",
      "workAge": "1年231天",
      "newJoinDate": 1618998077980,
      "managerFlag": false,
      "positionUuid": "be27e7c8f4aa44368b02a1d00ab4d367",
      "photoUrl": "http://image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2021/07/20210722/f11d2415d5e3488da58bd309cde77f52",
      "quitDate": null,
      "status": "试用",
      "roleName": "区总",
      "workflowStatus": "entryApproved"
    }
  ]
}

新增员工

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/addUser

  • 请求参数中联系人名称、联系人手机号、地址、户口地址、用户附件，是否必填需要读取系统配置，查看方式：系统->系统设置->人事OA设置->组织人事基本设置->员工入职必填设置

请求参数：

参数名 描述 数据类型 必填 字节长度
name 员工昵称 String 是 40
employeeNo 员工编号 String 是 50
trueName 员工真实姓名 String 是 40
idCardType 证件类型
{
  IDENTITY_CARD: 身份证号,
  PASS_CARD: 护照,
  H_C_LAISSEZ_PASSER: 港澳通行证,
  T_LAISSEZ_PASSER: 台湾通行证,
  IDENTITY_CARD_OF_WW: 台湾居民身份证,
  IDENTITY_CARD_OF_HK: 港澳居民身份证
}		 String 是 20
idCard 证件号 String 是 20
cellphone 手机号 String 是 50
status 员工状态
{
  正式,
  试用,
  实习,
  离职
}		 String 是 50
deptUuid 部门uuid String 是 40
gender 性别 String 是 10
birthday 员工生日(时间戳精确到毫秒) Date 是 50
joinDate 入职时间(时间戳精确到毫秒) Date 是 40
positionUuid 职务uuid String 是 50
isExperienced 有无行业经验 String 否 10
photoUrl 头像地址 String 否 100
censusRegister 户籍类型 String 否 10
freezeStatusFlag 是否冻结 Boolean 否
gradeUuid 上级uuid String 否 50
education 学历 String 否 20
linkManName 联系人名称 String 根据系统设置 40
linkManTel 联系人手机号 String 根据系统设置 50
masterUuid 师傅uuid String 否 50
nationality 民族 String 否 10
nativePlace 籍贯 String 否 100
recruiterUuid 招聘人uuid String 否 50
referralerUuid 转介人uuid String 否 50
roleUuidList 角色uuid List<String> 是 50
address 地址 String 根据系统设置 100
residenceAddress 户口地址 String 根据系统设置 100
userAttachmentList 用户附件 List<UserSysAttachmentOpenDTO> 根据系统设置 100

UserSysAttachmentOpenDTO：

参数名 描述 数据类型 必填 字节长度
photoName 文件名称 String 是 50
photoUrl 文件url String 是 200
photoCategoryName 文件类型
{
  身份证,
  学历证书
}		 String 是 50

请求示例：

{
  "param": {
    "address": "上海市浦东新区",
    "birthday": 691689600,
    "cellphone": "13800000001",
    "censusRegister": "本地农村户口",
    "deptUuid": "0b6bba424ad34e238a4e515ca7dcc4c8",
    "education": "博士",
    "employeeNo": "GXZH2",
    "freezeStatusFlag": false,
    "gender": "男",
    "gradeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "idCard": "411425199407171234",
    "idCardType": "IDENTITY_CARD",
    "isExperienced": "有",
    "joinDate": 1632478546000,
    "linkManName": "王五",
    "linkManTel": "13800000001",
    "masterUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "name": "张三",
    "nationality": "汉",
    "nativePlace": "上海金山区",
    "photoUrl": "http://image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2021/07/20210722/f11d2415d5e3488da58bd309cde77f52",
    "positionUuid": "be27e7c8f4aa44368b02a1d00ab4d367",
    "recruiterUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "referralerUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "roleUuidList": [
      "4e2ef808daa54da4bf11e6570c1812c5",
      "a2d12550f12d4442a8afdf42307e8ae0"
    ],
    "status": "正式",
    "trueName": "张三"
  }
}

返回参数

参数名 描述 数据类型 必填 字节长度
data 员工uuid String 是 50

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": "9925a691-c7b9-4d11-91d0-942801aa29ec"
}

更新员工

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/updateUser

  • 请求参数中联系人名称、联系人手机号、地址、户口地址，是否必填需要读取系统配置，查看方式：系统->系统设置->人事OA设置->组织人事基本设置->员工入职必填设置

请求参数：

参数名 描述 数据类型 必填 字节长度
employeeUuid 员工uuid String 是 50
employeeNo 员工编号 String 是 50
name 员工昵称 String 是 40
trueName 员工真实姓名 String 是 40
idCardType 证件类型
{
  
  IDENTITY_CARD: 身份证号,
  PASS_CARD: 护照,
  H_C_LAISSEZ_PASSER: 港澳通行证,
  T_LAISSEZ_PASSER: 台湾通行证,
  IDENTITY_CARD_OF_WW: 台湾居民身份证,
  IDENTITY_CARD_OF_HK: 港澳居民身份证
}		 String 否 20
idCard 证件号 String 否 20
status 员工状态
{
  正式,
  试用,
  实习,
  离职
}		 String 是 50
deptUuid 部门uuid String 否 40
gender 性别 String 是 10
birthday 员工生日(时间戳精确到毫秒) Date 是 50
joinDate 入职时间(时间戳精确到毫秒) Date 是 40
positionUuid 职务uuid String 否 50
photoUrl 头像地址 String 否 100
censusRegister 户籍类型 String 否 10
isExperienced 有无行业经验 String 否 10
gradeUuid 上级uuid String 否 50
education 学历 String 是 20
linkManName 联系人名称 String 根据系统设置 40
linkManTel 联系人手机号 String 根据系统设置 50
maritalStatus 婚姻状况 String 否 50
masterUuid 师傅uuid String 否 50
nationality 民族 String 否 10
nativePlace 籍贯 String 否 100
recruiterUuid 招聘人uuid String 否 50
referralerUuid 转介人uuid String 否 50
address 地址 String 根据系统设置 100
quitDate 离职时间（当status=“离职”时，必传） Date 否  
residenceAddress 户口地址 String 根据系统设置 100

请求示例：

{
  "param": {
    "employeeUuid": "9925a691-c7b9-4d11-91d0-942801aa29ec",
    "address": "上海市浦东新区",
    "birthday": 691689600,
    "censusRegister": "本地农村户口",
    "deptUuid": "0b6bba424ad34e238a4e515ca7dcc4c8",
    "education": "博士",
    "employeeNo": "GXZH2",
    "gender": "男",
    "gradeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "idCard": "411425199407171234",
    "idCardType": "IDENTITY_CARD",
    "isExperienced": "有",
    "joinDate": 1632478546000,
    "linkManName": "王五",
    "linkManTel": "13800000001",
    "maritalStatus": "已婚",
    "masterUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "name": "张三",
    "nationality": "汉",
    "nativePlace": "上海金山区",
    "photoUrl": "http://image.qfstatic.com/saas2_test2_company3_company7j8h6gh5tf/2021/07/20210722/f11d2415d5e3488da58bd309cde77f52",
    "positionUuid": "be27e7c8f4aa44368b02a1d00ab4d367",
    "recruiterUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "referralerUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "status": "正式",
    "trueName": "张三"
  }
}

返回参数：无

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": null
}

更新员工部门和职务

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/updateUserDeptAndPosition

请求参数：

参数名 描述 数据类型 必填 字节长度
employeeUuid 员工uuid String 是 50
newDepartmentUuid 新部门uuid String 是 50
newPositionUuid 新职务uuid String 是 50
roleUuidList 角色列表 List<String> 否
isSetUpperEmp 是否修改员工上级 Boolean 是 300
upperEmployeeUuid 员工上级uuid String 否 50
remark 备注（字符长度不超过10） String 否 10

请求示例：

{
  "param": {
    "employeeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "newDepartmentUuid": "0b6bba424ad34e238a4e515ca7dcc4c8",
    "newPositionUuid": "be27e7c8f4aa44368b02a1d00ab4d367",
    "remark": "remark",
    "roleUuidList": [
    "40d9360d62b4462d951a2518a6841faf"
    ],
    "isSetUpperEmp":true,
    "upperEmployeeUuid": "cf55b622-cd9a-4f5d-98df-77ecb52b23fc"    
  }
}

返回参数：无

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": null
}

员工离职

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/userDimission

请求参数：

参数名 描述 数据类型 必填 备注
employeeUuid 员工uuid String 是
quitType 离职类型
{
  辞退,
  劝退,
  自离,
  辞职
}		 String 是 10
quitDate 离职日期(时间戳精确到毫秒) Date 是 只能选今天及之前的日期，202307改为可以选择未来时间

请求示例：

{
  "param": {
    "employeeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "quitType": "自离",
    "quitDate": 1632478546000
  }
}

返回参数：无

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": null
}

员工复职

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/userResume

请求参数：

参数名 描述 数据类型 必填 字节长度
employeeUuid 员工uuid String 是 50
status 员工状态
{
  正式,
  试用,
  实习,
  离职
}		 String 是 50
reinstateDate 复职日期(时间戳精确到毫秒) Date 是
gradeUuid 上级uuid String 否 50
deptUuid 复职部门uuid String 是 50
positionUuid 复职职务uuid String 是 50
roleUuidList 角色uuid List<String> 是
phoneNumber APP账号 String 是 50

请求示例：

{
  "param": {
    "deptUuid": "0b6bba424ad34e238a4e515ca7dcc4c8",
    "employeeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89",
    "gradeUuid": "eeebf6dc-7dc1-4b72-b68e-cc8f1a3ab123",
    "phoneNumber": "string",
    "positionUuid": "be27e7c8f4aa44368b02a1d00ab4d367",
    "reinstateDate": 1632478546000,
    "roleUuidList": [
      "4e2ef808daa54da4bf11e6570c1812c5",
      "a2d12550f12d4442a8afdf42307e8ae0"
    ],
    "status": "正式"
  }
}

返回参数：无

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": null
}

更新员工手机号

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/updateUserPhone

请求参数：

参数名 描述 数据类型 必填 字节长度
employeeUuid 员工uuid String 是 50
oldPhone 原手机号 String 是 11
newPhone 新手机号 String 是 11

请求示例：

{
  "param": {
    "employeeUuid": "7eaee2d9-2db4-438e-bc53-a51f506174db",
    "newPhone": "13800000002",
    "oldPhone": "13800000003"
  }
}

返回参数：无

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": null
}

批量冻结/解冻员工

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/batchSetUserFreeStatus

请求参数：

参数名 描述 数据类型 必填 字节长度
employeeUuids 员工uuid List<String> 是
freezeStatus 冻结状态
true 冻结  false 解冻		 Boolean 是  

请求示例：

{
  "param": {
    "employeeUuid": [
      "eeebf6dc-7dc1-4b72-b68e-cc8f1a3abb89"
    ],
    "freezeStatus": false
  }
}

返回参数：无

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": null
}

批量查询员工信息（不包含删除的)

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/listValidEmployeeByUuids

请求参数：

参数名 描述 数据类型 必填 字节长度
uuids 员工employeeUuid集合,size在[1,200] List<String> 是  

请求示例：

{
  "uuids": [
    "42c8fe06-fe08-4b73-b5b7-10851bd03a01"
  ]
}

返回参数：

参数名 描述 数据类型 必填 字节长度
name 员工姓名 String 否 20
gender 性别 String 否 2
cellphone 手机 String 否 20
photoUrl 头像 String 否 500
employeeUuid 员工uuid String 否 50
companyUuid 公司uuid String 否 50

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "companyUuid": "qianhouduanliandiaoy_saas2_99dcd576f",
      "name": "ling",
      "gender": "女",
      "cellphone": "13800000004",
      "employeeUuid": "42c8fe06-fe08-4b73-b5b7-10851bd03a01",
      "photoUrl": "//image.qfstatic.com/qianhouduanliandiaoy_saas2_99dcd576f/2021/03/20210316/e465345ff0a74d658e3b88115e5fdfd0.jpg"
    }
  ]
}

批量获取员工身份证号

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/batchGetUserIdCard

请求参数：

参数名 描述 数据类型 必填 字节长度
param 员工uuids List<String> 是  

请求示例：

{
  "param": [
    "23184bb4-ca50-432e-bb8f-cb0bb5d3922b"
  ]
}

返回参数：Map <String,String>

参数名 描述 数据类型 必填 字节长度
key 员工uuid String 是 100
value 身份证号 String 是 100

返回示例：

{
    "responseCode": "1",
    "responseMessage": "success",
    "responseType": null,
    "data": {
        "23184bb4-ca50-432e-bb8f-cb0bb5d3922b": "430482199801201234"
    }
}

绑定短信

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/smsWubaBind

请求参数：

参数名 描述 数据类型 必填 字节长度
param 员工uuid String 是 100

请求示例：

{
  "param": "23184bb4-ca50-432e-bb8f-cb0bb5d3922b"
}

返回参数：无

返回示例：

{
    "responseCode": "1",
    "responseMessage": "success",
    "responseType": null,
    "data": null
}

绑定链接

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/getAuthenticatedUrl

请求参数：请求参数：

参数名 描述 数据类型 必填 字节长度
param 员工uuid String 是 100

请求示例：

{
  "param": "23184bb4-ca50-432e-bb8f-cb0bb5d3922b"
}

返回参数：

参数名 描述 数据类型 必填 字节长度
data 链接url String 是 100

返回示例：

{
    "responseCode": "1",
    "responseMessage": "success",
    "responseType": null,
    "data": "http://t.anjuke.com/xliVz1QutgD"
}

获取用户三网账号

请求方式：POST

请求地址：/api/marketingopenapi/common/getUserBindInfo

  • 请求header中需要传"appId" 请求参数：
参数名 描述 数据类型 必填 字节长度
externalCompanyUuid 公司uuid String 是  
externalEmployeeUuids 员工uuids List<String> 是  

请求示例：

{
  "externalCompanyUuid": "saas2_test2_company3_company7j8h6gh5tf",
  "externalEmployeeUuids": [
    "42f2d4a9-7c86-42b9-8292-789ef5543881"
  ]
}

返回参数：Map <String,List<UserBindInfoDTO>>

参数名 描述 数据类型 必填 字节长度
key 员工uuid String 是 100
value 绑定信息 List<UserBindInfoDTO>（三网账号：brokerId，其他字段可忽略） 是  

返回示例：

{
    "responseCode": "1",
    "responseMessage": "success",
    "responseType": null,
    "data": {
        "42f2d4a9-7c86-42b9-8292-789ef5543881": [
            {
                "employeeBrokerBindUuid": null,
                "brokerId": "202285160",
                "sanWangCompanyId": null,
                "companyUuid": null,
                "employeeUuid": "cf55b622-cd9a-4f5d-98df-77ecb52b23fc",
                "externalCompanyUuid": null,
                "externalEmployeeUuid": null,
                "externalCompanyName": null,
                "externalEmployeeName": null,
                "externalDeptName": null,
                "wubaIdCard": null,
                "wubaAuthFlag": null,
                "saasIdCard": null,
                "saasAuthFlag": null,
                "sanWangTrueName": null,
                "loginName": null,
                "loginMobile": null,
                "safeMobile": null,
                "authDesc": null,
                "bindStatus": "BIND",
                "rainbowBridgeRuleFlag": null,
                "loginFlag": null,
                "defaultAccount": null,
                "createTime": null,
                "bindDate": null,
                "companyAuthBtnFlag": null,
                "companyAuthSameCrmFlag": null,
                "companyAuthSameCityFlag": null,
                "companyAuthDesc": null,
                "currBrokerCrmInfo": null,
                "currBrokerCityIds": null,
                "saasCrmBindDTO": null,
                "brokerBindInfoList": null
            }
        ]
    }
}

获取所有员工手机号

请求方式：POST

请求地址：/api/jediopenplatformopenapi/organization/usercenter/listEmployeeContactByUuids

请求参数：

参数名 描述 数据类型 必填 字节长度
uuids 员工employeeUuid集合,size在[1,200] List 是  

请求示例：

{
  "uuids": [
    "42c8fe06-fe08-4b73-b5b7-10851bd03a01"
  ]
}

返回参数：

参数名 描述 数据类型 必填 字节长度
employeeUuid 员工uuid String 是 50
phone 手机 String 是 50
contactUUid 联系方式uuid String 是 50

返回示例：

{
  "responseCode": "1",
  "responseMessage": "success",
  "responseType": null,
  "data": [
    {
      "contactUUid": "def2acc0-c92c-438d-ba74-8bb6aaf052ef",
      "phone": "13222221111",
      "employeeUuid": "42c8fe06-fe08-4b73-b5b7-10851bd03a01"
    },
    {
      "contactUUid": "473c2f64-f0e1-45dc-92a7-25d9982c371f",
      "phone": "13322221112",
      "employeeUuid": "42c8fe06-fe08-4b73-b5b7-10851bd03a01"
    }
  ]
}

results matching ""

    No results matching ""