Exibir código-fonte para Criação de Relatório de Comissão para o vendedor

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem 
! Comentários 
|-
| 21/02/2022 || João Ramon || Criação do Documento 
|-
|}

== Necessidade ==

O cliente possui dois relatórios para quantificar as comissões dos vendedores: no primeiro, ele faz a relação das notas fiscais num dado período de tempo, com visões dos valores de venda e das comissões atribuídas a um vendedor específico; no segundo, o relatório apresenta as mesmas informações, mas com as notas devolvidas. Visto que o cliente passou a utilizar o EVO como força de vendas, sendo que ele já possui todas as estruturas existentes (processos de apuração, etc), ele deseja que estes relatórios possam ser extraídos na própria plataforma.

== Solução == 

Desenvolver meios para que a plataforma GeoSales realize a exportação de um relatório de comissões com as duas visões (vendas  e notas devolvidas), utilizadas pelo cliente.

== Implementação ==

Do lado do cliente, já existe a estrutura do relatório de comissões, e o cliente ira disponibilizar esta estrutura para que este relatório possa ser exportado no EVO. O Geosales não irá fazer qualquer tipo de controle, mas apenas exibir as informações que serão enviadas pelo cliente.

A estrutura do cliente será persistida com a tabela PEDIDO, do nosso lado, trazendo as informações do relatório desejadas. A estrutura do cliente possui o valor da comissão e, do nosso lado, temos o campo PC_COMISSAO, que traz dados percentuais das comissões. Para o recebimento correto das informações, uma tratativa deve ser realizada no momento da criação do script de extração dos dados, já que os dados de faturamento e o valor das comissões são disponíveis. Para isto, deve-se ter a tratativa de percentual de comissão, a partir da seguinte lógica:

<code><center> Percentual de comissão = (Valor da comissão / Valor do faturamento) *100 </center></code>

O resultado deste cálculo deverá popular o campo PC_COMISSAO na tabela PEDIDO_RETORNO. 

No momento da solicitação do envio de relatório de comissões por parte do usuário, o cálculo deverá ser novamente convertido para a comissão em valor nominal, pelo uso da seguinte lógica (processo inverso):

<code><center> Valor da Comissão = (Valor do Faturamento * Percentual de Comissão) /100 </center></code>


Após a tratativa deste valor estiver desta forma realizada, ela será apresentada no relatório de comissões do vendedor.

Por default, a fim de manter a precisão do valor do percentual de comissão, o campo PC_COMISSAO possui a característica de preenchimento de 16:8 (16 campos disponíveis para os valores inteiros, com 8 espaços para valores decimais após a vírgula. Portanto, o índice de precisão do campo será de 8 casas decimais).





Para criar acesso ao EVO a estes recursos, dever-se-á, inicialmente, criar uma tela para que ao usuário possa solicitar a extração do relatório. Portanto, o acesso a esta tela deverá ser criada na aba de vendas do EVO, criando-se a opção 'Relatório de Comissões'. Ao selecionar esta opção, será aberta a tela de relatório de comissões com os seguintes filtros/campos de pesquisa:

* Data inicial;
* Data final;
* Vendedor;
* Cliente;

O comportamento destes campos deverão respeitar o perfil de usuário utilizado. Se o perfil de usuário for vendedor (o usuário alvo deste documento), o campo de vendedor estará fixado no seu cadastro, não permitindo que este consiga fazer consultas em outros vendedores. Portanto, o vendedor poderá apenas fazer as consultas com filtros de data e os clientes 
a ele vinculados.

No caso do perfil utilizado seja o de gestor, o campo de vendedor estará disponível para edição. Para isso, um 'combo box' irá trazer todos os vendedores vinculados àquele gestor, bem como os clientes vinculados a estes vendedores.



Além dos campos supracitados, será inserido um 'select box', com as opções 'vendidos' e 'devolvidos', que são as opções dos relatórios que deverão ser criados.

Após o usuário colocar os filtros desejados, ele deverá ter a opção de exportar o relatório em formato pdf. No caso de relatório de vendidos, ele deverá conter as seguintes informações:

* Nome do cliente;
* Valor da NF;
* Numero da Fatura;
* Parcela;
* Valor da Parcela;
* Data da emissão;
* Data de vencimento;
* Data do pagamento;
* Valor da Comissão;
* Valor total dos itens;
* Valor total da comissão.


Todas estas informações podem ser visualizadas no relatório que o cliente utiliza atualmente, cujos detalhes observamos abaixo:

[[arquivo: relatoriocomissao1.png]]


[[arquivo: relatoriocomissao2.png]]





Além deste relatório, deve ser também possível a exportação da relação dos devolvidos, com as seguintes informações:

* Nota fiscal;
* Serie;
* Nome do Cliente;
* Loja;
* Data emissão;
* Valor;
* Comissão;
* Valor total;
* total comissões.

Todas estas informações podem ser visualizadas no relatório que o cliente utiliza atualmente, cujos detalhes observamos abaixo:

[[arquivo: devolvidos.png]]


Segundo informações do cliente, o usuário final deste relatório são os seus representantes comerciais/vendedores. Portanto, '''a habilitação/desabilitação do acesso ao relatório de comissões deve ser passível de configuração por parte do usuário''', portanto, deverá ser criado esta configuração no controle de ações GeoSales.

== Cenários ==

A forma de como o processo irá acontecer seguirá o fluxo de atividades conforme abaixo esquematizado:

[[arquivo: relcom2.png]]

==Regras de Negócio==

'''[RN-1]-''' Os dados para composição deste relatório serão fornecidos '''exclusivamente''' pelo ERP do cliente, por meio da estrutura já existente nele. O Geosales não irá fazer qualquer tipo de controle, mas apenas exibir as informações que serão enviadas pelo cliente.


'''[RN-2]-''' Os relatórios do cliente exibidos neste documento são apenas para efeito de comparação, para que a nossa equipe de desenvolvimento tenha melhor entendimento da criação da atividade proposta. O modelo de relatório seguirá o padrão dos relatórios já utilizados na GeoSales.

'''[RN-3]-''' A funcionalidade de relatório de comissões deverá ser habilitado/desabilitado para determinados perfis por meio do controle de ações.

== Aprovação ==

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado. 

=== GeoSales ===

{| class="wikitable"
! style="width:200px" |Setor 
! style="width:180px" |Aprovado Por
! style="width:100px" |Data
|- 
| Desenvolvimento - GeoSales || xxxxxxxxx || 00/00/000
|- 
| Integração - GeoSales || xxxxxxxxx || 00/00/0000
|-
|}

=== Empresa solicitante === 

{| class="wikitable"
! style="width:200px" |Setor 
! style="width:180px" |Aprovado Por
! style="width:100px" |Data
! style="width:200px" |Assinatura
|-
| Gerente TI - Cliente         ||  ||  ||
|- 
| Gerente de Projeto - Cliente ||  ||  ||
|- 
| Gerente Comercial - Cliente  ||  ||  ||
|- 
|}