# CustomVD

#### **Resumo**

A CustomVD Gifor

- Criação do Grupo de Vendedores e inclusão do campos nos relatórios de Documentos Fiscais.

---

#### **Versão 5.00 - [52431](https://mantis.supersoft.com.br/view.php?id=52431 "52431")**

**Criação do Grupo de Vendedores e inclusão do campos nos relatórios de Documentos Fiscais** No menu: Utilitários -> Customizações -> Manutenção -> Grupo de Vendedores, é possível cadastrar os grupos:

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/scaled-1680-/w5ximage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/w5ximage.png)

No menu: Manutenção -> Vendedores -> Manutenção, é possível vincular os Vendedores aos grupos cadastrados:

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/scaled-1680-/tsBimage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/tsBimage.png)

Nos Relatórios "Documentos Fiscais", "Documentos Fiscais/Produtos" e "Documentos Fiscais/Duplicatas" foi criada a quebra por "Grupo de Vendedores" e incluso o campo "Grupo de Vended." no Seleciona Campos:

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/scaled-1680-/image.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/image.png)[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/scaled-1680-/qNvimage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2025-05/qNvimage.png)

---

#### **Versão 5.01 - [53506](https://mantis.supersoft.com.br/view.php?id=53506)**

**Relatório de Vendas por Grupo de Representantes, com inclusão da classificação de clientes em "novos" e "antigo"**

No menu: Utilitários → Customizações → Relatório, é possível fazer algumas seleções que determinarão os resultados exibidos no relatório estatístico.

Na seleção dos filtros, é possível escolher a divisão (Mídia) - filtro muito importante no qual veremos os clientes 'antigos' e 'novos', o Grupo de Vendedores e o período no qual irá fazer o recorte dos dados. Os pedidos podem ser filtrados por dia, por mês ou por períodos mais longos.

[![2026-03-19_08-46.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-03/scaled-1680-/2026-03-19-08-46.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-03/2026-03-19-08-46.png)

Após fazer as seleções, será exibido um relatório gerencial mostrando o acumulado (valor que foi faturado na Nota Fiscal), se o cliente é 'novo' ou 'antigo', o valor devedor e quantidade devida.

[![2026-03-19_08-47.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-03/scaled-1680-/2026-03-19-08-47.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-03/2026-03-19-08-47.png)

Para notas de devolução que utilizam CFOP correspondente a esse tipo de atividade, o relatório se comporta dessa forma a partir de um tratamento feito no sistema de Vendas, no qual antes não era permitido informar um vendedor em notas de devolução e a partir da versão 6.683 do módulo de Vendas juntamente com a customização feita para este cliente, podemos extrair esse tipo de resultado abaixo no relatório gerencial :

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/scaled-1680-/PiYimage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-04/PiYimage.png)

Porém, se o cliente desejar visualizar apenas o resumo (na imagem1 "Estatística Venda Química" é possível ver um checkbox indicando "Só o resumo"), é exibido um relatório resumido, agrupado por vendedores com o total de todas as vendas, tal qual a imagem abaixo:

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-03/scaled-1680-/image.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-03/image.png)

Para esta Custom, a regra de negócio válida é:

- O relatório deverá considerar a classificação de clientes como novos ou antigos com base no histórico de compras por divisão (procedência).  
      
    Regras de classificação:  
    **Cliente novo**:  
    Primeira compra registrada naquela divisão;  
    Caso o cliente nunca tenha realizado compra em nenhuma divisão, será considerado novo na primeira compra.  
      
    **Cliente antigo**:  
    Quando o cliente já possuir compra anterior registrada na mesma divisão.  
      
    **Exemplos**:  
    Cliente realiza a primeira compra na divisão Químicos → Cliente novo.  
    Nova compra na divisão Químicos → Cliente antigo.  
    Primeira compra na divisão Plásticos → Cliente novo nessa divisão.  
      
    A classificação deverá ser avaliada por divisão, permitindo que o mesmo cliente seja considerado novo em uma divisão e antigo em outra, conforme seu histórico de compras.

**Inclusão de pedidos faturados ou não, entram na somatória do relatório**

