Criação de Relatório de Comissão para o vendedor

Histórico de Revisões

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:

Percentual de comissão = (Valor da comissão / Valor do faturamento) *100

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

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):

Valor da Comissão = (Valor do Faturamento * Percentual de Comissão) /100

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:

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:

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:

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

Setor	Aprovado Por	Data
Desenvolvimento - GeoSales	xxxxxxxxx	00/00/000
Integração - GeoSales	xxxxxxxxx	00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data	Assinatura
Gerente TI - Cliente
Gerente de Projeto - Cliente
Gerente Comercial - Cliente