OdooWiki OCA HUB

Brazilian Localization Sale Blanket Order

l10n_br_sale_blanket_order folder_open OCA/l10n-brazil open_in_new
Uncategorised License: AGPL-3

This module extends the Odoo Sale Blanket Order module to adapt it to the Brazilian needs, with this module you have tax data for collection and generation of fiscal documents (NF-e, NFS-e, CF-e, NFC-e and others), calculation Brazilian taxes and contributions (municipal, state and federal).

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds Brazilian fiscal data (fiscal operations, taxes, CFOP, CNAE, comments) to blanket orders and their lines, so blanket orders can be used as a basis for Brazilian tax calculation and fiscal documents.

This module brings Brazilian tax information into the blanket order screen (the long-term agreement with a customer from which sale orders are later generated).

On the blanket order itself, users now see and fill fiscal fields: a fiscal operation (required, limited to approved operations and defaulting from the company), whether the customer is a final consumer, a presence indicator, and a 'copy note on invoice' option. Customer tax details (CNPJ/CPF, legal name, state tax number) are pulled automatically from the customer record, and fiscal comments can be attached.

On each blanket order line, users can set the fiscal operation and its operation line, the fiscal taxes, the CNAE code, and fiscal quantity and price. The line form gains Taxes, Amounts, Extra Info and Accounting tabs, and the amounts shown (subtotal, tax, total, gross) are recalculated from the Brazilian fiscal values rather than the standard ones. Choosing a product or changing quantity re-syncs the taxes from the fiscal operation, and changing the fiscal operation on the order updates the fiscal position.

When a sale order is created from the blanket order, the fiscal data is carried over to the new order and its lines, and the taxes are set from the blanket line's fiscal taxes. If the selected lines have different fiscal operations, the creation is blocked with an error message.

Some fiscal fields only appear when the company's country is Brazil.

Models and fields (3)
  • sale.blanket.order · new modelcnpj_cpf (CNPJ/CPF), ind_pres, copy_note (Copy Sale note on invoice), legal_name (Legal Name), comment_ids (Comments), operation_name, l10n_br_ie_code (State Tax Number/RG), fiscal_operation_id
  • sale.blanket.order.line · new modeluom_id, cnae_id (CNAE Code), quantity (Product Uom Quantity), price_tax, country_id, partner_id (Partner), comment_ids (Comments), price_gross (Gross Amount), price_total, tax_framework (Tax Framework), fiscal_tax_ids (Fiscal Taxes), price_subtotal, fiscal_operation_id, fiscal_qty_delivered (Fiscal Utm Qty Delivered), fiscal_operation_line_id (Operation Line)
  • sale.blanket.order.wizard · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 14.0

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

terminal Installation and usage

OCA documentation · Odoo 18.0

To use this module, you need to:

  • Go to Sale
  • Create or select a Sale Blanket Order
  • Confirm the Sale Blanket Order
  • Create Sale Order

No verified information in OCA: Installation, Configuration.

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.