美国¶

美国薪资本地化涵盖员工的薪资计算，包括员工和雇主的薪资税。它考虑了联邦和州法规。

此本地化中包含的州有：

加利福尼亚州 (CA)
纽约州 (NY)
德克萨斯州 (TX)
佛罗里达州 (FL)
科罗拉多州 (CO)
阿拉巴马州 (AL)
华盛顿州 (WA)
内华达州 (NV)

注解

联邦税（所得税、 FICA 和失业税）对于员工和雇主都默认包含在 Odoo 美国薪资本地化中。随着时间的推移，将添加其他州，因此请回来查看更新。

在配置美国本地化之前，请参考通用的工资文档，其中包含所有本地化的基本信息，以及所有通用设置和字段。

应用和模块¶

安装以下模块以获取美国工资本地化的所有功能：

名称	技术名称	依赖项	描述
美国 - 工资	`l10n_us_hr_payroll`	hr_payroll hr_contract_reports hr_work_entry_holidays hr_payroll_holidays	提供美国工资基础，包括员工税务详情、工资结构（基本/总/净）、税务规则和 W-2/3PA 报告。
美国 - 带会计的工资	`l10n_us_hr_payroll_account`	hr_payroll_account l10n_us l10n_us_hr_payroll	通过创建日记账条目（如果需要，按工资单）将工资和会计联系起来，以在公司的账簿中记录工资。

参见

配置美国财务本地化

通用配置¶

首先，必须配置公司。导航到设置应用 ‣ 用户和公司 ‣ 公司。从列表中，选择所需的公司，并配置以下字段：

公司名称：在此字段中输入企业名称。
地址：填写完整地址，包括城市、州、邮政编码和国家。

重要
公司地址中选择的州默认关联为员工的 工作地址 ，并用于计算工资税。
税号：输入公司的 EIN（雇主识别号）。
公司 ID ：输入企业的州 ID 号码。
货币：默认选择 USD（美元）。如果没有，从下拉菜单中选择 USD 。
电话：输入公司电话号码。
电子邮件：输入用于一般联系信息的电子邮件。

警告

确保信息准确，因为在创建 W-2 表时会使用它。

员工¶

每个受薪员工都必须为其配置美国工资本地化的员工档案。在为美国配置数据库后，会出现其他字段。

要更新员工表单，打开员工应用并点击所需的员工记录。在员工表单上，在相关标签页中配置所需字段。

工作标签页¶

在工作标签页的位置部分输入员工的工作地址。

重要

此地址中选择的州决定了 Odoo 在计算税款时应用哪些工资规则。

个人标签页¶

确保员工在私人联系部分的银行账户字段中至少列出一个受信任的银行账户。

这些账户用于通过 NACHA 支付文件的自动化方式支付员工工资。对于没有 受信任 银行账户的员工，无法处理工资。如果未设置受信任的银行账户，工资仪表板上会出现警告，并且在尝试运行工资时会发生错误。

确保在公民身份部分输入了有效的 SSN 编号。 SSN（社会保险号）号码的最后四位数字会显示在员工的工资单上。

薪资标签页¶

合同概览部分¶

此部分包含驱动工资计算的信息。确保配置以下字段：

合同：可以根据需要更新薪酬条件的有效期。
工资类型：选择员工的支付方式。
- 对于每个支付周期收到相同金额的受薪员工，选择固定工资。
- 对于根据工作小时数支付工资的员工，选择小时工资。
小技巧
在工资结构类型中设置默认的工资类型以批量配置员工。如果需要，可以在个别员工记录上覆盖默认值以处理例外情况。
合同类型：决定员工的支付方式和分类，例如受薪豁免、受薪非豁免、小时工。

重要
此字段在工资单上可见。一些州要求工资单说明员工是否豁免或非豁免加班。确保选择符合州法律。
支付类别：为此字段选择美国：员工。这定义了员工的支付时间、默认工作时间表以及适用的工作条目类型。

排班部分¶

工作条目来源：定义在指定的支付周期内如何为工资生成工作条目。选项包括：
- 工作时间表：基于员工分配的工作时间表（例如，每周 40 小时）。
- 考勤：基于考勤应用中的批准的签到小时数。
- 计划：基于计划应用中的排班。
额外工时：勾选此复选框以允许考勤应用添加员工记录的任何额外工作条目。
工作时间：使用下拉菜单选择默认工作安排。这对于有资格获得加班费的员工（通常是小时工，而非受薪员工）尤其重要。

