接入流程指南

社保通API接口接入流程指南

1、获取测试access_token

发送邮件至 api@shebaochina.com 申请测试 access_token, 邮件中附带 环境(测试环境或生产环境)、公司名称、
调用接口服务器IP等信息

2、获取基数数据

在本地构建社保缴纳所需基础数据,需要调用以下2个接口获取基础数据:
a. 获取可缴纳城市 - 通过该接口获取社保通API业务可覆盖的城市
b. 按城市获取社保公积金基础数据 - 通过城市获取该城市的缴交类型以及缴交类型下包含的险种,最高/最低基数,
   险种个人/单位的缴费比例等信息

为了确保政策数据的一致性和准确性,建议每天定时通过接口更新政策数据

3、创建社保通平台企业账号

即给客户创建在社保通平台的账号,建议每一个客户都对应的创建一个社保通平台账号,创建账号时,需要提供客户的
营业执照扫描件,将扫描件转码成BASE64,然后通过接口传给我们

4、提交订单

参保人的增员、减员、补缴、续缴、基数变更等操作都通过该接口进行提交,详情请访问 wiki.shebaotong.com

5、提交人员材料

提交订单后,订单中增员的参保人需要通过该接口提交参保材料

6、修改订单状态

a. 提交订单后,订单的初始状态为 待提交 状态,该状态社保通客服不能对订单进行操作,需要调用 修改订单状态 
   接口,并传参数 status=1 ,此时订单状态为 已确认 状态,社保通客服可对订单进行操作
b. 订单确认后,需要用户对订单进行付款,如果订单未付款,并超过截止日,系统将自动取消该订单,针对未付款的
   订单社保通客服将不会到社保局进行业务办理,订单付款需要调用 修改订单状态 接口,并传参数 status=2 ,
   上传汇款凭证的BASE64码,社保通收到款项后,将会到社保局进行业务办理
c. 取消订单,如果用户需要取消订单,需要调用 修改订单状态 接口,并传参数 status=0,社保通已经在办理的
   订单不能取消

7、状态更新(由社保通回写)

状态更新是指用户提交的订单,社保通进行业务办理的过程中,需要通过合作伙伴平台提供的回调接口将办理的情况
回写给平台方。
回写数据包括以下3中:
a. 订单状态更新,即订单办理情况的状态回写,主要包括:已收到付款回写(status=3),办理中回写(status=4),
   办理完成回写(status=5),订单已关闭回写(status=6)
b. 人员缴交状态更新,即订单中参保人参保情况的状态回写,也就是参保人是参保成功,还是参保失败的回写
c. 人员材料审核状态更新,即参保人提交的材料的审核状态回写,也就是提交的参保人参保材料是审核通过,
   还是审核失败的回写

8、其他辅助接口

a. 计算社保公积金各项金额 接口,即社保计算器接口
b. 计算补缴时社保公积金各项金额 接口,即社保补缴计算器接口