Skip to content

finstone-yangzhou / finstone-yangzhou-doc

Go to a project
Commit f3b1c3fc by zim78
Options

no message

1 parent 5fed9109
Inline Side-by-side
Showing with 291 additions and 79 deletions
client_hessian.md
...@@ -86,7 +86,8 @@ ...@@ -86,7 +86,8 @@
"ywcode":"999", "ywcode":"999",
}, },
"list":"" "list":""
}``` }
```
1. 应答body 1. 应答body
1. 信息项 1. 信息项
<table width='100%'> <table width='100%'>
......
client_interface.md
<a name='dstart'></a> <a name='interface'></a>
# 各业务接口交易代码（transcode）及body描述
<a name='position'></a>
<a name='i_baseinfo'></a>
# 前端调用接口
--- ## 职工身份认证（010101）
1. 调用服务端接口需通过富深开发的jar包访问接口
1. 开发示例（java示例） 1. 交易代码（transcode）：010101
```//作为客户端发送过程测试 1. 请求body
FrameInvokeServiceClient client = new FrameInvokeServiceClient(); 1. 信息项
<table width='100%'>
//此处填写公积金中心的服务地址 <tr align='left'><th width='10%'>信息项英文名称</th><th width='10%'>信息项名称</th><th width='60%'>描述</th></tr>
client.setUrl("http://xxxxxxxxxx/esb/service/invokeService); <tr align='left'><td>transcode</td><td>交易代码</td><td>010101</td></tr>
client.setEncode("GBK"); <tr align='left'><td>type</td><td>类型</td><td>固定值：cas</td></tr>
<tr align='left'><td>logname</td><td>身份证号</td><td></td></tr>
//invoke方法完成 编码压缩、发送、获得返回报文、解压和签名对比 <tr align='left'><td>xingming</td><td>姓名</td><td></td></tr>
//retxml是获得的返回明文 </table>
String retxml = client.invoke("发送json报文明文"); 1. body示例
```
System.out.println(retxml); {
"head":{
1. 报文格式示例 "type": "cas",
"logname":"320382199504285013",
``` "xingming":"张三"
{ },
"head"：{ "list":""
"appid":"78", }
"transcode":"010101", ```
"trantime":"20110710150312", 1. 应答body信息项
"iseqno":"201107101503120011"
<table width='100%'>
<tr align='left'><th width='20%'>信息项英文名称</th><th width='80%'>信息项名称</th></tr>
<tr align='left'><td>username</td><td>用户姓名</td></tr>
<tr align='left'><td>userid</td><td>用户ID（职工账号）</td></tr>
<tr align='left'><td>dwzh</td><td>单位账户</td></tr>
<tr align='left'><td>dwmc</td><td>单位名称</td></tr>
<tr align='left'><td>password</td><td>密码</td></tr>
<tr align='left'><td>hjny</td><td>汇缴年月</td></tr>
<tr align='left'><td>curday</td><td>当前时间</td></tr>
<tr align='left'><td>firstdayformonth</td><td>每个月第一天</td></tr>
<tr align='left'><td>lastdayformonth</td><td>每个月最后一天</td></tr>
<tr align='left'><td>zjhm</td><td>身份证号</td></tr>
<tr align='left'><td>xm</td><td>姓名</td></tr>
<tr align='left'><td>sjhm</td><td>手机号码</td></tr>
</table>
## 基本信息查询（020108）
1. 交易代码（transcode）：020108
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>020108</td></tr>
<tr align='left'><td>grzh</td><td>职工账号</td><td></td></tr>
<tr align='left'><td>ishj</td><td>是否合计</td><td>固定值：0</td></tr>
<tr align='left'><td>sjqx_ywzl</td><td>业务查询所需字段</td><td>固定值：GJGL_CX</td></tr>
<tr align='left'><td>qxfw</td><td>业务查询所需字段</td><td>固定值：0</td></tr>
<tr align='left'><td>sjqx_hslx</td><td>业务查询所需字段</td><td>固定值：GJJ</td></tr>
</table>
1. body示例
```
{
"head":{
"grzh": "职工账号",
"ishj":"0",
"sjqx_hslx":"GJJ",
"qxfw":"0",
"sjqx_ywzl":"GJGL_CX",
"ywcode":"999",
},
"list":""
}
```
1. 应答body信息项
<table width='100%'>
<tr align='left'><th width='20%'>信息项英文名称</th><th width='80%'>信息项名称</th></tr>
<tr align='left'><td>dwzh</td><td>单位账号</td></tr>
<tr align='left'><td>dwmc</td><td>单位名称</td></tr>
<tr align='left'><td>orgname</td><td>管理部</td></tr>
<tr align='left'><td>grzh</td><td>职工账号</td></tr>
<tr align='left'><td>xm</td><td>职工姓名</td></tr>
<tr align='left'><td>zjhm</td><td>身份证号</td></tr>
<tr align='left'><td>sjh</td><td>手机号码</td></tr>
<tr align='left'><td>sex</td><td>性别</td></tr>
<tr align='left'><td>grzhye</td><td>账户余额</td></tr>
<tr align='left'><td>grzhztmc</td><td>汇缴状态</td></tr>
<tr align='left'><td>khrq</td><td>开户日期</td></tr>
<tr align='left'><td>hjny</td><td>最近汇缴年月</td></tr>
<tr align='left'><td>gzjs</td><td>工资基数</td></tr>
<tr align='left'><td>yje</td><td>月缴额</td></tr>
<tr align='left'><td>dwjjl</td><td>单位缴存比例</td></tr>
<tr align='left'><td>zgjjl</td><td>职工缴存比例</td></tr>
<tr align='left'><td>sfdk</td><td>是否贷款</td></tr>
<tr align='left'><td>schjny</td><td>首次汇缴年月</td></tr>
<tr align='left'><td>lxdz</td><td>联系地址</td></tr>
<tr align='left'><td>lxdh</td><td>联系电话</td></tr>
<tr align='left'><td>btye</td><td>补贴余额</td></tr>
<tr align='left'><td>btyje</td><td>个人补贴月缴额</td></tr>
<tr align='left'><td>yjce</td><td>月缴存额总和</td></tr>
<tr align='left'><td>hjze</td><td>合计总额</td></tr>
<tr align='left'><td>gryjce</td><td>公积金月缴额</td></tr>
<tr align='left'><td>tqlx</td><td>提取利息</td></tr>
<tr align='left'><td>btlx</td><td>补贴利息</td></tr>
<tr align='left'><td>orgcode</td><td>管理部代码</td></tr>
<tr align='left'><td>ocid</td><td>归集银行id</td></tr>
<tr align='left'><td>ocname</td><td>归集银行</td></tr>
<tr align='left'><td>kzyh</td><td>卡折银行</td></tr>
<tr align='left'><td>kzhm</td><td>卡折号码</td></tr>
</table>
## 大数据商品房信息查询（020922）
1. 交易代码（transcode）：020922
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>020922</td></tr>
<tr align='left'><td>zjhm</td><td>职工身份证</td><td></td></tr>
<tr align='left'><td>htbh</td><td>合同编号</td><td></td></tr>
</table>
1. body示例
```
{
"head":{
"zjhm": "身份证号",
"htbh":"41251235"
}, },
"body":{ "list":""
}
```
1. 应答body信息项
<table width='100%'>
<tr align='left'><th width='20%'>信息项英文名称</th><th width='80%'>信息项名称</th></tr>
<tr align='left'><td>sfgf</td><td>是否购房（0 否 1 是） </td></tr>
<tr align='left'><td>xmkfs</td><td>开发商</td></tr>
<tr align='left'><td>txdz</td><td>通讯地址 本地才返回</td></tr>
<tr align='left'><td>lxdh</td><td>联系电话</td></tr>
<tr align='left'><td>xm</td><td>购房人姓名</td></tr>
<tr align='left'><td>zjhm</td><td>购房人证件号码</td></tr>
<tr align='left'><td>tdsyqrq</td><td>土地使用权到期日期</td></tr>
<tr align='left'><td>ghyt</td><td>购房用途</td></tr>
<tr align='left'><td>xmmc</td><td>小区项目名称</td></tr>
<tr align='left'><td>gadh</td><td>公安栋号</td></tr>
<tr align='left'><td>gfmj</td><td>购房面积</td></tr>
<tr align='left'><td>spffj</td><td>商品房房价</td></tr>
<tr align='left'><td>gljg</td><td>阁楼价格</td></tr>
<tr align='left'><td>hjzj</td><td>合计总价</td></tr>
<tr align='left'><td>jfrq</td><td>房屋交付日期</td></tr>
<tr align='left'><td>qdrq</td><td>合同签订日期</td></tr>
<tr align='left'><td>barq</td><td>合同备案日期</td></tr>
<tr align='left'><td>htbah</td><td>合同备案号</td></tr>
<tr align='left'><td>gfnf</td><td>购房年份</td></tr>
</table>
## 公积金提取校验（040201）
1. 交易代码（transcode）：040201
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>040201</td></tr>
<tr align='left'><td>grzh</td><td>职工账号</td><td></td></tr>
<tr align='left'><td>sfxdk</td><td>是否贷款</td><td>商品房或二手房：0否，1是；其他业务，传空</td></tr>
<tr align='left'><td>ywlx</td><td>处理类型</td><td>二手房提取：1104 <br/>
购房提取：1103<br/>
租房提取：1113<br/>
结清公积金贷款提取：1121<br/>
部分冲还公积金贷款提取：1122<br/>
一年两次还商贷：1131<br/>
退休提取：1201<br/>
封存提取：1202<br/>
手机号、银行卡变更资格校验:upd</td></tr>
<tr align='left'><td>opertypeflag</td><td>类型标志</td><td>购房提取和二手房提取传入wx-esf<br/>
租房提取传入wx-zf<br/>
封存提取传入wx-fctq<br/>
手机号、银行卡变更资格校验传入 wx-update<br/>
其他情况为wx</td></tr>
</table>
1. body示例
```
{
"head":{
"grzh": "职工账号",
"sfxdk":"0",
"ywlx":"GJJ",
"opertypeflag":"0",
"sjqx_hslx":"GJGL_CX"
},
"list":""
}
```
1. 应答body信息项
<table width='100%'>
<tr align='left'><th width='20%'>信息项英文名称</th><th width='80%'>信息项名称</th></tr>
<tr align='left'><td>gjjkyye</td><td>公积金可用余额</td></tr>
<tr align='left'><td>ocid</td><td>归集银行</td></tr>
<tr align='left'><td>sjhm</td><td>手机号码</td></tr>
<tr align='left'><td>xingming</td><td>姓名</td></tr>
<tr align='left'><td>zjhm</td><td>证件号码</td></tr>
<tr align='left'><td>dwzh</td><td>单位账号</td></tr>
<tr align='left'><td>orgcode</td><td>归集机构</td></tr>
<tr align='left'><td>ocidname</td><td>归集银行名称</td></tr>
<tr align='left'><td>orgname</td><td>归集机构名称</td></tr>
<tr align='left'><td>grzh</td><td>个人账号</td></tr>
<tr align='left'><td>sfdk</td><td>是否贷款</td></tr>
<tr align='left'><td>grzhzt</td><td>个人账号状态</td></tr>
<tr align='left'><td>btye</td><td>补贴余额</td></tr>
<tr align='left'><td>lmkh</td><td>联名卡号</td></tr>
<tr align='left'><td>sfdj</td><td>是否冻结</td></tr>
<tr align='left'><td>lmkstatus</td><td>联名卡状态</td></tr>
<tr align='left'><td>grzhye</td><td>职工账号余额</td></tr>
<tr align='left'><td>gjjbtye</td><td>补贴可用余额</td></tr>
<tr align='left'><td>hqyhje</td><td>还清应还总金额（金额+利息）</td></tr>
<tr align='left'><td>hqyhlx</td><td>还清应还利息</td></tr>
<tr align='left'><td>blje</td><td>保留金额</td></tr>
<tr align='left'><td>startdate</td><td>商贷开始查询日期</td></tr>
<tr align='left'><td>enddate</td><td>商贷结束查询日期</td></tr>
<tr align='left'><td>pername</td><td>商贷贷款人姓名</td></tr>
<tr align='left'><td>cardcode</td><td>商贷贷款人证件号码</td></tr>
<tr align='left'><td>agrcode</td><td>商贷合同编号</td></tr>
<tr align='left'><td>bkloanacc</td><td>银行商贷账号</td></tr>
<tr align='left'><td>yhbz</td><td>商贷银行标志</td></tr>
<tr align='left'><td>sdytqje</td><td>商贷已提取金额</td></tr>
<tr align='left'><td>sfbdsd</td><td>是否绑定商贷</td></tr>
<tr align='left'><td>qhje</td><td>公积金贷款当期应还金额</td></tr>
<tr align='left'><td>wyfje</td><td>物业费每年每平方金额</td></tr>
<tr align='left'><td>zfzdje</td><td>租房最大可提取金额</td></tr>
</table>
## 校验是否存在预约申请（040219）
1. 交易代码（transcode）：040219
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>040219</td></tr>
<tr align='left'><td>grzh</td><td>职工账号</td><td></td></tr>
</table>
1. body示例
```
{
"head":{ "head":{
"type": "cas", "grzh": "职工账号"
"logname":"320382199504285013", },
"xingming":"张三" "list":""
}, }
"list":{} ```
} 1. 应答body信息项
} 返回成功，则校验成功；返回失败，则校验失败。
1. 报文格式说明
1. 报文由head和body两部分组成，其中head中元素及格式固定，body中元素及格式根据具体业务会不同。
1. head元素列表
## 购房、二手房提取校验（040220）
1. 交易代码（transcode）：040220
1. 请求body
1. 信息项
<table width='100%'> <table width='100%'>
<tr align='left'><th width='10%'>出现位置</th><th width='10%'>信息项英文名称</th><th width='10%'>信息项名称</th><th width='60%'>描述</th></tr> <tr align='left'><th width='10%'>信息项英文名称</th><th width='10%'>信息项名称</th><th width='60%'>描述</th></tr>
<tr align='left'><td>请求、应答</td><td>sender</td><td>发送方</td><td>固定值</td></tr> <tr align='left'><td>transcode</td><td>交易代码</td><td>040220</td></tr>
<tr align='left'><td>请求、应答</td><td>receiver</td><td>接收方</td><td>固定值</td></tr> <tr align='left'><td>grzh</td><td>职工账号</td><td></td></tr>
<tr align='left'><td>请求、应答</td><td>appid</td><td>应用系统</td><td>固定值</td></tr> <tr align='left'><td>ywlx</td><td>业务类型</td><td>二手房提取：1104 <br/> 购房提取：1103</td></tr>
<tr align='left'><td>请求、应答</td><td>transcode</td><td>报文交易代码</td><td>用于区分各业务功能，是最重要的参数</td></tr> <tr align='left'><td>bahth</td><td>备案合同号</td><td>商品房提取时传</td></tr>
<tr align='left'><td>请求</td><td>trantime</td><td>发送时间</td><td>yyyyMMddhhmmss</td></tr> <tr align='left'><td>bdczh</td><td>不动产证号</td><td>二手房提取时传</td></tr>
<tr align='left'><td>请求、应答</td><td>iseqno</td><td>报文流水号</td><td>示例：201107101503120011，由前端生成</td></tr> <tr align='left'><td>mmqybh</td><td>买卖契约编号</td><td>二手房提取时传</td></tr>
<tr align='left'><td>应答</td><td>retcode</td><td>应答代码</td><td>retcode只有两种值，code=0001表示请求成功，code=9999，表示请求失败，这个时候你们取retmsg（请求失败原因）</td></tr>
<tr align='left'><td>应答</td><td>retmsg</td><td>应答信息</td><td>提示信息（只有retcode=9999的时候取）</td></tr>
</table> </table>
1. body结构 1. body示例
一般包括head和list两部分，具体内容会根据业务进行详细说明 ```
\ No newline at end of file {
"head":{
"grzh": "300836443",
"ywlx":"1103",
"bahth":"300836443",
"bdczh":null,
"mmqybh":null,
},
"list":""
}
```
1. 应答body信息项
返回成功，则校验成功；返回失败，则校验失败。
\ No newline at end of file
login.md
...@@ -9,26 +9,4 @@ ...@@ -9,26 +9,4 @@
--- ---
1. 用户名，密码均不能为空 1. 用户名，密码均不能为空
1. 登录接口： 1. 登录接口：
1. 交易代码： <a href='client_hessian#i_baseinfo' target='blank'>基本信息查询（020108）</a>
1. 请求报文body \ No newline at end of file
```
{
"head":{
"logname":"320382199504285013",
"password":"张三"
},
"list":""
}
```
1. 应答报文
```
{
"head":{
"logname":"320382199504285013",
"password":"张三"
},
"list":""
}
```
\ 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!