W-2 表格部分¶

W-2 是一份年度税表，报告员工的工资、税款和福利。员工用它来申报纳税。以下选项对应于 W-2 表格 第 13 框 中的复选框。选择适用于员工的任何选项。

法定员工：如果员工免征所得税，但需缴纳 FICA（联邦保险贡献法）税，请勾选此框。
退休计划：如果员工是雇主赞助的退休计划的积极供款者，请勾选此框。
第三方病假工资：如果员工在一年内可能由第三方（例如保险公司）提供病假工资福利的计划下受保，请勾选此框。

W-4 表格部分¶

W-4 是一份 IRS（国税局）表格，用于确定员工的联邦预扣税，由雇主直接汇给 IRS（国税局）。

在此部分为员工配置任何相关字段。

州申报部分¶

员工的婚姻状况会影响他们的工资税。配置以下关于他们状况和预扣税的字段。

状态：使用下拉菜单，选择员工的联邦申报状态。选项包括单身、已婚/RDP 联合申报、已婚/RDP 分开申报、户主或符合资格的未亡配偶/带孩子的 RDP 。这通常来自员工的 W-4 表格。
税务状态：使用下拉菜单，选择员工的州申报状态（如果适用）。

小技巧
联邦和州状态不需要匹配。

注解
截至 2025 年，这些州不征收州所得税：阿拉斯加、佛罗里达、内华达、新罕布什尔、南达科他、田纳西、德克萨斯、华盛顿和怀俄明。如果这些州存在工资本地化，税务状态字段中没有相应的州选项。留空即可。
预扣免税额：输入当年从员工工资中预扣的州税总额。仅当员工居住在征收州所得税的州时才填写此项。
额外预扣：输入当年从员工工资中预扣的额外年度总额（不包括预扣免税额），用于州税，如果员工居住在征收州所得税的州。

常见福利¶

以下福利部分被认为是美国雇主提供的常见福利。需要用员工选择的信息来填写此信息。

注解

此部分列出的福利被认为是公司最常提供的福利。如果存在其他需要定期从工资中扣除的员工福利，可以将它们添加为输入。

税前扣除¶

税前福利降低了员工的总工资，从而减少了税基。这些在工资单开头总工资规定之前显示。

退休计划部分¶

此部分用于配置员工和雇主的 401(k) 供款。填写以下字段：

401(k) ：输入每个支付周期从员工工资单中扣除的金额。可以按工资单金额的百分比 (%) 输入，也可以按每张工资单的特定美元金额 ($/slip) 输入。
匹配金额：输入雇主相对于员工供款而向员工 401(k) 供款的匹配金额。此字段也可以配置为员工供款的百分比 (%)，或每张工资单的特定美元金额 ($/slip)。
匹配年度上限：如果雇主供款有限制，请将其输入为员工年薪的百分比。

Example

一家公司允许员工向 401(k) 退休计划供款，并匹配员工供款的 50%，每年最高 5,000 美元。该员工年薪为 50,000 美元，并将其工资的 20% 投入 401(k)，即 10,000 美元。

要配置此设置，请在 401(k) 字段中输入 20.00 ，在匹配金额字段中输入 50.00 ，并在匹配年度上限字段中输入 20.00 。

健康福利部分¶

此部分用于配置员工的健康保险供款。用从员工 每张工资单 中扣除的相应金额填写每个字段。

其他福利部分¶

此部分目前仅包含一个通勤福利字段。输入每张工资单扣除的金额，用于适用的通勤福利。

税后扣除部分¶

这些类型的福利在计算税款之后算作扣除项。它们出现在工资单末尾，在显示净额之前。目前，此部分仅显示一个字段 ROTH 401(k) 。输入从员工工资中扣除并存入 ROTH 401(k) 账户的工资单金额的百分比 (%)，或每张工资单的特定美元金额 ($/slip)。

薪资配置¶

工资应用中的几个部分安装了特定于美国的工资结构、结构类型、规则和参数。

薪资结构和结构类型¶

当 l10n_us_hr_payroll 模块被安装时，会安装一个新的工资结构：美国：常规工资。此结构包含一个结构类型：美国：常规工资。

工资结构包含所有单独的工资规则，这些规则告知工资应用如何计算员工工资单。

薪资规则¶

要查看告知工资结构如何操作的工资规则，请导航至工资应用 ‣ 配置 ‣ 结构并展开美国：员工组以显示美国：常规工资结构类型。点击美国：常规工资以查看详细的工资规则。

