Skip to main content
iVentureTeam
Odoo HR & Payroll

Odoo US Payroll in Odoo 19 and 20: State Coverage, Tax Filing, Limits

Odoo US payroll in Odoo 19 and 20: which states are covered, what Odoo files and what it does not, NACHA, ADP and Gusto options, and when to use a provider.

Siddharth JambukiyaSiddharth JambukiyaOdoo Techno-Functional Consultant
November 19, 202612 min read5 views
Odoo US Payroll in Odoo 19 and 20: State Coverage, Tax Filing, Limits cover

Most US companies asking about Odoo payroll want to know if it can replace their payroll provider. For some it can. Our Odoo US payroll implementation work starts with that question, state by state.

Related service: Odoo implementation services — HR, payroll and attendance configured for your local rules.

This guide is for US owners, controllers and HR leads on Odoo 19 or 20. It covers only the US localization. For HR, attendance and payroll setup in any country, read our Odoo payroll setup guide.

This article is general product information, not tax advice. Confirm your federal, state and local obligations with a CPA or payroll tax specialist.

What does Odoo US payroll cover in Odoo 19 and 20?

Odoo US payroll covers payslip calculation, federal and listed state withholdings, employer taxes, benefits deductions and journal entries. It is the Enterprise Payroll app plus a US localization module.

According to Odoo's US payroll documentation, it computes employee and employer taxes under federal and state rules. The main modules are:

ModuleTechnical nameWhat it adds
United States - Payrolll10n_us_hr_payrollTax details, US salary structure, tax rules, W-2 reporting
United States - Payroll with Accountingl10n_us_hr_payroll_accountJournal entries for payroll in the US chart of accounts
NACHA Paymentsl10n_us_payment_nachaNACHA files for bank payments
United States - Payroll - Export to ADPl10n_us_hr_payroll_adpCSV export of worked hours for ADP (Odoo 19 docs)

The employee form holds W-4 data, federal and state filing status, extra withholding and W-2 box 13 flags. Benefits include 401(k) with employer match, health, commuter and Roth 401(k) deductions.

Odoo posts to four default accounts: salaries and wages, employee payroll taxes, employer payroll taxes and salary payable. That accounting link is the main reason to try Odoo payroll.

Which states does Odoo US payroll support?

Odoo 20's documentation lists 25 states plus Washington, D.C.; Odoo 19's lists 19 states plus D.C. We checked both lists in Odoo's documentation source on November 19, 2026. Treat every other state as unverified.

CoverageOdoo 19 docsOdoo 20 docs
Listed in bothAlabama, Arizona, California, Colorado, Florida, Georgia, Idaho, Illinois, Iowa, MississippiSame
Listed in bothNevada, New Jersey, New York, North Carolina, Oregon, Texas, Vermont, Virginia, Washington and D.C.Same
Added in Odoo 20 docsNot listedKansas, Kentucky, Michigan, Missouri, South Carolina, Utah
Total19 states plus D.C.25 states plus D.C.

Some listed states have no state income tax. Odoo's docs name Florida, Nevada, Texas and Washington among them, so the state filing status field stays blank there.

Pennsylvania, Ohio, Massachusetts, Tennessee and every other state are not listed, so treat them as unverified. Odoo says states may be added, so recheck the Odoo 19 US payroll page and the 20.0 page.

The docs for Odoo Online releases 19.3 and 19.4 show the same list as 19.0, but code can move ahead of docs. Run a test payslip for each work state on your exact version.

How does Odoo handle federal vs state payroll tax?

Federal taxes are built in for every employee, while state rules apply only when the employee's work address is in a listed state. The work address state decides which salary rules Odoo uses.

Odoo's salary structure runs in a fixed order:

  1. Gross pay: basic wage plus commissions, tips and bonuses.
  2. Pre-tax deductions: medical, commuter and 401(k) amounts reduce taxable income.
  3. Federal taxes: federal income tax, Social Security, Medicare and federal unemployment.
  4. State taxes: the rules for the employee's work state, if that state is covered.
  5. Post-tax deductions: Roth 401(k) and other inputs such as child support.
  6. Employer deductions: a separate section showing the employer share of payroll taxes.

Rates and wage caps, such as the Social Security wage base, live in rule parameters. Odoo updates them each calendar year and advises editing them only when a rate differs, such as your own unemployment rate.

Odoo 20 docs add that US payroll uses the payment date, not the work date, for tax parameters, annual limits and year-to-date totals. That matters for pay runs that cross January 1.

Does Odoo file and pay US payroll taxes?

Odoo US payroll: What Odoo does and what you still do

No. Odoo calculates and reports the numbers, but you still file the returns and deposit the taxes yourself or through a third party.

