住房公积金社保委数据交换系统.docx
《住房公积金社保委数据交换系统.docx》由会员分享,可在线阅读,更多相关《住房公积金社保委数据交换系统.docx(11页珍藏版)》请在冰豆网上搜索。
住房公积金社保委数据交换系统
住房公积金-社保委数据交换系统
需求规格说明书
编写部门:
审核部门:
最后修改:
2015-7-1
定稿日期:
文档修改记录
创建日期
创建人
创建说明
版本号
页数
2015-7-1
施鹤
V1.00
12
目录
1.接口说明4
1.1.范围4
1.2.网络架构5
1.3.接口处理方案6
1.4.数据格式6
1.5.参数定义7
1.5.1入参XML格式:
7
1.5.2出参XML格式7
2.接口定义8
2.1.退休查询交易8
2.2.社保缴费状态查询交易8
2.3.单位基本信息查询10
2.4.单位参保人数查询11
2.5.单位参保明细查询11
2.6.市民卡银行账号信息查询(转发交易给银行)12
3.社保系统改造及数据整理13
3.1.系统改造13
3.2.数据整理13
1.接口说明
1.1.范围
本说明规定了住房公积金管理中心和区社保委的数据交换接口格式、区社保委系统改造及数据整理。
本说明适用于住房公积金管理中心和区社保委间关于“退休查询、职工参保状态、企业参保人数、参保明细、市民卡支付账户”的数据交换接口。
1.2.网络架构
在通讯服务器前部署千兆接口的防火墙系统,达到良好的边界保护和访问控制的要求,确保只有经过系统认证和授权的合法用户才能访问中心的通讯服务器,保护网络安全。
1.3.接口处理方案
公积金和社保委之间建立实时网络连接,公积金端程序通过社保委提供的动态库把相关参数数据打包发送,数据通过公积金和社保委的之间的网络传到社保中间件服务器进行处理,处理结果以XML形式返回给公积金端程序,公积金端程序再调用社保提供的动态库提取相关信息。
处理模型图:
1.4.数据格式
●数据传输通过XML格式传输。
●本接口涉及到金额部分均以元为单位,小数点后保留两位。
●本接口中涉及到的日期格式均为年月日顺序,中间带分隔符’-’,如YYYY-MM-DD,表示四位年两位月两位日。
1.5.参数定义
参数包括入参和出参
1.5.1入参XML格式:
1.以开始,结束。
2.表示功能号(交易码)。
3.表示参数组,参数组的数据项由具体的功能号接口定义。
例如入参XML为:
8102003
说明:
表示调用功能号位810200的交易,输入参数为corp_sta_code=3
1.5.2出参XML格式
1.以开始,结束。
2.表示返回码。
返回码小于零表示失败,失败信息为的内容。
返回码大于零表示功能交易成功,的内容为成功提示。
3.表示返回的提示交易成功或失败的中文内容。
4.其它内容为该功能成功返回的结果。
结果数据项由具体的功能号定义。
例如:
1
打包成功
150131
521521521
测试单位
0
说明:
表示该功能调用成功,返回的信息为结果集的内容,并且结果集中的内容只有一行。
该行数据项包括、、、四个数据项。
2.接口定义
2.1.退休查询交易
功能号
7500
业务规则
•中心主动发起,社保委从生产库中检索实时数据,返回信息。
接口定义
中心请求入参:
序号
入参
字段名称
长度
说明
1
name
姓名
50
2
idcard
身份证
18
社保委出参:
序号
出参
字段名称
长度
说明
1
perstate
当前状态
4
退休/非退/查无
2
indi_sta
个人状态
1
3
is_retire
是否是退休人员
2
2.2.社保缴费状态查询交易
功能号
7600
业务规则
•中心主动发起,社保委从生产库中检索实时数据,返回信息。
接口定义
·中心请求入参:
序号
入参
字段名称
长度
说明
1
name
姓名
50
2
idcard
身份证
18
·社保委出参:
序号
出参
字段名称
长度
说明
1
paystate
当前状态
4
停缴/非停/查无
2
indi_id
个人编号
12
3
indi_sta
个人状态
1
2.3.单位基本信息查询
功能号
7700
业务规则
•中心主动发起,社保委从生产库中检索实时数据,返回信息。
注意:
社保单位基本信息中一个组织机构代码证号可能对应多条社保单位内码。
接口定义
·中心请求入参:
序号
入参
字段名称
长度
说明
1
organiz_code_card
组织机构代码证
80
·社保委出参:
序号
出参
字段名称
长度
说明
1
corp_info
单位信息集合
单位信息集合:
序号
出参
字段名称
长度
说明
1
corp_id
社保单位内码
12
2
corp_name
单位名称
100
3
tax_code
税务机构编码
3
4
biz_lice_no
工商登记执照类型
6
5
bs_biz_lice_no
工商登记执照号码
30
6
organiz_codecard
组织机构代码证
80
2.4.单位参保人数查询
功能号
7800
业务规则
中心主动发起交易,社保委接到查询请求后,返回信息。
接口参数
·中心请求入参:
序号
入参
字段名称
长度
说明
1
organiz_code_card
组织机构代码证
80
·社保委出参:
序号
出参
字段名称
长度
说明
1
corp_insur_info
参保人数信息集合
参保人数信息集合:
序号
出参
字段名称
长度
说明
1
corp_id
社保单位内码
12
2
persons
人数
12
2.5.单位参保明细查询
功能号
7900
业务规则
公积金中心主动发起交易,社保委接收请求后,返回响应。
接口定义
·中心请求入参:
序号
入参
字段名称
长度
说明
1
organiz_code_card
组织机构代码证
80
·社保委出参:
序号
出参
字段名称
长度
说明
1
corp_insur_pers
人员结果集合
人员结果集合:
序号
出参
字段名称
长度
说明
1
idcard
身份证号
18
2
name
姓名
50
3
jfjs_yanglao
养老缴费基数
4
Corp_id
社保单位内码
12
2.6.市民卡银行账号信息查询(转发交易给银行)
功能号
8000
业务规则
分中心发起交易,社保委从生产库中获取市民卡银行账号信息,返回响应。
接口定义
中心请求入参:
序号
入参
字段名称
长度
说明
1
name
姓名
50
2
idcard
身份证
18
3
remark
备注
250
社保委出参:
序号
出参
字段名称
长度
说明
1
bank_name
银行名称
2
ccount_name
户名
3
account_no
账号
4
cardno
卡号
5
userno
市民卡外卡号
3.社保系统改造及数据整理
3.1.系统改造
单位基本信息表中添加字段组织机构代码证,单位新增、单位编辑功能添加该字段的维护,单位查询显示该字段。
3.2.数据整理
根据公积金中心提供的单位基本信息文件,将社保系统中与公积金单位对应得上的单位的组织机构代码证号设置为公积金中心的组织机构代码证号。