Mudanças entre as edições de "Visão de pedidos efetivados por data"

Edição das 18h54min de 11 de abril de 2022

Histórico de Revisões

Data	Quem	Comentários
11/04/2022	João Ramon	Criação do Documento

Necessidade

Os vendedores, por vezes, realiza orçamentos para seus clientes, e alguns são efetivados posteriormente. Ao realizar a efetivação, o vendedor recebe a confirmação por email, mas o gestor não possui essas informações. Dessa forma, o cliente possui a necessidade de que os seus gestores consigam ter uma visão de pedidos efetivados pelos seus vendedores.

Solução

Criar uma visão na qual o gestor possa verificar quais pedidos foram efetivados pelos seus vendedores, a partir do EVO, com utilização de alguns filtros para refinar a pesquisa conforme sua necessidade.

Implementação

Ao entrar na tela de listagem de pedidos no módulo Gestor, será disponibilizado ao usuário uma série de filtros para refino de pesquisas, a fim de extrair uma lista em função dos filtros inseridos. Um destes filtros já contempla a busca de pedidos efetivados, dentro de um período específico. Para melhorar a visão do gestor, deverá ser inserida uma coluna nesta lista, apresentando a data de efetivação dos pedidos filtrados, chamado 'Data Efetivação', devendo estar ao lado da coluna de data de emissão do pedido.

Com esta ação, o gestor deverá ter a condição de extrair, a partir de uma visão de tela, a relação dos pedidos que foram efetivados dentro do período selecionado.

Uma segunda visão deverá estar disponível, no formato de card, a ser apresentado no dashboard do usuário EVO. A visão apresentada deve conter a relação dos pedidos efetivados dentro do mês, e deve estar disponível para a seleção de visão no menu dashboard do módulo Baskoffice.

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.

[RN-4]- O relatório de comissões gerado pelo usuário trará as comissões oriundas das notas faturadas.

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

@@ Linha 5: / Linha 5: @@
 ! Comentários
 |-
-| 21/02/2022 || João Ramon || Criação do Documento
+| 11/04/2022 || João Ramon || Criação do Documento
 |-
 |}
@@ Linha 11: / Linha 11: @@
 == 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.
+Os vendedores, por vezes, realiza orçamentos para seus clientes, e alguns são efetivados posteriormente. Ao realizar a efetivação, o vendedor recebe a confirmação por email, mas o gestor não possui essas informações. Dessa forma, o cliente possui a necessidade de que os seus gestores consigam ter uma visão de pedidos efetivados pelos seus vendedores.
 == 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.
+Criar uma visão na qual o gestor possa verificar quais pedidos foram efetivados pelos seus vendedores, a partir do EVO, com utilização de alguns filtros para refinar a pesquisa conforme sua necessidade.
 == 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.
+Ao entrar na tela de listagem de pedidos no módulo Gestor, será disponibilizado ao usuário uma série de filtros para refino de pesquisas, a fim de extrair uma lista em função dos filtros inseridos. Um destes filtros já contempla a busca de pedidos efetivados, dentro de um período específico. Para melhorar a visão do gestor, deverá ser inserida uma coluna nesta lista, apresentando a data de efetivação dos pedidos filtrados, chamado 'Data Efetivação', devendo estar ao lado da coluna de data de emissão do pedido.
-Do lado da GeoSales, temos as tabelas PEDIDO, PEDIDO_RETORNO, NOTA_FISCAL e ITEM_NOTA_FISCAL e, portanto, já possui estrutura necessária mínima para o recebimento dos dados extraídos sem necessidade de alterações estruturais.
+Com esta ação, o gestor deverá ter a condição de extrair, a partir de uma visão de tela, a relação dos pedidos que foram efetivados dentro do período selecionado.
-Pelo exposto, conclui-se que as atividades de integração poderão ocorrer sem ônus de dados pela estrutura existente, sem que seja aplicadas novas medidas de alteração estrutural do lado da GeoSales.
+Uma segunda visão deverá estar disponível, no formato de card, a ser apresentado no dashboard do usuário EVO. A visão apresentada deve conter a relação dos pedidos efetivados dentro do mês, e deve estar disponível para a seleção de visão no menu dashboard do módulo Baskoffice.
-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;
-* Nº do pedido;
-* Valor da NF;
-* Numero da Fatura;
-* Data da emissão;
-* Valor da Comissão;
-* Valor total dos itens;
-* Valor total da comissão.
-Além deste relatório, deve ser também possível a exportação da relação dos devolvidos, com as mesmas informações já apresentadas no relatório de comissões.
-<!--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]]
-* Nome do Cliente;
-* Nº do pedido;
-* Nota fiscal;
-* Serie;
-* Data emissão;
-* 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 ==
@@ Linha 104: / Linha 32: @@
 A forma de como o processo irá acontecer seguirá o fluxo de atividades conforme abaixo esquematizado:
-[[arquivo: relcom2.png]]
+[[arquivo: efet.png]]
 ==Regras de Negócio==