ObligationWhat Odoo gives youWhat you still do
Form 941 (quarterly federal)CSV report by quarterE-file through a third party, deposit taxes
Form 940 (annual FUTA)CSV report by yearE-file through a third party, pay FUTA
W-2 for employeesCSV summary for the yearE-file with third-party software, send copies
Net pay to employeesNACHA file from batch paymentsUpload the file to your bank
State withholding returnsWithholding on payslips for listed statesFile and pay with each state agency
Local and city taxesNot described in Odoo's US docsHandle outside Odoo or with custom rules

Odoo's docs say the 941 and 940 files go "through a third party for e-filing." The IRS says Form 941 is filed for each quarter and is generally due by the last day of the month after the quarter ends.

So someone on your team owns deposits, quarterly returns, state filings and year-end forms. If nobody does that today, Odoo payroll adds work.

How does Odoo pay US employees with NACHA direct deposit?

Odoo creates a NACHA ACH file from payroll payments, and you upload that file to your bank's portal. There is no documented direct bank submission for payroll files.

The NACHA setup in Odoo's US accounting docs works per bank journal. Your bank supplies the routing number, company ID, originating DFI number and entry class code (CCD or PPD).

  • Trusted accounts: every employee needs a trusted bank account, or payroll and the NACHA file fail.
  • Batching: all payments in one batch must use the same NACHA payment method.
  • Cut-off times: same-day files must reach the bank before its cut-off, or carry a future date.
  • Corrections: you can regenerate the export file from the batch payment if something changes.

Test with a one-employee batch first, and enter bank values exactly as the bank gives them.

What are the main Odoo US payroll limitations?

The limits are coverage, filing and edge cases, not the payslip engine itself. These are the gaps we check in every US scoping call.

  • Unlisted states: any work state outside the documented list needs custom rules or a provider.
  • Local taxes: Odoo's US payroll docs do not describe city, county or school district income taxes.
  • Multi-state staff: tax rules follow the work address, so remote staff in many states need careful setup.
  • Prevailing wage: not covered in the US payroll docs; certified payroll for public contracts needs extra work.
  • S-corp owners: shareholder health premiums on W-2s are not described, so plan a custom input.
  • Garnishments: only child support appears as a standard input; other orders need inputs and testing.
  • No filing or payment service: Odoo does not file returns or deposit taxes for you.

On the Odoo forum, a 60-employee US company wanted a full-service provider integrated with Odoo to avoid the "legal risk or administrative hassles" of doing it themselves. That is a sensible position.

What changed for US payroll in Odoo 20?

Odoo 20 adds six documented states and reworks how time reaches payroll, which affects ADP exports and custom code.

Our Odoo 20 payroll release notes list 15 changes. Two matter most for US companies:

  • Time data: work entries and the Planning to Payroll bridge were removed; time off and work entry types merged into one Time Type.
  • Exports: provider-specific exports, including ADP, were replaced by one standard Export Time Entries file.

The 20.0 US payroll page still describes work entries and the ADP module, so the docs may lag the code. Test the new export against your ADP import before go-live.

Odoo 20 also adds guided pay runs with a pre-check and test-printed payslips before validation.

Odoo ADP integration and Gusto: when should you use a payroll provider?

Use a payroll provider when you need tax filing and payment as a service, many states, local taxes or year-round compliance support. Keep Odoo as the system for employees, time and accounting.

Gusto says it will "calculate, pay, and file all of your federal, state, and local payroll taxes," which is what Odoo does not do. ADP offers similar full-service payroll.

There are three common patterns:

  1. Hours out, journals in: Odoo exports hours to the provider, and the provider's payroll register comes back as a journal entry.
  2. Journal only: the provider runs everything, and a monthly summary entry posts to Odoo Accounting.
  3. Connector: an Odoo Apps Store module or a custom API sync moves employees, hours and journals.

An Odoo forum thread found no ready Gusto connector as of 2023. Apps Store modules exist now, so vet the version and who supports it. Our Odoo integration services build and test these links.

Odoo payroll or a payroll provider: how do you decide?

Odoo or a provider? Price the project

Run payroll in Odoo when your states are listed, your rules are simple and someone owns filing; otherwise use a provider and integrate it. The table sums up the choice.

Your situationBetter fitWhy
One or two listed states, salaried and hourly staffOdoo payrollPayslips, taxes and journals in one system
Staff in many states or remote across the USProviderWider state coverage and registrations
City or local income taxesProviderOdoo's US docs do not describe local taxes
Public contracts with prevailing wageProvider or customNot in Odoo's US payroll docs
No one to file 941, 940 and state returnsProviderFiling and payment as a service
Heavy overtime and shift rules in a listed stateOdoo payrollAttendance and schedules feed pay directly

Leaving QuickBooks? Our Odoo vs QuickBooks guide covers the wider switch. For a budget, try the Odoo project estimate tool.

Which US industries fit Odoo payroll best?

Odoo payroll fits single-state employers with hourly staff and simple benefits, while multi-state and public-contract employers usually need a provider.

