Venda por Representação

Tutorial

A venda por representação, a empresa trabalha com a modalidade de venda por representação e necessita que o ERP seja customizado para oferecer suporte completo a esse modelo de operação.

Nesse formato de venda, a empresa atua como intermediária entre o cliente final e o fabricante, sendo necessários ajustes específicos no sistema para garantir que os processos de gerenciamento de pedidos, controle de prazos de entrega, cálculo de comissões e tratamento financeiro estejam devidamente alinhados às necessidades operacionais dessa modalidade.

Atualmente, o ERP não possui um fluxo estruturado que atenda às particularidades da venda por representação. Embora exista um módulo de revenda, ele não apresenta aderência suficiente para esse cenário.

A customização proposta tem como objetivo suprir essas limitações, proporcionando maior automação dos processos, redução das atividades manuais e melhor controle operacional, especialmente em rotinas como a apuração de comissões e o acompanhamento das vendas realizadas por representação.

Lista de funcionalidades

Alterações no Banco de Dados:

Etapas para Instalação:

Vendas | Vendas

Vendas | Cancelamento

Sistema de usuários | Cadastro | Produtos | Produtos

Tradewin | Arquivos | Produtos | Produtos

TradChec | Com Orçamento

MU_ECF | Vendas

Sistema de usuários | Movimentos | Gerenciador de Vendas por Representação

Sistema de usuários | Relatórios | Comissão | Por Metas de Vendas

Relatório de Vendas por Representação (não é testado pelo QA)

Nota fiscal de serviço eletrônica (NFSe)

Etapas para Instalação:

1. LIGAR o parâmetro por filial “Trabalha com venda por representação?”

1. Configurar nos FORNECEDORES de venda por representação os dados adicionais:
   1. Fornecedor de venda por representação?
   2. Dia para vencimento de conta a receber de venda por representação
   3. Tipo de documento para conta a receber de venda por representação
   4. TPO para Conta a receber (dado adicional de pessoa jurídica)

Configuração para ativar o recurso de COMISSÃO POR INDICADOR (opcional):

1. Leitura e implantação do PA 78463
   1. Ligar o parâmetro por empresa "Orçamento com tratamento de revenda"
   2. Ligar o parâmetro por empresa "Utiliza tratamento de comissão por indicação"
   3. Configurar o parâmetro por filial "TPO para comissão de Indicadores".
   4. Ligar o parâmetro por filial " Validar limite de crédito do cliente do orçamento nas vendas para associados".
   5. Configurar o parâmetro empresa "Prorrogação para pagamento de comissão da Revenda" (número de dias correspondente ao prazo para efetuar o pagamento da comissão).
   6. Cadastrar para o tipo de indicador as classificações do indicador no cadastro de categoria:

Exemplo:

Representante (OID = 2128)

Arquiteto  (criado pelo usuário)

Decorador (criado pelo usuário)

Engenheiro (criado pelo usuário)

1. Cadastrar uma pessoa física classificada como cliente, fornecedor,representante e utilizando umas das classificações cadastradas para o tipo de indicador.

Exemplo: Arquiteto.

1. Configurar o dado adicional “Taxa sobre indicação de venda” dos indicadores já cadastrados;

1. Leitura do PA 418010 - Gerar nota de crédito para comissão de indicador

Objetivo

Implementar no ERP uma nova modalidade de Venda por Representação, permitindo que a empresa atue como intermediária entre o cliente final e o fabricante, sem movimentação de estoque próprio.

Todas as regras descritas neste documento devem ser aplicadas somente quando o parâmetro "Trabalha com venda por representação?" estiver habilitado na filial da venda.

---

Vendas | Pedido de Venda

Objetivo

Adequar o processo de inclusão e alteração de pedidos para suportar a modalidade de Venda por Representação.

Regra Geral

Em um pedido de venda por representação somente poderão ser informados produtos pertencentes ao mesmo fornecedor.

---

Regras de Negócio

RN001 – Identificação do fornecedor

Ao informar um produto, o sistema deve verificar se o fornecedor possui o dado adicional:

Fornecedor de venda por representação = Sim

---

RN002 – Mesmo fornecedor no pedido

Caso o primeiro produto informado pertença a um fornecedor de representação, todos os demais produtos do pedido deverão pertencer ao mesmo fornecedor.

Caso seja informado um produto de fornecedor diferente, exibir a mensagem:

