Skip to main content
iVentureTeam
Odoo Accounting & Tax

Odoo Puerto Rico IVU Setup: Tax Rates, Invoicing and Reports in 19/20

Set up Puerto Rico IVU in Odoo 19 and 20: 11.5% state and municipal taxes, the 4% B2B rate, exemptions, invoices, the US tax report and SURI filing.

Siddharth JambukiyaSiddharth JambukiyaOdoo Techno-Functional Consultant
November 20, 202614 min read1 view
Odoo Puerto Rico IVU Setup: Tax Rates, Invoicing and Reports in 19/20 cover

Puerto Rico businesses that pick Odoo usually find the same gap: the software knows US sales tax, but nobody explains IVU. Our Odoo implementation services close that gap with a tested tax setup, not a promise.

Related service: Odoo for finance teams — accounting, tax and reporting automation.

This guide is for controllers, owners and accountants in Puerto Rico running or moving to Odoo 19 or 20. If you are new to how taxes flow into the ledger, start with our guide on how Odoo Accounting works.

We checked Odoo's official 19.0 and 20.0 documentation and the Odoo source code on November 20, 2026. Anything we could not confirm is labelled "unconfirmed". We have not yet run this exact setup in a live Puerto Rico database, so test it in staging first.

Does Odoo have a Puerto Rico localization?

No, Odoo does not ship a Puerto Rico localization module, so IVU runs on the United States package plus your own tax setup. That is workable, because the US package already models state and local sales tax.

We looked for an `l10n_pr` module in the Odoo 19.0, 20.0 and master branches and found none. The United States localization docs also never mention Puerto Rico by name.

What Odoo does have:

  • Puerto Rico as a country: a country record with code PR and US dollars as its currency.
  • Puerto Rico as a US state: a state record under the United States with code PR, present in 19.0 and 20.0.
  • Municipalities in Odoo 20: the 20.0 US module loads a US county data file that includes 77 Puerto Rico municipality records.
  • Cities in Odoo 20: 281 Puerto Rico city records, each linked to a municipality.

One gap we spotted in that 20.0 data: Las Marías has a city record but no county record of its own, and its city points to Añasco. If you operate there, add the missing record before you map your municipal tax.

For a wider view of what country modules leave out, see our post on Odoo localization gaps.

What are the Puerto Rico IVU rates Odoo needs to handle?

Most sales carry 11.5% IVU, split into 10.5% state and 1% municipal, but several reduced and exempt cases need their own taxes in Odoo. Build each one as a separate tax so reports stay clean.

IVU caseRateWho receives itOdoo approach
Standard goods and taxable services10.5% state + 1% municipalHacienda and your municipalityTax group with two child taxes
B2B services and designated professional services4%Hacienda onlySeparate 4% tax, no municipal part
Prepared food at qualifying restaurants7%Check with your accountantSeparate 7% tax for certified sites
Unprepared food, prescribed medicineExemptNoneNontaxable mapping
Sales to eligible resellersExempt with certificateNoneExempt fiscal position
Imported goods for own useUse taxHaciendaPurchase tax on vendor bills

These figures come from the Grant Thornton Puerto Rico indirect tax guide dated January 2025. Confirm current rates with Hacienda or your accountant before go-live.

The same guide lists small-business service exemptions: annual volume of $50,000 or less for taxable services, $200,000 for professional services and $300,000 for B2B services.

The 7% prepared food rate started on October 1, 2019, as Hacienda announced in July 2019. Restaurants need a certificate under DA 19-03.

Should you set the company as Puerto Rico or as a US state?

Set the company country to United States and the state to Puerto Rico, so Odoo loads the US package and tax features. Then keep customer addresses consistent, or fiscal positions will not match.

Odoo picks a chart of accounts based on the company country. In the 20.0 source, a fallback list maps French overseas territories to France, but there is no entry mapping Puerto Rico to the United States. A company with country "Puerto Rico" may not get the US package by default.

There is a second reason. The Odoo AvaTax documentation says AvaTax works only when the fiscal country is the United States, Canada or Brazil.

