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

1、住房公积金社保委数据交换系统住房公积金-社保委数据交换系统需求规格说明书编写部门：审核部门：最后修改：2015-7-1定稿日期：文档修改记录创建日期创建人创建说明版本号页数2015-7-1施鹤V1.0012目 录1. 接口说明 41.1. 范围 41.2. 网络架构 51.3. 接口处理方案 61.4. 数据格式 61.5. 参数定义 71.5.1 入参XML格式： 71.5.2 出参XML格式 72. 接口定义 82.1. 退休查询交易 82.2. 社保缴费状态查询交易 82.3. 单位基本信息查询 102.4. 单位参保人数查询 112.5. 单位参保明细查询 112.6. 市民卡银行账号

2、信息查询（转发交易给银行） 123. 社保系统改造及数据整理 133.1. 系统改造 133.2. 数据整理 131. 接口说明1.1. 范围本说明规定了住房公积金管理中心和区社保委的数据交换接口格式、区社保委系统改造及数据整理。本说明适用于住房公积金管理中心和区社保委间关于 “退休查询、职工参保状态、企业参保人数、参保明细、市民卡支付账户”的数据交换接口。1.2. 网络架构在通讯服务器前部署千兆接口的防火墙系统，达到良好的边界保护和访问控制的要求，确保只有经过系统认证和授权的合法用户才能访问中心的通讯服务器，保护网络安全。1.3. 接口处理方案公积金和社保委之间建立实时网络连接，公积金端程序

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

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

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

6、个人状态12.3. 单位基本信息查询功能号7700业务规则中心主动发起，社保委从生产库中检索实时数据，返回信息。注意：社保单位基本信息中一个组织机构代码证号可能对应多条社保单位内码。接口定义中心请求入参：序号入参字段名称长度说明1organiz_code_card组织机构代码证80社保委出参：序号出参字段名称长度说明1corp_info单位信息集合单位信息集合：序号出参字段名称长度说明1corp_id社保单位内码122corp_name单位名称1003tax_code税务机构编码34biz_lice_no工商登记执照类型65bs_biz_lice_no工商登记执照号码306organiz_co

7、decard组织机构代码证80 2.4. 单位参保人数查询功能号7800业务规则中心主动发起交易，社保委接到查询请求后，返回信息。接口参数中心请求入参：序号入参字段名称长度说明1organiz_code_card组织机构代码证80社保委出参：序号出参字段名称长度说明1corp_insur_info参保人数信息集合参保人数信息集合：序号出参字段名称长度说明1corp_id社保单位内码122persons人数12 2.5. 单位参保明细查询功能号7900业务规则公积金中心主动发起交易，社保委接收请求后，返回响应。接口定义中心请求入参：序号入参字段名称长度说明1organiz_code_card组织

8、机构代码证80社保委出参：序号出参字段名称长度说明1corp_insur_pers人员结果集合人员结果集合：序号出参字段名称长度说明1idcard身份证号182name姓名503 jfjs_yanglao养老缴费基数4Corp_id社保单位内码12 2.6. 市民卡银行账号信息查询（转发交易给银行）功能号8000业务规则分中心发起交易，社保委从生产库中获取市民卡银行账号信息，返回响应。接口定义中心请求入参： 序号 入参 字段名称 长度 说明1 name 姓名 502 idcard 身份证 183 remark 备注 250社保委出参：序号 出参 字段名称 长度 说明1 bank_name 银行名称2 ccount_name 户名 3 account_no 账号4cardno 卡号5userno市民卡外卡号3. 社保系统改造及数据整理3.1. 系统改造单位基本信息表中添加字段组织机构代码证 ，单位新增、单位编辑功能添加该字段的维护，单位查询显示该字段。3.2. 数据整理根据公积金中心提供的单位基本信息文件，将社保系统中与公积金单位对应得上的单位的组织机构代码证号设置为公积金中心的组织机构代码证号。