"Pedido de venda de representação só pode conter produtos do mesmo fornecedor."

A inclusão do produto deverá ser bloqueada.

---

RN003 – Mistura com fornecedores comuns

Caso o pedido já possua produtos de fornecedores comuns, não deverá ser permitida a inclusão de um produto de fornecedor de representação.

Exibir a mensagem:

"Produto de fornecedor de representação não pode ser informado no mesmo pedido de outros fornecedores."

---

RN004 – Consulta de produtos

Quando o pedido for de venda por representação, a consulta de produtos deverá listar apenas produtos pertencentes ao mesmo fornecedor já informado no pedido.

---

RN005 – Consulta para pedidos comuns

Quando o pedido não for de venda por representação, a consulta de produtos não deverá exibir produtos cujo fornecedor possua:

Fornecedor de venda por representação = Sim

---

RN006 – Tipo de entrega

Para produtos de fornecedores de representação:

• somente deverá ser permitido o tipo de entrega Futura;
• o tipo de entrega deverá ser preenchido automaticamente;
• não deverá ser permitida alteração do tipo de entrega;
• não deverá ser permitido informar outro local de retirada;
• os campos Filial de Retirada e Filial de Transferência deverão permanecer em branco e bloqueados para edição.

---

RN007 – Previsão de entrega

A previsão de entrega deverá ser calculada automaticamente utilizando a fórmula:

Data da venda + Prazo Entrega Venda Representação

O prazo deverá ser obtido do cadastro do produto:

ComplementoProduto.PrazoEntregaRepresentação

O vendedor poderá alterar a previsão apenas para uma data posterior à calculada automaticamente.

---

RN008 – Tratamento de estoque

Para produtos de fornecedores de representação:

• não validar estoque;
• não reservar estoque;
• definir:
  • Itemclicad.Reserva = N
  • não atualizar Itemfilest.QtdeReserv
• não utilizar controle de lote;
• não utilizar controle de validade;
• não executar validações relacionadas a lote.

---

RN009 – Identificação do pedido

Ao salvar um pedido de venda por representação, atualizar:

Pediclicomplemento.VendaRepresentacao = 1

Esse atributo identifica o pedido como venda por representação.

---

RN010 – Inclusão e alteração

Todas as regras descritas anteriormente deverão ser aplicadas tanto na inclusão quanto na alteração do pedido.

---

Ajustes complementares

Ficha 468236

Quando o pedido for de venda por representação, não deverá ser realizada validação de crediário.

---

Ficha 468760

Item 1 – Roteiro automático

Não exibir o alerta:

"Não foi encontrado roteiro automático para o endereço de entrega."

Como a entrega é realizada pelo fabricante, esse tratamento não se aplica.

---

Item 2 – Encomenda

Não permitir a utilização da opção Encomenda.

Também deverá ser desabilitado todo tratamento relacionado à reserva de estoque e lote.

---

Item 3 – Liberação de lote

Não solicitar senha para liberar a pendência:

"Liberar pendência de venda sem reserva de lote."

Esse tratamento não se aplica à venda por representação.

---

Item 4 – NFe de simples faturamento

Desabilitar o alerta relacionado à emissão de Nota Fiscal de Simples Faturamento para pedidos de venda por representação.

---

Marco de Entrega 1

Implementação de todas as regras RN001 até RN010 e ajustes das fichas 468236 e 468760.

---

Vendas | Cancelamento

Objetivo

Definir regras específicas para cancelamento de pedidos de venda por representação.

---

Regras de Negócio

RN011 – Pedido faturado

Não permitir o cancelamento de pedidos de venda por representação já faturados.

Condição:

• Pediclicad.Sitven = 2
• Pediclicomplemento.VendaRepresentacao = 1

Exibir a mensagem:

"Pedido de vendas por representação já faturado não pode ser cancelado por essa opção."

O cancelamento deverá ser interrompido.

---

RN012 – Pedido não faturado

Caso o pedido ainda não esteja faturado:

Pediclicad.Sitven <> 2

o cancelamento deverá ocorrer normalmente.

---

Marco de Entrega 2

Implementação das regras RN011 e RN012.

---

Cadastro de Produtos

Módulos

• Sistema de Usuários → Cadastro → Produtos → Produtos
• Tradewin → Arquivos → Produtos → Produtos

Objetivo

