用友优普开放平台

personandchild/add

1.接口说明

1.1接口描述

新增一人员信息和子集

1.2适用版本

支持U8V12.0 及更高版本

2.使用场景

基础档案

3.接口调用说明

3.1请求说明

url	https://api.yonyouup.com/api/personandchild/add
格式	JSON
https请求方式	POST
编码类型	UTF-8

3.2url参数说明

参数	类型	是否必填	描述
from_account	string	是	调用方id
to_account	string	是	提供方id
app_key	string	是	应用编码
token	string	是	api调用唯一识别码
tradeid	string	是	交易唯一识别码，tradeid与biz_id只能传入一个
ds_sequence	number	否	数据源序号（默认取应用的第一个数据源）
biz_id	string	是	上游id，需要保证biz_id与ERP主键唯一对应关系，tradeid与biz_id只能传入一个
sync	number	否	0=异步新增（默认）;1=同步新增;

3.3请求体参数说明

参数	类型	参数路径	是否必填	描述
cpsn_num	string		是	人员编号
cpsn_name	string		是	姓名
cpsnemail	string		否	工作邮箱
vidno	string		否	身份证号
rsex	string		否	性别
dbirthdate	string		否	出生日期
cpsnmobilephone	string		否	联系电话
djoinworkdate	string		否	参加工作日期
denddate	string	hr_hi_probation	是	招聘试用期结束日期
rpersontype	string	hr_hi_jobinfo	否	人员类别
csupperson	string	hr_hi_jobinfo	否	任职主管上级主管上级
cdepcode	string	hr_hi_jobinfo	是	任职所属组织
cdutycode	string	hr_hi_jobinfo	否	任职职务
cjobcode	string	hr_hi_jobinfo	否	任职职位
bpartjob,	string	hr_hi_jobinfo	否	是否兼职
rpersontype	string		否	人员类别
blastflag,	string	hr_hi_jobinfo	否	是否当前记录
cregion	string	hr_hi_jobinfo	否	任职社保缴纳地(福利地区)
vcontractcode	string	hr_hi_ctrt	是	合同编号
rtermtype	string	hr_hi_ctrt	否	合同期限类型
ilimit	number	hr_hi_ctrt	否	合同期限
icontimes	string	hr_hi_ctrt	是	合同签约次数
dbegindate	string	hr_hi_ctrt	否	合同开始日期
denddate	string	hr_hi_ctrt	否	合同结束日期
ipromonth	number	hr_hi_ctrt	否	合同试用期限
dtryenddate	string	hr_hi_ctrt	否	合同试用结束日期
vschool	string	hr_hi_edu	否	学校名称
rmajor	string	hr_hi_edu	否	专业名称
reducation	string	hr_hi_edu	否	学历
rdegree	string	hr_hi_edu	否	学位
dentrancedate	string	hr_hi_edu	否	教育学校开始日期
dgrduatedate	string	hr_hi_edu	否	教育学校结束日期
vworkcorp	string	hr_hi_work	否	工作单位
dbegindate	string	hr_hi_work	否	工作开始日期
vworkpost	string	hr_hi_work	否	主要职务
vworkduty	string	hr_hi_work	否	主要职责
denddate	string	hr_hi_work	否	工作结束日期
vmem_name	string	hr_hi_family	否	家庭成员姓名
rmem_relation	string	hr_hi_family	否	家庭成员关系
vrelaphone	string	hr_hi_family	否	家庭成员联系电话
vmem_cor	string	hr_hi_family	否	家庭成员工作单位
irecordid	string	hr_hi_bankaccount	是	记录标识
copenbankcode	string	hr_hi_bankaccount	是	银行名称
cbankaccount	string	hr_hi_bankaccount	是	银行账号

3.4请求示例

POST https://u8open.yonyou.com/api/personandchild/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1

POST 内容：
{
	"personandchild":{
		"cpsn_num":"1002",
		"cpsnemail":"wenbinc@yonyou.com",
		"cpsn_name":"温斌",
		"rsex":"1",
		"cpsnmobilephone":"18610919999",
		"hr_hi_probation":{
			"entry":{
				"denddate":"2016-12-26"
			}
		},
		"hr_hi_jobinfo":{
			"entry":{
				"cdepcode":"1",
				"rpersontype":"101",
				"cjobcode":"10101",
				"cregion":"31"
			}
		},
		"hr_hi_edu":{
			"entry":[
				{
					"dentrancedate":"2010-09-01",
					"dgrduatedate":"2012-09-08",
					"vschool":"哈尔滨理工大学",
					"rmajor":"020103",
					"reducation":"2010-09-01",
					"rdegree":"0"
				},
				{
					"dentrancedate":"2016-12-26",
					"vschool":"北京",
					"rmajor":"010199",
					"reducation":"2016-12-26",
					"rdegree":"001"
				}
			]
		},
		"hr_hi_work":{
			"entry":{
				"dbegindate":"2016-12-26",
				"vworkpost":"xcvxc",
				"vworkduty":"xcvxc"
			}
		},
		"hr_hi_family":{
			"entry":[
				{
					"vmem_name":"元",
					"rmem_relation":"102",
					"vmem_cor":"元"
				},
				{
					"vmem_name":"温宗浩",
					"rmem_relation":"201",
					"vmem_cor":"温宗浩"
				}
			]
		},
		"hr_hi_bankaccount":{
			"entry":{
				"irecordid":"1",
				"copenbankcode":"中国银行",
				"cbankaccount":"123354545"
			}
		}
	}
}

3.5返回参数说明

参数说明	类型	描述
errcode	string	错误码，0 为正常。
errmsg	string	错误信息。
id	string	新增成功后返回新人员编码。
tradeid	string	新增成功后返回交易唯一识别码

3.6正确返回示例

JSON示例:

{
    "tradeid": "158f3f05730711e591c702004c4f4f50",
    "ping_after": "3",
    "url": "https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50"
}
上述 api 请求返回信息表示建议客户端 3 秒钟后向 https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50 发送 GET 请求获取真正的 api 调用结果，结果格式如下：
{
  "errcode" : "0", 
  "errmsg" : "", 
  "id" : "883",
  "tradeid" : "158f3f05730711e591c702004c4f4f50"
}

3.7错误返回示例

application/json;charset=UTF-8
{
	"errcode" : "30021",
	"errmsg" : "此应用未上线"
}

4.API测试

API测试 SDK下载

基础档案类

personandchild/add

目录

1.接口说明

1.1接口描述

1.2适用版本

2.使用场景

3.接口调用说明

3.1请求说明

3.2url参数说明

3.3请求体参数说明

3.4请求示例

3.5返回参数说明

3.6正确返回示例

3.7错误返回示例

4.API测试