登录

您的位置 : 文档中心 -> API信息

系统级别输入参数

参数名称 说明
appkey 客户端标识 (由fesco技术部提供给调用方一对appkey与appsecret)
sign 调用方签名后的字符串
format (json/jsonp)如果该参数不传递,默认返回json
timeStamp 时间戳(毫秒值,1534225991898)
methodName 方法名

接口概述
开发者 栗慧慧
方法名 personnelmgr.insertOrUpdateIntroductTalent
说明 引进人才手续可回填10个步骤,步骤没有办理顺序且可以重复回填(存在办理中的数据时不能重复发起)
1.接收材料(1.配偶是否外企雇员值为是时根据配偶证件类型、证件号码查询唯一号 2.传入成员信息必须与雇员已存在的成员五要素完全匹配3.办理类型为本人+配偶+子女时可添加一个子女信息,办理类型为本人+子女时可添加两个子女信息)
2.材料审核
3.报送主管部门
4.主管部门不通过
5.领取批信
6.员工领取批信
8.接收本人档案(雇员档案已存在时不能办理此步骤)
8.接收配偶档案(配偶非外企雇员或档案已存在时不能办理此步骤)
9.办结(步骤回填完后手续为已办结)
10.停办(步骤回填完后手续为已终止)

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
jsonList {} 应用级别参数对象Json序列化后的字符串
empName String 雇员姓名(手续实例为空时必填,代表办理新手续)
idCardNo String 要号证件号码(手续实例为空时必填,代表办理新手续)
socialCreditCode String 统一社会信用代码(手续实例为空时必填,代表办理新手续)
stepOrder Integer 步骤标识 1.接收材料
2.材料审核
3.报送主管部门
4.主管部门不通过
5.领取批信
6.员工领取批信
7.接收雇员档案
8.接收配偶档案
9.办结
10.停办
flowInstSource Integer 手续来源 1.核心
2.帮办小助手
flowInstId Long 手续实例ID(回填办理中的手续时必填)
operId Long 操作人ID(在核心必须有引进人才专员角色)
stepDesc String 步骤说明
range Integer 办理范围(办理接收材料时必填) 1.本人
2.本人+配偶
3.本人+配偶+子女
4.本人+子女
contact String 联系方式
isMateFEmp Integer 配偶是否外企雇员(默认为否) 0.否
1.是
memberInfoList [] 成员信息集合(办理类型为2、3时配偶信息必填,办理类型为3、4时子女1信息必填)
processingDate TimeStamp 办理日期(办理2.材料审核、3.报送主管部门、4.主管部门审核不通过、5.领取批信、6.员工领取批信、7.接收本人档案、8.接收配偶档案、10.停办步骤时必填) YYYY-MM-DD
mateFileLocal String 配偶原档案所在地(办理接收材料且办理范围为2、3时必填)
mateCompName String 配偶在京接收单位(办理接收材料且办理范围为2、3时必填)
mateHouseAddr String 配偶户口所在地(办理接收材料且办理范围为2、3时必填)
empOldFileAdds String 本人原档案所在地
companyArea Long 公司所在区 2147002 北京海淀
2147122 北京门头沟
2146882 北京通州
752262 昌平区
755803 朝阳区
755821 大兴区
755757 东城区
755815 房山区
755805 丰台区
755811 海淀区
755823 怀柔区
2145820 经济技术开发区
755813 门头沟区
755827 密云区
755825 平谷区
755807 石景山区
752260 顺义区
2147182 通州区
755797 西城区
2145819 延庆区
isPassMatCheck Integer 是否材料审核通过(办理材料审核步骤时必填) 0否
1是
resviewer String 审核人(办理材料审核步骤时必填)
auditFailedReasons String 审核不通过原因(办理材料审核步骤且审核不通过时必填)
reasonDepInCharge String 政府审核不通过原因(办理主管部门不通过步骤时必填)
expressNumber String 快递单号
matIds [] 材料ID集合(办理接收本人档案/接收配偶档案步骤时必填) 1109 档案
suspendReason String 停办原因(办理停办步骤时必填)

返回结果

名称 类型 描述
code String 0为成功,其他为失败
errorMsg String 失败原因
successResult [] 成功数据
errorResult {} 错误数据集合
status String 1为中间库成功,2为新系统成功,3为新系统失败(新系统业务处理异常,不插入中间库)
piCallRecId String 中间表主键id(根据中间表主键id查询返回正确业务数据的json串)
errorStack String 错误堆栈

调用示列

--1 接收材料
{
"empName":"测试引进人才回填",
"idCardNo":"110101198006090013",
"socialCreditCode":"66628794-1",
"stepOrder":1,
"flowInstSource":2,
"operId":757872,
"stepDesc":"步骤说明",
"range":3,
"contact":"15111001101",
"isMateFEmp":1,
"memberInfoList":[
{
"memberName":"测试手续回填",
"memberSex":2,
"memberCardType":1,
"memberIdCardNo":"110101198006090662",
"memberBirthDate":329328000000,
"relationShip":4
},
{
"memberName":"测试子女1",
"memberCardType":1,
"memberIdCardNo":"110101200506090132",
"memberBirthDate":1118246400000,
"memberSex":1,
"relationShip":5
}
],
"mateFileLocal":"天津市",
"mateCompName":"测试单位",
"mateHouseAddr":"天津市和平区",
"empOldFileAdds":"天津市",
"companyArea":755803,
"sign":123
}

--2材料审核
{
"stepOrder":2,
"operId":757872,
"flowInstSource":2
"stepDesc":"步骤说明",
"flowInstId":1660010,
"isPassMatCheck":1,
"resviewer":"娄春蕾",
"processingDate":1639929600000,
"auditFailedReasons":"",
"sign":123
}
--3.报送主管部门
{
"stepOrder":3,
"flowInstSource":2,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstId":1660010,
"processingDate":1640016000000,
"sign":123
}

