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 report, fiscal positions, and document and identification types.

Brazil - Accounting Reports

l10n_br_reports

Accounting reports for Brazil.

AvaTax Brazil, Avatax Brazil Sale & Test SOs for the Brazilian Avatax

l10n_br_avatax, l10n_br_avatax_sale & l10n_br_test_avatax_sale

Goods and Services tax computation through Avalara.

Brazilian Accounting EDI

l10n_br_edi

Provides electronic invoicing through Avatax.

Brazilian Accounting EDI For Sale

l10n_br_edi_sale

Adds some fields to sale orders that are carried over the invoice.

Brazilian Accounting EDI for POS

l10n_br_edi_pos

Provides electronic invoicing through Avatax in the POS.

Brazilian Accounting EDI for eCommerce

l10n_br_edi_website_sale

Allows tax calculation and EDI for eCommerce users.

Brazilian Accounting EDI for stock

l10n_br_edi_stock

Adds delivery-related information to the NF-e.

Brazil - Website Sale

l10n_br_website_sale

Allows tax calculation and EDI for eCommerce users.

Brazil - Sale

l10n_br_sales

Sale modifications for Brazil

Brazil - Sale Subscription

l10n_br_sale_subscription

Sale subscription modifications for Brazil

Note

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

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:

Sales taxes can be automatically computed, and electronic invoices for goods (NF-e) and services (NFS-e) can be sent using AvaTax (Avalara) through API calls. Moreover, taxes for services can be configured.

For the goods and services tax computation and electronic invoicing process, configure the contacts, company, and products and create an account in AvaTax in the general settings.

For the services taxes, create and configure them from Odoo directly without computing them with AvaTax.

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. Avalara uses some to compute taxes on sales orders or invoices.

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

Important

For service taxes created manually, NFS-e can’t be issued. To electronically send an NFS-e, compute taxes using Avalara.

Warning

Do not delete taxes, as they are used for the AvaTax tax computation. If deleted, Odoo creates them again when used in an SO or invoice, and computing taxes with AvaTax. However, the account used to register the tax must be re-configured in the tax’s Definition tab, under the Distribution for invoices and Distribution for refunds sections.

Products

To use the AvaTax integration on sales orders and invoices, enter the following information in the Sales tab of the product form under the Brazil Accounting section, based on how the product will be used.

E-Invoice for goods (NF-e)

  • CEST Code: code for products subject to ICMS tax substitution

  • Mercosul NCM Code: Mercosur Common Nomenclature Product Code

  • Source of Origin: origin of the product, which can be foreign or domestic, among other possible options, depending on the specific use case

  • SPED Fiscal Product Type: fiscal product type according to SPED list table

  • Purpose of Use: intended purpose of use for this product

Product configuration.

Note

Odoo automatically creates three products to be used for transportation costs associated with sales. These are named Freight, Insurance, and Other Costs and are already configured. If more need to be created, duplicate and use the same configuration:

  • Product Type Service

  • Transportation Cost Type: Insurance, Freight, or Other Costs

E-Invoice for services (NFS-e)

  • Mercosul NCM Code: Mercosur Common Nomenclature Product Code

  • Purpose of Use: intended purpose of use for this product

  • Service Code Origin: City Service Code where the provider is registered

  • Labor Assignment: checkbox to select if service involves labor

  • Transport Cost Type: type of transport costs to select

  • Service Codes: City Service Code where the service will be provided; if no code is added, the Service Code Origin will be used.

Company and contacts

To use all the features of this fiscal localization, the following fields are required 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

    Company configuration.

Configure the Fiscal Information within the Sales and Purchase tab:

  • Add the Fiscal Position for AvaTax Brazil.

  • Tax Regime: Federal Tax Regime

  • ICMS Taxpayer Type: indicates ICMS regime, Exempt status, or Non-Taxpayer

  • Main Activity Sector

Company fiscal configuration.

Configure the following extra Fiscal Information to issue NFS-e:

  • Add the Fiscal Position for AvaTax Brazil.

  • COFINS Details: Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended

  • PIS Details Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended

  • CSLL Taxable if the company is subject to CSLL or not

Company fiscal configuration for NFSe.

Note

If it is a simplified regime, the ICMS rate under Accounting ‣ Configuration ‣ Settings ‣ Taxes ‣ AvaTax Brazil must be configured.

The same configuration applies to the relevant contact form when using the AvaTax integration.

Note

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

Fiscal positions

To compute taxes and send electronic invoices on sales orders and invoices, both the Detect Automatically and the Use AvaTax Brazil API options need to be enabled in the Fiscal Position. To do so, go to Accounting ‣ Configuration ‣ Fiscal Positions. Then, open Automatic Tax Mapping (Avalara Brazil) and update it accordingly.

