系统级别输入参数
| 参数名称 | 说明 |
|---|---|
| appkey | 客户端标识 (由fesco技术部提供给调用方一对appkey与appsecret) |
| sign | 调用方签名后的字符串 |
| format | （json/jsonp)如果该参数不传递,默认返回json |
| timeStamp | 时间戳（毫秒值，1534225991898） |
| methodName | 方法名 |
| 接口概述 | |
|---|---|
| 开发者 | 侯瑞凯 |
| 方法名 | personnelmgr.insertEsEmpCerInfo |
| 说明 |
批量新增雇员证件信息： 1、入参证件类型为[残疾证]时，残疾类型、残疾等级 字段不能为空； 2、根据证件号和证件类型判断是否有其他唯一号在使用，如有，不可新增； 3、根据雇员唯一号、雇员证件类型查询是否存在有效证件，如果存在，不可新增。 |
应用级输入参数
| 名称 | 类型 | 是否必须 | 描述 | 示例值 | 默认值 |
|---|---|---|---|---|---|
jsonList
|
|
是 | 应用级别参数对象Json序列化后的字符串 | ||
esEmpCers
|
|
是 | 证件信息集合 | "esEmpCers": [ { "cardBeginDate": null, "cardEndDate": null, "cardId": 0, "cardName": "", "cardNum": "08593312", "cardType": 15, "cerSource": 0, "disabilityLevel": 0, "disabilityType": 0, "empName": "", "exactCardType": 0, "isAppUniqNo": 0, "isValid": 0, "issueDate": null, "operId": 0, "operTime": null, "operatorCompanyId": 0, "pubCardUnit": "", "remark": "", "uniqNo": 7555657, "validPeriod": 0, "validPeriodUnit": "" } ] |
返回结果
| 名称 | 类型 | 描述 |
|---|---|---|
| code |
|
0为成功，其他为失败 |
| errorMsg |
|
失败原因 |
| successResult |
|
成功数据 |
| errorResult |
|
错误数据集合 |
| status |
|
1为中间库成功，2为新系统成功，3为新系统失败（新系统业务处理异常，不插入中间库） |
| piCallRecId |
|
中间表主键id（根据中间表主键id查询返回正确业务数据的json串） |
| errorStack |
|
错误堆栈 |
调用示列
---- 调用入参
{
"callUrl": "http://api.inside.com:8852/personnelmgr",
"sign": 123456,
"esEmpCers": [
{
"cardBeginDate": null,
"cardEndDate": null,
"cardId": 0,
"cardName": "",
"cardNum": "08593312",
"cardType": 15,
"cerSource": 0,
"disabilityLevel": 0,
"disabilityType": 0,
"empName": "",
"exactCardType": 0,
"isAppUniqNo": 0,
"isValid": 0,
"issueDate": null,
"operId": 0,
"operTime": null,
"operatorCompanyId": 0,
"pubCardUnit": "",
"remark": "",
"uniqNo": 7555657,
"validPeriod": 0,
"validPeriodUnit": ""
}
],
"thisIsServiceJobSign": 12514281
}
--调用成功返参
{
"code": "0",
"errorMsg": "",
"errorResult": null,
"piCallRecId": "12514281",
"status": 2,
"successResult": null
}
--调用失败样例
{
"code": "PERSONNELMGR-00102",
"errorMsg": "参数不全",
"status": null,
"piCallRecId": null,
"successResult": null
}
错误码
| 错误编码 | 错误描述 | 错误原因 | 解决方案 |
|---|---|---|---|
| PERSONNERLMGR-00212 | 证件类型为残疾证时,残疾类型不能为空 | 证件类型为残疾证时,残疾类型入参不能为空 | |
| PERSONNERLMGR-00213 | 证件类型为残疾证时,残疾等级不能为空 | 证件类型为残疾证时,残疾等级不能为空 | |
| PERSONNELMGR-00102 | uniqNo为空 | 雇员唯一号字段为空 | |
| PERSONNERLMGR-00211 | cardNum证件号码为空 | 入参证件号码是空 | |
| PERSONNERLMGR-00216 | 已经存在相同证件，只能进行修改! | 根据雇员唯一号、雇员证件类型，查询当前雇员已经存在有效相同证件类型。 | |
| PERSONNERLMGR-00115 | cardType证件类型为空 | 证件类型字段是空 | |
| PERSONNELMGR-00100 | 参数不全 | 传入的参数对象是空 | |
| PERSONNERLMGR-00215 | 修改后的证件号码已被其他雇员使用,不能进行新增证件信息操作! | 根据证件类型，证件号码，查询其他雇员在使用此证件类型的提示语 | |
| PERSONNERLMGR-00214 | 证件号码被多次使用 | 根据证件类型，证件号码，查询有多个雇员在使用此证件类型的提示语 |
