Este é o módulo 'raiz' da localização brasileira. Ele traz adaptações nos modelos do módulo base do Odoo como Parceiros, Empresas e Endereços:
- Campo CNPJ e CPF com formatação e validação destes campos;
- Campo de Inscrição Estadual com validação;
- Formatação dos campos de endereço;
- Código do Banco Central e Siscomex para países;
- Código do IBGE para estados e municípios;
- Lista dos Bancos brasileiros;
- Contas bancarias e chaves PIX dos parceiros;
- Lista dos municípios brasileiros.
Se trata de um módulo muito simples e maduro. Existem alguns outros módulos simples que dependem apenas desse módulo ou quase como l10n_br_crm ou l10n_br_portal.
Mas se você quiser emitir ou apenas gerenciar algum tipo de documento fiscal como NF-e ou NFS-e, o próximo módulo que você deve olhar é o l10n_br_fiscal que é porém um módulo muito mais complexo.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds Brazilian tax and address fields (CNPJ/CPF, state and municipal tax numbers, IBGE codes, Pix keys) to partners, companies, banks and cities, with validation and formatting rules.
This module adapts Odoo's base data for Brazil. On partners and companies you get fields for CNPJ/CPF (the VAT number), State Tax Number (Inscrição Estadual), Municipal Tax Number, Suframa code, legal name, district and a city linked to the Brazilian city list. These fields appear on the partner and company forms only when the country is Brazil.
Validation rules run automatically: CNPJ and CPF are checked for correct format and check digits, and the State Tax Number is validated according to the state. Duplicate CNPJ/CPF is blocked unless you enable the option 'Multiple partners with the same CNPJ' in Settings; even then, the same State Tax Number cannot be repeated for the same state. You can also disable CPF/CNPJ or IE validation in Settings.
Addresses are formatted the Brazilian way: street name, number, district, and the city is chosen from a list filtered by state. The CNPJ/CPF is stored without punctuation but displayed formatted, and searching by a formatted number also works.
Banks gain Brazilian bank code, ISPB number and COMPE flag. Bank accounts gain branch number, account digit and account type, with checks on branch length and required fields for checking/saving accounts. Partners can store Pix keys (CPF/CNPJ, phone, email or random key) with format validation and uniqueness per partner.
Countries, states and cities gain IBGE, BC, Siscomex, SIAFI and ANP codes. The module also loads the list of Brazilian cities, states and banks.
Depends on
Required by other modules
Models and fields (11)
- res.bank · extends an existing modelcode_bc (Brazilian Bank Code), short_name, ispb_number (ISPB Number), compe_member (COMPE Member)
- res.city · extends an existing modelanp_code (ANP Code), ibge_code (IBGE Code), siafi_code (SIAFI Code)
- res.company · new modelzip, city, street, city_id, street2, district, state_id, country_id, legal_name, street_name, street_number, street_number2, l10n_br_ie_code, l10n_br_im_code, l10n_br_isuf_code, state_tax_number_ids (State Tax Numbers)
- res.country · extends an existing modelbc_code (BC Code), ibge_code (IBGE Code), siscomex_code, nationality_code
- res.partner · new modelpix_key_ids (Pix Keys), is_br_partner, l10n_br_rg_code (RG)
- res.partner.pix · new modelkey, key_type (Type), sequence, partner_id (Partner), partner_bank_id (Bank Account)
- res.partner.bank · extends an existing modelacc_number (Account Number), bra_number (Bank Branch), bra_bank_bic (BIC/Swift Final Code.), acc_number_dig (Account Digit), bra_number_dig (Bank Branch Digit), partner_pix_ids (Pix Keys), bank_account_type, company_country_id (Company Country), transactional_acc_type (Account Type)
- res.country.state · extends an existing modelibge_code (IBGE Code)
- state.tax.numbers · new modelstate_id (State), company_id (Company), partner_id (Partner), l10n_br_ie_code (State Tax Number)
- res.config.settings · extends an existing modelmodule_l10n_br_zip (Use Brazilian postal service API), allow_cnpj_multi_ie (Multiple partners with the same CNPJ), disable_ie_validation (Disable IE validation), disable_cpf_cnpj_validation (Disable CPF and CNPJ validation)
- l10n_br_base.party.mixin · new modelvat, city_id (City of Address), district, country_id, legal_name, show_l10n_br, l10n_br_ie_code (State Tax Number), l10n_br_im_code (Municipal Tax Number), cnpj_cpf_stripped (CNPJ/CPF Stripped), l10n_br_isuf_code (Suframa), show_br_vat_format, vat_formatted_cnpj (VAT Formatted (Brazil)), state_tax_number_ids (Others State Tax Number)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 13.0
Confirmed on 2026-11-03 in branch 13.0 of OCA/l10n-brazil.
terminal Installation and usage
OCA documentation · Odoo 19.0Installation
Source · Odoo 19.0Este módulo depende dos pacotes Python:
- erpbrasil.base
- num2words
- phonenumbers
- email_validator
Configuration
Source · Odoo 19.0Após a instalação do módulo deve ser preenchido o endereço da empresa para que a formação e validações necessárias para o Brasil funcione os objetos parceiros e nos endereços.
Usage
Source · Odoo 19.0Após ter o endereço da empresa configurado, no cadastro do parceiro você encotrar os campos CNPJ, CPF, IE, RG e os campos de endereço formatado para o Brasil. Caso você tenha apenas o módulo base instalado, você pode instalar o módulo Contact para acessar o cadastro de parceiros.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.