Fiscal position configuration

The fiscal positions can be configured:

  • either on the contact, in the Sales & Purchase tab under the Fiscal Information section;

  • or when creating a sales order or an invoice, in the Other Info tab under the Invoicing or Accounting section.

AvaTax integration

Avalara AvaTax is a tax calculation and electronic invoicing provider that can be integrated into Odoo to compute taxes automatically. It considers the company, contact (customer), product, and transaction information to retrieve the correct tax to be used and process the e-invoice afterward with the government.

This integration requires In-App-Purchases (IAPs) to compute taxes and send electronic invoices. To compute taxes, send an electronic document (NF-e, NFS-e, etc.), or perform any electronic flow (NF-e Cancellation, Correction letter, Invalidate invoice number range), an API call is made using credits from the IAP credit balance.

Note

  • Odoo is a certified partner of Avalara Brazil.

  • Buy IAP credits on odoo.com.

  • On creation, new databases receive 500 free credits.

Credential configuration

To activate AvaTax in Odoo, an account must be created. To do so, go to Accounting ‣ Configuration ‣ Settings ‣ Taxes. In the AvaTax Brazil section, add the administration Email address for the AvaTax portal in AvaTax Portal Email, and click Create account.

Warning

When testing or creating a production AvaTax Portal Email integration in a sandbox or production database, use a real Email address, as it is needed to log in to the Avalara Portal and set up the certificates, whether to test or use it on production.

There are two different Avalara Portals, one for testing and one for production:

When the account is created from Odoo, select the right environment. Moreover, the Email used to open the account cannot be used to open another account. Save the API ID and API Key when the account is created from Odoo.

Transfer API Credentials.

After the account is created from Odoo, go to the Avalara Portal to set up the password:

  1. Access the Avalara portal.

  2. Click Meu primeiro acesso.

  3. Add the Email address used in Odoo to create the Avalara/AvaTax account, and click Solicitar Senha.

  4. An Email will then be received with a token and a link to create a password. Click on this link and copy-paste the token to allocate the desired password.

Tip

Start using AvaTax in Odoo for tax computation only, without creating a password and accessing the Avalara portal in the Odoo database. However, to use the electronic invoice service, you must access the AvaTax portal and upload the certificate there.

AvaTax account configuration.

Note

API credentials can be transferred. This option should be used only when an account has already been created in another Odoo instance and must be reused.

A1 certificate upload

To issue electronic invoices, a certificate must be uploaded to the AvaTax portal.

The certificate will be synchronized with Odoo as long as the external identifier number in the AvaTax portal matches - without special characters - with the CNPJ number, and the identification number (CNPJ) in Odoo matches the CNPJ in AvaTax.

Important

Some cities require the certificate to be linked within the City Portal system before issuing NFS-e from Odoo.

If an error message from the city that says Your certificate is not linked to the user is received, this process needs to be done in the city portal.

Tax computation

Warning

Actions that trigger API calls for tax computation come with a cost. Be mindful of the actions that trigger these calls to manage costs effectively.

Tax calculations on quotations and sales orders

Trigger an API call to calculate taxes on a quotation or sales order automatically with AvaTax in any of the following ways:

  • Quotation confirmation

    Confirm a quotation into a sales order.

  • Manual trigger

    Click Compute Taxes Using AvaTax.

  • Preview

    Click Preview.

  • Email a quotation/sales order

    Send a quotation or sales order to a customer via Email.

  • Online quotation access

    When a customer accesses the quotation online (via the portal view), the API call is triggered.

Tax calculations on invoices

Trigger an API call to calculate taxes on a customer invoice automatically with AvaTax in any of the following ways:

  • Manual trigger

    Click Compute Taxes Using AvaTax.

  • Preview

    Click Preview.

  • Online invoice access

    When a customer accesses the invoice online (via the portal view), the API call is triggered.

Note

The Fiscal Position must be set to Automatic Tax Mapping (Avalara Brazil) for any of these actions to compute taxes automatically.

Accounting

Electronic documents

Configuration

A series number is linked to a sequence number range for electronic invoices. To configure the series number on a sales journal, go to Accounting ‣ Configuration ‣ Journals and set it in the Series field. If more than one series is needed, a new sales journal must be created, and a new series number assigned for each series.

Enable the Use Documents? option as the Series field will only be displayed if the Use Documents? field is selected on the journal.

When issuing electronic and non-electronic invoices, the Type field selects the document type used when creating the invoice.

Journal configuration with the Use Documents? field checked.

Note

