美国¶
美国薪资本地化涵盖员工的工资计算，包括雇员与雇主两侧的薪资税，并考虑联邦与州的法规。
该本地化涵盖的州包括：
州 |
缩写 |
|---|---|
Alabama |
(AL) |
Arizona |
(AZ) |
California |
(CA) |
Colorado |
(CO) |
Florida |
(FL) |
Georgia |
(GA) |
Idaho |
(ID) |
Illinois |
(IL) |
Iowa |
(IA) |
Kansas |
(KA) |
Kentucky |
(KY) |
Michigan |
|
Mississippi |
(MS) |
Missouri |
(MO) |
内华达州 |
(NV) |
新泽西州 |
(NJ) |
纽约州 |
(NY) |
北卡罗来纳州 |
(NC) |
俄勒冈州 |
(OR) |
南卡罗来纳州 |
(SC) |
得克萨斯州 |
(TX) |
犹他州 |
(UT) |
佛蒙特州 |
(VT) |
弗吉尼亚州 |
(VA) |
华盛顿州 |
(WA) |
华盛顿哥伦比亚特区 |
(DC) |
注解
在 Odoo 美国薪资本地化中，员工和雇主双方的联邦税（所得税、FICA 和失业保险税）默认已涵盖。
各州可能会陆续增加，请随时回来查看更新。
在配置美国本地化之前，请参阅通用的 薪资 文档，其中包含所有本地化的基本信息以及所有通用设置和字段。
应用与模块¶
请 安装 以下模块，以获得美国薪资本地化的全部功能：
名称 |
技术名称 |
依赖 |
描述 |
|---|---|---|---|
United States - Payroll |
|
|
提供美国薪资基础功能，包括员工税务详情、薪资结构（基本工资/应发工资/实发工资）、税务规则以及 W-2/3PA 申报。 |
United States - Payroll with Accounting |
|
|
通过创建日记账分录（如有需要，可每张工资单一笔）将薪资与会计关联，把薪资记录到公司账簿中。 |
更多内容
常规配置¶
首先必须配置公司。导航到 。在列表中，选择所需的公司，并配置以下字段：
公司名称：在此字段中输入企业名称。
Address：填写完整地址，包括 City、State、Zip Code 和 Country。
重要
在公司地址中选择的州默认作为员工的 工作地址，也是计算薪资税所使用的地址。
税号：输入公司的 EIN。
公司 ID：输入企业的州识别号。
币种：默认已选择 USD。如未选中，请从下拉菜单中选择 USD。
Phone：输入公司电话号码。
Email：输入用于一般联络的邮箱。
警告
请确保信息准确，因为创建 W-2 表时会使用这些信息。
人事管理¶
每位领取薪资的员工都必须按美国薪资本地化的要求配置其员工档案。在为数据库配置美国本地化后，会出现额外的字段。
要更新员工表单，请打开 应用并点击所需的员工记录。在员工表单上，于相关选项卡中配置必填字段。
工作选项卡¶
在 工作 选项卡的 位置 部分，为员工输入 工作地址。
重要
此地址中选择的州决定了 Odoo 在计算税费时应用哪些薪资规则。
个人选项卡¶
确保员工至少有一个受信任的 银行账户 列在 私人联系信息 部分的 银行账户 字段中。
这些账户通过 NACHA 付款文件自动向员工付款。若员工没有 可信 的 银行账户，则 无法 为其处理薪资。如果未设置可信银行账户，薪资 仪表板上会出现警告，且尝试运行薪资时会报错。
请确保在 国籍 部分录入了有效的 SSN 号；员工工资单上会显示 SSN 号码的后四位。
薪资选项卡¶
合同概览部分¶
此部分包含驱动薪资计算的信息。请确保配置了以下字段：
Contract：可根据需要更新薪酬条款的有效期。
薪资类型：选择员工的支付方式。
对于每个发薪周期领取相同金额的受薪员工，请选择 固定工资 。
对于按工时计酬的员工，请选择 计时工资 。
小技巧
在薪资 结构类型 中设置默认的 工资类型，即可批量配置员工。如有需要，可以在单个员工记录上覆盖该默认值。
合同类型：决定员工的薪酬支付方式与类别归属，例如 Salary-exempt、 Salary-nonexempt、 Hourly。
重要
此字段会显示在工资单上。某些州要求工资单注明员工属于加班豁免还是非豁免类别。请确保所选项符合所在州的法律。
薪资类别：为此字段选择 United States: Employee。它定义了员工的付款时间、默认工作时间表以及适用的工作记录类型。
排班部分¶
W-2 表部分¶
W-2 是一份年度税务表格，用于报告员工的工资、税款和福利，员工用它来申报纳税。以下选项对应 W-2 表格中 第 13 栏 的复选框，请选择适用于员工的选项。
Statutory Employee：如果员工免于缴纳所得税但需缴纳 FICA 税，请勾选此框。
Retirement Plan：如果员工正积极参与雇主发起的退休计划供款，请勾选此框。
Third-Party Sick Pay：如果员工所属计划中，病假福利可能在当年由第三方（例如保险公司）提供，请勾选此框。
W-4 表部分¶
W-4 是一份 IRS 表格，用于确定员工的联邦预扣税，由雇主将其直接汇缴给 IRS。
请在此部分为员工配置所有相关字段。
税务申报部分¶
员工的婚姻状况会影响其薪资税。请配置以下与其身份状态和预扣税款相关的字段。
联邦税务状态：使用下拉菜单选择员工的 联邦 申报状态。选项包括 单身、已婚/RDP 共同申报、已婚/RDP 分别申报、户主 或 符合条件的有子女丧偶配偶/RDP。这通常来自员工的 W-4 表格。
州税务状态：使用下拉菜单选择员工的 州 申报状态（如适用）。
小技巧
联邦与州的申报状态 无需 一致。
注解
截至 2025 年，以下州 不 征收州所得税：阿拉斯加州、佛罗里达州、内华达州、新罕布什尔州、南达科他州、田纳西州、得克萨斯州、华盛顿州和怀俄明州。如果这些州有对应的薪资本地化，则 州税务状态 字段中 没有 相应的州选项，可以将该字段留空。
预扣免税额：输入当年应因州税而从员工工资中预扣的年度总额。仅当员工居住在征收州所得税的州时才填写此项。
额外预扣额：如果员工居住在征收州所得税的州，请输入当年应 额外 从员工工资中预扣的州税年度总额（不含 预扣免税额 金额）。
常见福利¶
以下福利部分属于美国雇主提供的常见福利，需要用员工所选的信息进行填写。
注解
本节列出的福利是企业最常提供的。如果存在其他需要定期从工资中扣除的员工福利，可将其作为 输入项 添加。
税前扣除¶
税前福利会降低员工的应发工资，从而减少计税基数。这些项目显示在工资单开头、应发工资确定之前。
退休计划部分¶
在此部分配置员工与雇主的 401(k) 供款。请填写以下字段：
401(k)：输入每个发薪周期从员工工资单中扣除的金额，可按工资单金额的百分比（%）或每张工资单的具体美元金额（$/slip）填写。
Matching Amount：输入雇主相对于员工供款向员工 401(k) 账户匹配供款的金额。此字段同样可按员工供款的百分比（%）或具体美元金额（$/slip）配置。
Matching Yearly Cap：如果雇主供款存在上限，请按员工年薪的百分比输入该上限。
示例
某公司允许员工向 401(k) 退休计划供款，并按员工供款的 50% 进行匹配，每年匹配上限为 5,000 美元。员工年薪 50,000 美元，并将其工资的 20% 存入 401(k)，即 10,000 美元。
为此配置时，在 401(k) 字段中输入
20.00，在 Matching Amount 字段中输入50.00，在 Matching Yearly Cap 字段中输入20.00。
健康福利部分¶
在此部分配置员工的健康类供款。请根据 每张工资单 中员工对应的扣款金额填写每个字段。
其他福利部分¶
此部分目前仅包含 Commuter 通勤福利字段。如有适用的通勤福利，请输入每张工资单应扣除的金额。
税后扣除部分¶
此类福利在计算税款 之后 作为扣减项处理，显示在工资单末尾、实发金额之前。当前此部分仅显示 ROTH 401(k) 一个字段。请输入按工资单金额百分比（%）或每张工资单的具体美元金额（$/slip）从员工工资中扣除、并存入 ROTH 401(k) 账户的数额。
薪资配置¶
薪资 应用内的多个部分会安装适用于美国的薪资结构、结构类型、规则与参数。
薪资结构与结构类型¶
当 l10n_us_hr_payroll 模块被 安装 后，系统会安装一个新的 薪资结构，即 United States: Regular Pay。该结构包含一个 结构类型，即 United States: Regular Pay。
Salary Structure （工资结构）包含所有单项 薪资规则，用于告知 Payroll 应用如何计算员工工资单。
薪酬规则¶
要查看为薪资结构提供依据的薪资规则，请前往 ，展开 United States: Employee 组以显示 United States: Regular Pay 结构类型。点击 United States: Regular Pay 查看详细的薪资规则。
每条规则定义了工资的计算方式，并考虑佣金、奖金、税款和保险等因素。 United States: Regular Pay 规则背后的 逻辑 如下：
前四条规则反映了所有收入来源，包括合同上列明的基本工资 Basic Salary，以及各项津贴，例如 Commissions、 Tips 和 Bonuses。
对这些输入项求和即可得到应发工资（Gross Pay）。该金额是计算薪资税的基础金额。
下一组规则是各项税前福利和应税收入，例如 Medical 保险缴费和 Commuter Benefits。计算出员工的 Gross Pay 后，Odoo 会扣除员工合同上列出的所有税前福利，以确定员工的 Taxable Income。
接下来列出所有各类税规则，其中联邦和州的薪资预扣均有说明。首先列出联邦税规则，然后列出任何州规则（如有）。
注解
Worker's Compensation的联邦预扣规则出现在若干州特有预扣规则 之后，不 出现在上方图片中，但已在规则中列出。最后列出的规则是税后员工扣款。
其他录入项 选项卡包含影响薪资的其他所有内容，包括需要添加到工资单的项目（例如 小费）以及其他扣款（例如 子女抚养费）。
员工的净工资是员工从雇主处实际收到的金额。计算净工资的公式为：
\[\text{Gross Salary} + \text{Allowances} - \text{Payroll Taxes} - \text{General Deductions}\]此外，美国的薪资计算还有一个名为
Employer Deductions的附加部分，用于分解雇主必须作为其薪资税份额支付的各项款项。
注解
Worker's Compensation的雇主扣款规则出现在若干州特有的雇主扣款规则 之后，不 出现在上方图片中，但已在规则中列出。
规则参数¶
某些计算需要与之关联的特定税率或工资封顶额。规则参数 能够列出一个百分比或固定金额值，以便在薪资规则中引用。
示例
2025 年社会保障税计算的工资基数设有上限，体现在 US: FICA OASDI Cap 参数中。
大多数规则从参数模块中提取所存储的信息，以获取规则税率（百分比）和封顶额（金额）。
要查看规则参数，请导航到 。在此，所有规则参数都会连同其关联且可访问的 薪资规则 一同显示。通过查找规则的 名称 来查看与某条规则关联的参数，并按需进行任何编辑。
示例
公司的失业税与 Odoo 默认添加的失业税不同。要更新此税率，请导航到 ，然后按 FUTA 或需要编辑的州名筛选结果，并在列表中编辑对应的税率。
重要
Odoo 会为当前日历年添加更新后的规则参数。除非联邦或州参数已发生变化 并且与 Odoo 创建的规则参数不同，否则 不 建议编辑规则参数。在更改任何规则参数 之前，请对照所有地方和国家法规进行核实。
运行美国薪资¶
在运行薪资之前，薪资管理员必须验证员工的 工作记录，以确认工资准确并发现错误。这包括检查所有休假是否已批准以及加班是否合适。
工作记录根据员工的 合同 配置进行同步。Odoo 从指定的工作日程、考勤记录、排班日程和已批准的休假中获取数据。
一切确认无误后，可以 单独创建 工资单草稿，或在 分组 中创建，在 薪资 应用中称为 薪资批次。
注解
为节省薪资专员的时间，通常按批次处理工资单，可按工资类型（固定工资或时薪）、发薪计划（每周、双周、每月等）、部门（直接成本或行政管理），或其他最适合公司的分组方式。
运行薪资的流程包括需要执行的多项操作，以确保薪资税扣除金额正确、员工实得的净工资正确，以及工时计算反映员工的实际工作时间等。
运行薪资批次时，在开始分析或验证数据 之前，请检查所涵盖的期间、公司和员工是否正确。
工资单生成草稿后，检查其准确性。查看 Worked Days & Inputs 标签页，确保所列的工作时间以及其他录入项正确。补充缺失的录入项，如提成、小费、报销等。
接下来，检查各项合计（应发工资、员工税费、福利、雇主税费、实发工资），如有修改，点击 Compute Sheet 更新薪资计算。如果一切正确，点击 Validate。
重要
在美国，薪资税和工资申报通常以工资 支付 的日期为依据，而 不是 工作执行的日期。因此，Odoo 在美国薪资中将付款日期作为参考日期，用于计算薪资规则、应用税务参数和年度限额，以及确定年初至今的金额。这有助于确保薪资计算符合美国的税务和申报要求。
会计检查¶
创建日记账分录¶
工资单确认并验证后，日记账分录可逐张或按批次过账。日记账分录首先以草稿形式创建。
重要
在运行薪资 之前，必须确定日记账分录是逐张创建还是按批次创建。
美国薪资本地化包含美国 CoA 中的四个科目：
611000 Salaries & Wages：记录应发工资和雇主的薪资费用份额，同时归集没有专用科目的规则所产生的金额（例如公司特有福利）。230100 Employee Payroll Taxes：从员工工资中预扣、需由雇主申报并缴纳的税款。日记账分录的往来对象和标签列标明具体税种。230200 Employer Payroll Taxes：需申报并缴纳的雇主薪资税份额。日记账分录的往来对象和标签列标明具体税种。230000 Salary Payable：应付给员工的净工资。
注解
当公司位于美国时，CoA 配置会默认完成。科目代码和名称可以修改以适合公司需要。如果某个薪资规则（用于薪资结构）没有关联任何 CoA 科目，无论该分录的性质如何，Odoo 都会使用 Salary Expenses 科目来创建日记账分录。
如果日记账分录草稿一切正确，请过账这些日记账分录。
登记付款¶
日记账分录 验证后，Odoo 可以生成付款。
重要
要从工资单生成付款，员工 必须 拥有 受信任 （trusted）的银行账户。如果员工的银行账户 未 标记为 trusted，则 无法 通过 Odoo 生成 NACHA 文件。
如果薪资规则关联了某个伙伴，付款可按 Grouped by Partner （按伙伴分组）方式生成。
关闭薪资¶
如果没有错误，该发薪周期的薪资工作即告完成。
报告¶
美国本地化包含多份美国特有的报表，为员工提供税务信息，并可与 ADP 等外部机构集成。
W2 报表¶
W2 Report 生成一个 CSV 文件，使员工可以使用第三方软件电子申报其 W2 报告。要访问此报表，请导航到 。
要创建 W2 表格，请点击 新建，系统会加载空白的 创建 W2 表格 页面。设置 开始日期 和 结束日期，通常为一个日历年；如果数据库为多公司模式，请选择 公司。
该时间段内的所有薪资发放都会出现在列表视图中。要添加任何遗漏的薪资发放，请点击列表底部的 Add a line，并选择遗漏的文件。
完成后，点击 Generate 按钮，生成一个 CSV 文件，其中汇总了指定时间段内进行的所有与薪资相关的付款。
Form 941 表¶
Form 941 报表用于向政府通报从员工工资中预扣的联邦所得税和 FICA 税（Medicare 和社会保障）的金额。它还报告员工一侧的税款。
要创建此报表，请导航到 。点击 New 按钮，系统会加载一个新的 Form 941 报表页面。在表单顶部填写信息，包括 Company、Tax Year、Quarter、IRS Payment Option （款项如何汇给 IRS）和 Deposit Schedule and Tax Liability （向 IRS 缴款的频率）。
该时间段内的所有薪资发放都会出现在列表视图中。要添加任何遗漏的薪资发放，请点击列表底部的 Add a line，并选择遗漏的文件。
完成后，点击 Generate，报表将生成为 CSV 文件并显示在 Form 941 报表仪表板上。然后公司下载此报表并通过第三方进行电子申报。
Form 940 表¶
Form 940 报表详述了薪资中预扣的年度 FUTA。
要创建此报表，请导航到 。点击 New 按钮，系统会加载一个新的 Form 940 报表页面。在表单顶部填写信息，包括 Company、Tax Year、Single State Payer、Multi State Employer、Paid in Credit Reduction State 和 IRS Payment Option （款项如何汇给 IRS）。
该时间段内的所有薪资发放都会出现在列表视图中。要添加任何遗漏的薪资发放，请点击列表底部的 Add a line，并选择遗漏的文件。
完成后，点击 Generate，报表将生成为 CSV 文件并显示在 Form 940 报表仪表板上。然后公司下载此报表并通过第三方进行电子申报。
将数据导出到 ADP¶
ADP Export 报表生成一个可提交给 ADP 的 CSV 文件，然后由 ADP 向员工支付工资。
该 CSV 文件汇总员工在指定时间段内的工作时数，并与其固定工资或小时工资对应。此报表基于 工作记录 生成，且是在所有休假得到确认 之后 才生成。
该导出格式旨在与 ADP 的格式匹配。由于公司可以自定义其门户并可能需要一些更改，这些数据将被提供给 ADP，以便在其中运行薪资。
重要
要访问 ADP Export 报表，United States - Payroll - Export to ADP 模块 必须 已 安装。
设置¶
要将数据导出到 ADP，公司 必须 在公司设置中配置 ADP 代码。请进入 。在 美国本地化 部分，在对应字段中输入 ADP 代码。
接下来，每个被引用的工作记录类型都 必须 在 外部代码字段 中列出正确的 ADP 代码。
最后，每位员工都 必须 在其员工表单中输入 ADP 代码。要添加此代码，请打开 ，点击员工记录，然后点击进入 薪资 选项卡。在 ADP 信息 部分，在对应字段中输入 ADP 代码。
ADP 代码 是 ADP 用来识别特定员工的方式，通常为六位数字。
导出数据¶
一旦 工作记录 经过验证，信息就会导出为 CSV 文件，然后上传到 ADP。
要导出数据，请进入 ，然后点击 新建。接下来，使用日历弹出窗口输入工作记录的 开始日期 和 结束日期。
然后，在对应字段中输入 批次 ID。建议此字段以 YY-MM-DD 格式输入日期，并在后面加上其他字符以区分该特定工资单批次，例如部门名称。
在对应字段中输入 批次说明。该说明应简短且具有描述性，但与工资单批次的名称有所区别。
确保 公司 字段中填充了正确的公司。如有需要，使用下拉菜单更改所选公司。
最后，将员工的工作记录信息添加到列表中。点击 添加一行，系统会加载 添加：员工 弹出窗口。可以 筛选 列表，以查找要添加到列表中的员工。
小技巧
请将数据导出分成多个组来处理，而不是放在一个包含所有员工的大组中。这有助于有意义地区分各个批次，并使整体处理更易于管理。最常见的员工分组方式是按部门或按工资类型（小时工或月薪制）。
点击员工姓名左侧的复选框，选择要添加到列表中的员工。选择完所有需要的员工后，点击角落的 选择 按钮，员工便会出现在列表中。
要创建 CSV 文件，请点击 生成 按钮。
更多内容