Disponibilizar novos campos no cadastro de produtos para atender à modalidade de Venda por Representação.

Entre eles, o campo responsável pelo cálculo da previsão de entrega:

• Prazo Entrega Venda Representação (ComplementoProduto.PrazoEntregaRepresentação).

Os demais campos deverão ser definidos conforme os protótipos e requisitos funcionais do projeto.

Regras de Negócio

RN013 – Comissão Venda por Representação

Deverá ser incluído, na página Unidade e Preço do cadastro de produtos, o campo:

Comissão Venda por Representação

Características

• Campo não obrigatório;
• Utilizado para informar o percentual de comissão do produto na modalidade Venda por Representação;
• Permitir apenas valores percentuais maiores ou iguais a zero (≥ 0);
• Atualizar o campo ComplementoProduto.ComissaoRepresentacao.

---

RN014 – Prazo Entrega Venda por Representação

Deverá ser incluído, na página Dados Complementares do cadastro de produtos, o campo:

Prazo Entrega Venda por Representação

Características

• Campo não obrigatório;
• Utilizado para informar o prazo de entrega do produto para vendas por representação;
• Permitir apenas valores maiores ou iguais a zero (≥ 0);
• Atualizar o campo ComplementoProduto.PrazoEntregaRepresentacao.

---

RN015 – Navegação do cadastro

Ao navegar entre os registros do cadastro de produtos, o sistema deverá realizar corretamente a leitura, atualização e persistência dos novos campos de Venda por Representação.

---

Marco de Entrega 3

Implementação das regras RN013 a RN015.

---

TradChec | Com Orçamento

Objetivo

Adequar o processo de faturamento para pedidos de Venda por Representação.

Nesta modalidade, o cliente realiza o pagamento diretamente ao fornecedor. Portanto, o faturamento não deverá gerar os mesmos registros financeiros de uma venda convencional.

Em substituição, deverão ser gerados:

• registros da nova estrutura de Venda por Representação;
• registros de Contas a Receber referentes exclusivamente à comissão da venda por representação.

---

Regras de Negócio

Regra Geral

Todas as regras descritas nesta seção deverão ser aplicadas somente quando o parâmetro "Trabalha com venda por representação?" estiver habilitado na filial padrão do usuário.

---

RN016 – Geração do financeiro

Ao faturar um pedido identificado como Venda por Representação:

Pediclicomplemento.VendaRepresentacao = 1

o sistema não deverá gerar os registros financeiros normalmente criados em uma venda convencional.

Essa regra existe porque o pagamento da mercadoria será realizado diretamente entre o cliente e o fornecedor, cabendo ao ERP controlar apenas as informações relacionadas à comissão da venda por representação e aos respectivos registros específicos dessa modalidade.

Objetivo

Criar uma nova rotina denominada Gerenciador de Vendas por Representação, destinada ao gerenciamento das vendas realizadas nessa modalidade.

A rotina deverá permitir o registro dos eventos relacionados ao processo de venda por representação, bem como o acompanhamento do pedido junto ao fornecedor até a entrega da mercadoria ao cliente.

---

Regras de Negócio

RN023 – Inclusão da rotina no menu

Deverá ser criada uma nova opção no menu Movimentos denominada:

Gerenciador de Vendas por Representação

Regras

• Criar o script responsável pela inclusão da opção no menu dinâmico do Sistema de Usuários;
• A opção deverá ficar disponível somente no menu dinâmico;
• Apenas usuários com a devida permissão poderão visualizar e acessar a rotina.

---

RN024 – Interface principal

Ao acessar a opção Gerenciador de Vendas por Representação, o sistema deverá apresentar a interface principal da rotina conforme o layout/protótipo definido para o projeto.

A tela deverá servir como ponto central para gerenciamento das vendas por representação, permitindo o acompanhamento do fluxo operacional do pedido, desde o faturamento até a entrega ao cliente, bem como o registro dos eventos relacionados ao processo.

RN025 – Pesquisa de pedidos

Ao acionar o botão Procurar, o sistema deverá pesquisar os pedidos de Venda por Representação considerando os filtros informados pelo usuário.

Validação dos filtros

Antes de realizar a pesquisa, deverá ser validado se pelo menos um filtro foi informado ou selecionado.

Caso nenhum filtro seja informado, exibir a mensagem:

"Informe ou selecione um filtro para a pesquisa."