When creating the journal, ensure the Dedicated Credit Note Sequence field in the Accounting Information section is unchecked, as in Brazil, sequences between invoices, credit notes, and debit notes are shared per series number, which means per journal.

Customer invoices

To process an electronic invoice for goods (NF-e) or services (NFS-e), the invoice must be confirmed and taxes must be computed by Avalara. The following fields must be filled out:

  • Customer, with all the customer information

  • Payment Method: Brazil: how the invoice is planned to be paid.

  • Document Type set as (55) Electronic Invoice (NF-e) or (SE) Electronic Service Invoice (NFS-e).

And in the Other Info tab:

  • Fiscal Position set as Automatic Tax Mapping (Avalara Brazil).

Some optional fields depend on the nature of the transaction. These fields in the Other Info tab are not required, so in most cases, leaving them blank will not result in errors from the government when the invoice is submitted:

  • Freight Model determines how the goods are planned to be transported - domestic.

  • Transporter Brazil determines who is doing the transportation.

Invoice information needed to process an electronic invoice. Process electronic invoice pop-up in Odoo.

Then, click Send. In the Print & Send window, click Process e-invoice and any other options - Download or Email. Finally, click Send to process the invoice with the government.

Note

All fields available on the invoice used to issue an electronic invoice are also available on the sales order, if needed. When creating the first invoice, the Document Number field is displayed, allocated as the first number to be used sequentially for subsequent invoices.

Credit notes

If a sales return needs to be registered, a credit note can be created in Odoo and sent to the government for validation.

Note

Credit notes are only available for electronic invoices for goods (NF-e).

Debit Notes

If additional information needs to be included or values that were not accurately provided in the original invoice need to be corrected, a debit note can be issued.

Note

  • Debit notes are only available for electronic invoices for goods (NF-e).

  • Only the products included in the original invoice can be included in the debit note. While changes can be made to the product’s unit price or quantity, products cannot be added to the debit note. The purpose of this document is only to declare the amount to be added to the original invoice for the same or fewer products.

Invoice cancellation

It is possible to cancel an electronic invoice that the government validated.

Note

Check whether the electronic invoice is still within the cancellation deadline, which may vary according to each state’s legislation.

E-invoices for goods (NF-e)

To cancel an e-invoice for goods (NF-e) in Odoo, click Request Cancel and add a cancellation Reason on the pop-up that appears. To send this cancellation reason to the customer via Email, enable the E-mail checkbox.

Invoice cancellation reason in Odoo.

Note

This is an electronic cancellation, which means that Odoo will send a request to the government to cancel the NF-e. It will then consume one IAP credit, as an API call occurs.

E-invoices for services (NFS-e)

To cancel an e-invoice for services (NFS-e) in Odoo, click Request Cancel. In this case, there is no electronic cancellation process, as not every city has this service available. The user needs to manually cancel this NFS-e on the city portal. Once that step is completed, they can request the cancellation in Odoo, which will cancel the invoice.

Correction letter

A correction letter can be created and linked to an electronic invoice for goods (NF-e) that the government validated.

To do so in Odoo, click Correction Letter and add a correction Reason on the pop-up that appears. To send the correction reason to a customer via Email, enable the E-mail checkbox.

Correction letter reason in Odoo.

Note

Correction letters are only available for electronic invoices for goods (NF-e).

Invalidate invoice number range

A range of sequences that are assigned to sales journals can be invalidated by the government if they are not currently used and will not be used in the future. To do so, open the journal, click the (gear) icon, and select Invalidate Number Range (BR). On the Invalidate Number Range (BR) wizard, add the Initial Number and End Number of the range that should be cancelled, and enter an invalidation Reason.

Number range invalidation selection in Odoo. Number range invalidation wizard in Odoo.

Note

Invalidate invoice number range documents are only available for electronic invoices for goods (NF-e).

Note

The journal’s chatter records the log of the cancelled numbers, along with the XML file.

Vendor bills

When receiving an invoice from a supplier, encode the bill in Odoo by adding all the commercial information, together with the same Brazilian-specific information that is recorded on the customer invoices.

These Brazilian-specific fields are:

  • Payment Method: Brazil: how the invoice is planned to be paid

  • Document Type: used by the vendor

  • Document Number: the invoice number from the supplier

  • Freight Model: NF-e specific how goods are planned to be transported - domestic

  • Transporter Brazil: NF-e specific who is doing the transportation.

Point of sale NFC-e

The NFC-e is a legal document that supports selling goods or merchandise to the final customer. Like the NF-e, the electronic customer invoice is also issued in XML file format and has an auxiliary document (DANFC-e) known as the NFC-e Summary. This electronic document can be issued through Odoo Point of Sale app.

