client_hessian.md
6.22 KB
前端调用接口简介
- 调用服务端接口需通过富深开发的jar包访问接口
-
开发示例（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);
-
报文格式示例
{ "head"：{ "appid":"78", "transcode":"010101", "trantime":"20110710150312", "iseqno":"201107101503120011" }, "body":{ "head":{ "type": "cas", "logname":"320382199504285013", "xingming":"张三" }, "list":{} } }
- 报文格式说明
- 报文由head和body两部分组成，其中head中元素及格式固定，body中元素及格式根据具体业务会不同。
- head元素列表
出现位置 信息项英文名称 信息项名称 描述 请求、应答 sender 发送方 固定值 请求、应答 receiver 接收方 固定值 请求、应答 appid 应用系统 固定值 请求、应答 transcode 报文交易代码 用于区分各业务功能，是最重要的参数 请求 trantime 发送时间 yyyyMMddhhmmss 请求、应答 iseqno 报文流水号 示例：201107101503120011，由前端生成 应答 retcode 应答代码 retcode只有两种值，code=0001表示请求成功，code=9999，表示请求失败，这个时候你们取retmsg（请求失败原因） 应答 retmsg 应答信息 提示信息（只有retcode=9999的时候取） - body结构
一般包括head和list两部分，具体内容会根据业务进行详细说明
各业务接口交易代码（transcode）及body描述
基本信息查询（020108）
- 交易代码（transcode）：020108
- 请求body
- 信息项
信息项英文名称 信息项名称 描述 transcode 交易代码 020108 grzh 职工账号 ishj 是否合计 固定值：0 sjqx_ywzl 业务查询所需字段 固定值：GJGL_CX qxfw 业务查询所需字段 固定值：0 sjqx_hslx 业务查询所需字段 固定值：GJJ - body示例
{ "head":{ "grzh": "职工账号", "ishj":"0", "sjqx_hslx":"GJJ", "qxfw":"0", "sjqx_ywzl":"GJGL_CX", "ywcode":"999", }, "list":"" }
- 信息项
- 应答body
- 信息项
信息项英文名称 信息项名称 dwzh 单位账号 dwmc 单位名称 orgname 管理部 grzh 职工账号 xm 职工姓名 zjhm 身份证号 sjh 手机号码 sex 性别 grzhye 账户余额 grzhztmc 汇缴状态 khrq 开户日期 hjny 最近汇缴年月 gzjs 工资基数 yje 月缴额 dwjjl 单位缴存比例 zgjjl 职工缴存比例 sfdk 是否贷款 schjny 首次汇缴年月 lxdz 联系地址 lxdh 联系电话 btye 补贴余额 btyje 个人补贴月缴额 yjce 月缴存额总和 hjze 合计总额 gryjce 公积金月缴额 tqlx 提取利息 btlx 补贴利息 orgcode 管理部代码 ocid 归集银行id ocname 归集银行 kzyh 卡折银行 kzhm 卡折号码
- 信息项