钉钉开发文档

添加企业待入职员工

更新时间: 2019-5-17

此接口用于添加人员到企业待入职,并不同步员工详细档案信息。

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

名称 类型 必须 示例值 描述
param PreEntryEmployeeAddParam 添加待入职入参
└ name String 张三 员工姓名
└ mobile String 13712345678 手机号
└ pre_entry_time Date 2018-08-08 00:00:00 预期入职时间
└ op_userid String manager123 操作人userid
└ extend_info String {"depts": "123 345

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/addpreentry");
OapiSmartworkHrmEmployeeAddpreentryRequest req = new OapiSmartworkHrmEmployeeAddpreentryRequest();
PreEntryEmployeeAddParam param = new PreEntryEmployeeAddParam();
param.setPreEntryTime(StringUtils.parseDateTime("2018-08-08 00:00:00"));
param.setName("张三");
param.setExtendInfo("{\"depts\": \"123|345|899\",   \"employeeType\": 1,   \"mainDeptId\": 123,   \"mainDeptName\": \"研发部\",   \"position\": \"高级工程师\",   \"workPlace\": \"杭州\" }");
param.setOpUserid("manager123");
param.setMobile("13712345678");
req.setParam(param);
OapiSmartworkHrmEmployeeAddpreentryResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

返回结果示例

{
    "userid":"0123456789",
    "errcode":0,
    "errmsg":"成功",
    "success":true
}

返回结果:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
success 调用是否成功
userid 创建成功后,返回的员工唯一标识ID
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!