Automatize a conformidade fiscal brasileira, simplificando a criação de faturas a pagar para impostos retidos em compras de fornecedores. Garanta a precisão e eficiência no gerenciamento de obrigações fiscais com o módulo l10n_br_account_withholding para Odoo.
auto_awesome What this module does
AI-generated from the code · Odoo 16.0Automatically creates withholding tax invoices for Brazilian supplier bills when they are posted, based on tax group settings. Users can see and open the generated withholding invoices from the original bill.
When a supplier bill (in_invoice) is posted, the module checks each tax line. If the tax's fiscal group is marked to generate withholding invoices and is a withholding tax, a new vendor bill is created for the withheld amount. The new bill uses the tax group's configured purchase journal and due date (one month after the original bill, on the day set in the tax group). For city taxes (tax scope 'city'), the partner is the city hall registered for the city, if one exists; otherwise the tax group's partner is used. The withholding bill is automatically posted and linked to the original bill in the chatter.
On the original bill, a smart button 'WH Invoices' appears when withholding invoices exist, showing their count and opening the list of those bills. If the original bill is reset to draft, the related withholding invoices are set to draft or cancelled and their link is cleared.
In the tax group configuration, new fields let you enable withholding invoice generation, choose the purchase journal, and set a special payable account for these invoices. A search filter and a column in the tax group list help find groups that generate withholding invoices.
On partners, a new 'Is City Hall?' checkbox is available. Only one partner per city can be marked as city hall; otherwise a validation error is raised. Lines of a withholding invoice cannot have their quantity or price changed.
Depends on
Models and fields (4)
- res.partner · extends an existing modelwh_cityhall (Is City Hall?)
- account.move · extends an existing modelwh_invoice_ids (WH Invoices), wh_invoice_count (WH Invoice Count)
- account.move.line · extends an existing modelwh_move_line_id (WH Account Move Line)
- l10n_br_fiscal.tax.group · extends an existing modeljournal_id (Account Journal), generate_wh_invoice (Generate WH Invoice), wh_payable_account_id (WH Payable Account)
Text generated by AI (DeepSeek) from reading the Odoo 16.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: 3 confirmed, 6 with no information of 9 versions.
Sources · Odoo 15.0
Confirmed on 2026-11-03 in branch 15.0 of OCA/l10n-brazil.
terminal Installation and usage
OCA documentation · Odoo 16.0Installation
Source · Odoo 16.0Para instalar o módulo l10n_br_account_withholding em seu projeto Odoo:
- Adicione o Repositório:
- Adicione o repositório
l10n-brazilda OCA no seu projeto adicionando a URL:https://github.com/OCA/l10n-brazil. - Verifique os arquivos requirements.txt e oca_dependencies.txt localizados na raiz do repositório
l10n-brazil. Estes arquivos contêm, respectivamente, as dependências Python necessárias para o Odoo e os repositórios da OCA dos quais os módulos da localização brasileira dependem. - Configure o Caminho dos Addons:
- Adicione o caminho do repositório na configuração do Odoo em
addons-path. - Atualize a Lista de Módulos:
- Atualize sua lista de módulos para que o Odoo reconheça o novo módulo.
- Busque pelo Módulo:
- Pesquise por
"L10n Br Account Withholding"nos addons do Odoo para localizar o módulo. - Instale o Módulo:
- Prossiga com a instalação do módulo no ambiente Odoo.
Configuration
Source · Odoo 16.0Configure a geração de faturas de retenção de impostos no Odoo seguindo estes passos:
- Acesse Configurações Fiscais: Vá até
Fiscal -> Configurações -> Grupos de Impostos. Procure por impostos retidos do tipo entrada. - Configure os Impostos Retidos: Para cada imposto que requer uma fatura de retenção, garanta que esteja corretamente configurado. Defina um fornecedor, o diário e uma conta pagável para a geração da fatura do imposto se necessário. Se um diário não for especificado, o módulo usará o diário da fatura de compra original. A conta pagável é opicional, se não definida será utilizada a conta padrão do parceiro.
- Definir uma Prefeitura para o ISSQN: Crie ou edite um parceiro, vá até a aba "Fiscal" e marque a opção "É Prefeitura".
Usage
Source · Odoo 16.0Siga estes passos para utilizar a geração de faturas de retenção de impostos no Odoo:
- Criando uma Fatura de Compra: Ao criar uma fatura de compra, aplique o imposto retido nas linhas necessárias.
- Confirmação da Fatura: Ao confirmar a fatura de compra, o módulo gera automaticamente as faturas de retenção de impostos.
- Definir uma Prefeitura para o ISSQN: Ao incluir um imposto de retenção e informar a cidade correspondente para o ISSQN, o módulo busca automaticamente o parceiro marcado como Prefeitura para essa cidade. Caso não o encontre, ele retorna o parceiro padrão definido no Grupo de Impostos.
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.