每条规则定义了薪酬的计算方式，考虑了佣金、奖金、税款和保险等因素。美国：常规工资规则背后的逻辑如下：

列出的前四条规则反映了所有收入来源，包括合同上列出的基本工资（基本工资），加上任何津贴，例如佣金、小费和奖金。
将这些输入相加即可计算出总工资（总工资）。此金额是用于计算工资税的基数。
下一组规则是各种税前福利和应税收入，例如医疗保险供款和通勤福利。在计算员工的总工资后，Odoo 会扣除员工合同上列出的所有税前福利，以确定员工的应税收入。
接下来，列出了所有各种税务规则，其中概述了联邦和州的工资预扣税。首先列出联邦税务规则，然后列出任何州规则（如果有）。

注解
工人赔偿 的联邦预扣税规则在列出几个州特定预扣税之后出现，并且没有出现在上图中，但列在规则中。
列出的最后规则是税后员工扣除项。
其他输入标签页包含影响工资的任何其他内容。这包括要添加到工资单的项目，例如小费，以及其他扣除项，例如子女抚养费。
员工的净工资是员工从雇主那里收到的金额。计算净工资的公式是：

\[\text{总工资} + \text{津贴} - \text{工资税} - \text{一般扣除项}\]
此外，美国的工资计算中还有一个额外的部分，称为 雇主扣除项 ，它细分了雇主必须作为其工资税部分支付的款项。

注解
工人赔偿 的雇主扣除规则在列出几个州特定雇主扣除项之后出现，并且没有出现在上图中，但列在规则中。

规则参数¶

某些计算需要特定的相关费率或工资上限。 规则参数 能够列出一个值，无论是百分比还是固定金额，以便在工资规则中引用。

Example

社会保障税计算的工资基数在 2025 年有上限，这在 US: FICA OASDI Cap 参数中有所考虑。

大多数规则从参数模块中提取存储的信息，以获取规则的费率（百分比）和上限（金额）。

要查看规则参数，请导航到薪资应用 ‣ 配置 ‣ 规则参数。此处显示所有规则参数及其链接的薪资规则，可以访问这些规则。通过查找规则的名称来查看与规则相关的参数，并根据需要进行任何编辑。

Example

公司的失业税与 Odoo 默认添加的不同。要更新此设置，请导航至工资应用 ‣ 配置 ‣ 规则参数，然后按 FUTA（联邦失业税法）或需要编辑的州名称过滤结果，并从列表中编辑相应的费率。

重要

Odoo 会为当前日历年添加更新的规则参数。 不建议 编辑规则参数， 除非联邦或州参数已更改 ，并且与 Odoo 创建的规则参数不同。在对规则参数进行任何更改之前，请查阅所有地方和国家法规。

运行美国工资¶

在运行工资之前，工资专员必须验证员工的工作条目，以确认工资准确性并发现错误。这包括检查所有休假是否已批准以及任何加班是否适当。

工作条目根据员工的合同配置同步。Odoo 从分配的工作安排、考勤记录、规划安排和批准的休假中提取数据。

必须解决任何差异或冲突，然后可以重新生成工作条目。

一旦一切正确，可以单独创建草稿工资单或批量创建，在薪资应用中称为 薪资运行 。

注解

为了减少薪资专员的时间，通常按批次处理工资单，可以按工资类型（固定工资与小时工资）、支付计划（每周、每两周、每月等）、部门（直接成本与管理）或任何其他最适合公司的分组进行。

运行工资的过程包括需要执行的不同操作，以确保从工资税中预扣的金额正确，员工收到的净工资金额正确，以及工作小时数的计算反映员工的实际工作小时数等。

运行薪资批次时，在开始分析或验证数据之前，请检查包含的期间、公司和员工是否正确。

起草工资单后，请检查其准确性。检查工作天数与输入标签页，并确保列出的工作时间以及任何其他输入是正确的。添加任何缺失的输入，例如缺失的佣金、小费、报销等。

接下来，检查各种总额（总工资、员工税、福利、雇主税、净工资），然后如果有编辑，点击计算表以更新工资计算。如果一切正确，点击验证。

会计检查¶

运行工资时的会计流程包括两个部分：创建日记账条目和登记付款。

日记账分录创建¶

工资单确认并验证后，日记账分录会单独或批量过账。日记账分录首先创建为草稿。

