Skip to content

finstone-yangzhou / finstone-yangzhou-doc

Go to a project
Commit 5fed9109 by zim78
Options

no message

1 parent f656b9f6
Inline Side-by-side
Showing with 140 additions and 12 deletions
client_hessian.md
<a name='dstart'></a>
<a name='client_hessian'></a>
<a name='position'></a>
# 前端调用接口
# 前端调用接口简介
---
1. 调用服务端接口需通过富深开发的jar包访问接口
1. 开发示例（java示例）
......@@ -54,4 +54,73 @@
<tr align='left'><td>应答</td><td>retmsg</td><td>应答信息</td><td>提示信息（只有retcode=9999的时候取）</td></tr>
</table>
1. body结构
一般包括head和list两部分，具体内容会根据业务进行详细说明
\ No newline at end of file
一般包括head和list两部分，具体内容会根据业务进行详细说明
<a name='interface'></a>
# 各业务接口交易代码（transcode）及body描述
<a name='i_baseinfo'></a>
## 基本信息查询（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
1. 信息项
<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>
\ No newline at end of file
client_interface.md 0 → 100644
<a name='dstart'></a>
<a name='position'></a>
# 前端调用接口
---
1. 调用服务端接口需通过富深开发的jar包访问接口
1. 开发示例（java示例）
```//作为客户端发送过程测试
FrameInvokeServiceClient client = new FrameInvokeServiceClient();
//此处填写公积金中心的服务地址
client.setUrl("http://xxxxxxxxxx/esb/service/invokeService);
client.setEncode("GBK");
//invoke方法完成 编码压缩、发送、获得返回报文、解压和签名对比
//retxml是获得的返回明文
String retxml = client.invoke("发送json报文明文");
System.out.println(retxml);
1. 报文格式示例
```
{
"head"：{
"appid":"78",
"transcode":"010101",
"trantime":"20110710150312",
"iseqno":"201107101503120011"
},
"body":{
"head":{
"type": "cas",
"logname":"320382199504285013",
"xingming":"张三"
},
"list":{}
}
}
1. 报文格式说明
1. 报文由head和body两部分组成，其中head中元素及格式固定，body中元素及格式根据具体业务会不同。
1. head元素列表
<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'><td>请求、应答</td><td>sender</td><td>发送方</td><td>固定值</td></tr>
<tr align='left'><td>请求、应答</td><td>receiver</td><td>接收方</td><td>固定值</td></tr>
<tr align='left'><td>请求、应答</td><td>appid</td><td>应用系统</td><td>固定值</td></tr>
<tr align='left'><td>请求、应答</td><td>transcode</td><td>报文交易代码</td><td>用于区分各业务功能，是最重要的参数</td></tr>
<tr align='left'><td>请求</td><td>trantime</td><td>发送时间</td><td>yyyyMMddhhmmss</td></tr>
<tr align='left'><td>请求、应答</td><td>iseqno</td><td>报文流水号</td><td>示例：201107101503120011，由前端生成</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>
1. body结构
一般包括head和list两部分，具体内容会根据业务进行详细说明
\ No newline at end of file
login.md
......@@ -9,7 +9,7 @@
---
1. 用户名，密码均不能为空
1. 登录接口：
1. 交易代码：
1. 交易代码： <a href='client_hessian#i_baseinfo' target='blank'>基本信息查询（020108）</a>
1. 请求报文body
```
{
......@@ -23,12 +23,12 @@
```
1. 应答报文
```
{
"head":{
"logname":"320382199504285013",
"password":"张三"
},
"list":""
}
{
"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!