--4.主管部门不通过
{
"stepOrder":4,
"flowInstSource":2,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstId":1660010,
"processingDate":1640016000000,
"reasonDepInCharge":"测试主管部门不通过原因",
"sign":123
}
--5.领取批信
{
"stepOrder":5,
"operId":757872,
"flowInstSource":2,
"stepDesc":"步骤说明",
"flowInstId":1660010,
"processingDate":1631014662876,
"sign":123
}

--6.员工领取批信
{
"stepOrder":6,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstSource":2
"flowInstId":1660010,
"expressNumber":"SF-100110",
"processingDate":1631014662876,
"sign":123
}

--7.接收本人档案
{
"stepOrder":7,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstSource":2
"flowInstId":1660010,
"matIds":[1109],
"userRoleId":3820373,
"processingDate":1631014662876,
"sign":123
}

--8.接收配偶档案
{
"stepOrder":8,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstSource":2
"flowInstId":1660010,
"matIds":[1109],
"userRoleId":3820373,
"processingDate":1631014662876,
"sign":123
}

--9.办结
{
"stepOrder":9,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstSource":2
"flowInstId":1660010,
"sign":123
}
--10.停办
{
"stepOrder":10,
"operId":757872,
"stepDesc":"步骤说明",
"flowInstSource":2
"flowInstId":1660010,
"suspendReason":"测试停办",
"suspendDate":1631014662876,
"sign":123
}
--调用成功样例
{
"code": "0",
"errorMsg": null,
"piCallRecId": "string",
"status": 2,
"successResult": {
"flowInstId": 1660010
},
"errorResult": null
}
--调用失败样例
{
"code": "PERSONNERLMGR-00301",
"errorMsg": "步骤标识不存在!",
"status": null,
"piCallRecId": null,
"successResult": null
}

错误码

错误编码 错误描述 错误原因 解决方案
PERSONNERLMGR-00286 根据雇员姓名、证件号码、统一社会信用代码未查询到雇员信息! 未查询到雇员信息或雇员不存在有效订单
PERSONNERLMGR-00317 办理范围为空! 办理接收材料时必填
PERSONNERLMGR-00325 配偶非外企雇员,无法办理档案接收! 在核心未查询到配偶的雇员信息
PERSONNERLMGR-00328 操作人无权限! 操作人不存在引进人才专员角色
PERSONNERLMGR-00334 成员信息为空! 办理范围为2、3、4时成员信息不能为空
PERSONNERLMGR-00280 步骤标识为空! 必填项不能为空
PERSONNERLMGR-00301 步骤标识不存在! 步骤标识不正确
PERSONNERLMGR-00311 报送日期为空! 办理报送主管部门步骤时必填
PERSONNERLMGR-00315 停办原因为空! 办理停办步骤时必填
PERSONNERLMGR-00319 成员信息不存在! 在核心未查询到成员信息
PERSONNERLMGR-00326 地区不存在! 根据传入companyArea未查询到地区信息
PERSONNERLMGR-00330 是否通过为空! 办理材料审核步骤时必填
PERSONNERLMGR-00341 雇员存在办理中的手续,不能重复发起办理! 存在办理中数据不能重复发起
PERSONNERLMGR-00281 手续来源为空! 必填项不能为空
PERSONNERLMGR-00287 未查询到雇员订单信息! 雇员不存在有效订单
PERSONNERLMGR-00308 审核人为空! 办理材料审核、主管部门审核不通过时,审核人不能为空
PERSONNERLMGR-00310 审核不通过原因为空! 办理材料审核、主管部门审核不通过时,审核原因不能为空
PERSONNERLMGR-00312 领取日期为空! 办理领取批信、员工领取批信时,领取日期不能为空,必填
PERSONNERLMGR-00313 接收日期为空! 接收雇员档案、配偶档案时,接收日期不能为空,必填
PERSONNERLMGR-00316 停办日期为空! 办理停办步骤时,停办日期不能为空
PERSONNERLMGR-00318 配偶信息不全! 传入配偶五要素不全
PERSONNERLMGR-00320 配偶非外企雇员! 配偶非外企雇员时,isMateFEmp字段不能为是
PERSONNERLMGR-00322 手续未回填配偶信息! 办理配偶档案接收时还未办理接收档案步骤,无法获取配偶信息
PERSONNERLMGR-00323 雇员档案已在外企,无法办理档案接收! 雇员档案存在时不能重复接收
PERSONNERLMGR-00327 时间格式转换异常! 时间格式转化错误
PERSONNERLMGR-00329 雇员姓名、要号证件号码、统一社会信用代码和手续实例ID都为空时无法回填手续! 回灌手续时无法匹配雇员信息
PERSONNERLMGR-00333 调用客服接口失败,客服反馈原因 调用客服接口失败
PERSONNERLMGR-00340 办理范围不包含配偶时,无法办理档案接收! 办理范围非2、3时不能办理配偶档案接收步骤
PERSONNELMGR-00100 参数不全 参数不能为空
PERSONNERLMGR-00108 operId为空 必填项不能为空
PERSONNERLMGR-00309 审核日期为空! 办理材料审核、主管部门审核不通步骤时审核日期不能为空
PERSONNERLMGR-00314 材料为空! 办理配偶档案接收、雇员档案接收步骤时,材料不能为空
PERSONNERLMGR-00321 子女五要素信息不全! 办理范围为3、4时子女信息必填
PERSONNERLMGR-00324 配偶档案已在外企,无法办理档案接收! 配偶档案存在时不可重复接收

API工具

联系我们

400-8000-800

产品咨询:010-85692930

FESCO官方

FESCO服务