Its legal validity is guaranteed by the digital signature and by each Brazilian state’s SEFAZ (Secretaria da Fazenda).

See also

Point of Sale

Configuration

Install the Brazilian Accounting EDI for POS (l10nbr_edi_pos) module.

CSC details

Go to Accounting ‣ Configuration ‣ Settings, scroll to the Taxes section. In the NFC-e configuration section, complete the following CSC (Taxpayer Security Code) fields:

  • CSC ID: The CSC ID or CSC Token is an identification of the taxpayer security code, which can have 1 to 6 digits and is available on your state’s website of State Department of Finance (SEFAZ).

  • CSC Number: The CSC Number is a code of up to 36 characters that only you and the Department of Finance know. It is used to generate the QR Code of the NFC-e and ensure the authenticity of the DANFE.

Note

The information required for these fields can be generated through the SEFAZ website of each Brazilian state by the company’s accountant.

Product configuration

First, create a new product in POS, then in the Sales tab, configure the following Brazil Accounting fields:

  • CEST Code: A tax classification code identifying goods and products subject to tax substitution under ICMS regulations. It helps determine the applicable tax treatment and procedures for specific items. Check if the product is subject to this at https://www.codigocest.com.br/.

  • Mercosul NCM Code: NCM (Nomenclatura Comun do Mercosul) code from the Mercosur list.

  • Source of Origin: Indicates whether the product is of foreign or national origin, with different variations and characteristics depending on the product use case.

  • SPED Fiscal Product Type: Fiscal product type according to the SPED list table.

  • Purpose of Use: Shows what this product is used for.

Shop configuration

Go to Point of Sale ‣ Configuration ‣ Point of Sales and create a New shop. Choose an internal name for the new POS and save.

Then, go to Point of Sale ‣ Configuration ‣ Settings and make sure that the correct Point of Sale is selected at the top of the screen. Then, scroll to the Accounting section and configure the Brazilian EDI fields:

  • Series

  • Next number: the next NFC-e number in the sequence to be issued, for instance, if the last number issued in SEFAZ is 100, the Next number will be 101.

Note

For the production environment, make sure that this information is updated.

Generating an NFC-e

First, open the Shop and make a sale.

After validating the payment, Odoo calculates taxes and issues an NFC-e. The valid NFC-e appears on the right side of the screen.

NFC-e Success in a POS session.

Note

It is also possible to issue an NFC-e that identifies the customer by their CPF/CNPJ. To do so, click Customer, search for the customer if they are already registered, or click Create.

The following are mandatory fields to issue a CPF/CNPJ identified NFC-e:

  • Name

  • City and State where the invoice is being issued

  • CPF/CNPJ

After saving the register, click Validate. The NFC-e appears, highlighting the customer’s CPF on the print.

Finally, select one of the two options to deliver the invoice to the customer:

  • Print

  • Send via e-mail

NFC-e ticket print

After generating and validating the NFC-e, click Print to deliver the invoice.

Example

Printed NFC-e ticket example.

This is the DANFC-e, the print of NFC-e when it is successfully issued, and shows all the important information that is legally required.

Tip

  1. Using an Odoo IoT Box to integrate the print NFC-e through the Point of Sale app is unnecessary.

  2. The Odoo NFC-e feature works with any thermal printer.

Re-issue PoS order with NFC-e error

If the NFC-e returns an error, correct the error first. Then, to re-issue the NFC-e, click the (menu) icon and select Orders.

Filter the list to show only Paid orders and click Details. The error will then be displayed, and the Send NFC-e button will be available.

Note

If the error was fixed and the PoS Session was closed, Odoo indicates the tax adjustment on that journal entry in the chatter. The order’s journal entry shows that the taxes were not calculated correctly. In that case, reprocessing the NFC-e is necessary.

Point of sale order view form.

NFC-e refunds & cancellations

Refunds can be created from Odoo, but cancellations must be done from the government portal.

Important

SEFAZ only allows cancellation of an NFC-e within 30 minutes of its issuance on the SEFAZ website. After this period, a manual refund must be processed, along with the issuance of a Return of Goods NF-e.

To issue a refund, click the (menu) icon and select Orders. Filter the list to show only Paid orders, open the order, and click Refund.

Choose the Payment method and Amount, then click Refund payment.

Note

Alternatively, to reimburse and cancel the NFC-e through the backend, go to Point of Sale ‣ Orders ‣ Orders. Open the order, select the customer, and click Payment to reimburse. Then click Invoice to create the invoice and issue the Return of Goods NF-e.

When the process is finalized, the approved return NF-e is created, meaning the previous NFC-e is canceled.

Return of Goods NF-e Approved.