Skip to content

finstone-yangzhou / finstone-yangzhou-doc

Go to a project
Commit 4b658f29 by zim78
Options

no message

1 parent 4d7c9a0e
Inline Side-by-side
Showing with 76 additions and 97 deletions
client_hessian.md
......@@ -10,6 +10,7 @@
FrameInvokeServiceClient client = new FrameInvokeServiceClient();
//此处填写公积金中心的服务地址
//测试服地址：192.168.100.103:7001/esb_wl_test
client.setUrl("http://xxxxxxxxxx/esb/service/invokeService);
client.setEncode("GBK");
......
client_interface.md
......@@ -175,12 +175,12 @@
<tr align='left'><td>transcode</td><td>交易代码</td><td>020912</td></tr>
<tr align='left'><td>cardcode</td><td>证件号码</td><td>主贷人的证件号码</td></tr>
<tr align='left'><td>codetype</td><td>证件类型</td><td>固定值：01</td></tr>
<tr align='left'><td>pername</td><td>个人姓名</td><td></td></tr>
<tr align='left'><td>agrcode</td><td>借款合同号</td><td></td></tr>
<tr align='left'><td>bkloanacc</td><td>银行商贷账户</td><td></td></tr>
<tr align='left'><td>pername</td><td>个人姓名</td><td>主贷人的姓名</td></tr>
<tr align='left'><td>agrcode</td><td>借款合同号</td><td>不输入</td></tr>
<tr align='left'><td>bkloanacc</td><td>银行商贷账户</td><td>不输入</td></tr>
<tr align='left'><td>fristno</td><td>起始行号</td><td>固定值：1</td></tr>
<tr align='left'><td>resultSize</td><td>最多返回笔数</td>固定值：20<td></td></tr>
<tr align='left'><td>yhbz</td><td>银行标志</td><td>040204对应字段</td></tr>
<tr align='left'><td>yhbz</td><td>银行标志</td><td>040224接口的dm</td></tr>
<tr align='left'><td>accounttype</td><td>是否一类账户</td><td>固定值：1</td></tr>
</table>
1. body示例
......
（一年两次还商贷绑定）ynlchsdbd.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -2,38 +2,17 @@
<a name='position'></a>
# 1. 一年两次还商贷提取
# 一年两次还商贷绑定
---
1. 步骤：此业务与其他业务不同，有4步：职工基本信息，选择银行商贷，商贷详情，完成
1. 业务处理步骤
1. 第一步：公积金提取校验
1. 调用<a href='client_interface.md#i_040201' target='blank'>（040201）公积金提取校验接口</a>
1. 校验成功： 判断sfbdsd，等于0，提示：未绑定商贷，请先完成一年两次还商贷绑定。终止流程；否则，进入下一步；
1. 校验失败，则提示错误信息，并中止流程。
1. 第二步：商贷查询贷款已还金额
1. 调用<a href='client_interface.md#i_020913' target='blank'>（020913）商贷查询贷款已还金额请求</a>
1. 返回失败，则提示错误信息，并中止流程。
1. 返回成功：
1. 查询结构无数据（total==0），提示：商贷查询异常！未查询到已还金额数据。终止流程
1. 若查询结果有数据，出参payedmny为空或null，提示“未查询到您的还款金额”，并结束
1. 计算最大可提取金额，（sdytqje、gjjkyye、gjjbtye值取自040201接口，payedmny出自020913接口）
```
if((payedmny-sdytqje)>(gjjkyye+gjjbtye)){
最大可提取金额= gjjkyye+gjjbtye;
}else{
最大可提取金额= payedmny-sdytqje;
}
```
最大可提取金额显示整百，提取金额也控制在为整百
若最大可提取金额小于等于0，则提示"报帐额度已用完，请于下个报帐期办理"，并结束
1. 第三步：校验是否存在预约申请
1. 调用<a href='client_interface.md#i_040219' target='blank'>（040219）校验是否存在预约申请</a>
1. 校验成功，进入下一步；校验失败，则提示错误信息，并中止流程。
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>
<a href='web/tx_1_1.jpg' target='blank'><img height='600px' src='web/tx_1_1.jpg'/></a>
1. 页眉的办理人信息：姓名和证件号码取自（010101）职工身份认证接口的xm和zjhm
1. 页面元素与接口元素对应关系
<table width='100%'>
......@@ -41,64 +20,63 @@
<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>账户可用余额（gjjkyye）</td><td>（040201）</td><td>gjjkyye</td><td>只读</td><td>3,1</td></tr>
<tr align='left'><td>补贴可用余额（gjjbtye）</td><td>（040201）</td><td>gjjbtye</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>
<tr align='left'><td>手机号码（sjh）</td><td>（020108）</td><td>sjh</td><td>只读</td><td>2,1</td></tr>
<tr align='left'><td>所属机构（orgname）</td><td>（020108）</td><td>orgname</td><td>只读</td><td>2,2</td></tr>
<tr align='left'><td>单位名称（dwmc） </td><td>（020108）</td><td>dwmc</td><td>只读</td><td>2,3</td></tr>
<tr align='left'><td>是否主贷人（sfzdr）</td><td></td><td></td><td>下拉选择（0-否，1-是），默认为1</td><td>2,1</td></tr>
<tr align='left'><td>主贷人姓名（pername）</td><td></td><td></td><td>输入</td><td>2,2</td></tr>
<tr align='left'><td>主贷人姓名证件号码（cardcode） </td><td></td><td></td><td>输入</td><td>2,3</td></tr>
</table>
1. 当是否主贷人选择是，主贷人姓名和主贷人证件号码默认为xm和zjhm，并只读；当是否主贷人选择否，主贷人姓名和主贷人证件号码清空，并可输入
1. 点击下一步
1. 校验：主贷人姓名和主贷人证件号码不能为空
1. 如果是否主贷人选择否， 调用<a href='client_interface.md#i_020923' target='blank'>（020923）婚姻登记信息查询</a>，其中zjhm传zjhm,pozjhm传cardcode。返回检查sfyh，如果等于0，提示：婚姻验证失败。并中止流程，等待用户重新输入主贷人证件号码。否则，下一步。
1. 第二步：选择贷款账户
1. 页面设计示意图
<a href='web/zhbd.jpg' target='blank'><img height='600px' src='web/zhbd.jpg'/></a>
调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询</a>（flag=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>贷款银行（yhbz）</td><td>040224</td><td></td><td>下拉选择，（040224）返回的银行列表</td><td>1,1</td></tr>
</table>
1. 该页面为职工信息审核界面，均不可修改。审核确认后，点击【下一步】
1. 第五步：展示提取业务及结算信息
1. 选择银行后，调用<a href='client_interface.md#i_020912' target='blank'>（020912）商贷查询贷款合同</a>，获取商贷列表。
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>借款合同号（agrcode）</td><td>020912</td><td>agrcode</td><td>只读</td><td>1,1</td></tr>
<tr align='left'><td>贷款账户（loancode）</td><td>020912</td><td>loancode</td><td>只读</td><td>1,2</td></tr>
<tr align='left'><td>贷款金额(loanmny)</td><td>020912</td><td>loanmny</td><td>只读</td><td>1,3</td></tr>
<tr align='left'><td>月还款额(mntpay)</td><td>020912</td><td>mntpay</td><td>只读</td><td>2,1</td></tr>
<tr align='left'><td>贷款开始时间(bdate)</td><td>020912</td><td>bdate</td><td>只读</td><td>2,2</td></tr>
<tr align='left'><td>贷款结束时间(edate)</td><td>020912</td><td>edate</td><td>只读</td><td>2,3</td></tr>
</table>
1. 下一步
1. 若没有选择商贷，提示：“请在商贷列表里选择一条数据”。否则，下一步。
1. 第三步：
1. 页面设计示意图
<a href='web/tx_2.jpg' target='blank'><img height='600px' src='web/tx_2.jpg'/></a>
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>账户可用余额（gjjkyye）</td><td>（040201）</td><td>gjjkyye</td><td>只读</td><td>1,1</td></tr>
<tr align='left'><td>补贴可用余额（gjjbtye）</td><td>（040201）</td><td>gjjbtye</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>提取金额（tqje）</td><td></td><td></td><td>输入，数值，必填，默认为hjye</td><td>2,1</td></tr>
<tr align='left'><td>银行名称（kzyh）</td><td>（020108）</td><td>kzyh</td><td>下拉选择（默认赋值kzyh）</td><td>2,2</td></tr>
<tr align='left'><td>银行卡号（kzhm）</td><td>（020108）</td><td>kzhm</td><td>录入(默认赋值kzhm)</td><td>2,3</td></tr>
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第六步：提交保存
1. 校验提取金额
1. 提取金额不能超过最大可提取金额
1. 设置两个变量，（提取公积金金额）tqgjj和（提取补贴金额）tqbt。如果提取金额 <= 补贴可用余额,则tqbt=提取金额,tqgjj=0;如果提取金额 > 补贴可用余额,则tqbt=补贴可用余额,tqgjj=提取金额 - 补贴可用余额。
1. 保存接口
1. 下一步（零材料）：调用<a href='client_interface.md#i_040209' target='blank'>（040209）提取保存接口</a>
1. 下一步（需收件）：暂缺
1. 请求报文body中元素赋值
<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>固定值：1104</td></tr>
<tr align='left'><td>tqsd</td><td>提取时点</td><td>自动生成当前时间年月，例：2019.05</td></tr>
<tr align='left'><td>skrkh</td><td>收款人卡号</td><td>银行卡号kzhm</td></tr>
<tr align='left'><td>tqgjj</td><td>提取公积金金额</td><td>tqgjj变量</td></tr>
<tr align='left'><td>tqbt</td><td>提取补贴金额</td><td>tqbt变量</td></tr>
<tr align='left'><td>tqzje</td><td>提取总金额</td><td>tqje</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>dkhth</td><td>贷款合同号</td><td>（040201）agrcode</td></tr>
<tr align='left'><td>sdychje</td><td>商贷已偿还金额</td><td>（020913）payedmny</td></tr>
<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>贷款银行（yhbz）</td><td></td><td></td><td>下拉选择的dm</td><td>1,1</td></tr>
<tr align='left'><td>借款合同号（agrcode）</td><td>选择的商贷记录</td><td>agrcode</td><td>只读</td><td>1,1</td></tr>
<tr align='left'><td>贷款账户（loancode）</td><td>选择的商贷记录</td><td>loancode</td><td>只读</td><td>1,2</td></tr>
<tr align='left'><td>借款人姓名(pername)</td><td>选择的商贷记录</td><td>pername</td><td>只读</td><td>2,2</td></tr>
<tr align='left'><td>贷款开始时间(bdate)</td><td>选择的商贷记录</td><td>bdate</td><td>只读</td><td>2,2</td></tr>
<tr align='left'><td>贷款结束时间(edate)</td><td>选择的商贷记录</td><td>edate</td><td>只读</td><td>2,3</td></tr>
<tr align='left'><td>贷款金额(loanmny)</td><td>选择的商贷记录</td><td>loanmny</td><td>只读</td><td>1,3</td></tr>
<tr align='left'><td>当前本金余额(loanbal)</td><td>选择的商贷记录</td><td>loanbal</td><td>只读</td><td>1,3</td></tr>
<tr align='left'><td>月还款额(mntpay)</td><td>选择的商贷记录</td><td>mntpay</td><td>只读</td><td>2,1</td></tr>
</table>
1. 第七步：完成
1. 第五步：提交保存
1. 保存接口
1. 调用<a href='client_interface.md#i_040225' target='blank'>（040225）一年两次还商贷绑定</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. 点击【继续办理业务】，返回个人主页
......
（提取管理_一年两次还商贷提取）ynlchsdtq_1131.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -66,7 +66,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第六步：提交保存
1. 校验提取金额
......
（提取管理_二手房提取）esftq_1104.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -54,7 +54,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>5,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 当是否需要公积金贷款发生变动后，都要重新调用<a href='client_interface.md#i_040201' target='blank'>（040201）公积金提取校验接口</a>，重新获取gjjkyye和gjjbtye，并回填到账户可用余额和补贴可用余额
1. 第五步：提交保存
......
（提取管理_封存半年提取）txtq_1202.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -48,7 +48,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第五步：提交保存
1. 保存接口
......
（提取管理_租房提取）zftq_1113.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -59,7 +59,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>4,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第七步：提交保存
1. 校验租房合同号
......
（提取管理_结清公积金贷款提取）jqtq_1121.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -52,7 +52,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第五步：提交保存
1. 校验提取金额
......
（提取管理_购买商品房提取）gftq_1103.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -53,7 +53,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>4,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 当是否需要公积金贷款发生变动后，都要重新调用<a href='client_interface.md#i_040201' target='blank'>（040201）公积金提取校验接口</a>，重新获取gjjkyye和gjjbtye，并回填到账户可用余额和补贴可用余额
1. 第五步：提交保存
......
（提取管理_退休提取）txtq_1201.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -48,7 +48,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第五步：提交保存
1. 保存接口
......
（提取管理_部分冲还公积金贷款提取）bfchtq_1122.md
<a name='dstart'></a>
<a name='dstart'></a>
......@@ -52,7 +52,7 @@
<tr align='left'><td>提取备注（bzsm）</td><td></td><td></td><td>手填</td><td>3,1</td></tr>
</table>
1. 职工未绑定银行卡
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>，获取银行列表并选择银行。
1. 银行名称变更为可选，调用<a href='client_interface.md#i_040224' target='blank'>（040224）商贷银行列表查询应答</a>（传fkyh=1），获取银行列表并选择银行。
1. 银行卡号变更为手填。
1. 第五步：提交保存
1. 校验提取金额
......
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!