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 字段。请使用 输入（工资输入类型）按员工传入预扣税率，或安装社区美国薪酬模块（OCA l10n_us_hr_payroll），该模块可正确处理 W4 申报状态。

示例 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 薪酬仅限企业版 —— 社区版不包含薪酬模块（hr_payroll）。
• 美国特定合规（W2、941、州 SUI/SDI 申报）需要基础本地化之外的额外模块；Odoo 不直接生成税务申报。
• 不涵盖 多国薪酬（不同国家的员工需要单独的结构和本地化）。
• 通过工资单进行的 费用报销（例如里程、居家办公）需要自定义工资规则输入，标准 HR 薪酬文档中未涵盖。