Este módulo é a base comum para os planos de contas da localização brasileira.
Herança
Assim como na localização espanhola, que já permitia carregar vários planos de contas, este módulo define um plano de contas básico que é depois estendido pelos planos de contas específicos (ITG 1000, empresas do regime normal de determinados setores...). Isso permite compartilhar configurações entre os planos, especialmente para carregar o plano customizado de uma determinada empresa. Por exemplo, no repositório da localização, este módulo é herdado pelos módulos l10n_br_coa_simples, l10n_br_coa_generic, entre outros customizados.
Em particular, são definidos aqui os tipos de contas usados na DRE e no Balanço Patrimonial (módulo l10n_br_mis_report) para facilitar a adaptação desses relatórios para os diversos planos de contas.
Contas contábeis para impostos
Uma outra característica é que, ao contrário do que acontece na Europa (o primeiro mercado focado pelo Odoo), no Brasil existem muitas alíquotas, pelo menos para as empresas do regime normal. Sendo assim, não é viável ter um objeto account.tax para cada alíquota como o Odoo nativo espera (fazíamos isso até a versão 10.0, mas era muito trabalhoso para manter). Em vez disso, temos tabelas específicas para armazenar todas as alíquotas no módulo l10n_br_fiscal e temos registros account.tax apenas para alíquotas de cada família. O módulo l10n_br_account faz a ligação entre o account.tax do Odoo e os registros l10n_br_fiscal.tax para cada alíquota da localização. Vale a pena notar que nos EUA o Odoo também não usa um registro account.tax por alíquota; em vez disso, eles geralmente usam conectores e serviços (como AvaTax) para obter as alíquotas de uma determinada operação.
Neste caso, a configuração contábil não podia ser carregada nem pelo account.tax nem pelo l10n_br_fiscal.tax (já que o módulo l10n_br_fiscal não depende do módulo account). Então, estendemos o objeto account.tax.group para carregar as informações contábeis, inclusive das taxas dedutíveis.
A partir da versão 17.0, existe também no template o método populate_default_br_tax_accounts, que permite injetar em qualquer plano de contas essas contas de impostos. Existem 2 padrões de numeração das contas para escolher: o padrão ITG ou CFC. Uma vez geradas as contas, elas podem ser identificadas pelo sufixo .GEN e modificadas manualmente. Esse método de geração das contas de impostos é agora usado pelos módulos l10n_br_coa_simples e l10n_br_coa_generic da localização.
Impostos dedutíveis
No Odoo nativo, um imposto é considerado dedutível (como, por exemplo, uma compra em outro país europeu) se o registro account.tax tiver uma alíquota negativa. Porém, como mencionado anteriormente, aqui é preferível não gerenciar um account.tax por alíquota. Por isso, temos um flag adicional no account.tax e account.tax.template através do account.tax.mixin para identificar se é um imposto dedutível.
Template
Foi ainda necessário sobrescrever a função que instancia um plano de contas a partir de um template para propagar essas informações.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Provides the shared foundation for Brazilian chart of accounts: a basic chart template, Brazilian tax groups and tax templates, tax account tags for reports, and extra fields on accounts and taxes (SPED referential code, deductible/withholdable flags).
This module is the common base that Brazilian chart-of-accounts modules build on. It does not add a full ready-to-use chart by itself; it prepares the pieces that the specific Brazilian charts reuse.
What users see: - A "Brazil" section under the Accounting reports menu. - On each account form and in the account list, a new field "Conta referencial da RFB" (the federal tax authority's referential account code), used for SPED/ECD/ECF reporting mappings. - On tax forms and tax templates, two new checkboxes: "Deductible Tax?" (on by default) and "Withholdable Tax?" (off by default).
Automatic behaviour: - When a tax is marked deductible or withholdable, its tax repartition lines get a negative percentage, so the tax amount is booked with the opposite sign. This is recalculated when the checkboxes change and when tax accounts are assigned. - When a Brazilian chart is loaded for a company in Brazilian reais, the module creates a standard set of tax accounts (ICMS, IPI, PIS, COFINS, ISSQN, IRPJ, CSLL, INSS, etc.) and links each tax template to its invoice and refund accounts. Two account-numbering flavours exist (CFC and ITG). - The liquidity transfer account created during chart loading is renamed "Liquidity Transfer" and tagged as cash and equivalents so it appears correctly in the balance sheet and cash flow statement. - A large set of account tags (balance sheet, income statement, cash flow, value added, tax tags) is installed for Brazilian reports.
It touches account.account, account.tax, account.tax.template and account.chart.template.
Depends on
Required by other modules
Menus it adds
Models and fields (5)
- account.tax · new model
- account.account · extends an existing modell10n_br_sped_referential_code (Conta referencial da RFB)
- account.tax.mixin · new modeldeductible (Deductible Tax?), withholdable (Withholdable Tax?)
- account.tax.template · new model
- account.chart.template · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. 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
No verified informationInstallation 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.