sj.md
5.53 KB
收件
- 收件不是单独的业务功能,是提取业务保存后的后续步骤
-
从提取业务传递过来的数据项
信息项名称 赋值 职工姓名 (020108)xm 身份证号 (020108)zjhm 业务办理机构 (020108)orgcode 提取表主键 保存接口返回主键 -
收件业务类型
业务名称 业务类型 收件类型 购买商品房提取 1103 T1 购买二手房提取 1104 T2 租房提取 1113 T8 结清公积金贷款提取 1121 CD 部分冲还公积金贷款提取 1122 TA 一年两次还商贷 1131 TB 退休提取 1201 TF 封存提取 1202 TG 收件调用的是第三方的接口,所以收件接口的host最好放在配置文件中,以方便修改。
下面的接口,因为是第三方接口,所以当调用失败后,一般再调第二次,如果两次都失败,则提示:收件服务请求失败,请将文件拍照保存,在业务系统进行收件补录。
测试host:待提供
-
页面设计图
-
业务处理步骤
- 第一步:调用获取令牌接口
- GET /sword/call/getAppToken/yzgjjwt/ztpad
- 返回示例
{ "code": 200, "message": "获取令牌成功", "data": { "tokenName": "nsauthorization", "user": { "appId": "bzgjjwt", "NAME": "wt" }, "tokenValue": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzd29yZCI6IjMwZWM0MDg1ODczZDMzMDMzYmQyZWNlYzQ1OTBjNTYwZmNmZTlmYjQxODA2MTMyYzI3YjAxMzI5YmI1N2E1ZjJjYzhkNjBiMzZhNmZhNTY5MDE0YjFkOTJmZWJiZDY0ZmRhNDcxYWEwOWMyMTJlNTFmMDJjZjYxMTc3Y2Y2M2Y3IiwiZXhwIjoxNjU4MjE0MTQ5LCJpYXQiOjE2NTgyMTIzNDksIk5BTUUiOiJ3dCJ9.pXzNMctG8Y3LHvxlYfy3vfgSSZFdBD8SaJvHcreceyw" } } - code:200 ok;201 created;401 Unauthorized;403 Forbidden;404 Not Found
- 获取tokenValue,作为令牌,后续的接口都需要用到
- GET /sword/call/getAppToken/yzgjjwt/ztpad
-
第二步:调用接口创建档案,并获取档案采集页面的地址
- POST /sword/wt/GetCreateDataAction
- header(下面接口都要加): nsauthorization=令牌;secret=
-
body示例
{ "AJTM": "张三", //姓名 "BLQD": "ztpad", //固定值:ztpad "DWMC": "", "DWZH": "", "GRXM": "张三", //还是姓名 "HDDZ": "", "JKLX": "scan/query", //收件是scan,查询是query "SFZH": "358459199005263215", //身份证号 "YWBLJGDM": "999", //业务办理机构 "YWLSH": "20220719001", //提取表主键 "YWLXDM": "WT001", //收件类型,根据业务类型到收件业务类型表中找对应收件类型 "YWRQ": "20220719", //当前日期,格式如示例 "YWSSJGDM": "999" //还是业务办理机构 } -
返回示例
{ "code": 200, "data": "http://localhost:81/mobileVue?uuid=ed20d7d6-6674-494d-9620-0e2f339dbcce", "message": "创建档案成功" } 获取data提请的地址,打开网页
-
第三步:提交(点击提交按钮)
-
检查上传图片数量
- 接口: POST /sword/wt/GetFileNumAction
-
body 示例
{ "YWLSH": "20220719001", //提取表主键 "YWLXDM": "WT001" //收件类型 } -
返回 示例
{ "code": 200, "data": 1, "message": "获取成功" } 如果data == 0,提示:未搜索到扫描图片,请先上传图片;否则,下一步。
-
提交
- 接口:/sword/wt/CheckUpDataAction
- 请求body示例
{ "YWLSH": "20220719001", "YWLXDM": "WT001" } - 返回示例
{ "code": 200, "data": {}, "message": "同步成功" } - 提交成功后,收件流程结束
- 接口:/sword/wt/CheckUpDataAction
-
- 第一步:调用获取令牌接口