The catch is customer data. Odoo has both a Puerto Rico country and a Puerto Rico state, and imported addresses often mix them. A fiscal position keyed to "United States, state Puerto Rico" will not detect a customer saved with country "Puerto Rico". Clean this before go-live.

Odoo 20 also changes the chart itself: our Odoo 20 accounting release notes show that account codes are now optional and the US chart ships without codes. Decide early whether your accountant wants codes added back.

How do you configure IVU taxes in Odoo 19 and 20?

Build IVU as a group of taxes: one 10.5% state tax and one 1% municipal tax, combined into an 11.5% group for daily use. Users pick one tax, and the ledger keeps the two parts apart.

Follow these steps in a staging database first:

  1. Company: set country United States, state Puerto Rico, currency USD, and confirm the fiscal localization package is United States.
  2. Accounts: create separate liability accounts for state IVU payable, municipal IVU payable and use tax payable.
  3. Child taxes: create "IVU Estatal 10.5%" and "IVU Municipal 1%" with Tax Type set to None, so they only appear inside the group.
  4. Group: create "IVU 11.5%" as a group of taxes containing both children, Tax Type Sales, and set its invoice label.
  5. Special rates: create "IVU 4% B2B/SPD" and, if you run qualifying restaurants, "IVU 7% Alimentos Preparados".
  6. Odoo 20 jurisdiction: on each tax, open Advanced Options and set Jurisdiction Type to State, State to Puerto Rico; for the municipal tax, choose County and your municipality.
  7. Exempt and nontaxable links: in Odoo 20, link each tax to its exempt and nontaxable versions so the report splits sales correctly.
  8. Products: set default customer taxes on product categories, then test ten real invoices and credit notes.

The Odoo taxes documentation explains groups of taxes and the None tax type. Steps 6 and 7 use fields documented only in the 20.0 US page; the 19.0 page does not describe them.

Mapping the municipal 1% to a county is our suggested approach, not something Odoo documents for Puerto Rico. Unconfirmed: how the US tax report treats a county-level tax for a Puerto Rico municipality in a live database.

How do you handle the 4% B2B IVU and exemptions?

Use fiscal positions to swap the standard 11.5% group for the 4% tax, an exempt tax or a nontaxable tax, based on the customer. That keeps product setup simple and puts the rule on the customer record.

The 4% special rate applies to services sold to other businesses and to designated professional services such as legal, accounting and engineering work. No municipal portion applies. In Odoo, a "Puerto Rico merchant" fiscal position maps "IVU 11.5%" to "IVU 4% B2B/SPD" on service products.

Resellers and other exempt buyers need a certificate. Create an "Exempt with certificate" fiscal position and attach the certificate to the contact.

The fiscal positions documentation covers automatic detection by country and state.

Small service providers under the thresholds above may be exempt for some services. Odoo will not track that threshold for you, so review it with your accountant at year end.

How does IVU appear on Odoo invoices and POS receipts?

Odoo invoices show the IVU label per line and the tax totals at the bottom, so customers see what they paid. Name tax groups clearly so the PDF shows "IVU 11.5%" rather than a generic label.

Set the invoice label on the group tax, and decide whether the PDF should show the 10.5% and 1% parts or one 11.5% line. Many retailers prefer one line for customers while the ledger keeps both parts.

Point of sale needs more care. Grant Thornton notes that merchants must register with the Fiscal Terminals Program, with a $20,000 penalty for failing to register.

We found no Puerto Rico fiscal terminal module in Odoo 19.0 or 20.0. Treat POS fiscal terminal support as unconfirmed and plan a custom or third-party integration.

If POS is central to your business, read our Odoo POS implementation guide before you choose hardware.

How do you report and file IVU from Odoo?

Odoo prepares the IVU figures, but you file the monthly return yourself in SURI by the 20th of the following month. We found no SURI or COFIM connector in Odoo 19.0 or 20.0.

In Odoo 20, the Tax Report (US) groups sales and purchases by state, with child jurisdictions under each state. Its columns show total sales, exempt, nontaxable, taxable, tax rate and tax. Puerto Rico lines should appear under the Puerto Rico state, if each tax carries the right jurisdiction.

