系统级别输入参数
| 参数名称 | 说明 |
|---|---|
| appkey | 客户端标识 (由fesco技术部提供给调用方一对appkey与appsecret) |
| sign | 调用方签名后的字符串 |
| format | （json/jsonp)如果该参数不传递,默认返回json |
| timeStamp | 时间戳（毫秒值，1534225991898） |
| methodName | 方法名 |
| 接口概述 | |
|---|---|
| 开发者 | 张强 |
| 方法名 | personnelmgr.insertHshdRegCardReturnFlow |
| 说明 |
【户口卡归还】手续回灌接口，所有手续步骤一次回填(存在办理中的数据时不能重复发起，户口卡归还手续ID：1238) 1.接收材料。 2.退押金。 |
应用级输入参数
| 名称 | 类型 | 是否必须 | 描述 | 示例值 | 默认值 |
|---|---|---|---|---|---|
jsonList
|
|
否 | 应用级别参数对象Json序列化后的字符串 | ||
| └ uniqNo |
|
是 | 雇员唯一号 | 123456 | |
hshdRegInfoList
|
|
是 | 户口集合信息 | ||
| └ retDate |
|
是 | 户口卡归还日期（YYYY-MM-DD） | 2022-10-01 | |
| └ retUser |
|
是 | 户口卡归还人 | 张三 | |
| └ oprName |
|
是 | 操作人账号名称 | zhangsan | |
| └ flowInstSource |
|
是 | 手续实例来源(FLOW_INST_SOURCE) | 10、集体户口在线办理系统 | |
|
stepInfoDtoList
|
|
否 | 手续步骤说明公共参数 |
返回结果
| 名称 | 类型 | 描述 |
|---|---|---|
| code |
|
0为成功，其他为失败 |
| errorMsg |
|
失败原因 |
|
successResult
|
|
成功数据 |
| errorResult |
|
错误数据集合 |
| status |
|
1为中间库成功，2为新系统成功，3为新系统失败（新系统业务处理异常，不插入中间库） |
| piCallRecId |
|
中间表主键id（根据中间表主键id查询返回正确业务数据的json串） |
| errorStack |
|
错误堆栈 |
调用示列
---- 接口入参：
{
"uniqNo": 61489454,
"hshdRegInfoList": [
{
"hshdRegUser": "杜亦格",
"memberMId": ""
}
],
"idCardNo": "222401198509052522",
"retUser": "张三归还",
"retDate": "2022-03-08",
"oprName": "zhangsan",
"flowInstSource": 3,
"stepInfoDtoList": [
{
"stepFlag": "2",
"stepDesc": "户口归还步骤说明 退押金 222"
},
{
"stepFlag": "1",
"stepDesc": "户口归还 接收材料步骤说明123123"
}
],
"sign": 123
}
--调用成功返参
{
"code": "0",
"errorMsg": null,
"piCallRecId": "string",
"status": 2,
"successResult": {
"orderId": 1660010,
"flowId": 1660010,
"flowInstId": 1660010
},
"errorResult": null
}
--调用失败样例
{
"code": "PERSONNERLMGR-00301",
"errorMsg": "雇员唯一号不能为空！",
"status": null,
"piCallRecId": null,
"successResult": null
}
错误码
| 错误编码 | 错误描述 | 错误原因 | 解决方案 |
|---|---|---|---|
| PERSONNERLMGR-00273 | 日期格式转换错误 | 传入的日期格式与要求不一致 | |
| PERSONNERLMGR-00282 | 操作人ID为空！ | 入参操作人ID是空。 | |
| PERSONNERLMGR-00352 | 该雇员户口信息已归还，无法办理！ | 雇员集体户口信息已经归还，无法再次办理户口归还手续。 | |
| PERSONNELMGR-00001 | 系统异常 | 未知的系统捕获异常信息。 | |
| PERSONNERLMGR-00287 | 未查询到雇员订单信息！ | 根据雇员查询客服订单接口，未查询雇员到雇员有效的订单信息。 | |
| PERSONNERLMGR-00333 | 调用客服接口失败，客服反馈原因 | 调用客服接口，未正确的返回参数信息。 | |
| PERSONNERLMGR-00360 | 户口卡归还人姓名为空 | 入参户口卡归还人字段是空 | |
| PERSONNELMGR-00100 | 参数不全 | 传入的参数对象是空 | |
| PERSONNELMGR-00102 | uniqNo为空 | 入参雇员唯一号是空 | |
| PERSONNERLMGR-00359 | 归还日期为空 | 入参归还日期是空 | |
| PERSONNERLMGR-00281 | 手续来源为空 | 入参手续来源字段为空 | |
| PERSONNERLMGR-00230 | stepId当前要办理的步骤ID为空! | 根据办理的手续步骤，没有查询到系统中配置有效的手续步骤信息。 | |
| PERSONNERLMGR-00358 | 该手续已被其他系统办理，无法办理！ | 判断办理集体户口借阅手续系统来源，是否是同一个系统操作。 | |
| PERSONNERLMGR-00357 | 操作人ID不合法 | 传入的操作人ID不存在核心系统当中。 | |
| PERSONNERLMGR-00347 | 该雇员集体户口不在外企，无法办理 | 没有查询到雇员在外企的集体户口信息，无法办理该手续 | |
| PERSONNERLMGR-00342 | 户口信息为空 | 入参集体户口信息是空 | |
| MEDICAREMGR-00350 | 成员ID主数据编码不能为空 | 雇员家属集体户口信息，成员主数据编码ID必填 | |
| PERSONNERLMGR-00349 | 未匹配到该雇员户口信息 | 根据雇员查询在外企的集体户口信息，入参未匹配到系统中外企集体户口数据 | |
| MEDICAREMGR-00351 | 成员ID主数据编码错误 | 雇员家属集体户口信息，入参成员主数据编码ID与系统不一致 |
