个人社保缴纳接口支持指定城市社保公积金缴费比例查询和补缴计算、正常缴纳以及补缴,主要包括:
1.可缴纳城市查询
2.按城市获取社保公积金基础数据
3.个人账号创建
4.社保公积金各项金额计算
5.补缴时社保公积金各项金额计算
6.参保人信息管理
7.提交订单
8.变更社保公积金缴纳基数
9.社保公积金补缴
10.订单状态更新
11.提交人员材料
12.推送设置
可查看聚合数据页面完整个人社保缴纳接口信息:/docs/api/id/227
可缴纳城市查询
接口地址:/gerenshebao/test/getcities.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/getcities.php?key=APPKEY
JSON返回示例:
{"reason":"成功的返回","result":[{"city":"shenzhen",/*城市的编码*/"cname":"深圳",/*城市的名称*/"pname":"广东",/*城市所在省的名字*/"prov":"guangdong",/*城市所在省编码*/"region":"华南",/*地理分区*/"rule":-1,/*该城市报增报减的规则:1为当月增减次月;0为当月增减当月*/"subdl":30,/*该城市每月提交代缴订单并付款的截止日期,若此值为31,但该月实际只有28天,则截止日期应为28*/"month":"11",/*该城市在当前时间点可通过社保通平台代缴社保公积金的月份*/"timestamp":1443159946000/*时间戳*/},{"city":"wuhan","cname":"武汉","pname":"湖北","prov":"hubei",4"region":"华中","rule":0,"subdl":30,"month":"12","timestamp":1443159962000}],"error_code":0}
按城市获取社保公积金基础
接口地址:/gerenshebao/test/getbasic.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/getbasic.php?key=APPKEY&city=shanghai
JSON返回示例:
{"reason":"成功的返回","result":{"ins":[/*所有社保缴交类型基数集合*/{"type":"shanghaiwuxian",/*社保公积金类型编码*/"name":"上海五险",/*此类型对应的名称*/"desc":"本地城镇,本地农村,外地城镇",/*描述信息*/"bchgmonth":"07",/*此项目可调整缴交基数的月份*/"efdate":1436544000000,/*此项目的开始生效日期*/"inc":[/*包含的险种和公积金类型*/{"code":"yanglao",/*社保险种以及公积金项目编码*/"name":"养老保险"/*项目名称*/"max":16353,/*最高基数*/"min":3271,/*最低基数*/"empprop":8,/*此项目个人缴纳的比例*/"orgprop":216/*此项目企业缴纳的比例*/},{"code":"yiliao","name":"医疗保险""max":16353,"min":3271,"empprop":8,"orgprop":21}],"min":1000,/*最低基数*/"max":2000/*最高基数*/}],"hf":[/*公积金类型集合*/{"type":"shanghaigongjijin","name":"上海公积金","desc":"","bchgmonth":"06","efdate":1434643200000,"inc":[{"code":"gongjinjin","name":"公积金""max":16357,"min":1820,"empprop":7,"orgprop":7},{"code":"buchong_gongjijin","name":"补充公积金""max":16357,"min":1820,"empprop":7,"orgprop":7}],"min":1000,"max":2000}]},"error_code":0}
个人账号创建
接口地址:/gerenshebao/test/createindvaccount.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/createindvaccount.php?key=APPKEY&name=用户名&...
JSON返回示例:
{"reason":"注册成功","result":{"result":1,"usercode":"1406396"/*若创建成功,则返回此用户在社保通中的唯一标识符*/}"error_code":"0"}
社保公积金各项金额计算
接口地址:/gerenshebao/test/calculate.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/calculate.php?key=APPKEY&data=需计算的社保公积金
JSON返回示例:
{"reason":"查询成功","result":[{"gongjijin":{/*社保险种以及公积金项目,对应按城市获取社保公积金基础数据里面的code*/"base":5000,/*缴纳基数*/"co":350,/*公司缴纳部分*/"in":350,/*个人缴纳部分*/"sum":700/*缴纳总额*/}},{"yanglao":{"base":5000,"co":1050,"in":400,"sum":1450},"shengyu":{"base":5000,"co":50,"in":0,"sum":50},"gongshang":{"base":5000,"co":25,"in":0,"sum":25},"canjijin":{"base":5000,"co":75,"in":0,"sum":75},"shiye":{"base":5000,"co":75,"in":25,"sum":100},"yiliao":{"base":5000,"co":550,"in":100,"sum":650}}],"error_code":0}
补缴时社保公积金各项金额
接口地址:/gerenshebao/test/calcoverdue.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/calcoverdue.php?key=APPKEY&data=需补交数据
JSON返回示例:
{"reason":"查询成功","result":[{"gongjijin":{/*社保险种以及公积金项目,对应按城市获取社保公积金基础数据里面的code*/"base":5000,/*缴纳基数*/"co":350,/*公司缴纳部分*/"in":350,/*个人缴纳部分*/"odf":0,/*缴纳滞纳金*/"sum":700/*缴纳总额*/}},{"yanglao":{"base":5000,"co":1050,"in":400,"odf":0,"sum":1450},"gongshang":{"base":5000,"co":25,"in":0,"odf":0,"sum":25},"canjijin":{"base":5000,"co":75,"in":0,"odf":0,"sum":75},"yiliao":{"base":5000,"co":300,"in":50,"odf":0,"sum":350}}],"error_code":0}
参保人信息管理
接口地址:/gerenshebao/test/insuredInfo.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/insuredInfo.php?key=APPKEY&usercode=usercode&name=name&idcardno=id&idtype=idcard&phone=phone&gender=gender&birthday=birthday&city=city&ins_type=ins_type&ins_base=ins_base&hf_type=hf_type&hf_base=hf_base
JSON返回示例:
{"reason":"新增参保人信息成功","result":null,"error_code":0}XML返回示例:<?xmlversion="1.0"encoding="utf-8"?><root><reason>新增参保人信息成功</reason><result/><error_code>0</error_code></root>
提交订单
接口地址:/gerenshebao/test/submitorder.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/submitorder.php?key=APPKEY&usercode=usercode&data=data&invoice=invoice
JSON返回示例:
{"reason":"订单提交成功","result":{"amount":3520,/*缴纳总额*/"orderid":"736311075911361",/*订单编号*/"ordsum":3520,/*订单总额*/"service":0,/*服务费*/"success":[/*缴纳成功集合*/{"base":6000,/*缴纳基数*/"co":2190,/*公司缴纳金额*/"code":"shebao",/*社保缴纳项目*/"id":"11011719931227780X",/*参保人证件号*/"in":630,,/*参保人姓名*/"month":"02",/*个人缴纳金额*/"name":"夏增霞",/*社保缴纳月份*/"odf":0,/*滞纳金*/"status":"add",/*社保缴纳类型add/keep/stop*/"sum":2820,/*缴纳总额*/"type":"shanghaiwuxian"/*社保类型*/},{"base":5000,"co":350,"code":"gongjijin","id":"11011719931227780X","in":350,"month":"02","name":"夏增霞","odf":0,"status":"add","sum":700,"type":"shanghaigongjijin"}],//如果有缴纳失败的人员,将显示在这里,如果所有人员缴纳都失败,则不会有订单编号返回"fail":[/*缴纳失败集合*/{"id":"420321198508193414","name":"何郭辉","code":"shebao","status":"keep","month":"12","errcode":222702,/*错误编码*/"msg":"该人员本月已提交过订单"/*缴纳失败原因*/}]},"error_code":0}
变更社保公积金缴纳基数
接口地址:/gerenshebao/test/basechg.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/basechg.php?key=APPKEY&usercode=usercode&data=data&invoice=invoice
JSON返回示例:
{"reason":"订单提交成功,但无缴费成功人员,订单无效,无订单号生成","result":{"orderid":"486902185116451",/*订单编号*/"amount":2586329.07,/*缴纳总额*/"ordsum":2586329.07,/*订单总额*/"service":0,/*服务费*/"success":[/*缴纳成功集合*/{"base":4000,/*缴纳基数*/"co":1460,/*公司缴纳金额*/"code":"shebao",/*社保缴纳项目*/"id":"110112199011108234",/*参保人证件号*/"name":"何郭辉",/*参保人姓名*/"in":420,/*个人缴纳金额*/"month":"12",/*社保缴纳月份*/"odf":0,/*滞纳金*/"status":"basechg",/*社保缴纳类型*/"type":"shanghaiwuxian",/*社保类型*/"sum":1880/*缴纳总额*/},{"base":4000,/*缴纳基数*/"co":1460,/*公司缴纳金额*/"code":"gongjijin",/*社保缴纳项目*/"id":"110112199011108234",/*参保人证件号*/"name":"何郭辉",/*参保人姓名*/"in":420,/*个人缴纳金额*/"month":"12",/*社保缴纳月份*/"odf":0,/*滞纳金*/"status":"basechg",/*社保缴纳类型*/"type":"shanghaigongjijin",/*社保类型*/"sum":1880/*缴纳总额*/}],"fail":[{"code":"shebao","errcode":"200002","id":"140203199309204995","month":"02","msg":"该社保公积金类型此月不可变更基数","name":"钱钱磊","status":"basechg"},{"code":"gongjijin","errcode":"200002","id":"140203199309204995","month":"02","msg":"该社保公积金类型此月不可变更基数","name":"钱钱磊","status":"basechg"}]},"error_code":0}
社保公积金补缴
接口地址:/gerenshebao/test/overdue.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/overdue.php?key=APPKEY&usercode=usercode&data=data&invoice=invoice
JSON返回示例:
{"reason":"订单提交成功","result":{"amount":560,/*缴纳总额*/"orderid":"194411041815161",/*订单编号*/"ordsum":560,/*订单总额*/"service":0,/*服务费*/"success":[/*缴纳成功集合*/{"base":4000,/*缴纳基数*/"co":280,/*公司缴纳金额*/"code":"gongjijin",/*社保缴纳项目*/"id":"220701197712153097",/*参保人证件号*/"in":280,/*个人缴纳金额*/"month":"08",/*社保补缴月份*/"name":"姚肖任",/*参保人姓名*/"odf":0,/*滞纳金*/"status":"overdue",/*社保缴纳类型add,keep,stop,basechg,overdue*/"sum":560,/*缴纳总额*/"type":"shanghaigongjijin"/*社保类型*/}],"fail":[/*补缴失败集合*/{"code":"shebao","errcode":"222702",/*失败代码*/"id":"220701197712153097","month":"07","msg":"该月不可发生补缴",/*失败原因*/"name":"姚肖任","status":"overdue"},{"code":"shebao","errcode":"222702","id":"220701197712153097","month":"08","msg":"该月不可发生补缴","name":"姚肖任","status":"overdue"},{"code":"gongjijin","errcode":"222702","id":"220701197712153097","month":"07","msg":"该月不可发生补缴","name":"姚肖任","status":"overdue"}]},"error_code":0}
订单状态更新
接口地址:/gerenshebao/test/manager.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/manager.php?key=APPKEY&orderid=orderid&usercode=usercode&status
JSON返回示例:
{"reason":"订单状态更新成功","result":{"result":1,/*更新状态,成功返回1*/"payment":[/*付款方式,只有当订单状态改为1(确认)的时候才会返回给用户,付款方式*/{"bank":"交通银行上海支行",/*开户行信息*/"actname":"上海智服人力资源有限公司",/*户名*/"act":"121916999510206"/*付款账户*/"comment":"请在付款截止日期前付款,付款时候请注明订单号和姓名,以便快速确认付款信息"/*这个必须显示给用户看到*/"paydl":1434643200000/*付款截止日期*/}]},"error_code":0}
提交人员材料
接口地址:/gerenshebao/test/additional.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/additional.php?key=APPKEY&usercode=usercode&idcardno=idcardno&name=name&idcarda=idcarda&idcardb=idcardb&suf=suf
JSON返回示例:
{"reason":"提交成功","result":{"result":"1"/*提交成功*/},"error_code":0}
推送设置
接口地址:/gerenshebao/test/setPush.php
支持格式:json/xml
请求方式:httppost
请求示例:/gerenshebao/test/setPush.php?key=APPKEY&
JSON返回示例:
{"reason":"成功的返回","result":{"name":"我的公司名","orderstatus_callbacke":"地址","orderrowstatus_callback":"地址","shenhestatus_callback":"地址","key":"这里会显示您的appkey"},"error_code":0}