OdooWiki OCA HUB

Brazilian Localization Sale

l10n_br_sale folder_open OCA/l10n-brazil open_in_new
Localisation License: AGPL-3

Este módulo estende o módulo sale do Odoo para adaptá-lo as necessidades brasileira, com este módulo você tem dados fiscal para faturamento e geração dos documentos fiscais (NF-e, NFS-e, CF-e, NFC-e e etc.), cálculo dos impostos e contribuições brasileiros (municipais, estaduais e federal).

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds Brazilian fiscal data to sales orders and quotations: fiscal operations, CFOP, NCM/CEST codes and Brazilian taxes, and uses them to build the fiscal invoice. It also adds Brazilian tax columns and totals to the sales analysis report.

This module adapts sales orders and quotations to Brazilian invoicing rules. On a Brazilian company, the sale order form shows a fiscal operation (chosen by default from the company setting), buyer presence and final-consumer indicators, plus fields for freight, insurance and other amounts. Each order line gets its own fiscal operation line, fiscal taxes, CFOP, service and tax codes, and a fiscal quantity/price, shown in a dedicated fiscal tab.

  • The order totals are recalculated from the fiscal line amounts, and the standard tax summary widget is hidden for Brazilian companies.
  • Creating the invoice splits the order by the document type required by each line's fiscal operation, and copies the fiscal data, document type, document series and journal onto the invoice.
  • Discounts can be entered as a percentage or as a fixed amount, and a global discount rate can be applied to the whole order; these options depend on user groups.
  • A company setting lets you copy the sale order note onto the fiscal document, and a company field sets the default sales fiscal operation.
  • The sales analysis report gains columns for fiscal operation, CFOP, NCM, CEST, ICMS, ICMS ST, IPI, PIS, COFINS, import tax, freight, insurance, other values and a total with taxes.
  • Salespeople get read-only access to fiscal operations, document types, series, CNAE codes and partner profiles.

Depends on

sale_managementl10n_br_account
Models and fields (5)
  • sale.order · new modelind_pres, copy_note (Copy Sale note on invoice), comment_ids (Comments), discount_rate (Discount), company_country_id, fiscal_operation_id
  • res.company · extends an existing modelcopy_note (Copy Sale note on invoice), sale_fiscal_operation_id (Standard Sales Fiscal Operation)
  • sale.report · extends an existing modelnbm_id (NBM), ncm_id (NCM), cest_id (CEST), cfop_id (CFOP), ii_value (II Value), ind_pres (Buyer Presence), ipi_value (IPI Value), pis_value (PIS Value), icms_value (ICMS Value), fiscal_type (Product Fiscal Type), other_value, cofins_value (COFINS Value), icmsst_value (ICMS ST Value), freight_value, insurance_value, total_with_taxes (Total with Taxes), fiscal_operation_id (Fiscal Operation), fiscal_operation_line_id (Fiscal Operation Line)
  • sale.order.line · new modeluom_id, cnae_id (CNAE Code), discount, quantity (Product Uom Quantity), price_tax, partner_id (Partner), comment_ids (Comments), price_gross (Gross Amount), tax_framework (Tax Framework), delivery_costs, discount_fixed (Fixed Discount?), discount_value, fiscal_tax_ids (Fiscal Taxes), price_subtotal, fiscal_operation_id, user_discount_value, user_total_discount, fiscal_qty_delivered (Fiscal Utm Qty Delivered), fiscal_operation_line_id (Operation Line), force_compute_delivery_costs_by_total
  • res.config.settings · extends an existing modelcopy_note (Copy notes in Fiscal documents)

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 7 confirmed, 2 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 19.0

Este módulo depende dos seguintes módulos:

  • sale_management
  • l10n_br_account
  • l10n_br_fiscal

Este módulo depende do módulo l10n_br_fiscal e l10n_br_account e para funcionar corretamente deve ser previamente configurado parâmetros fiscais e contábeis.

Após configurar a empresa, os dados contábeis e fiscais, ao criar um pedido de venda será, será possível visualizar os dados fiscais e contábeis:

Ao adicionar um produto ou serviço será exibido os detalhes dos impostos:

info

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.