This module was written to extend the functionality of contract module to support the adequacy of Brazilian contract standards
auto_awesome What this module does
AI-generated from the code · Odoo 17.0Adds Brazilian fiscal data to contracts and their lines, so recurring invoices are generated with the correct fiscal operation, taxes and document type. It also lets you set default sale/purchase fiscal operations per company.
This module adapts the Contracts app for Brazilian companies. On a contract you get Brazilian fiscal fields: fiscal operation, CNPJ/CPF, legal name, state tax number, comments and a 'Recalculate taxes before invoicing' option. These fields only appear when the company country is Brazil.
On each contract line you can set the fiscal operation, its operation line, CFOP, service type, city and national taxation codes and CNAE, plus fiscal taxes and comments. A Taxes tab and an Amounts tab show fiscal amounts such as untaxed, tax, total and withholding amounts.
When recurring invoices are created, the module groups invoice lines by partner and by the fiscal document type coming from each line's fiscal operation, and fills the document type and document series. If a contract has no fiscal operation, the document type is cleared. If a line has no fiscal operation line, an error is raised.
In company settings there is a Contract page where you set the default sale and purchase fiscal operations and the default tax recalculation option. New contracts automatically pick the right default fiscal operation based on whether they are sale or purchase contracts.
Depends on
Required by other modules
Models and fields (3)
- res.company · extends an existing modelcontract_sale_fiscal_operation_id (Default Contract Sale Fiscal Operation), contract_purchase_fiscal_operation_id (Default Contract Purchase Fiscal Operation), contract_recalculate_taxes_before_invoice (Dafault recalculate taxes before invoicing)
- contract.line · new modelcountry_id, partner_id (Partner), comment_ids (Comments), tax_framework (Tax Framework), fiscal_tax_ids (Fiscal Taxes), line_recurrence
- contract.contract · new modelie (State Tax Number/RG), cnpj_cpf (CNPJ/CPF), country_id, legal_name (Legal Name), comment_ids (Comments), currency_id, operation_name, fiscal_operation_id (Fiscal Operation), contract_recalculate_taxes_before_invoice (Recalculate taxes before invoicing)
Text generated by AI (DeepSeek) from reading the Odoo 17.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: 4 confirmed, 5 with no information of 9 versions.
Sources · Odoo 17.0
Confirmed on 2026-11-03 in branch 17.0 of OCA/l10n-brazil.
terminal Installation and usage
OCA documentation · Odoo 17.0Installation
Source · Odoo 17.0To install this module, you need to do nothing
Configuration
Source · Odoo 17.0No additional configuration is required to use this module
Usage
Source · Odoo 17.0To use this module, you need to:
- Run the core contract flow normally
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.