Skip to content

finstone-yangzhou / finstone-yangzhou-doc

Go to a project
Commit c037b36c by zim78
Options

no message

1 parent 8c4a16e2
Inline Side-by-side
Showing with 128 additions and 74 deletions
sj.md
......@@ -4,81 +4,121 @@
# 收件
1. 业务流程图
<a href='web/tx_workflow.png' target='blank'><img height='600px' src='web/tx_workflow.png'/></a>
1. 接口文档中的接口调用流程
（040201）公积金提取校验
（020108）基本信息查询检查是否绑定银行卡
（040219）校验是否存在预约申请
（020108）基本信息查询
（040209）提交保存
---
1. 业务处理步骤
1. 第一步：公积金提取校验
1. 调用<a href='client_interface.md#i_040201' target='blank'>（040201）公积金提取校验接口</a>
1. 校验成功，进入下一步；校验失败，则提示错误信息，并中止流程。
1. 第二步：校验是否存在预约申请
1. 调用<a href='client_interface.md#i_040219' target='blank'>（040219）校验是否存在预约申请</a>
1. 校验成功，进入下一步；校验失败，则提示错误信息，并中止流程。
1. 第三步：提取职工基本信息，并展示
1. 调用<a href='client_interface.md#i_020108' target='blank'>（020108）基本信息查询</a>，在应答报文中获取职工基本信息。
1. 将职工基本信息展示在第一个页面，并审核
1. 页面设计图
<a href='web/tx_1.jpg' target='blank'><img height='600px' src='web/tx_1.jpg'/></a>
1. 页眉的办理人信息：姓名和证件号码取自（010101）职工身份认证接口的username和zjhm
1. 页面元素与接口元素对应关系
<table width='100%'>
<tr align='left'><th width='20%'>页面元素名称(字段名)</th><th width='10%'>对应接口</th><th width='10%'>对应英文名称</th><th width='50%'>操作</th><th width='10%'>位置（行，列）</th></tr>
<tr align='left'><td>职工账号（grzh）</td><td>（020108） </td><td>grzh</td><td>只读</td><td>1,1</td></tr>
<tr align='left'><td>姓名（xm）</td><td>（020108）</td><td>xm</td><td>只读</td><td>1,2</td></tr>
<tr align='left'><td>证件号码（zjhm）</td><td>（020108）</td><td>zjhm</td><td>只读</td><td>1,3</td></tr>
<tr align='left'><td>个人账户状态（grzhztmc）</td><td>（020108）</td><td>grzhztmc</td><td>只读</td><td>2,1</td></tr>
<tr align='left'><td>汇缴年月（hjny）</td><td>020108</td><td>hjny</td><td>只读</td><td>2,2</td></tr>
<tr align='left'><td>手机号码（sjh）</td><td>（020108）</td><td>sjh</td><td>只读</td><td>2,3</td></tr>
<tr align='left'><td>账户余额（grzhye）</td><td>（040201）</td><td>grzhye</td><td>只读</td><td>3,1</td></tr>
<tr align='left'><td>补贴余额（btye）</td><td>（040201）</td><td>btye</td><td>只读</td><td>3,2</td></tr>
<tr align='left'><td>合计余额（hjye）</td><td></td><td></td><td>账户余额与补贴余额的合计计算值，只读</td><td>3,3</td></tr>
<tr align='left'><td>所属机构（orgname）</td><td>（040201）</td><td>orgname</td><td>只读</td><td>4,1</td></tr>
<tr align='left'><td>单位名称（dwmc） </td><td>（020108）</td><td>dwmc</td><td>只读</td><td>4,2</td></tr>
</table>
1. 该页面为职工信息审核界面，均不可修改。审核确认后，点击【下一步】
1. 第四步：展示提取业务及结算信息
1. 页面设计图
<a href='web/tx_2.jpg' target='blank'><img height='600px' src='web/tx_2.jpg'/></a>
1. 页面元素与接口元素对应关系
1. 收件不是单独的业务功能，是提取业务保存后的后续步骤
1. 从提取业务传递过来的数据项
<table width='100%'>
<tr align='left'><th width='20%'>页面元素名称（字段名）</th><th width='10%'>对应接口</th><th width='10%'>对应英文名称</th><th width='50%'>操作</th><th width='10%'>位置（行，列）</th></tr>
<tr align='left'><td>账户余额（grzhye）</td><td>（040201）</td><td>grzhye</td><td>只读</td><td>1,1</td></tr>
<tr align='left'><td>补贴余额（btye）</td><td>（040201）</td><td>btye</td><td>只读</td><td>1,2</td></tr>
<tr align='left'><td>合计余额（hjye）</td><td></td><td></td><td>账户余额与补贴余额的合计计算值，只读</td><td>1,3</td></tr>
<tr align='left'><td>银行名称（kzyh）</td><td>（020108）</td><td>kzyh</td><td>下拉选择（默认赋值kzyh）</td><td>2,1</td></tr>
<tr align='left'><td>银行卡号（kzhm）</td><td>（020108）</td><td>kzhm</td><td>录入(默认赋值kzhm)</td><td>2,2</td></tr>
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
<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>（020108）orgcode</td></tr>
<tr align='left'><td>提取表主键</td><td>保存接口返回主键</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第五步：提交保存
1. 保存接口
1. 调用<a href='client_interface.md#i_040209' target='blank'>（040209）提取保存接口</a>
1. 请求报文body中元素赋值
1. 收件业务类型
<table width='100%'>
<tr align='left'><th width='10%'>信息项英文名称</th><th width='10%'>信息项名称</th><th width='60%'>赋值</th></tr>
<tr align='left'><td>transcode</td><td>交易代码</td><td>固定值：040209</td></tr>
<tr align='left'><td>grzh</td><td>职工账号</td><td>（020108）grzh</td></tr>
<tr align='left'><td>dwzh</td><td>单位账号</td><td>（020108）dwzh</td></tr>
<tr align='left'><td>xm</td><td>职工姓名</td><td>（020108）xm</td></tr>
<tr align='left'><td>ywlx</td><td>提取类型</td><td>固定值：1201</td></tr>
<tr align='left'><td>tqsd</td><td>提取时点</td><td>自动生成当前时间年月，例：2019.05</td></tr>
<tr align='left'><td>skrkh</td><td>收款人卡号</td><td>（020108）kzhm</td></tr>
<tr align='left'><td>tqgjj</td><td>提取公积金金额</td><td>（040201）grzhye</td></tr>
<tr align='left'><td>tqbt</td><td>提取补贴金额</td><td>(040201)btye</td></tr>
<tr align='left'><td>tqzje</td><td>提取总金额</td><td>hjye</td></tr>
<tr align='left'><td>bzsm</td><td>备注说明</td><td>bzsm</td></tr>
<tr align='left'><td>blrsjhm</td><td>办理人手机号码</td><td>（020108）sjh</td></tr>
<tr align='left'><td>skrkhh</td><td>收款人开户行</td><td>kzyh</td></tr>
<tr align='left'><td>sfgjjdk</td><td>是否公积金贷款</td><td>不传</td></tr>
<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>
</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
txtq.md
......@@ -78,3 +78,15 @@
1. 第六步：收件
1. 只有在第三步，点击了【下一步（需收件）】，才会进入第六步；否则直接到第七步
<a href='sj.md' target='blank'>收件说明文档</a>
1. 第七步：完成
1. 页面示意图
<a href='web/tx_4.jpg' target='blank'><img height='600px' src='web/tx_4.jpg'/></a>
1. 如果在第三步，选择了【下一步（需收件）】，则弹出收件窗口进行收件流程
<a href='sj.md' target='blank'>收件流程说明文档</a>
1. 提示：尊敬的xxx职工，您的xxxx业务已完成
【扬州公积金】
1. 点击【继续办理业务】，返回个人主页
1. 点击【结束并退出】
1. 二次提醒
<a href='web/tx_5.jpg' target='blank'><img height='600px' src='web/tx_5.jpg'/></a>
1. 返回首页
\ No newline at end of file
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!