Skip to content

finstone-yangzhou / finstone-yangzhou-doc

Go to a project
Commit f6666691 by zim78
Options

no message

1 parent b094fec4
Inline Side-by-side
Showing with 38 additions and 127 deletions
业务查询_单位流水查询.md 0 → 100644
<a name='dstart'></a>
<a name='dstart'></a>
<a name='position'></a>
# 单位流水查询
1. 分两步：第一步（单位查询），第二步业务查询
## 第一步（单位查询）
<a href='单位业务查询模块第一步.md' target='blank'>单位业务查询第一步文档
## 第二步（业务查询）
1. 数据接口：<a href='client_interface.md#i_205020222' target='blank'>（205020222）根据单位账号查询单位流水账</a>
\ No newline at end of file
单位业务查询模块.md deleted 100644 → 0
<a name='dstart'></a>
<a name='dstart'></a>
<a name='position'></a>
# 收件
1. 收件不是单独的业务功能，是提取业务保存后的后续步骤，因为每个提取流程都会用到，所以单独
1. 从提取业务传递过来的数据项
<table width='100%'>
<tr align='left'><th width='10%'>信息项名称</th><th width='60%'>赋值</th></tr>
<tr align='left'><td>职工姓名</td><td>（020108）xm</td></tr>
<tr align='left'><td>身份证号</td><td>（020108）zjhm</td></tr>
<tr align='left'><td>业务办理机构</td><td>登录操作员的orgcode</td></tr>
<tr align='left'><td>提取表主键</td><td>提取保存接口返回提取表主键或单位开户返回的单位账号</td></tr>
</table>
1. 收件业务类型
<table width='100%'>
<tr align='left'><th width='30%'>业务名称</th><th width='10%'>业务类型</th><th width='60%'>收件类型</th></tr>
<tr align='left'><td>购买商品房提取</td><td>1103</td><td>T1</td></tr>
<tr align='left'><td>购买二手房提取</td><td>1104</td><td>T2</td></tr>
<tr align='left'><td>租房提取</td><td>1113</td><td>T8</td></tr>
<tr align='left'><td>结清公积金贷款提取</td><td>1121</td><td>CD</td></tr>
<tr align='left'><td>部分冲还公积金贷款提取</td><td>1122</td><td>TA</td></tr>
<tr align='left'><td>一年两次还商贷</td><td>1131</td><td>TB</td></tr>
<tr align='left'><td>退休提取</td><td>1201</td><td>TF</td></tr>
<tr align='left'><td>封存提取</td><td>1202</td><td>TG</td></tr>
<tr align='left'><td>单位开户</td><td>0301</td><td>BB</td></tr>
</table>
1. 收件调用的是第三方的接口，所以收件接口的host最好放在配置文件中，以方便修改。
1. 下面的接口，因为是第三方接口，所以当调用失败后，一般再调第二次，如果两次都失败，则提示：收件服务请求失败，请将文件拍照保存，在业务系统进行收件补录。
1. 测试host:待提供
1. 页面设计图
<a href='web/tx_3.jpg' target='blank'><img height='400px' src='web/tx_3.jpg'/></a>
---
1. 业务处理步骤
1. 第一步：调用获取令牌接口
1. GET /sword/call/getAppToken/yzgjjwt/ztpad
1. 返回示例
```
{
"code": 200,
"message": "获取令牌成功",
"data": {
"tokenName": "nsauthorization",
"user": {
"appId": "bzgjjwt",
"NAME": "wt"
},
"tokenValue": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzd29yZCI6IjMwZWM0MDg1ODczZDMzMDMzYmQyZWNlYzQ1OTBjNTYwZmNmZTlmYjQxODA2MTMyYzI3YjAxMzI5YmI1N2E1ZjJjYzhkNjBiMzZhNmZhNTY5MDE0YjFkOTJmZWJiZDY0ZmRhNDcxYWEwOWMyMTJlNTFmMDJjZjYxMTc3Y2Y2M2Y3IiwiZXhwIjoxNjU4MjE0MTQ5LCJpYXQiOjE2NTgyMTIzNDksIk5BTUUiOiJ3dCJ9.pXzNMctG8Y3LHvxlYfy3vfgSSZFdBD8SaJvHcreceyw"
}
}
```
1. code:200 ok;201 created;401 Unauthorized;403 Forbidden;404 Not Found
1. 获取tokenValue，作为令牌，后续的接口都需要用到
1. 第二步:调用接口创建档案，并获取档案采集页面的地址
1. POST /sword/wt/GetCreateDataAction
1. header(下面接口都要加): nsauthorization=令牌；secret=
1. 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" //还是业务办理机构
}
```
1. 返回示例
```
{
"code": 200,
"data": "http://localhost:81/mobileVue?uuid=ed20d7d6-6674-494d-9620-0e2f339dbcce",
"message": "创建档案成功"
}
```
1. 获取data提请的地址，打开网页
1. 第三步：提交（点击提交按钮）
1. 检查上传图片数量
1. 接口： POST /sword/wt/GetFileNumAction
1. body 示例
```
{
"YWLSH": "20220719001", //提取表主键
"YWLXDM": "WT001" //收件类型
}
```
1. 返回 示例
```
{
"code": 200,
"data": 1,
"message": "获取成功"
}
```
1. 如果data == 0,提示：未搜索到扫描图片，请先上传图片；否则，下一步。
1. 提交
1. 接口：/sword/wt/CheckUpDataAction
1. 请求body示例
```
{
"YWLSH": "20220719001",
"YWLXDM": "WT001"
}
```
1. 返回示例
```
{
"code": 200,
"data": {},
"message": "同步成功"
}
```
1. 提交成功后，收件流程结束
\ No newline at end of file
单位业务查询模块第一步.md 0 → 100644
<a name='dstart'></a>
<a name='dstart'></a>
<a name='position'></a>
# 第一步（单位查询）
1. 界面示意图
<a href='web/zhbd.jpg' target='blank'><img height='600px' src='web/zhbd.jpg'/></a>
1. 界面元素
1. 筛选项：单位名称（手工输入，不能为空）
1. 按钮：查询。位置在单位名称输入框右边，点击后，调用接口提取单位列表
1. 单位列表：
<table width='100%'>
<tr align='left'><th width='10%'>信息项名称</th><th width='10%'>赋值</th><th width='800%'>说明</th></tr>
<tr align='left'><td>单位账号</td><td>（205020221）单位账号</td><td>位置：第一行，占一列</td></tr>
<tr align='left'><td>单位名称</td><td>（205020221）dwmc</td><td>位置：第一行，占两列</td></tr>
<tr align='left'><td>法人姓名</td><td>（205020221）dwfrdbxm</td><td>位置：第二行，占一列</td></tr>
<tr align='left'><td>单位地址</td><td>（205020221）dwdz</td><td>位置：第二行，占两列</td></tr>
</table>
1. 单位列表查询接口：<a href='client_interface.md#i_205020221' target='blank'>（205020221）根据单位名称查询单位信息
1. 因为接口没有分页设置，如果返回数据量太大，取前100个展示
1. 选择单位后，记录所选单位的dwzh
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!