Por solicitação do cliente e pelo escopo da customização, o relatório tem uma visão gerencial baseada em pedidos, inclusive considerando quantidade de pedidos, valores, clientes novos/antigos e devoluções dentro do período . Ou seja, o pedido faz parte da base da informação, independentemente do faturamento. Nesse contexto, o fato do pedido estar faturado ou não é mais uma característica dele, e não necessariamente um critério de exclusão, até porque, para a regra de negócio do cliente, o pedido já compõe a venda.  
  
**Complementando com um ponto técnico**: o próprio sistema permite gerar duplicatas diretamente no pedido (antes do faturamento). Isso mostra que o pedido pode gerar financeiro e já é tratado como uma entidade completa dentro do processo, sem depender exclusivamente da nota.

No entanto, quando o pedido estiver faturado, ele continua sendo considerado uma única vez, apenas relacionado à respectiva nota, evitando duplicidade e mantendo a rastreabilidade, inclusive em casos de devolução.

---

#### **Versão 5.02 - [53877](https://mantis.supersoft.com.br/view.php?id=53877 "53877")**

**Atender uma demanda já existente no sistema antigo (Mitra), permitindo à área comercial visualizar os resultados de vendas por grupo de representantes, com acompanhamento dos indicadores de clientes novos e antigos por divisão. Além disso, opção por cliente 'novo' e 'antigo' passa a ser manual no cadastro do cliente.**

Nesta nova etapa, o relatório passa a ser um relatório próprio, não mais vinculado aos relatórios de Documentos Fiscais, permitindo a emissão de relatórios de vendas com quebra por grupo de representantes, apresentando:

\- Quebra por Grupo de Vendedores;  
\- Vendedores por grupo, com total de pedidos e valores;  
\- Quantidade de clientes novos e antigos;  
\- Totalização de vendas por grupo, considerando clientes novos, clientes antigos e devoluções;  
\- O relatório deverá possuir layout gráfico com logotipo e permitir emissão em modo paisagem;  
\- As notas de devolução precisam estar estritamente vinculadas ao vendedor. Caso não tenha nenhum vendedor vinculado, não será possível emitir notas de devolução;  
\- **IMPORTANTE**: Clientes 'novos' e 'antigos' são controlados pela Gifor manualmente através de banco de dados/tela de pedidos. Ou seja, caso seja realizado três pedidos, para o mesmo cliente, na mesma mídia e na tela de pedidos ele for classificado como 'novo', ele entra somente uma vez como 'novo' e apenas contabiliza o faturamento das demais notas. Pedidos também são considerados no faturamento, o que acontece é uma hierarquia. Caso haja um pedido e em sequência o faturamento do mesmo, haverá uma substituição do pedido feito para nota faturada.   
\- O caminho correto para obtenção dos resultados é a realização de um pedido > faturamento do mesmo através da NF (pedido recebido/devolvido através do CFOP selecionado). Caso haja cadastro de NF (Movimentação > Nota Fiscal Eletrônica > Cadastra) sem vínculo de pedido, não será contabilizado no relatório gerencial. Em Movimentação > Nota Fiscal Eletrônica > Manutenção, é possível verificar que a nota foi emitida, porém sem validade para o relatório da Gifor.  
\- Importante destacar que o vendedor a qual o pedido foi relacionado deve estar vinculado a um grupo de vendedores (Manutenção > Vendedores > Editar > Grupo de Vendedor)

O objetivo desta customização é disponibilizar um relatório gerencial que auxilie no acompanhamento de metas, desempenho individual e por equipe, gestão de carteira de clientes e análise de expansão comercial. Sempre que houver necessidade de análise de desempenho de vendas por representante ou grupo de representantes, considerando período, divisão (procedência) e evolução de clientes novos e antigos.

[![Clipboard - 2 de junho de 2026 às 14_44.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-06/scaled-1680-/clipboard-2-de-junho-de-2026-as-14-44.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-06/clipboard-2-de-junho-de-2026-as-14-44.png)

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-06/scaled-1680-/image.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-06/image.png)

[![image.png](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-06/scaled-1680-/g8gimage.png)](https://wiki.supersoft.com.br/uploads/images/supersoft/gallery/2026-06/g8gimage.png)

---