odoo-hr-payroll-setup

Odoo HR & 給与のセットアップ

概要

このスキルは、HR マネージャーおよび給与経理担当者が Odoo HR と給与を正しくセットアップできるようガイドします。Python で計算されるルールを用いた給与構造の作成、休暇ポリシー、従業員契約タイプ、そして給与 → 会計仕訳の転記フローを扱います。

このスキルを使う場面

• 総支給額、控除、手取り額を含む給与構造を作成する。
• 年次休暇、病気休暇、祝日のポリシーを設定する。
• 給与明細の金額が正しくない、またはルールの加算が欠落している問題をトラブルシューティングする。
• 会計に正しく転記するための給与仕訳をセットアップする。

仕組み

1. 有効化: @odoo-hr-payroll-setup をメンションし、給与のシナリオを説明します。
2. 設定: 給与ルールと休暇割り当ての手順ごとのセットアップを受け取ります。
3. デバッグ: 給与ルールまたは給与明細の問題を貼り付けると、根本原因の分析を受け取ります。

例

例 1: 控除を含む給与構造

Menu: Payroll → Configuration → Salary Structures → New

Name: US Employee Monthly
Payslip Code: MONTHLY

Rules (executed top-to-bottom — order matters):
  Code  | Name                   | Formula                        | Category
  ----- | ---------------------- | ------------------------------ | ---------
  BASIC | Basic Wage             | contract.wage                  | Basic
  GROSS | Gross                  | BASIC                          | Gross
  SS    | Social Security (6.2%) | -GROSS * 0.062                 | Deduction
  MED   | Medicare (1.45%)       | -GROSS * 0.0145                | Deduction
  FIT   | Federal Income Tax     | -GROSS * inputs.FIT_RATE.amount| Deduction
  NET   | Net Salary             | GROSS + SS + MED + FIT         | Net

連邦所得税: 標準の Odoo 米国ローカライゼーションでは、単一の l10n_us_w4_rate フィールドは公開されていません。従業員ごとの源泉徴収率を渡すには input（給与インプットタイプ）を使用するか、W4 の申告ステータスを適切に処理するコミュニティの米国給与モジュール（OCA l10n_us_hr_payroll）をインストールしてください。

例 2: 休暇タイプの設定

Menu: Time Off → Configuration → Time Off Types → New

Name: Annual Leave / PTO
Approval: Time Off Officer
Leave Validation: Time Off Officer  (single approver)
  or: "Both" for HR + Manager double approval

Allocation:
  ☑ Employees can allocate time off themselves
  Requires approval: No

Negative Balance: Not allowed (employees cannot go negative)

Then create initial allocations:
Menu: Time Off → Managers → Allocations → New
  Employee: [Each employee]
  Time Off Type: Annual Leave / PTO
  Allocation: 15 days
  Validity: Jan 1 – Dec 31 [current year]

例 3: 給与仕訳の結果

After validating a payroll batch, Odoo generates:

Debit   Salary Expense Account     $5,000.00
  Credit  Social Security Payable     $310.00
  Credit  Medicare Payable             $72.50
  Credit  Federal Tax Payable         (varies)
  Credit  Salary Payable           $4,617.50+

When net salary is paid:
Debit   Salary Payable            $4,617.50
  Credit  Bank Account              $4,617.50

Employer taxes (e.g., FUTA, SUTA) post as separate journal entries.

ベストプラクティス

• ✅ 推奨: カスタムルールを構築する前に、お住まいの国の 給与ローカライゼーション（l10n_us_hr_payroll、l10n_mx_hr_payroll など）をインストールしてください。事前設定された税構造が提供されます。
• ✅ 推奨: 変動値（賞与、手当、源泉徴収率）を渡すには、ルールの数式にハードコードするのではなく、給与ルールのインプット（inputs.ALLOWANCE.amount）を使用してください。
• ✅ 推奨: 古い給与構造は削除するのではなくアーカイブしてください。有効な給与明細はその構造を参照しており、構造を削除すると壊れてしまいます。
• ✅ 推奨: 給与明細を生成する前に、必ず正しい日付と給与を設定した有効な 従業員契約 を設定してください。
• ❌ 非推奨: 転記済みの給与明細を手動で編集しないでください。修正が必要な場合は、給与明細のバッチをキャンセルして再生成してください。
• ❌ 非推奨: 構造が月次か年次かを確認せずに、控除ルールで contract.wage を使用しないでください。必ず契約の給与期間を確認してください。

制限事項

• Odoo 給与は Enterprise 専用です — Community Edition には給与モジュール（hr_payroll）が含まれていません。
• 米国固有のコンプライアンス（W2、941、州の SUI/SDI 申告）には、ベースのローカライゼーション以外に追加のモジュールが必要です。Odoo は税務申告を直接生成しません。
• 多国間の給与（異なる国に従業員がいる場合、それぞれ別の構造とローカライゼーションが必要）は対象外です。
• 給与明細による 経費精算（例: マイレージ、在宅勤務）にはカスタム給与ルールのインプットが必要で、標準の HR 給与ドキュメントでは扱われていません。