系统级别输入参数
参数名称 | 说明 |
---|---|
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.停办(步骤回填完后手续为已终止) |
应用级输入参数
名称 | 类型 | 是否必须 | 描述 | 示例值 | 默认值 |
---|---|---|---|---|---|
![]() |
|
应用级别参数对象Json序列化后的字符串 | |||
└ empName |
|
否 | 雇员姓名(手续实例为空时必填,代表办理新手续) | ||
└ idCardNo |
|
否 | 要号证件号码(手续实例为空时必填,代表办理新手续) | ||
└ socialCreditCode |
|
否 | 统一社会信用代码(手续实例为空时必填,代表办理新手续) | ||
└ stepOrder |
|
是 | 步骤标识 | 1.接收材料 2.材料审核 3.报送主管部门 4.主管部门不通过 5.领取批信 6.员工领取批信 7.接收雇员档案 8.接收配偶档案 9.办结 10.停办 |
|
└ flowInstSource |
|
是 | 手续来源 | 1.核心 2.帮办小助手 |
|
└ flowInstId |
|
否 | 手续实例ID(回填办理中的手续时必填) | ||
└ operId |
|
是 | 操作人ID(在核心必须有引进人才专员角色) | ||
└ stepDesc |
|
否 | 步骤说明 | ||
└ range |
|
否 | 办理范围(办理接收材料时必填) | 1.本人 2.本人+配偶 3.本人+配偶+子女 4.本人+子女 |
|
└ contact |
|
否 | 联系方式 | ||
└ isMateFEmp |
|
否 | 配偶是否外企雇员(默认为否) | 0.否 1.是 |
|
![]() |
|
否 | 成员信息集合(办理类型为2、3时配偶信息必填,办理类型为3、4时子女1信息必填) | ||
└ processingDate |
|
否 | 办理日期(办理2.材料审核、3.报送主管部门、4.主管部门审核不通过、5.领取批信、6.员工领取批信、7.接收本人档案、8.接收配偶档案、10.停办步骤时必填) | YYYY-MM-DD | |
└ mateFileLocal |
|
否 | 配偶原档案所在地(办理接收材料且办理范围为2、3时必填) | ||
└ mateCompName |
|
否 | 配偶在京接收单位(办理接收材料且办理范围为2、3时必填) | ||
└ mateHouseAddr |
|
否 | 配偶户口所在地(办理接收材料且办理范围为2、3时必填) | ||
└ empOldFileAdds |
|
否 | 本人原档案所在地 | ||
└ companyArea |
|
否 | 公司所在区 | 2147002 北京海淀 2147122 北京门头沟 2146882 北京通州 752262 昌平区 755803 朝阳区 755821 大兴区 755757 东城区 755815 房山区 755805 丰台区 755811 海淀区 755823 怀柔区 2145820 经济技术开发区 755813 门头沟区 755827 密云区 755825 平谷区 755807 石景山区 752260 顺义区 2147182 通州区 755797 西城区 2145819 延庆区 |
|
└ isPassMatCheck |
|
否 | 是否材料审核通过(办理材料审核步骤时必填) | 0否 1是 |
|
└ resviewer |
|
否 | 审核人(办理材料审核步骤时必填) | ||
└ auditFailedReasons |
|
否 | 审核不通过原因(办理材料审核步骤且审核不通过时必填) | ||
└ reasonDepInCharge |
|
否 | 政府审核不通过原因(办理主管部门不通过步骤时必填) | ||
└ expressNumber |
|
否 | 快递单号 | ||
└ matIds |
|
否 | 材料ID集合(办理接收本人档案/接收配偶档案步骤时必填) | 1109 档案 | |
└ suspendReason |
|
否 | 停办原因(办理停办步骤时必填) |
返回结果
名称 | 类型 | 描述 |
---|---|---|
code |
|
0为成功,其他为失败 |
errorMsg |
|
失败原因 |
![]() |
|
成功数据 |
errorResult |
|
错误数据集合 |
status |
|
1为中间库成功,2为新系统成功,3为新系统失败(新系统业务处理异常,不插入中间库) |
piCallRecId |
|
中间表主键id(根据中间表主键id查询返回正确业务数据的json串) |
errorStack |
|
错误堆栈 |
调用示列
--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 | 配偶档案已在外企,无法办理档案接收! | 配偶档案存在时不可重复接收 |