In Odoo 19, the US page documents no jurisdiction report. Use the generic tax report and filter by tax or tax group. Unconfirmed: exact 19.0 report layout for a Puerto Rico company, since we could not test it.

Your monthly routine should look like this:

  • By the 5th: reconcile bank, post all invoices and vendor bills, and lock the prior month.
  • By the 10th: check import declarations for air shipments, which Grant Thornton says are due by the 10th.
  • By the 15th: run the tax report, tie state and municipal IVU to their liability accounts, and review exempt sales.
  • By the 20th: file the state return in SURI and the municipal return through COFIM or the municipality's channel.

Late filing carries a 10% penalty on the tax due, per Grant Thornton. Our Odoo month end close checklist shows how to set lock dates so filed periods stay closed.

Can AvaTax calculate Puerto Rico IVU in Odoo?

AvaTax connects to Odoo for companies with a US fiscal country, but we could not confirm how it returns Puerto Rico IVU through Odoo. Test it with your real addresses before you rely on it.

Odoo offers two routes. Avalara Included runs on Odoo IAP credits at EUR 0.44 each, with 10 free credits and one credit per posted invoice or credit note. It is limited to 5,000 transactions a year. Avalara Direct is contract-based with no such cap.

Neither route files returns. Odoo's docs list return preparation, filing and remittance as add-ons only. In Odoo 20, AvaTax fills most jurisdiction fields, but it does not set the county or city fields, so you set the municipal side yourself.

Unconfirmed: whether AvaTax returns the 10.5% and 1% split, and the 4% B2B rate, for Puerto Rico. For most Puerto Rico firms selling only on the island, manual IVU taxes are simpler and cost less.

Odoo 19 vs Odoo 20 for Puerto Rico IVU

Puerto Rico IVU in Odoo: Odoo 19 or 20 for IVU?

Odoo 20 is the better base for Puerto Rico IVU, because it adds jurisdiction fields, municipality data and a US tax report. Odoo 19 works, but you rely more on tax names and filters.

FeatureOdoo 19Odoo 20
Puerto Rico moduleNone foundNone found
Puerto Rico state recordYes, under United StatesYes, under United States
Municipality and city dataNot in US module77 municipalities, 281 cities
Tax jurisdiction fieldsNot documentedState, county, city, special
US tax report by jurisdictionNot documentedTax Report (US) with exempt columns
AvaTax optionsAvaTax integrationAvalara Included or Avalara Direct

If you are on Odoo 19 today, you can still run IVU well. Plan the jurisdiction fields into your Odoo 20 upgrade so the new report works from day one.

Puerto Rico IVU in Odoo by industry

The IVU setup changes by industry, because restaurants, distributors and service firms hit different rates. The table shows the usual pain and how we handle it.

IndustryPain or cost driverOdoo approachHow iVentureTeam helps
Restaurants7% rate needs a certificate per siteSeparate 7% tax and POS fiscal positionsMap certified sites, test receipts
RetailFiscal terminal rules at the counterPOS with IVU group taxScope the terminal integration
Wholesale and distributionReseller certificates and use tax on importsExempt fiscal position, purchase use taxLoad certificates, set import taxes
Professional services4% rate on B2B and designated servicesMerchant fiscal positionMap services and customer types
ManufacturingExempt inputs and finished goods salesExempt purchase taxes, standard sales taxAlign BOM costs with tax setup

What does an Odoo setup for Puerto Rico cost?

A Puerto Rico Odoo project costs about the same as any US project, plus a few days to design, build and test the IVU setup. The extra work is tax design and testing, not licenses.

Our published Odoo implementation cost ranges are $3k to $9k for small projects (4 to 8 weeks), $9k to $27k for mid-size (8 to 14 weeks) and $27k to $150k+ for large ones (12 to 24 weeks). Data migration adds $1.2k to $9k.

Licenses follow the US list on the Odoo pricing page: US$31.10 per user a month for Standard and US$61.00 for Custom, billed yearly. For a quick number for your own scope, use the Odoo project estimate tool.

How iVentureTeam helps with Odoo Puerto Rico IVU

