@him0/freee-mcp

# 従業員の厚生年金保険 ## 概要 従業員の厚生年金保険の操作 ## エンドポイント一覧 ### GET /api/v1/employees/{employee_id}/welfare_pension_insurance_rule 操作: 従業員の厚生年金保険の取得 説明: 概要 指定した従業員・日付の厚生年金保険情報を返します。 注意点 管理者権限を持ったユーザーのみ実行可能です。 保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の厚生年金保険料の計算方法が自動計算の場合、給与計算時の厚生年金保険料の直接指定金額はnullが返されます) ### パラメータ | 名前 | 位置 | 必須 | 型 | 説明 | |------|------|------|-----|------| | company_id | query | はい | integer | 事業所ID | | year | query | はい | integer | 従業員情報を取得したい年 | | month | query | はい | integer | 従業員情報を取得したい月<br> 締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が検索結果として返します。<br> 翌月払いの従業員の2022/01の従業員情報を取得する場合は、year=2021,month=12を指定してください。<br> | | employee_id | path | はい | integer | 従業員ID | ### レスポンス (200) successful operation - employee_welfare_pension_insurance_rule (任意): object - id (任意): integer(int32) - child_allowance_contribution_bonus_calc_type (任意): string - 賞与計算時の子ども・子育て拠出金の計算方法 (選択肢: auto, manual) 例: `manual` - child_allowance_contribution_salary_calc_type (任意): string - 給与計算時の子ども・子育て拠出金の計算方法 (選択肢: auto, manual) 例: `manual` - company_id (任意): integer(int32) - 事業所ID - employee_id (任意): integer(int32) - 従業員ID - entried (任意): boolean - 厚生年金保険に加入しているかどうか - manual_child_allowance_contribution_amount_bonus (任意): number(float) - 賞与計算時の子ども・子育て拠出金の直接指定金額 例: `111.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_child_allowance_contribution_amount_salary (任意): number(float) - 給与計算時の子ども・子育て拠出金の直接指定金額 例: `222.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_company_bonus (任意): number(float) - 賞与計算時の厚生年金保険料の直接指定金額（会社負担分） 例: `333.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_company_salary (任意): number(float) - 給与計算時の厚生年金保険料の直接指定金額（会社負担分） 例: `444.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_employee_bonus (任意): integer(int32) - 賞与計算時の厚生年金保険料の直接指定金額（従業員負担分） 例: `555` (最小: -999999999, 最大: 999999999) - manual_welfare_pension_insurance_amount_of_employee_salary (任意): integer(int32) - 給与計算時の厚生年金保険料の直接指定金額（従業員負担分） 例: `666` (最小: -999999999, 最大: 999999999) - reference_num (任意): string - 厚生年金保険の被保険者整理番号 - standard_monthly_remuneration (任意): integer(int32) - 標準報酬月額 - welfare_pension_insurance_bonus_calc_type (任意): string - 賞与計算時の厚生年金保険料の計算方法 (選択肢: auto, manual) 例: `manual` - welfare_pension_insurance_salary_calc_type (任意): string - 給与計算時の厚生年金保険料の計算方法 (選択肢: auto, manual) 例: `manual` ### PUT /api/v1/employees/{employee_id}/welfare_pension_insurance_rule 操作: 従業員の厚生年金保険の更新 説明: 概要 指定した従業員の厚生年金保険情報を更新します。 注意点 管理者権限を持ったユーザーのみ実行可能です。 保険料計算方法が自動計算の場合、対応する保険料の直接指定金額は無視されnullが返されます。(例: 給与計算時の厚生年金保険料の計算方法が自動計算の場合、給与計算時の厚生年金保険料の直接指定金額はnullが返されます) ### パラメータ | 名前 | 位置 | 必須 | 型 | 説明 | |------|------|------|-----|------| | employee_id | path | はい | integer | 従業員ID | ### リクエストボディ - company_id (必須): integer(int32) - 更新対象事業所ID（必須） (最小: 1, 最大: 2147483647) - year (必須): integer(int32) - 更新対象年（必須） 例: `2021` (最小: 2000, 最大: 2100) - month (必須): integer(int32) - 更新対象月（必須）<br> 締め日支払い日設定が翌月払いの従業員情報の場合は、 指定したmonth + 1の値が更新されます。<br> 翌月払いの従業員の2022/01の従業員情報を更新する場合は、year=2021,month=12を指定してください。<br> 例: `1` (最小: 1, 最大: 12) - employee_welfare_pension_insurance_rule (必須): object - entried (任意): boolean - 厚生年金保険に加入しているかどうか null不可 - welfare_pension_insurance_salary_calc_type (任意): string - 給与計算時の厚生年金保険料の計算方法 (選択肢: auto, manual) 例: `manual` - welfare_pension_insurance_bonus_calc_type (任意): string - 賞与計算時の厚生年金保険料の計算方法 (選択肢: auto, manual) 例: `manual` - manual_welfare_pension_insurance_amount_of_employee_salary (任意): integer(int32) - 給与計算時の厚生年金保険料の直接指定金額（従業員負担分） 例: `1111` (最小: -999999999, 最大: 999999999) - manual_welfare_pension_insurance_amount_of_employee_bonus (任意): integer(int32) - 賞与計算時の厚生年金保険料の直接指定金額（従業員負担分） 例: `2222` (最小: -999999999, 最大: 999999999) - manual_welfare_pension_insurance_amount_of_company_salary (任意): number(float) - 給与計算時の厚生年金保険料の直接指定金額（会社負担分） 例: `3333.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_company_bonus (任意): number(float) - 賞与計算時の厚生年金保険料の直接指定金額（会社負担分） 例: `4444.0001` (最小: -999999999.9999, 最大: 999999999.9999) - child_allowance_contribution_salary_calc_type (任意): string - 給与計算時の子ども・子育て拠出金の計算方法 (選択肢: auto, manual) 例: `manual` - child_allowance_contribution_bonus_calc_type (任意): string - 賞与計算時の子ども・子育て拠出金の計算方法 (選択肢: auto, manual) 例: `manual` - manual_child_allowance_contribution_amount_salary (任意): number(float) - 給与計算時の子ども・子育て拠出金の直接指定金額 例: `5555.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_child_allowance_contribution_amount_bonus (任意): number(float) - 賞与計算時の子ども・子育て拠出金の直接指定金額 例: `6666.0001` (最小: -999999999.9999, 最大: 999999999.9999) - reference_num (任意): string - 厚生年金保険の被保険者整理番号 例: `0000000000` - standard_monthly_remuneration (必須): integer(int32) - 標準報酬月額 null不可 例: `88000` (最小: 1, 最大: 2147483647) ### レスポンス (200) successful operation - employee_welfare_pension_insurance_rule (任意): object - id (任意): integer(int32) - child_allowance_contribution_bonus_calc_type (任意): string - 賞与計算時の子ども・子育て拠出金の計算方法 (選択肢: auto, manual) 例: `manual` - child_allowance_contribution_salary_calc_type (任意): string - 給与計算時の子ども・子育て拠出金の計算方法 (選択肢: auto, manual) 例: `manual` - company_id (任意): integer(int32) - 事業所ID - employee_id (任意): integer(int32) - 従業員ID - entried (任意): boolean - 厚生年金保険に加入しているかどうか - manual_child_allowance_contribution_amount_bonus (任意): number(float) - 賞与計算時の子ども・子育て拠出金の直接指定金額 例: `111.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_child_allowance_contribution_amount_salary (任意): number(float) - 給与計算時の子ども・子育て拠出金の直接指定金額 例: `222.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_company_bonus (任意): number(float) - 賞与計算時の厚生年金保険料の直接指定金額（会社負担分） 例: `333.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_company_salary (任意): number(float) - 給与計算時の厚生年金保険料の直接指定金額（会社負担分） 例: `444.0001` (最小: -999999999.9999, 最大: 999999999.9999) - manual_welfare_pension_insurance_amount_of_employee_bonus (任意): integer(int32) - 賞与計算時の厚生年金保険料の直接指定金額（従業員負担分） 例: `555` (最小: -999999999, 最大: 999999999) - manual_welfare_pension_insurance_amount_of_employee_salary (任意): integer(int32) - 給与計算時の厚生年金保険料の直接指定金額（従業員負担分） 例: `666` (最小: -999999999, 最大: 999999999) - reference_num (任意): string - 厚生年金保険の被保険者整理番号 - standard_monthly_remuneration (任意): integer(int32) - 標準報酬月額 - welfare_pension_insurance_bonus_calc_type (任意): string - 賞与計算時の厚生年金保険料の計算方法 (選択肢: auto, manual) 例: `manual` - welfare_pension_insurance_salary_calc_type (任意): string - 給与計算時の厚生年金保険料の計算方法 (選択肢: auto, manual) 例: `manual` ## 参考情報 - freee API公式ドキュメント: https://developer.freee.co.jp/docs - OpenAPIスキーマ: [hr-api-schema.json](../../openapi/hr-api-schema.json)