Brazilian Localization Sales Commissions
Esse módulo localiza o sale_commission que implementa a Comissão nos Pedidos de Venda, isso é feito com a possibilidade de:
- Cadastrar Representantes/Agentes Comissionados
- Atribuir e Configurar Tipos de Comissão
- Informar os Representantes/Agentes Commisionados nos Pedidos de Venda ou no cadastro do Cliente
- Criar a Fatura para o Pagamento de Commissões de um determinado Período tanto de diversos Representantes/Agentes como de apenas um específico
Ao Localizar esse módulo também é incluída a opção de que a Fatura de Pagamento de Comissões que será criada também seja um Documento Fiscal do Brasil, por exemplo uma Nota Fiscal de Serviço NFS-e.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Adds Brazilian fiscal options to sales commission handling, so commission payment invoices can be issued as Brazilian fiscal documents (e.g. a service invoice) with a chosen document type, fiscal operation and product.
This module connects the sales commission feature with the Brazilian localization. It does not create commissions itself; it extends them so that the invoice generated to pay commissions can also be a Brazilian fiscal document.
Where it appears: - In Sales settings, a new "Commission" block lets you pick a default product used for invoicing commissions. - Next to it, a "Brazilian Fiscal Document" block has a switch to generate a fiscal document, plus a default fiscal document type (service documents only) and a default fiscal operation. Turning the switch off clears the two defaults. - In the commission invoicing wizard, a "Brazilian Fiscal Data" group appears when the fiscal option is on, letting you choose the fiscal document type and fiscal operation for that run. These fields are only shown to fiscal managers.
Automatic behaviour: - The wizard pre-fills the document type, fiscal operation and product from the settings. - When the invoice is created, it is filled with the chosen document type, its document series (looked up for the company and fiscal operation), the fiscal operation, and an issuer (the partner for purchase journals, otherwise the company). - Products offered for the commission invoice are limited to service-type products when a fiscal document type is selected.
Business rule on commissions: - On sale order lines and invoice lines, commission agents are removed when the fiscal operation (CFOP) is marked as not a finance move, and invoice lines marked commission-free get no agents.
It touches sale order lines, invoice lines, commission settlements and the commission invoicing wizard.
Depends on
Required by other modules
Models and fields (5)
- sale.order.line · extends an existing model
- account.move.line · extends an existing model
- res.config.settings · extends an existing modelallowed_product_ids, commission_product_id (Default Product for invoicing), commission_document_type_id (Default Fiscal Document), commission_gen_br_fiscal_doc (Generate Brazilian Fiscal Document), commission_fiscal_operation_id (Default Fiscal Operation)
- commission.settlement · extends an existing model
- commission.make.invoice · extends an existing modelproduct_id, allowed_product_ids, fiscal_operation_id (Fiscal Operation), commission_document_type_id (Fiscal Document), commission_gen_br_fiscal_doc (Generate Brazilian Fiscal Document)
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-03Confirmation status: 5 confirmed, 4 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 18.0Installation
Source · Odoo 18.0O módulo depende do:
- sale_commission
- l10n_br_sale
Configuration
Source · Odoo 18.0Para configurar a Comissão é necessário:
Cadastrar os Tipos de Comissão, que é onde será informado a forma que deverá ser feito o Cálculo do Valor das Comissões e em que momento a Commissão será Paga, em:
Comissão > Configuração > Tipos de Comissão
Cadastrar os Representantes/Agentes Comissionados, em:
Comissão > Representantes
Informar se será um caso Brasil que deverá gerar um Documento Fiscal, em:
Vendas > Configuração > Definições
Na seção de Comissão é possível definir os campos Produto/Serviço da Comissão, Se Gera Documento Fiscal Brasileiro?, Tipo do Documento Fiscal e Operação Fiscal que deverão ser os valores padrões a serem usados na criação da Fatura para Pagamento de Comissões, mas também é possível se necessário, no momento de criação da Fatura alterar esses campos.
Verifique as Permissões de Acesso para o Usuário que deverá criar a Fatura de Comissão, em:
Definições > Usuários e Empresas > Usuários
Marcar a Opção Gerenciar as comissões das faturas.
Usage
Source · Odoo 18.0Para usar esse módulo é necessário:
Informar o(s) Representante/Agente na Linha do Pedido de Vendas, existe um ícone específico que mostra as informações sobre a Comissão.
OBS.: Se no seu Caso de Uso o Cliente está associado a um ou mais Representantes/Agentens isso pode ser informado no cadastro do Cliente na aba de Vendas e Compras na seção Vendas o(s) Representantes/Agentes, assim ao criar um Novo Pedido de Vendas essa informação deverá ser carregada por padrão.
Para Gerar a Fatura de Pagamento das Commissões é preciso Liquidar as Comissões, em:
Comissões > Liquidações > Liquidar as Comissões
Informe Até a Data que será usada, o Tipo da Commissão e dependendo se deve criar apenas para um Representante específico ou para todos.
Caso sejam criadas, logo em seguida, o programa vai mostrar/abrir a tela com as Liquidações, que também podem ser acessadas em:
Comissões > Liquidações > Liquidações
Dentro de uma Liquidação é possível ver as Linhas de Comissão referentes, e o ao clicar no botão Faturar serão mostradas as opções da Fatura de Pagamento da Comissão, no caso do Brasil é possível selecionar o Documento e a Operação Fiscal que deverão ser usados, se informados será criado um Documento Fiscal do Brasil, por exemplo uma NFS-e.
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.