IndustryPain or cost driverOdoo approachHow iVentureTeam helps
ManufacturingShifts, overtime, hourly staffAttendance feeds payslipsSet up schedules and overtime rules
ConstructionPrevailing wage, job costingPayroll costs to projects, provider for certified payrollMap labor costs, connect provider
Professional servicesSalaried staff, many remote statesProvider for taxes, Odoo for timesheetsBuild the journal import
Retail and restaurantsTips, part-time staff, turnoverTips input, hourly wage typeConfigure inputs, test payslips
HealthcareShift rates, multiple sitesSchedules and attendanceModel shift rules, run parallel tests

For hourly teams, the time source matters as much as tax rules. Our guide on attendance vs timesheets in Odoo explains which one should drive pay.

What does Odoo US payroll cost?

Odoo US payroll costs the Odoo user licenses plus setup, and you still pay any third-party e-filing service. There is no separate US payroll fee in Odoo's pricing.

On Odoo's pricing page, US Standard is US$31.10 and Custom is US$61.00 per user a month billed yearly. Employees without an Odoo login count as Light Users at US$8.90 a month, so a 60-person workforce adds license cost even if few people log in.

Our published setup ranges are $3k to $9k for small projects, $9k to $27k for mid-size and $27k to $150k+ for large ones. See our US Odoo implementation partner page for how we work with US teams.

How iVentureTeam helps with Odoo US payroll

We tell you early whether Odoo payroll fits your states and rules, then build it or connect the provider that does. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.

  • State check: every work state compared with Odoo's documented list on your exact version.
  • Setup and testing: salary rules, benefits, NACHA and a parallel run against your current payroll.
  • Provider integration: ADP, Gusto or another provider linked to Odoo, with hours out and journals in.
  • Payroll app scope: what the Odoo Payroll app covers before you add custom rules.
  • Odoo 20 upgrades: time data and export changes tested before your first pay run.

Odoo payroll data case study: Enabl Health

Clean time data is what makes payroll and billing trustworthy, and Enabl Health shows the work involved. This project ran in Australia, not the US, but the time-to-pay lessons carry over.

Enabl Health tracked work hours with manual start and stop times and needed different rates for weekdays, weekends and holidays. Its stack included Odoo Timesheets, Odoo Payroll and Odoo Invoicing on Odoo.sh.

We cleaned five data sets, including timesheets and payslips, and automated day-type classification across three rate types. Staging and production branches on Odoo.sh kept testing safe over a 10-week delivery.

Read the Enabl Health timesheet and billing case study.

The bottom line on Odoo US payroll

Odoo US payroll is a solid choice for employers in listed states with someone in-house to file and pay taxes; everyone else should pair Odoo with a payroll provider. Check your states first.

List every work state, compare it with Odoo's current docs, and decide who files the 941, 940, W-2 and state returns. If the answers are simple, run payroll in Odoo; if not, integrate a provider.

Ready to check if Odoo can run your US payroll?

Get a US payroll fit review

Send us your states, headcount and pay rules for a straight answer. Get an Odoo US payroll fit review, call +91-90235-15208, or email business@iventureteam.com.

Frequently Asked Questions

Does Odoo support US payroll?

+

Yes. Odoo Enterprise includes a US payroll localization that calculates federal taxes, listed state taxes, benefits and employer taxes. It does not file returns or pay taxes to agencies for you.

How many states does Odoo payroll support?

+

Odoo 20's documentation lists 25 states plus Washington, D.C. Odoo 19's lists 19 states plus D.C. Check the current docs for your version before you rely on it.

Does Odoo file Form 941 and W-2s?

+

No. Odoo generates CSV files for Form 941, Form 940 and W-2s. You submit them through a third-party e-filing service and make tax deposits yourself.

Can Odoo do direct deposit for payroll?

+

Yes, through NACHA files. Odoo generates the ACH file from payroll payments, and you upload it to your bank. Each employee needs a trusted bank account.

Does Odoo integrate with ADP?

+

Odoo 19 has an ADP export of worked hours. Odoo 20 replaced provider-specific exports with one standard time export, so test it against your ADP import format.

Is there an Odoo Gusto integration?

+

There is no official Odoo connector. Apps Store modules and custom API syncs exist, or you can post Gusto's payroll register to Odoo as a journal entry.

Does Odoo handle local and city payroll taxes?

+

Odoo's US payroll documentation does not describe city, county or school district taxes. Plan custom rules or a payroll provider if you have them.

Is Odoo payroll included in the Standard plan?

+

Odoo's per-user price includes all apps, including Payroll. Employees without a login count as Light Users at US$8.90 a month in the US.

Should a small US business use Odoo payroll?

+

If you operate in one or two listed states and someone owns filing, it can work well. If not, a provider with filing included is usually safer.

Free payroll setup review

Setting up payroll in Odoo?

Tell us your headcount and pay rules. We set up salary rules, statutory files and leave in Odoo, and show what needs a custom module.

Free, with no obligation. A senior consultant replies within 12 business hours.

We use cookies to improve your experience

Essential cookies make the site work, and we use analytics to improve it. Choose “Only necessary” to turn analytics off. See our cookie policy.