Moving to Odoo in PR? Price it first

We design, build and test your IVU setup in a staging database, then train your team on the monthly close. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.

  • Tax design: state, municipal, 4%, 7%, exempt and use taxes mapped to your accounts.
  • Customer data cleanup: Puerto Rico addresses fixed so fiscal positions detect them.
  • Reporting: the Odoo 20 Tax Report (US) or a custom IVU report that matches your SURI return.
  • POS and integrations: fiscal terminal scoping and links to other systems through our Odoo integration services.
  • US-wide support: if you also sell on the mainland, our Odoo partner team for the USA covers state sales tax and payroll.

Running payroll for island staff too? Our post on Odoo US payroll state coverage explains what Odoo covers.

Odoo tax localization case study: Fernando Tax Management

A Dutch tax practice needed Odoo tax reports for two jurisdictions, the Netherlands and Curaçao, and we built them as custom localized reports. The same approach applies when a jurisdiction like Puerto Rico needs reports Odoo does not ship.

Fernando Tax Management B.V. had outgrown a rigid legacy system. Manual entry across systems created duplicate records, and reports had translation gaps, a real risk for a firm whose output feeds government compliance.

We migrated the firm to Odoo 18 in 10 weeks, built a cost tracking workflow into Sales and Purchase, and developed custom tax compliance reports for its Dutch and Curaçao contexts. We also fixed a hidden journal lines issue.

The firm cut manual data entry by 60%. Read the Fernando Tax Odoo accounting automation case study.

The bottom line on Odoo Puerto Rico IVU

Odoo can handle Puerto Rico IVU well on the US package, and Odoo 20 makes it cleaner, but you must build and test the taxes yourself. No official module does it for you.

Set the company as a US company in Puerto Rico, build IVU as a state and municipal group, add the 4%, 7% and exempt cases, and prove the numbers against one real SURI return before go-live.

Ready to set up IVU correctly in Odoo?

Plan my IVU setup

Get a tested IVU tax setup before your first Odoo return is due. Talk to our team about your Puerto Rico Odoo setup, call +91-90235-15208, or email business@iventureteam.com.

Frequently Asked Questions

Does Odoo support Puerto Rico sales tax?

+

Yes, through the United States package and manual taxes. Odoo has no dedicated Puerto Rico module in 19.0 or 20.0, so you build the 10.5% state and 1% municipal IVU as a group of taxes.

What is the IVU rate in Puerto Rico?

+

The standard rate is 11.5%: 10.5% state and 1% municipal. B2B services and designated professional services pay a 4% special rate, and qualifying restaurants charge 7% on prepared food.

Should my Odoo company country be Puerto Rico or United States?

+

Use United States with the state set to Puerto Rico. That loads the US package, enables AvaTax if you want it, and lets Odoo 20 group taxes by state in the US tax report.

Can Odoo file my IVU return in SURI?

+

No. We found no SURI or COFIM connector in Odoo 19.0 or 20.0. Odoo prepares the figures, and you file the monthly return by the 20th of the following month.

How do I set up the 4% B2B IVU in Odoo?

+

Create a 4% tax with no municipal part, then a fiscal position for merchant customers that swaps the 11.5% group for the 4% tax on service products. Test it on real invoices first.

Does AvaTax work for Puerto Rico in Odoo?

+

AvaTax connects when the fiscal country is the United States. We could not confirm how it returns Puerto Rico IVU through Odoo, so test it with real addresses before relying on it.

Does Odoo POS support Puerto Rico fiscal terminals?

+

We found no Puerto Rico fiscal terminal module in Odoo 19.0 or 20.0. Plan a custom or third-party integration and confirm the requirements with Hacienda before you open.

Is Odoo 20 better than Odoo 19 for IVU?

+

Yes, for reporting. Odoo 20 adds jurisdiction fields on taxes, Puerto Rico municipality data and a Tax Report (US) with exempt and nontaxable columns. Odoo 19 works but needs more manual filtering.

Free written answer from a certified consultant

Getting Odoo Accounting set up right?

We map your accounting, tax and reporting in Odoo and show what to set up first, and what to watch.

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.