住房公积金-社保委数据交换系统

1、余杭区住房公积金业务应用系统（软件）-数据交换子系统 需求规格说明书第 PAGE 9页共 NUMPAGES 13页住房公积金-社保委数据交换系统需求规格说明书编写部门：审核部门：最后修改：2015-7-1定稿日期：文档修改记录创建日期创建人创建说明版本号页数2015-7-1施鹤V1.0012目 录 TOC o 1-3 h z u HYPERLINK l _Toc425956670 1.接口说明 PAGEREF _Toc425956670 h 4 HYPERLINK l _Toc425956671 1.1.范围 PAGEREF _Toc425956671 h 4 HYPERLINK l _Toc

2、425956672 1.2.网络架构 PAGEREF _Toc425956672 h 5 HYPERLINK l _Toc425956673 1.3.接口处理方案 PAGEREF _Toc425956673 h 6 HYPERLINK l _Toc425956674 1.4.数据格式 PAGEREF _Toc425956674 h 6 HYPERLINK l _Toc425956675 1.5.参数定义 PAGEREF _Toc425956675 h 7 HYPERLINK l _Toc425956676 1.5.1入参XML格式： PAGEREF _Toc425956676 h 7 HYPE

3、RLINK l _Toc425956677 1.5.2出参XML格式 PAGEREF _Toc425956677 h 7 HYPERLINK l _Toc425956678 2.接口定义 PAGEREF _Toc425956678 h 8 HYPERLINK l _Toc425956679 2.1.退休查询交易 PAGEREF _Toc425956679 h 8 HYPERLINK l _Toc425956680 2.2.社保缴费状态查询交易 PAGEREF _Toc425956680 h 8 HYPERLINK l _Toc425956681 2.3.单位基本信息查询 PAGEREF _To

4、c425956681 h 10 HYPERLINK l _Toc425956682 2.4.单位参保人数查询 PAGEREF _Toc425956682 h 11 HYPERLINK l _Toc425956683 2.5.单位参保明细查询 PAGEREF _Toc425956683 h 11 HYPERLINK l _Toc425956684 2.6.市民卡银行账号信息查询（转发交易给银行） PAGEREF _Toc425956684 h 12 HYPERLINK l _Toc425956685 3.社保系统改造及数据整理 PAGEREF _Toc425956685 h 13 HYPERLI

5、NK l _Toc425956686 3.1.系统改造 PAGEREF _Toc425956686 h 13 HYPERLINK l _Toc425956687 3.2.数据整理 PAGEREF _Toc425956687 h 13接口说明范围本说明规定了住房公积金管理中心和区社保委的数据交换接口格式、区社保委系统改造及数据整理。本说明适用于住房公积金管理中心和区社保委间关于 “退休查询、职工参保状态、企业参保人数、参保明细、市民卡支付账户”的数据交换接口。网络架构在通讯服务器前部署千兆接口的防火墙系统，达到良好的边界保护和访问控制的要求，确保只有经过系统认证和授权的合法用户才能访问中心的通讯

6、服务器，保护网络安全。接口处理方案公积金和社保委之间建立实时网络连接，公积金端程序通过社保委提供的动态库把相关参数数据打包发送，数据通过公积金和社保委的之间的网络传到社保中间件服务器进行处理，处理结果以XML形式返回给公积金端程序，公积金端程序再调用社保提供的动态库提取相关信息。处理模型图：数据格式数据传输通过XML格式传输。本接口涉及到金额部分均以元为单位，小数点后保留两位。本接口中涉及到的日期格式均为年月日顺序，中间带分隔符-，如YYYY-MM-DD，表示四位年两位月两位日。参数定义参数包括入参和出参1.5.1入参XML格式：1. 以开始，结束。2. 表示功能号（交易码）。3. 表示参数组

7、 ，参数组的数据项由具体的功能号接口定义。 例如入参XML为：8102003说明：表示调用功能号位810200的交易，输入参数为 corp_sta_code =3 1.5.2出参XML格式1. 以开始，结束。2. 表示返回码。返回码小于零表示失败，失败信息为的内容。返回码大于零表示功能交易成功，的内容为成功提示。3. 表示返回的提示交易成功或失败的中文内容。4. 其它内容为该功能成功返回的结果。结果数据项由具体的功能号定义。例如：1打包成功150131521521521测试单位0说明：表示该功能调用成功，返回的信息为结果集的内容，并且结果集中的内容只有一行。该行数据项包括、四个数据项。接口定义

8、退休查询交易功能号7500业务规则中心主动发起，社保委从生产库中检索实时数据，返回信息。接口定义中心请求入参：序号入参字段名称长度说明1name姓名502idcard身份证18社保委出参：序号出参字段名称长度说明1perstate当前状态4退休/非退/查无2indi_sta个人状态13is_retire是否是退休人员2社保缴费状态查询交易功能号7600业务规则中心主动发起，社保委从生产库中检索实时数据，返回信息。接口定义中心请求入参：序号入参字段名称长度说明1name姓名502idcard身份证18社保委出参：序号出参字段名称长度说明1paystate当前状态4停缴/非停/查无2indi_id

9、个人编号123indi_sta个人状态1余杭区住房公积金业务应用系统（软件）-数据交换子系统 需求规格说明书第 PAGE 10页共 NUMPAGES 13页单位基本信息查询功能号7700业务规则中心主动发起，社保委从生产库中检索实时数据，返回信息。注意：社保单位基本信息中一个组织机构代码证号可能对应多条社保单位内码。接口定义中心请求入参：序号入参字段名称长度说明1organiz_code_card组织机构代码证80社保委出参：序号出参字段名称长度说明1corp_info单位信息集合单位信息集合：序号出参字段名称长度说明1corp_id社保单位内码122corp_name单位名称1003tax_

10、code税务机构编码34biz_lice_no工商登记执照类型65bs_biz_lice_no工商登记执照号码306organiz_codecard组织机构代码证80余杭区住房公积金业务应用系统（软件）-数据交换子系统 需求规格说明书第 PAGE 13页共 NUMPAGES 13页单位参保人数查询功能号7800业务规则中心主动发起交易，社保委接到查询请求后，返回信息。接口参数中心请求入参：序号入参字段名称长度说明1organiz_code_card组织机构代码证80社保委出参：序号出参字段名称长度说明1corp_insur_info参保人数信息集合参保人数信息集合：序号出参字段名称长度说明1c

11、orp_id社保单位内码122persons人数12 单位参保明细查询功能号7900业务规则公积金中心主动发起交易，社保委接收请求后，返回响应。接口定义中心请求入参：序号入参字段名称长度说明1organiz_code_card组织机构代码证80社保委出参：序号出参字段名称长度说明1corp_insur_pers人员结果集合人员结果集合：序号出参字段名称长度说明1idcard身份证号182name姓名503 jfjs_yanglao养老缴费基数4Corp_id社保单位内码12 市民卡银行账号信息查询（转发交易给银行）功能号8000业务规则分中心发起交易，社保委从生产库中获取市民卡银行账号信息，返回响应。接口定义中心请求入参： 序号 入参 字段名称 长度 说明1 name 姓名 502 idcard 身份证 183 remark 备注 250社保委出参：序号 出参 字段名称 长度 说明1 bank_name 银行名称2 ccount_n