e não executar a consulta.

---

Critérios da pesquisa

A consulta deverá retornar apenas pedidos identificados como Venda por Representação.

Condição obrigatória

• Pediclicomplemento.VendaRepresentacao = 1

Os demais filtros deverão ser aplicados somente quando informados.

Período

Filtrar pela data da venda considerando apenas a data:

• VendasRepresentacao.DataVenda ≥ Data Inicial
• VendasRepresentacao.DataVenda ≤ Data Final

---

Pedido ERP

Filtrar por:

• Pediclicad.Numped

---

Pedido do Fabricante

Filtrar por:

• Pediclicad.Referencia

---

Filial

Filtrar por:

• Pediclicad.Filial

---

Cliente

Filtrar por:

• Pediclicad.Codclie

---

Fornecedor

Relacionar:

• Itemclicad.CodPro = Produtocad.CodPro

e filtrar:

• Produtocad.CodFor

---

Pendência de impressão do Termo de Compra

Quando marcado o filtro correspondente, retornar apenas pedidos onde:

• VendasRepresentacao.TermoDeCompra = 0
• ou NULL

---

Entrega atrasada

Quando solicitado, retornar pedidos cujos itens atendam simultaneamente às condições:

• Itemclicad.DtPrevEnt < Data Atual
• VendasRepresentacaoItem.DataExpedicao IS NULL

---

Itens pendentes

Retornar pedidos que possuam quantidade pendente de entrega.

Condição:

Itemclicad.Quant >

(VendasRepresentacaoItem.QtdeFaturada +

VendasRepresentacaoItem.QtdeCancelada +

VendasRepresentacaoItem.QtdeDevolvida)

---

Pedidos faturados

Retornar apenas pedidos que possuam Nota Fiscal emitida.

Condição:

• VendasRepresentacaoItem.NumeroNFVenda > 0

---

Pedidos concluídos

Retornar pedidos cuja expedição tenha sido concluída.

Condição:

• VendasRepresentacao.DataExpedicao preenchida

---

Nenhum registro localizado

Caso nenhum pedido seja encontrado, exibir a mensagem:

"Nenhum registro encontrado."

---

RN026 – Exibição do resultado

Os pedidos localizados deverão ser apresentados no GRID agrupados por pedido e ordenados inicialmente pelos seguintes campos:

1. Filial;
2. Data da Venda;
3. Data de Previsão de Entrega;
4. Pedido ERP.

Além da ordenação padrão, deverá ser disponibilizado o recurso de ordenação clicando no cabeçalho de cada coluna.

---

Colunas do GRID

Coluna	Informação apresentada
Filial	Filial do pedido (Pediclicad.Filial).
Pedido ERP	Número do pedido no ERP (Pediclicad.Numped).
Pedido Fábrica	Número do pedido informado pelo fabricante (Pediclicad.Referencia).
TPO	Código e descrição do TPO (TPO_r.Codigo - TPO_r.Nome).
Cliente	Razão social do cliente (Pediclicad.RazaoCli).
Fornecedor/Fabricante	Razão social do fornecedor dos produtos do pedido (Fornecedor_r.RazaoSocial).
Vendedor	Código e nome do vendedor (Pediclicad.CodVend - VendedorCad.Nome).
Valor do Pedido	Valor total do pedido (Pediclicad.ValPed).
Data da Venda	Data do faturamento registrada em VendasRepresentacao.DataVenda.
Data da Expedição	Maior data registrada em VendasRepresentacaoItem.DataExpedicao.
Data Prevista de Entrega	Data prevista de entrega do pedido (Pediclicad.DtPrevEnt).
Data da Entrega	Maior data registrada em VendasRepresentacaoItem.DataEntrega. (Ficha 470004 – 10/06/2025).
Impresso Termo de Compra	Indica se o Termo de Compra foi impresso (VendasRepresentacao.TermoDeCompra = 1).
Situação	Situação atual do pedido (VendasRepresentacao.Situacao).

---

RN027 – Impressão do Termo de Compra

A rotina deverá disponibilizar o botão Impressão Termo de Compra, responsável pela emissão do termo referente ao pedido selecionado.

Validação

Antes da impressão, deverá ser verificado se existe um pedido selecionado no GRID.

Caso nenhum pedido esteja selecionado, exibir a mensagem:

"Selecione o pedido."

