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" : "此应用未上线" }