社保公积金¶

企业月度社保公积金账单数据同步¶

使用场景：该接口用于按年月同步社保公积金人员账单数据。

请求方式：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	提交的数据总中，数据错误原因数组