钉钉开发文档

获取离职员工离职信息

更新时间: 2019-5-17

根据员工userid列表,批量查询员工的离职信息。传入非离职员工userid,不会返回信息。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/listdimission?access_token=ACCESS_TOKEN
参数说明:

名称 类型 必须 示例值 描述
userid_list String 1, 2, 3 员工userid列表,最大长度50

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/listdimission");
OapiSmartworkHrmEmployeeListdimissionRequest req = new OapiSmartworkHrmEmployeeListdimissionRequest(); 
req.setUseridList("123"); 
OapiSmartworkHrmEmployeeListdimissionResponse response = client.execute(req , accessToken);
System.out.println(rsp.getBody());

返回结果示例

{
  "result": [
    {
      "userid": "123",
      "last_work_day": 1534569419008,
      "dept_list": [
        {
          "dept_path": "门诊部-门诊外科",
          "dept_id": 1234
        },
        {
          "dept_path": "门诊部-门诊外科",
          "dept_id": 1235
        }
      ],
      "reason_memo": "世界太大,想出去看看",
      "reason_type": 1,
      "pre_status": 1,
      "handover_userid": "123456",
      "status": 2,
      "main_dept_name": "门诊外科",
      "main_dept_id": 1234
    }
  ],
  "errcode": 0,
  "errmsg": "成功",
  "success": true
}

返回结果:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
success 调用是否成功
result 员工离职信息列表
└ userid 员工唯一标识ID
└ last_work_day 最后工作时间
└ dept_list 部门列表
└└ dept_path 部门路径
└└ dept_id 部门id
└ reason_memo 离职原因备注
└ reason_type 离职原因类型:1,家庭原因;2,个人原因;3,发展原因;4,合同到期不续签;5,协议解除;6,无法胜任工作;7,经济性裁员;8,严重违法违纪;9,其他
└ pre_status 离职前工作状态:1,待入职;2,试用期;3,正式
└ handover_userid 离职交接人
└ status 离职状态:1,待离职;2,已离职
└ main_dept_name 离职前主部门名称
└ main_dept_id 离职前主部门id
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!