美国工资本地化指南：配置、模块与报表全攻略
美国
美国的工资本地化覆盖员工的薪资计算，包括员工和雇主的工资税。它遵循联邦和州的法规。
本本地化包含的州包括：
- 加利福尼亚 (CA)
- 纽约 (NY)
- 德克萨斯 (TX)
- 佛罗里达 (FL)
- 科罗拉多 (CO)
- 阿拉巴马 (AL)
- 华盛顿 (WA)
- 内华达 (NV)
- 佛蒙特 (VT)
- 伊利诺伊 (IL)
- 弗吉尼亚 (VA)
- 华盛顿特区 (DC)
- 亚利桑那 (AZ)
- 爱达荷 (ID)
- 俄勒冈 (OR)
- 北卡罗来纳 (NC)
:::: note ::: title 注意 :::
联邦税（收入税、FICA（联邦保险贡献法）以及失业税）对员工和雇主默认在 Odoo 美国工资本地化中覆盖。后续会陆续添加更多州，请关注更新。
::::
在配置美国本地化之前，请先参考通用的 payroll <../../payroll> 文档，其中包含所有本地化的基本信息以及通用设置和字段。
应用与模块 {#payroll/usa_apps}
Install <general/install> 以下模块即可获得美国工资本地化的全部功能：
+————————————————————-+——————————————+————————–+——————–+
| 名称 | 技术名称 | 依赖 | 描述 |
+=============================================================+==========================================+==========================+====================+
| United States - Payroll{.interpreted-text | [l10n_us_hr_payroll] | - hr_payroll | 提供美国 payroll 基础， |
| role=“guilabel”} | | - hr_contract_reports | 包括员工税务细节、 |
| | | - hr_work_entry_holidays | 薪资结构（基本/毛/净）， |
| | | - hr_payroll_holidays | 税则，以及 W‑2/3PA 报告。 |
+————————————————————-+——————————————+————————–+——————–+
| United States - Payroll with Accounting{.interpreted-text | [l10n_us_hr_payroll_account] | - hr_payroll_account | 将 payroll 与会计关联， |
| role=“guilabel”} | | - l10n_us | 通过创建分录（如有） |
| | | - l10n_us_hr_payroll | 将工资单记录到公司账簿。 |
+————————————————————-+——————————————+————————–+——————–+
::: seealso Configure the United States fiscal localization <../../../finance/fiscal_localizations/united_states> :::
通用配置
首先，需要配置公司。进入 Settings app --> Users & Companies --> Companies。在列表中选择目标公司，配置以下字段：
Company Name：填写公司名称。Address：完整填写地址，包括City、State、Zip Code与Country。:::: important ::: title 重要 :::
公司地址中选择的州默认作为员工的 工作地址，并用于计算工资税。 ::::
Tax ID：填写公司EIN（雇主识别号）。Company ID：填写公司所在州的 ID 编号。Currency：默认已选USD（美元），如未选请从下拉框中选择。Phone：填写公司电话。Email：填写公司通用联系邮箱。
:::: warning ::: title 警告 :::
确保信息准确，因为这些信息将在生成 W‑2 时使用。 ::::
员工
所有领取工资的员工必须在美国工资本地化中配置其员工档案。配置美国本地化后会出现额外字段。
要编辑员工表单，打开 Employees 应用，点击对应员工记录，在表单的相关标签页中填写必填字段。
Work（工作）标签页
在 Work 标签页的 Location 区域填写员工的 Work Address。
:::: important ::: title 重要 :::
该地址选择的州决定 Odoo 在计算税款时使用的薪资规则。 ::::
Personal（个人）标签页
确保在 Private Contact 区域的 Bank Accounts 字段中至少列出一个 受信任的银行账户，该账户用于通过 NACHA 文件自动支付工资。若未设置受信任的银行账户，Payroll 仪表盘会出现警告，且在运行 payroll 时会报错。
确认在 Citizenship 区域填写有效的 SSN No（社会安全号码）。SSN 的后四位会显示在员工的工资单上。
Payroll（工资）标签页
合同概览区
该区块保存驱动薪资计算的信息。请确保以下字段已配置：
Contract：可根据需要更新薪酬条件的有效期。Wage Type：选择员工的薪酬方式。Fixed Wage：固定工资制员工，每个发薪期金额相同。Hourly Wage：按实际工时计酬的员工。
:::: tip ::: title 小贴士 :::
在薪资
Structure Type <payroll/structure-types>中设置默认Wage Type，可批量配置员工；如有例外，可在单个员工记录中覆盖。 ::::Contract Type：决定员工的薪酬分类，如Salary‑exempt、Salary‑nonexempt、Hourly等。:::: important ::: title 重要 :::
此字段会显示在工资单上。部分州要求工资单注明员工是否免除加班费，请遵守当地法律。 ::::
Pay Category：选择United States: Employee。该字段决定员工的发薪频率、默认工作计划以及适用的工作条目类型。
Schedule（排班）区
Work Entry Source：定义在指定发薪期间如何生成work entries <../work_entries>，选项包括：Working Schedule：基于员工的working schedule <employees/schedule>（如每周 40 小时）。Attendances：基于 Attendances 应用中已批准的签到工时。Planning：基于 Planning 应用的scheduled shifts。
Extra Hours：勾选后，Attendances 应用可添加员工记录的额外工时。Working Hours：使用下拉框选择默认工作计划，尤其对需要加班工资的（通常为计时员工）很重要。
W‑2 表单区
W‑2 为年度税表，报告员工工资、税款和福利。以下复选框对应 W‑2 表单第 13 框，依据实际情况勾选：
Statutory Employee：若员工免除所得税但需缴纳FICA税，则勾选。Retirement Plan：若员工参与雇主提供的退休计划，则勾选。Third‑Party Sick Pay：若员工的病假工资由第三方（如保险公司）提供，则勾选。
W‑4 表单区
W‑4 为 IRS（美国国税局） 用于确定联邦预扣税的表单。请在此区填写员工的相关信息。
State filing（州申报）区
员工的婚姻状态会影响州工资税。请配置以下字段：
Status：选择员工的 联邦 申报状态（如Single、Married/RDP filing jointly等），通常来源于员工的 W‑4 表单。Tax Status：选择员工的 州 申报状态（如适用）。:::: tip ::: title 小贴士 :::
联邦和州的状态不必相同。 ::::
:::: note ::: title 注 :::
截至 2025 年，以下州不征收州所得税：阿拉斯加、佛罗里达、内华达、新罕布什尔、南达科他、田纳西、德克萨斯、华盛顿和怀俄明。若本地化包含这些州，则
Tax Status字段保持空白。 ::::Withholding Allowance：填写州税年度预扣额（仅在有州所得税的州填写）。Extra Withholding：填写除Withholding Allowance之外的额外预扣额（同上）。
常见福利
以下福利为美国雇主常提供的项目，请根据员工选择填写相应信息。
:::: note ::: title 注 :::
若还有其他需在工资单中扣除的福利，可作为 inputs 添加。 ::::
税前扣除
税前福利会降低员工的毛工资，从而减少税基。它们在工资单的毛工资之前显示。
退休计划区
配置员工与雇主的 401(k) 贡献：
401(k)：填写每期从工资单中扣除的金额，可为百分比或固定金额。Matching Amount：雇主为员工 401(k) 所匹配的金额，同样支持百分比或固定金额。Matching Yearly Cap：若雇主匹配有上限，填写该上限（可用百分比表示年薪的比例）。
::: example 公司为员工提供 401(k) 计划，匹配员工贡献的 50%，上限为每年 5,000 美元。员工年薪 50,000 美元，贡献 20%（即 10,000 美元）。
配置方式：401(k) 填写 20.00，Matching Amount 填写 50.00，Matching Yearly Cap 填写 20.00。
:::
健康福利区
填写每期工资单中从员工工资中扣除的健康保险费用。
其他福利区
目前仅包含 Commuter（通勤）福利字段，填写对应的每期扣除金额。
税后扣除区
此类福利在税后扣除，仅在工资单的净额之前显示。目前仅有 ROTH 401(k) 一项。填写百分比或固定金额，即从员工净工资中扣除后存入 ROTH 401(k) 账户。
薪资配置
在 Payroll 应用中会安装美国专用的薪资结构、结构类型、规则和参数。
薪资结构与结构类型
安装 l10n_us_hr_payroll 模块后，会自动创建名为 United States: Regular Pay 的 Salary Structure，以及对应的 Structure Type United States: Regular Pay。
该结构包含所有 salary rules，指导 Payroll 应用如何计算工资单。
薪资规则 {#payroll/usa_rules}
在 Payroll app --> Configuration --> Structures 中展开 United States: Employee 组，可查看 United States: Regular Pay 结构的详细规则。
每条规则定义了包括佣金、奖金、税费和保险等在内的计薪方式。
规则逻辑概述：
前四条规则汇总所有收入来源，包括合同上的
Basic Salary、Commissions、Tips与Bonuses。将这些收入相加得到 Gross Pay（毛工资），随后用于计算税费。
接下来是税前福利与应税收入，如
Medical保险、Commuter Benefits等。系统在计算完毛工资后，先扣除税前福利，得到 Taxable Income（应税收入）。然后列出各种税费规则，先是联邦税，随后是州税（若适用）。
:::: note ::: title 注 :::
工伤赔偿税规则位于若干州特定扣除之后，不在上述截图中。 ::::
最后是税后扣除。
Other Inputs选项卡包含其他可能影响工资单的项目，如Tips、Child Support等。净工资 = 毛工资 + 补贴 - 税费 - 一般扣除。
还有 雇主扣除 部分，列出雇主需承担的税费（如工伤赔偿）。
:::: note ::: title 注 :::
工伤赔偿的雇主扣除同样位于若干州特定扣除之后。 ::::
规则参数
某些计算需要特定比例或上限，Rule Parameters 用于存储这些数值（百分比或固定金额），供薪资规则引用。
例如，2025 年社会保险税的工资基数上限存于 US: FICA OASDI Cap 参数中。
在 Payroll app --> Configuration --> Rule Parameters 中可查看并编辑这些参数。仅在联邦或州参数实际改变且与 Odoo 默认不符时才修改，并务必核对当地法规。
:::: important ::: title 重要 :::
Odoo 会自动为当前日历年添加最新的规则参数，不建议自行修改，除非确有法规变动。 ::::
运行美国 payroll
在生成工资单前，Payroll 负责人必须先 验证 员工的 work entries <../work_entries>，确保工时准确、加班合理、请假已批准。
工作条目依据员工的 contract <../contracts> 配置，从工作计划、考勤记录、排班以及批准的请假中同步生成。
如出现 冲突或不一致，需先解决后再 regenerate <payroll/regenerate-work-entries>。
确认无误后，可在 Payroll 应用中 创建 草稿工资单，方式有：
- 单独
created individually <payroll/process> - 批量
in groups <../pay_runs>（即 Pay Runs）
:::: note ::: title 注 :::
通常会按工资类型（固定/计时）、发薪频率（周、双周、月）或部门等分批处理，以提升效率。 ::::
核对工资单
检查草稿工资单的 Worked Days & Inputs 标签页，确保工时、补贴、佣金、报销等全部正确。随后核对各项合计（毛工资、税费、福利、雇主税、净工资），点击 Compute Sheet 重新计算，如无误点击 Validate 完成。
会计核对
运行 payroll 时会产生两类会计操作：
- 分录创建
payroll/journal - 付款登记
payroll/register
分录创建 {#payroll/journal}
工资单确认后，系统会生成会计分录（草稿），可