文档中心 > API类目 > 钉钉API

dingtalk.oapi.smartwork.hrm.employee.addpreentry (智能人事添加企业待入职员工)

智能人事添加待入职员工信息

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
param	PreEntryEmployeeAddParam	必须			添加待入职入参
└ pre_entry_time Date 可选 2018-08-08 00:00:00 预期入职时间 └ name String 必须张三待入职员工姓名 └ extend_info String 可选 {"depts": "123\|345\|899", "employeeType": 1, "mainDeptId": 123, "mainDeptName": "研发部", "position": "高级工程师", "workPlace": "杭州" } 扩展信息，json串格式，按要求传入有效信息，无效信息不会保存。有效信息有：depts--部门id列表，"\|"分隔多个；mainDeptId--主部门id； mainDeptName--主部门名称； position--职位； workPlace--工作地点；employeeType--员工类型枚举值（0，无类型;1，全职;2，兼职;3，实习;4，劳务派遣;5，退休返聘;6，劳务外包） └ op_userid String 可选 manager123 操作人userid └ mobile String 必须 13712345678 待入职员工手机号

响应参数

名称	类型	示例值	描述
userid	String	0123456789	员工id
errcode	Number	400020	错误码
errmsg	String	无访问权限	错误信息
success	Boolean	false	调用结果

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

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

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/addpreentry");
OapiSmartworkHrmEmployeeAddpreentryRequest req = new OapiSmartworkHrmEmployeeAddpreentryRequest();
OapiSmartworkHrmEmployeeAddpreentryRequest.PreEntryEmployeeAddParamDomain obj1 = new OapiSmartworkHrmEmployeeAddpreentryRequest.PreEntryEmployeeAddParamDomain();
obj1.PreEntryTime = DateTime.Parse(2018-08-08 00:00:00");
obj1.Name = "张三";
obj1.ExtendInfo = "{\"depts\": \"123|345|899\",   \"employeeType\": 1,   \"mainDeptId\": 123,   \"mainDeptName\": \"研发部\",   \"position\": \"高级工程师\",   \"workPlace\": \"杭州\" }";
obj1.OpUserid = "manager123";
obj1.Mobile = "13712345678";
req.Param_ = obj1;
OapiSmartworkHrmEmployeeAddpreentryResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiSmartworkHrmEmployeeAddpreentryRequest;
$param = new PreEntryEmployeeAddParam;
$param->pre_entry_time="2018-08-08 00:00:00";
$param->name="张三";
$param->extend_info="{\"depts\": \"123|345|899\",   \"employeeType\": 1,   \"mainDeptId\": 123,   \"mainDeptName\": \"研发部\",   \"position\": \"高级工程师\",   \"workPlace\": \"杭州\" }";
$param->op_userid="manager123";
$param->mobile="13712345678";
$req->setParam($param);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/addpreentry");

curl -X POST "https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/addpreentry" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=47ea04e0-a7ed-4cae-ae3a-fd5253e900c7' \
-d 'param=null'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiSmartworkHrmEmployeeAddpreentryRequest("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/addpreentry")

req.param=""
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.smartwork.hrm.employee.addpreentry");
add_param(pRequest,"param","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.smartwork.hrm.employee.addpreentry', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "userid":"0123456789",
    "errcode":400020,
    "errmsg":"无访问权限",
    "success":false
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.smartwork.hrm.employee.addpreentry (智能人事添加企业待入职员工)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