Caso exista um pedido selecionado, o sistema deverá gerar o Termo de Compra utilizando o layout gráfico definido para o projeto.

Cabeçalho do Termo de Compra

Campo	Informação
Página	Número da página do relatório.
Data de Emissão	Data e hora da impressão do documento.
Número do Pedido	Número do pedido de venda (Pediclicad.Numped).
Data da Venda	Data do faturamento registrada em VendasRepresentacao.DataVenda.
Filial de Venda	Código e nome da filial (Pediclicad.Filial - FilialCad.Nome).
Vendedor	Código e nome do vendedor (Pediclicad.CodVend - VendedorCad.Nome).
Pedido do Fabricante	Número do pedido informado pelo fabricante (Pediclicad.Referencia).
Fornecedor/Fabricante	Código e razão social do fornecedor dos produtos (Produtocad.CodFor - Fornecedor_r.RazaoSocial).
CNPJ	CNPJ do fornecedor (Fornecedor_r.Identificador).
Endereço do Fornecedor	Endereço comercial completo do fornecedor.
Cliente da Venda	Nome do cliente (Pediclicad.RazaoCli).
CPF/CNPJ	CPF ou CNPJ do cliente (Pediclicad.CgcCli).
Endereço do Cliente	Endereço comercial completo do cliente (logradouro, bairro, cidade, estado e CEP).
Endereço de Entrega	Endereço de entrega do pedido, obtido a partir de Pediclicad.CodEndEnt.
Condição de Pagamento	Descrição da condição de pagamento (Pediclicad.RFormaDePagar - FormaDePagar_r.Nome).

---

Detalhamento dos Produtos

O relatório deverá apresentar os produtos do pedido em formato tabular contendo as seguintes informações:

Campo	Informação
Produto	Código do produto (Itemclicad.CodPro).
Referência	Referência do produto (Produtocad.CodInterno).
Descrição	Descrição longa do produto (ComplementoProduto.DescricaoLonga).
Unidade	Unidade de venda (Itemclicad.Unid).
Quantidade Vendida	Quantidade vendida (Itemclicad.Quant).
Previsão de Entrega	Data prevista de entrega do produto (Itemclicad.DtPrevEnt).
Preço Unitário	Valor unitário do produto (Itemclicad.Preco).
Preço Total	Quantidade × Preço Unitário (Itemclicad.Quant × Itemclicad.Preco).

---

Totais do Pedido

Ao final do relatório deverão ser apresentados os valores consolidados do pedido.

Campo	Informação
Total de Mercadorias	Somatório do preço total dos itens do pedido.
Desconto	Valor do desconto geral do pedido (Pediclicad.Desconto).
Frete	Valor do frete do pedido (Pediclicad.FreteOrc).
Outras Despesas	Demais valores que compõem o total do pedido, quando houver.
Total do Pedido	Valor total do pedido (Pediclicad.ValPed).

---

O documento deverá consolidar todas essas informações em um único Termo de Compra, servindo como registro formal da venda por representação e contendo os dados da negociação, das partes envolvidas, dos produtos comercializados e dos valores totais do pedido.

Comissão do Profissional Indicador

O painel Comissão do Profissional Indicador deverá ser apresentado de forma condicional, conforme as configurações do sistema.

---

Regras de Negócio

RN028 – Exibição do painel

O GRID Comissão do Profissional Indicador deverá ser exibido somente quando o parâmetro:

"Utiliza tratamento de comissão por indicação"

estiver habilitado.

Caso o parâmetro esteja desabilitado:

• o GRID não deverá ser exibido;
• o GRID de Comissão de Venda por Representação deverá ser redimensionado automaticamente para ocupar o espaço disponível na interface, evitando áreas em branco.

---

RN029 – Dados apresentados

O GRID deverá listar todos os registros financeiros relacionados à comissão por indicação vinculados ao pedido de venda.

Os registros apresentados dependerão da configuração do parâmetro:

"Gerar nota de crédito para comissão de profissional indicador?"

Quando o parâmetro estiver habilitado

Exibir os registros de Contas a Receber (Nota de Crédito) gerados para o profissional indicador.

Quando o parâmetro estiver desabilitado

Exibir os registros de Contas a Pagar gerados para o profissional indicador.

Em ambos os casos, deverão ser exibidos exclusivamente os registros financeiros vinculados à comissão por indicação do pedido de venda selecionado.