---

name: odoo-hr-payroll-setup description: "Odoo HR 和薪资专家指南：薪资结构、工资单规则、休假政策、员工合同和薪资日记账分录。" risk: safe source: "self"

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（薪资输入类型）按员工传递预扣税率，或安装社区美国薪资模块（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 薪资文档中未涵盖。