社保查询 |
您所在的位置：网站首页 › 社保缴费信息查询接口异常 › 社保查询 |
|
社保公积金¶
企业月度社保公积金账单数据同步¶
使用场景：该接口用于按年月同步社保公积金人员账单数据。 请求方式：POST（HTTPS） 请求地址：https://openapi.2haohr.com/api/security/bill_sync/?access_token=ACCESS_TOKEN 请求包结构体为： { "year": 2021, "month": 12, "records": [ { "emp_id": "686460*****44f2987db8*****079b89", "month_status":1, "social_security_base_company":0, "social_security_base_person":0, "housing_fund_security_base_company":0, "housing_fund_security_base_person":0, "social_security_total_amount_company":200, "social_security_total_amount_person":100, "housing_fund_total_amount_company":0, "housing_fund_total_amount_person":0, "total_amount_company":200, "total_amount_person":100, "service_fee_amount":0, "items": [ { "item_name": "养老保险", "insurance_type": 1, "personal_amount": 100, "company_amount": 200 } ], "payment_items": [ { "item_name": "养老保险", "insurance_type": 1, "supplementary_year": 2021, "supplementary_month": 10, "personal_amount": 100, "company_amount": 200 } ], "diff_items": [ { "item_name": "养老保险", "insurance_type": 1, "supplementary_year": 2021, "supplementary_month": 11, "personal_amount": 100, "company_amount": 200 } ] } ] }参数说明： 参数 类型 是否必须 说明 access_token String 是 调用接口凭证 year Int 是 账单年份 month Int 是 账单月份 records List 是 账单员工记录数组。最大支持100条记录。超过后，此次提交的数据都不会保存，并返回相应错误码。 emp_id String 是 员工id month_status Int 否 是否本月增员：1:正常, 2:新增 3:停保 ，默认1 social_security_base_company Float 否 企业社保基数，支持3位小数，默认0 social_security_base_person Float 否 个人社保基数，支持3位小数，默认0 housing_fund_security_base_company Float 否 企业公积金基数，支持3位小数，默认0 housing_fund_security_base_person Float 否 个人公积金基数，支持3位小数，默认0 social_security_total_amount_company Float 是 社保费用总计-企业，支持3位小数 social_security_total_amount_person Float 是 社保费用总计-个人，支持3位小数 housing_fund_total_amount_company Float 是 公积金费用总计-企业，支持3位小数 housing_fund_total_amount_person Float 是 公积金费用总计-个人，支持3位小数 total_amount_company Float 是 费用总计-企业，支持4位小数 total_amount_person Float 是 费用总计-个人，支持4位小数 service_fee_amount Float 否 服务费，支持3位小数 items List 是 员工社保公积金项列表。社保项最多支持15项，公积金项最多支持7项 item_name String 是 社保公积金项名称，字符长度最长10位 insurance_type Int 是 项目类型：1=社保，2=公积金 personal_amount Float 是 个人缴纳金额，支持3位小数 company_amount Float 是 企业缴纳金额，支持3位小数 payment_items List 否 补缴项列表。补缴社保项最多支持15项，补缴公积金项最多支持7项 diff_items List 否 补差项列表。补差社保项最多支持15项，补差公积金项最多支持7项 supplementary_year Int 是 补缴/补差年份，默认2000， 只能补缴或补差2000年以后，当前参数年月以前的账单月份数据 supplementary_month Int 是 补缴/补差月份，默认1参数详细说明 item_name 固定项目: 养老保险，医疗保险，失业保险，工伤保险，生育保险，公积金。 附加项目(从200开始)： 补充（大病）医疗，残保金，补充养老，补充公积金 其他自定义项目，请在系统中维护，如系统中没有，调用此接口时将自动创建 item_name名字不能重复，在系统中唯一 企业全部社保项（insurance_type=1）最多支持15项，全部公积金项（insurance_type=2）最多支持7项注意： 只能同步当前最新账单月的数据（历史账单月的数据已封存），如果年月大于当前账单月，则创建新的账单 一次添加的员工记录数不得大于100条 如果接口重复提交同一个人同一个月，将删除原数据，重新插入 重复提交一个人的社保项数据，将删除原数据，重新插入原本已存在账单中的员工，但不在本次同步参数中的员工将会被删除 原本已存在的员工社保项数据，但不在本次同步参数中将会被删除权限说明 返回结果： { "errcode": 0, "errmsg": "", "data": { "fail": 2, "total": 10, "err": [ "686460*****44f2987db8*****079b89, 未同步到社保" ], "success": 8 } }参数说明： 参数 说明 errcode 错误返回码。 errmsg 对返回码的文本描述内容 data 返回数据total 提交的数据总数fail 提交的数据总中，有误的数据量success 提交的数据总中，成功保存的数据量err 提交的数据总中，数据错误原因数组 企业月度社保公积金账单数据删除¶使用场景：该接口用于删除指定月份社保账单人员数据。 请求方式：DELETE（HTTPS） 请求地址：https://openapi.2haohr.com/api/security/bill/?access_token=ACCESS_TOKEN 请求包结构体为： { "year": 2021, "month": 12, "emp_ids": [ "686460*****44f2987db8*****079b89" ] }参数说明： 参数 类型 是否必须 说明 access_token String 是 调用接口凭证 year Int 是 账单年份 month Int 是 账单月份 emp_ids List 否 员工ids数据参数详细说明 注意： 只能删除当前最新账单月的人员数据，历史账单月的数据已封存 一次删除的员工记录数不得大于100条 当员工id列表为空时则删除整个账单数据权限说明 返回结果： { "errcode": 0, "errmsg": "", "data": { "fail": 2, "total": 10, "err": [ "员工：686460*****44f2987db8*****079b89, 未同步到社保" ], "success": 8 } }参数说明： 参数 说明 errcode 错误返回码。 errmsg 对返回码的文本描述内容 data 返回数据total 提交的数据总数fail 提交的数据总中，执行失败的数据量success 提交的数据总中，执行成功的数据量err 提交的数据总中，数据错误原因数组 |
今日新闻 |
推荐新闻 |
| CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |