Skip to content

finstone-yangzhou / finstone-yangzhou-doc

Go to a project
Commit f2768e83 by zim78
Options

no message

1 parent af24b17e
Inline Side-by-side
Showing with 158 additions and 2 deletions
client_interface.md
......@@ -58,6 +58,7 @@
------------------------
<a name='i_121020333'></a>
## 获取归集银行（121020333）
1. 交易代码（transcode）：121020333
......@@ -77,7 +78,29 @@
</table>
------------------------
<a name='i_121020331'></a>
## 字典查询（121020331）
1. 交易代码（transcode）：121020331
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>id</td><td>字典表id</td><td></td></tr>
</table>
1. 应答body信息项
<table width='100%'>
<tr align='left'><th width='20%'>信息项英文名称</th><th width='80%'>信息项名称</th></tr>
<tr align='left'><td>name</td><td>名称</td></tr>
<tr align='left'><td>dm</td><td>代码</td></tr>
</table>
------------------------
<a name='i_Z01010110'></a>
## 操作员登录认证（Z01010110）
1. 交易代码（transcode）：Z01010110
......@@ -120,6 +143,41 @@
</table>
------------------------
<a name='i_121040710'></a>
## 单位开户保存（121040710）
1. 交易代码（transcode）：121040710
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>orgcode</td><td>归集机构</td><td></td></tr>
<tr align='left'><td>ocid</td><td>归集银行</td><td></td></tr>
<tr align='left'><td>dwjcbl</td><td>单位缴存比例</td><td>范围：5-12</td></tr>
<tr align='left'><td>grjcbl</td><td>个人缴存比例</td><td>范围：5-12</td></tr>
<tr align='left'><td>dwmc</td><td>单位名称</td><td></td></tr>
<tr align='left'><td>dwdz</td><td>单位地址</td><td></td></tr>
<tr align='left'><td>dwfrdbxm</td><td>单位法人代表姓名</td><td></td></tr>
<tr align='left'><td>dwfrdbzjhm</td><td>单位法人代表身份证号码</td><td></td></tr>
<tr align='left'><td>dwlsgx</td><td>单位隶属关系</td><td>字典表id：DWLSGX</td></tr>
<tr align='left'><td>dwjjlx</td><td>单位经济类型</td><td>字典表id：JJLXFL</td></tr>
<tr align='left'><td>dwsshy</td><td>单位所属行业</td><td>字典表id：GMJJHY</td></tr>
<tr align='left'><td>dwxz</td><td>单位性质</td><td>字典表id：DWXZ</td></tr>
<tr align='left'><td>dwyb</td><td>单位邮编</td><td></td></tr>
<tr align='left'><td>zzjgdm</td><td>统一社会信用代码</td><td></td></tr>
<tr align='left'><td>jbrxm</td><td>经办人姓名</td><td></td></tr>
<tr align='left'><td>jbrsjhm</td><td>经办人手机号</td><td></td></tr>
<tr align='left'><td>jbrzjhm</td><td>经办人身份证号码</td><td></td></tr>
<tr align='left'><td>yhzh</td><td>受托银行账号</td><td></td></tr>
<tr align='left'><td>dwfxr</td><td>发薪日</td><td>范围：01-28</td></tr>
<tr align='left'><td>dwslrq</td><td>单位设立日期</td><td>格式：yyyy.mm.dd</td></tr>
<tr align='left'><td>btjcbl</td><td>补贴比例</td><td>范围：0 -30</td></tr>
</table>
1. 应答body信息项
返回成功，则保存成功；返回失败，则保存失败；
------------------------
<a name='i_010101'></a>
## 职工身份认证（010101）
......@@ -129,8 +187,6 @@
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>010101</td></tr>
<tr align='left'><td>type</td><td>类型</td><td>固定值：cas</td></tr>
<tr align='left'><td>logname</td><td>身份证号</td><td></td></tr>
<tr align='left'><td>xingming</td><td>姓名</td><td></td></tr>
......
（单位管理_单位开户）dwkh_121040710.md 0 → 100644
<a name='dstart'></a>
<a name='dstart'></a>
<a name='position'></a>
# 1. 单位开户
---
1. 业务分三步：单位基本信息、单位其他信息，完成
1. 业务处理步骤
1. 第一步：单位基本信息
1. 页面设计示意图
<a href='web/tx_1.jpg' target='blank'><img height='600px' src='web/tx_1.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>归集机构</td><td>121020332</td><td></td><td>下拉选择，必填</td><td>1,1</td></tr>
<tr align='left'><td>归集银行</td><td>121020333</td><td></td><td>下拉选择，必填</td><td>1,2</td></tr>
<tr align='left'><td>单位设立日期</td><td></td><td></td><td>日期选择，必填，格式：yyyy.mm.dd</td><td>1,3</td></tr>
<tr align='left'><td>单位名称</td><td></td><td></td><td>文本输入，必填（内容较长，需占2列）</td><td>2,1</td></tr>
<tr align='left'><td>统一社会信用代码</td><td></td><td></td><td>文本输入，必填</td><td>2,3</td></tr>
<tr align='left'><td>单位地址</td><td></td><td></td><td>文本输入，必填（内容较长，需占2列）</td><td>3,1</td></tr>
<tr align='left'><td>单位邮编</td><td></td><td></td><td>文本输入，必填</td><td>3,3</td></tr>
<tr align='left'><td>单位隶属关系</td><td>121020331</td><td></td><td>下拉选择，必填</td><td>4,1</td></tr>
<tr align='left'><td>单位法人代表姓名</td><td></td><td></td><td>文本输入，必填</td><td>4,2</td></tr>
<tr align='left'><td>单位法人代表身份证号码</td><td></td><td></td><td>文本输入，必填</td><td>4,3</td></tr>
</table>
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>单位经济类型</td><td>121020331</td><td></td><td>下拉选择，必填</td><td>1,1</td></tr>
<tr align='left'><td>单位所属行业</td><td>121020331</td><td></td><td>下拉选择，必填</td><td>1,2</td></tr>
<tr align='left'><td>单位性质</td><td>121020331</td><td></td><td>下拉选择，必填</td><td>1,3</td></tr>
<tr align='left'><td>经办人姓名</td><td></td><td></td><td>文本输入，必填</td><td>2,1</td></tr>
<tr align='left'><td>经办人手机号</td><td></td><td></td><td>文本输入，必填</td><td>2,2</td></tr>
<tr align='left'><td>经办人身份证号码</td><td></td><td></td><td>文本输入，必填</td><td>2,3</td></tr>
<tr align='left'><td>单位缴存比例</td><td></td><td></td><td>数字输入，必填，范围：5-12</td><td>3,1</td></tr>
<tr align='left'><td>个人缴存比例</td><td></td><td></td><td>数字输入，必填，范围：5-12</td><td>3,2</td></tr>
<tr align='left'><td>补贴比例</td><td></td><td></td><td>文本输入，必填，范围：0 -30</td><td>3,3</td></tr>
<tr align='left'><td>受托银行账号</td><td></td><td></td><td>文本输入，必填</td><td>4,1</td></tr>
<tr align='left'><td>发薪日</td><td></td><td></td><td>文本输入，必填，范围：01-28</td><td>4,2</td></tr>
</table>
1. 职工未绑定银行卡
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. 第五步：提交保存
1. 检查是否已经选择了是否需要公积金贷款
1. 校验是否购房
1. 调用<a href='client_interface.md#i_020922' target='blank'>（020922）大数据查询商品房</a>
1. 参数中的合同编号，就是备案合同号
1. 返回失败，提示：查询商品房信息失败。并中止流程
1. 返回成功，判断sfgf，如果等于0，提示：没有查询到购房信息。并中止流程；如果等于1，检查gfnf（购房年份），当gfnf<去年，提示：目前仅支持近两年的备案合同。并中止流程。否则下一步；
1. 购商品房二手房校验
1. 调用<a href='client_interface.md#i_040220' target='blank'>（040220）购房、二手房提取校验</a>
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>固定值：1103</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>sfgjjdk</td><td>是否公积金贷款</td><td>sfxdk</td></tr>
<tr align='left'><td>gfqy</td><td>购房区域</td><td>gfqy</td></tr>
<tr align='left'><td>bahth</td><td>备案合同号</td><td>bahth</td></tr>
</table>
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!