CONTEÚDO
- Visão geral
- Exemplo de utilização
- Pedido de Vendas e Orçamento de Vendas
- Comportamentos especificos
- Tabelas utilizadas
01. VISÃO GERAL
O Portal Gestão de Vendas permite a inclusão de campos personalizados no cabeçalho, itens e visualização nas operações de inclusão e alteração do Pedido de Vendas e Orçamentos.
Para Pedidos de Vendas esta funcionalidade estará disponivel a partir da versão 1.6.0 do Portal Gestão de Vendas, sendo necessário aplicação do pacote da expedição continua do módulo de Faturamento.
Para Orçamentos de Vendas esta funcionalidade estará disponivel a partir da versão 1.8.6 do Portal Gestão de Vendas, sendo necessário aplicação do pacote da expedição continua do módulo de Faturamento.
02. EXEMPLO DE UTILIZAÇÃO
Para personalização dos formulários do Portal Gestão de Vendas, temos os pontos de entradas disponíveis abaixo:
- DT PE GVFLDC5 - Adicionar na interface do PGV campos adicionais do Cabeçalho do Pedido de Venda (SC5)
- DT PE GVFLDC6 - Adicionar na interface do PGV campos adicionais dos itens do Pedido de Venda (SC6)
- PE GVFLDCJ - Adicionar na interface do PGV campos adicionais do Cabeçalho do Orçamento (SCJ)
- PE GVFLDCK - Adicionar na interface do PGV campos adicionais dos Itens do Orçamento (SCK)
Deve ser realizado o login no portal para ocorrer a carga de dados dos campos personalizados retornados no ponto de entrada.
03. Pedido de Vendas e Orçamentos de Vendas
Ao Incluir, Alterar ou Visualizar um Pedido de Vendas, será apresentados os campos retornados nos pontos de entradas, conforme os exemplos abaixo:
a. Dados Gerais
Ponto de entrada GVFLDC5
b. Itens
Ponto de entrada GVFLDC6
Ao Incluir, Alterar ou Visualizar um Orçamento de Vendas, será apresentados os campos retornados nos pontos de entradas, conforme os exemplos abaixo:
a. Dados Gerais
Ponto de entrada GVFLDCJ
b. Itens
Ponto de entrada GVFLDCK
04. Comportamentos específicos
A seguir serão descritos o funcionamento e o comportamento dos campos customizados no Portal Gestão de Vendas, de acordo com as configurações no Protheus.
a. Carga de Dados
Os campos informados nos pontos de entrada desta documentação, são carregados para o armazenamento local do navegador com as suas respectivas características descritas no Dicionário de Dados do Protheus.
Porém, se forem informados campos com os tipos não considerados pelo PGV conforme descrito na documentação dos seus respectivos pontos de entrada, os campos não serão carregados no PGV e consequentemente não serão apresentados para o preenchimento. Campos virtuais também não serão carregados.
b. Características do Dicionário de Dados Protheus aplicadas nos campos customizados do Portal Gestão de Vendas
Os campos customizados são apresentados no PGV seguindo algumas das características descritas no dicionário de dados do Protheus, conforme mencionado no tópico acima.
A relação entre as propriedades de um campo customizado do dicionário de dados Protheus e as propriedades destes mesmo campo no PGV são apresentadas a seguir:
- Título (X3_TITULO): Rótulo do campo exibido.
- Descrição (X3_DESCRIC): Texto de ajuda apresentado abaixo do campo.
- Tipo (X3_TIPO): Tipo do campo
- Tamanho (X3_TAMANHO): Tamanho máximo de caracteres
- Propriedade (X3_VISUAL): Desabilita o campo caso tenha o valor V – Visualizar no dicionário de dados
- Obrigatório (X3_OBRIGAT): Define a obrigatoriedade do campo
Os gatilhos, validações e inicializadores padrões dos campos somente serão executados após o acionamento da opção de salvamento dos dados, conforme a rotina automática correspondente.
As consultas padrões (F3) não são executadas na interface do PGV.
c. Campos Customizados Obrigatórios
Esta seção vai apresentar alguns detalhes sobre os campos customizados obrigatórios (X3_OBRIGAT).
Estes campos vêm com uma indicação na parte superior com esta informação. Caso o campo seja preenchido e depois for deixado vazio as bordas do campo ficarão vermelhas. Mas, as demais operações na interface não serão interrompidas.
A validação do preenchimento dos campos customizados obrigatórios acontecerá após o acionamento da opção de salvamento dos dados. Caso algum destes campos não esteja preenchido, será apresentada a seguinte mensagem:
d. Validações do Protheus nos campos
Conforme já mencionado as validações dos campos adicionadas no dicionário de dados do Protheus (X3_VALID e/ou X3_VLDUSR), não são executadas na interface do PGV. Porém, após o acionamento da opção de salvamento dos dados, o PGV irá validar o preenchimento dos campos conforme configuração no Protheus.
Caso alguma validação retorne um resultado negativo, este será apresentado no PGV.
Caso contrário o salvamento dos dados ocorrerá com sucesso.
e. Campos que não serão apresentados como customizados
Alguns dados não serão personalizados, mesmo que informados nos pontos de entrada. Isso significa que eles não aparecerão na tela do Portal de Gestão de Vendas porque já estão lá por padrão ou não podem ser alterados manualmente. Esses são os campos:
C5_FILIAL - Filial
C5_NUM - Numero
C5_TIPO - Tipo Pedido
C5_TABELA - Tabela
C5_CONDPAG - Cond. Pagto
C5_EMISSAO - DT Emissao
C5_CLIENTE - Cliente
C5_LOJACLI - Loja
C5_TRANSP - Transp.
C5_TPFRETE - Tipo Frete
C5_FRETE - Frete
C5_SEGURO - Seguro
C5_DESPESA - Despesa
C5_DESC1 - Desconto 1
C5_DESC4 - Desconto 4
C5_MOEDA - Moeda
C5_TPLIB - Tipo de Liberação
C5_CODA1U - Cod Intermed
C5_INDPRES - Presença Com
C5_MENNOTA - Mens.p/ Nota
C5_COMENT - Comentario
CJ_FILIAL - Filial
CJ_NUM - Numero
CJ_NUMEXT - Descrição
CJ_TABELA - Tabela de Preços
CJ_CONDPAG - Condição de Pagamento
CJ_CLIENTE - Cliente
CJ_LOJA - Loja
CJ_PROSPE - Prospect
CJ_LOJPRO - Loja do Prospect
CJ_EMISSAO - Emissão
CJ_TPFRETE - Tipo do Frete
CJ_FRETE - Frete
CJ_SEGURO - Seguro
CJ_DESPESA - Despesa
CJ_DESC1 - Descrição
CJ_MOEDA - Moeda
CJ_TIPLIB - Tipo de Liberação
CJ_TIPOCLI - Tipo do Cliente
CJ_STATUS - Status
CJ_PROPOST - Proposta
CK_FILIAL - Filial
CK_NUM - Numero
CK_ITEM - Item
CK_PRODUTO - Produto
CK_DESCRI - Descrição do Produto
CK_QTDVEN - Quantidade
CK_PRUNIT - Preço Unitário
CK_PRCVEN - Preço de Venda
CK_VALOR - Valor Total
CK_DESCONT - Desconto
CK_VALDESC - Valor do Desconto
CK_TES - TES - Tipo de Entrada ou Saída
CK_OPER - Tipo de Operação
05. TABELAS UTILIZADAS
- SC5 - Pedidos de Venda
- SC6 - Itens dos Pedidos de Venda
- SCJ - Orçamentos de Venda
- SCK - Itens dos Orçamentos de Vendas