重要

必须在运行薪资之前决定日记账分录是单独完成还是批量完成。

工资本地化包含了美国 CoA（会计科目表）中的四个账户：

611000 工资与薪金 ：记录总工资和雇主的工资费用部分。还分组没有特定账户的规则值（例如，公司特定福利）。
230100 员工工资税 ：从员工预扣的税款，雇主必须申报和支付。日记账条目的合作伙伴和标签列指示具体税款。
230200 雇主工资税 ：需要申报和支付的雇主部分工资税。日记账条目的合作伙伴和标签列指示具体税款。
230000 应付工资 ：欠员工的净工资。

注解

当公司位于美国时，默认完成 CoA（会计科目表）配置。可以编辑账户代码和名称以适应公司需求。如果没有与工资规则（用于工资结构）关联的 CoA（会计科目表）账户，Odoo 将使用 工资费用 账户创建日记账条目，无论移动的性质如何。

如果日记账分录草稿上的一切看起来正确，请过账日记账分录。

登记付款¶

日记账条目验证后，Odoo 可以生成付款。

重要

要从工资单生成付款，员工必须有一个 受信任的 银行账户。如果员工的银行账户未标记为 受信任 ，则无法通过 Odoo 生成 NACHA 文件。

如果有与工资规则关联的合作伙伴，付款可以按合作伙伴分组。

关闭薪资¶

如果没有错误，则该支付周期的薪资已完成。

报告¶

美国本地化包含几个美国独有的报告，这些报告为员工提供税务信息，并且能够与外部组织（如 ADP）集成。

W2 报告¶

W2 报告 提供一个 CSV 文件，允许员工通过第三方软件电子申报其 W2 报告。要访问此报告，请导航至工资 -> 报告 -> 美国 -> W2 。

要创建 W2 表格，请点击新建，将加载一个空的创建 W2 表格页面。设置开始日期和结束日期`（通常为一个日历年），如果在多公司数据库中，请选择 :guilabel:`公司。

该时间段的所有工资运行会以列表视图显示。要添加任何缺失的工资运行，请点击列表底部的添加行，并选择缺失的文件。

完成后，点击生成按钮创建一个 CSV 文件，其中包含指定时间段内所有工资相关付款的摘要。

表格 941¶

表格 941 报告旨在告知政府从员工薪水中预扣的联邦所得税、 FICA（联邦保险贡献法）税（医疗保险和社会保障）的金额。它还报告员工的税款部分。

要创建此报告，请导航至工资 -> 报告 -> 美国 -> 表格 941 。点击新建按钮，将加载一个新的表格 941 报告页面。配置表格顶部的信息，包括公司、纳税年度、季度、 IRS 付款选项（资金如何发送给 IRS）和存款时间表和纳税义务（向 IRS 付款的频率）。

该时间段的所有工资运行会以列表视图显示。要添加任何缺失的工资运行，请点击列表底部的添加行，并选择缺失的文件。

完成后，点击生成，报告将创建为 CSV 文件，并出现在表格 941 报告仪表板上。然后公司通过第三方下载并提交此报告以进行电子申报。

表格 940¶

表格 940 报告详细说明了为工资预扣的年度 FUTA（联邦失业税法）。

要创建此报告，请导航至工资 -> 报告 -> 美国 -> 表格 940 。点击新建按钮，将加载一个新的表格 940 报告页面。配置表格顶部的信息，包括公司、纳税年度、单一州支付方、多州雇主、在信用减免州支付和 IRS 付款选项（资金如何发送给 IRS）。

该时间段的所有工资运行会以列表视图显示。要添加任何缺失的工资运行，请点击列表底部的添加行，并选择缺失的文件。

完成后，点击生成，报告将创建为 CSV 文件，并出现在表格 940 报告仪表板上。然后公司通过第三方下载并提交此报告以进行电子申报。

将数据导出到第三方应用¶

ADP 导出 报告生成一个 CSV 文件，可以提交给 ADP，然后由 ADP 向员工付款。

CSV 文件总结了员工在指定时间段内的工作小时数，与其薪水或小时工资相关联。该报告是在任何休假确认之后从工作条目生成的。

导出格式旨在与 ADP 格式匹配。由于公司可以自定义其门户并可能需要一些更改，因此数据可以输入到 ADP 中以运行工资。

重要

要访问 ADP 导出报告，必须安装 美国 - 工资 - 导出到 ADP 模块。

Edit on GitHub