Metadata-Version: 2.1
Name: odoo-addon-l10n_br_sale_commission
Version: 16.0.2.0.0
Requires-Python: >=3.10
Requires-Dist: odoo-addon-l10n_br_sale>=16.0dev,<16.1dev
Requires-Dist: odoo-addon-sale_commission>=16.0dev,<16.1dev
Requires-Dist: odoo>=16.0a,<16.1dev
Summary: Brazilian Localization of Sales Commissions
Home-page: https://github.com/OCA/l10n-brazil
License: AGPL-3
Author: Akretion, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 16.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

========================================
Brazilian Localization Sales Commissions
========================================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:00205d2fe0be94164ced842cb49be303a98430c6e3bbe99461fe93737cf97937
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--brazil-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_sale_commission
    :alt: OCA/l10n-brazil
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-brazil-16-0/l10n-brazil-16-0-l10n_br_sale_commission
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-brazil&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Esse módulo localiza o
`sale_commission <https://github.com/OCA/commission/tree/16.0/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**.

**Table of contents**

.. contents::
   :local:

Installation
============

O módulo depende do:

- sale_commission
- l10n_br_sale

Configuration
=============

Para 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
=====

Para 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**.

Changelog
=========

16.0.1.0.0 (2025-03-14)
-----------------------

- [MIG] Migração para a versão 16.0

14.0.1.0.0 (2024-01-09)
-----------------------

- [MIG] Migração para a versão 14.0

12.0.1.0.0 (2022)
-----------------

- [ADD] Versão inicial do módulo

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-brazil/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-brazil/issues/new?body=module:%20l10n_br_sale_commission%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Akretion

Contributors
------------

- `Akretion <https://www.akretion.com/pt-BR>`__:

  - Renato Lima <renato.lima@akretion.com.br>
  - Magno Costa <magno.costa@akretion.com.br>
  - Raphaël Valyi <raphael.valyi@akretion.com.br>

- `KMEE <https://www.kmee.com.br>`__:

  - Diego Paradeda <diego.paradeda@kmee.com.br>

- `Escodoo <https://www.escodoo.com.br>`__:

  - Marcel Savegnago <marcel.savegnago@escodoo.com.br>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-renatonlima| image:: https://github.com/renatonlima.png?size=40px
    :target: https://github.com/renatonlima
    :alt: renatonlima

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-renatonlima| 

This module is part of the `OCA/l10n-brazil <https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_sale_commission>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
