Brazil

Modules

The following modules related to the Brazilian localization are available:

Name

Technical name

Description

Brazilian - Accounting

l10n_br

Brazilian fiscal localization package, complete with the Brazilian chart of accounts, taxes, tax grids, fiscal positions, and document and identification types (CNPJ, CPF).

Brazil - Sale

l10n_br_sales

Brazilian layout of the sales order in the customer portal (tax totals per tax group).

Brazil - Website Sale

l10n_br_website_sale

eCommerce adjustments for Brazil: prices are shown tax included, and the business (B2B) fields such as the identification number are always shown at checkout.

Note

The localization’s core modules are installed automatically with the localization. The rest can be manually installed.

Tax computation through Avalara AvaTax, the electronic documents (NF-e, NFS-e, NFC-e) issued through AvaTax, the Brazilian accounting reports, and the subscription extension are not available in this edition. Taxes are computed by the standard tax engine from the taxes configured on products and fiscal positions.

Localization overview

The Brazilian localization package ensures compliance with Brazilian fiscal and accounting regulations. It includes tools for managing taxes, fiscal positions, reporting, and a predefined chart of accounts tailored to Brazil’s standards.

The Brazilian localization package provides the following key features to ensure compliance with local fiscal and accounting regulations:

  • Chart of accounts: a predefined structure tailored to Brazilian accounting standards

  • Taxes: pre-configured tax rates, including standard VAT, zero-rated, and exempt options.

  • Fiscal positions for internal and interstate operations.

  • Reporting

Chart of accounts

In the chart of accounts, the accounts are mapped automatically to their corresponding taxes, and the default account payable and account receivable fields.

Note

The Brazil chart of accounts is based on the SPED CoA, which provides a baseline of the necessary accounts.

Taxes

Taxes are automatically created and configured when installing the Brazilian localization: IPI, ICMS, PIS, COFINS, ISS, IR and CSLL taxes with their tax grids.

Taxes used for services must be manually added and configured, as the rate may differ depending on the city where the service is offered.

Brazilian taxes have three additional options on the tax form (visible for Brazilian companies only):

  • Discount this Tax in Price: the tax amount is deducted from the price;

  • Redution: percentage reduction of the tax base;

  • MVA Percent: the Margem de Valor Agregado percentage used for the ICMS-ST base.

screenshot: finance-fl-brazil-tax-form
menu
Accounting ‣ Configuration ‣ Taxes ‣ (an ICMS tax)
shows
The tax form of a Brazilian ICMS tax with the "Discount this Tax in Price", "Redution" and "MVA Percent" fields next to "Included in Price".
highlight
The three Brazil-specific fields.
data
Demo company "YourCompany BR", Brazilian localization installed.
module
l10n_br
notes
English UI, light theme, 1440px width.

Fiscal positions

Fiscal positions carry an Interstate Fiscal Position Type (Internal, South/Southeast selling to North/Northeast/Midwest, or Other interstate) so that the ICMS taxes of interstate operations can be mapped correctly. Assign the fiscal position to the customer or vendor, or let Odoo detect it automatically from the partner’s state.

Company and contacts

The following fields should be filled in on the company record:

  • Name

  • Address: add City, State, Zip Code, Country

    • In the Street field, enter the street name, number, and any additional address information.

    • In the Street 2 field, enter the neighborhood.

  • Identification Number: CNPJ or CPF

  • Tax ID: associated with the identification type

  • IE: State registration

  • IM: Municipal registration

  • SUFRAMA code: Superintendence of the Manaus Free Trade Zone - add if applicable

  • Phone

  • Email

In the Sales and Purchase tab, add the Fiscal Position that applies to the partner.

Tip

If it is a simplified regime, the ICMS rate must be configured. To do so, go to Accounting ‣ Configuration ‣ Settings, scroll down to the Taxes section, and set the Sales Tax and Purchase Tax fields in the Default Taxes section.

The same configuration applies to the relevant contact form.

screenshot: finance-fl-brazil-partner-fields
menu
Contacts ‣ (a Brazilian company contact)
shows
A contact form for a Brazilian company: Identification Number type "CNPJ" with the Tax ID, and the "IE", "IM" and "SUFRAMA code" fields; the address with Street, Street 2 (neighborhood), City, State, Zip and Country.
highlight
The "IE", "IM" and "SUFRAMA code" fields.
data
Contact "Empresa Exemplo Ltda", CNPJ 12.345.678/0001-95, São Paulo.
module
l10n_br
notes
English UI, light theme, 1440px width.

Note

Select the Company option for a contact with a tax ID (CNPJ), or check Individual for a contact with a CPF.