系统级别输入参数
| 参数名称 | 说明 |
|---|---|
| appkey | 客户端标识 (由fesco技术部提供给调用方一对appkey与appsecret) |
| sign | 调用方签名后的字符串 |
| format | （json/jsonp)如果该参数不传递,默认返回json |
| timeStamp | 时间戳（毫秒值，1534225991898） |
| methodName | 方法名 |
| 接口概述 | |
|---|---|
| 开发者 | 栗慧慧 |
| 方法名 | personnelmgr.insertOrUpdateWorkPermitFlow |
| 说明 |
工作居住证手续回填有四个步骤 1.单位审核不通过：生成对应的手续实例并返回手续实例ID，手续为已终止，不能再回填其他步骤 2.单位提交：生成对应的手续实例并返回手续实例ID，手续为运行状态，可以继续回填主管部门通过、主管部门不通过步骤 3.主管部门通过：回填过单位提交步骤才可以回填此步骤，步骤回填完后手续为已办结 4.主管部门不通过：回填过单位提交步骤才可以回填此步骤，步骤回填完后手续为已终止 |
应用级输入参数
| 名称 | 类型 | 是否必须 | 描述 | 示例值 | 默认值 |
|---|---|---|---|---|---|
jsonList
|
|
应用级别参数对象Json序列化后的字符串 | |||
| └ empName |
|
否 | 雇员姓名(回填单位审核不通过、单位提交时必填) | ||
| └ idCardNo |
|
否 | 要号证件号码(回填单位审核不通过、单位提交时必填) | ||
| └ socialCreditCode |
|
否 | 统一社会信用代码(回填单位审核不通过、单位提交时必填) | ||
| └ stepOrder |
|
是 | 步骤标识 | 1.单位审核不通过 2.单位提交 3.主管部门通过 4.主管部门不通过 |
|
| └ flowInstSource |
|
是 | 手续来源 | 1.核心 2.帮办小助手 |
|
| └ flowInstId |
|
否 | 手续实例ID(回填主管部门通过、主管部门不通过时必填) | ||
| └ operId |
|
是 | 操作人ID | ||
| └ stepDesc |
|
否 | 步骤说明 | ||
| └ companyAuditFailReason |
|
否 | 审核不通过原因(回填单位审核不通过时必填) | ||
| └ companyAuditor |
|
否 | 审核人(回填单位审核不通过时必填) | ||
| └ companyAuditDate |
|
否 | 审核日期(回填单位审核不通过时必填) | ||
| └ counties |
|
否 | 办理区县(回填单位审核不通过、单位提交时必填) | 朝阳区 东城区 西城区 海淀区 经济技术开发区 顺义区 昌平区 丰台区 石景山区 门头沟区 房山区 大兴区 怀柔区 平谷区 密云区 延庆区 北京通州 北京海淀 北京门头沟 通州区 |
|
| └ type |
|
否 | 办理类别(回填单位审核不通过、单位提交时必填) | 1.新办 2.续签 3.随往变更 4.聘变 5.居住变更 6.其他变更 9.取消关联 10.关联和新办 11.关联和聘变 |
|
| └ submitDate |
|
否 | 提交日期(回填单位提交时必填) | ||
| └ opinion |
|
否 | 主管部门审核意见(回填主管部门通过时必填) | ||
| └ auditDate |
|
否 | 审核通过/审核不通过日期(回填主管部门通过、主管部门不通过时必填) | ||
| └ auditFailReason |
|
否 | 主管部门审核不通过原因(回填主管部门不通过时必填) | ||
| └ returnWay |
|
否 | 退回方式(回填主管部门不通过时必填) | 1.退回个人 2.退回单位 |
返回结果
| 名称 | 类型 | 描述 |
|---|---|---|
| code |
|
0为成功，其他为失败 |
| errorMsg |
|
失败原因 |
successResult
|
|
成功数据 |
| errorResult |
|
错误数据集合 |
| status |
|
1为中间库成功，2为新系统成功，3为新系统失败（新系统业务处理异常，不插入中间库） |
| piCallRecId |
|
中间表主键id（根据中间表主键id查询返回正确业务数据的json串） |
| errorStack |
|
错误堆栈 |
调用示列
--1 单位审核不通过
{
"empName":"测试工作居住证手续回灌",
"idCardNo":"150304199002210681",
"socialCreditCode":"66628794-1",
"stepOrder":1,
"flowInstSource":2,
"operId":112211,
"stepDesc":"步骤说明",
"companyAuditFailReason":"审核不通过原因",
"companyAuditor":"审核人",
"companyAuditDate":1631014662876,
"counties":"朝阳区",
"type":"1,2,3",
"sign":123
}
--2 单位提交
{
"empName":"测试工作居住证手续回灌",
"idCardNo":"150304199002210681",
"socialCreditCode":"66628794-1",
"stepOrder":2,
"operId":112211,
"stepDesc":"步骤说明",
"submitDate":1631014662876,
"counties":"朝阳区",
"type":"1,2,3",
"flowInstSource":"2",
"sign":123
}
--3.主管部门审核通过
{
"flowInstId":1667891,
"stepOrder":3,
"operId":112211,
"stepDesc":"步骤说明",
"auditDate":1631014662876,
"opinion":"主管部门意见",
"sign":123,
"flowInstSource":2
}
--4.主管部门审核不通过
{
"flowInstId":1667892,
"stepOrder":4,
"operId":112211,
"stepDesc":"步骤说明",
"auditDate":1631014662876,
"auditFailReason":"主管部门审核不通过原因",
"returnWay":1,
"flowInstSource":2,
"sign":123
}
--调用成功样例
{
"code": "0",
"errorMsg": null,
"piCallRecId": "string",
"status": 2,
"successResult": 1636212,
"errorResult": null
}
--调用失败样例
{
"code": "PERSONNERLMGR-00301",
"errorMsg": "步骤标识不存在！",
"status": null,
"piCallRecId": null,
"successResult": null
}
错误码
| 错误编码 | 错误描述 | 错误原因 | 解决方案 |
|---|
