Pular para o conteúdo principal

RPD028 — Relatório RPD028

Fonte​

  • Source: source/RPD028/

Perguntas Frequentes​

Perguntas Gerais​

P: Qual é a finalidade da tela RPD028? R: O RPD028 é um relatório de visitas comerciais realizadas a clientes. Ele exibe registros de visitas agrupando informações como cliente visitado, visitante (representante ou vendedor responsável pela visita), representante comercial, vendedor, endereço, município, estado, data da visita, observações e número de linha/dias. O relatório utiliza a view/stored procedure VIEW_RPD028 para retornar os dados filtrados por condições dinâmicas. Permite filtrar por período de visita, região comercial, pessoa/cliente, visitante, vendedor, representante, município e estado.

P: O que é a "Região Comercial" e como ela afeta o relatório? R: A região comercial (CD_REGIAOCOMERCIAL) é um agrupamento geográfico ou comercial cadastrado no sistema. Ao informar uma região comercial, o relatório filtra os registros pela coluna R.CD_REGIAOCOMERCIAL, exibindo apenas visitas a clientes pertencentes àquela região. Use F9 no campo para pesquisar usando a busca REGIAOCOMERCIAL.

P: O que são as "Quebras" disponíveis nos checkboxes? R: Os checkboxes de quebra adicionam agrupamentos (quebras de página ou subtotais) ao relatório, além de alterar a ordenação:

  • Estado (chkEstado): agrupa e ordena por estado do cliente (O_SG_ESTADOCLIENTE), adicionando a coluna QB_ESTADO ao SELECT.
  • Representante (chkRepresentante): agrupa e ordena por representante (O_CD_REPRESENTANTE), adicionando a coluna QB_REPRESENTANTE.
  • Vendedor (chkVendedor): agrupa e ordena por vendedor (O_CD_VENDEDOR), adicionando a coluna QB_VENDEDOR.

Quando nenhuma quebra está marcada, o relatório é ordenado por cliente e data de visita.

P: O relatório salva ou exclui dados do sistema? R: Não. O RPD028 é um relatório somente de leitura. Os botões "Salvar", "Excluir", "Procurar" e "Atualizar" ficam sempre ocultos. O botão "Limpar" remove a linha selecionada no grid ativo (cliente, vendedor, visitante, representante, município ou estado).

P: O sistema salva os filtros entre sessões? R: Sim. O RPD028 utiliza as funções Grava_FiltroPrograma e Recupera_FiltroPrograma para persistir e restaurar os filtros definidos pelo usuário. Ao fechar o relatório, os filtros são salvos automaticamente vinculados ao usuário e à empresa. Na próxima abertura, os filtros do usuário são restaurados.

P: Como funciona a pesquisa rápida (F9) nos grids e campos? R: Ao pressionar F9 nos grids, o sistema abre a busca padronizada:

  • Grid de Pessoas/Clientes: pesquisa usando a busca PESSOA.
  • Grid de Visitantes: pesquisa usando a busca PESSOA.
  • Grid de Representantes: pesquisa usando a busca PESSOA.
  • Grid de Vendedores: pesquisa usando a busca VENDEDOR.
  • Grid de Municípios: pesquisa usando a busca MUNICIPIO.
  • Grid de Estados: pesquisa usando a busca ESTADO, retornando a sigla do estado.
  • Campo Região Comercial: pesquisa usando a busca REGIAOCOMERCIAL.

P: O que são os atalhos de teclado disponíveis? R: Os seguintes atalhos estão disponíveis na tela RPD028:

  • F4: Limpar/remover a linha selecionada no grid ativo.
  • F5: Novo (reinicializa os filtros).
  • F8: Imprimir/gerar o relatório.
  • F12: Sair da tela.

P: Qual é a diferença entre "Pessoa/Cliente", "Visitante" e "Representante" no RPD028? R: Os três filtros se referem a papéis diferentes no registro de visita:

  • Pessoa/Cliente (tabPESSOA): o cliente que foi visitado. Filtra por V.CD_CLIENTE.
  • Visitante (tabVISITANTE): a pessoa que realizou a visita (quem visitou o cliente). Filtra por V.CD_VISITANTE.
  • Representante (tabREPRESENTANTE): o representante comercial vinculado ao cliente ou à visita. Filtra por PR.CD_PESSOA.
  • Vendedor (tabVENDEDOR): o vendedor responsável pela região ou cliente. Filtra por PE.CD_PESSOA.

P: É possível filtrar por múltiplos clientes, visitantes, vendedores, representantes, municípios ou estados simultaneamente? R: Sim. Todos os grids aceitam múltiplas linhas. O sistema monta a cláusula IN com todos os códigos informados. Use F9 para adicionar e F4 para remover linhas dos grids.

P: Como funciona o filtro de período (Data de Visita)? R: Os campos Data de Início e Data de Fim definem o intervalo de datas de visita. O filtro é aplicado na view VIEW_RPD028 como CAST(V.DT_VISITA AS DATE) >= [data_inicio] AND CAST(V.DT_VISITA AS DATE) <= [data_fim]. Ambos os campos são opcionais; se não informados, o relatório retorna todas as visitas sem restrição de data.

P: O que representam as colunas O_NR_LINHA e O_QT_DIAS no relatório? R: Essas colunas são retornadas pela view/procedure VIEW_RPD028:

  • O_NR_LINHA: número de ordem ou linha da visita dentro do agrupamento.
  • O_QT_DIAS: quantidade de dias entre visitas ao mesmo cliente, útil para analisar a frequência de visitas.

Mensagens de Validação e Erros​

P: Aparece a mensagem "A Data Inicial não pode ser Maior que a Data Final!". O que fazer? R: A data de início informada é posterior à data de fim. Corrija os campos para que a data inicial seja anterior ou igual à data final.

P: Aparece a mensagem "A Data Final não pode ser Menor que a Data Inicial!". O que fazer? R: A data final está sendo preenchida como anterior à data inicial. Corrija para que a data final seja igual ou posterior à data inicial.

P: Aparece a mensagem "A Pessoa [código] não está cadastrado! Verifique [TFA001]". O que fazer? R: O código de pessoa informado em algum dos grids (cliente, visitante ou representante) não existe no cadastro de pessoas. Verifique o código ou use F9 para pesquisar. Cadastre em TFA001 se necessário. A mensagem inclui o código informado para facilitar a identificação.

P: Aparece a mensagem "O Municipio [código] não está cadastrado! Verifique [TFA003]". O que fazer? R: O código de município informado no grid de municípios não existe no cadastro. Verifique o código ou use F9 para pesquisar. Cadastre em TFA003 se necessário.

P: Aparece a mensagem "O Estado [sigla] não está cadastrado! Verifique [TFA004]". O que fazer? R: A sigla de estado informada no grid de estados não existe no cadastro. Verifique a sigla (ex.: SP, RJ, MG) ou use F9 para pesquisar. Cadastre em TFA004 se necessário.

P: Aparece a mensagem "A Região [código] não está cadastrado! Verifique [TFA014]". O que fazer? R: O código de região comercial informado no campo específico não existe. Verifique o código ou use F9. Cadastre em TFA014 se necessário.

P: Aparece a mensagem "A Pessoa [código] não está cadastrado! Verifique [TFA001]" ao preencher o grid de Visitantes. O que fazer? R: O código informado no grid de Visitantes não existe no cadastro de pessoas. Verifique o código ou use F9 para pesquisar a pessoa visitante. Cadastre em TFA001 se necessário.

P: Aparece a mensagem "A Pessoa [código] não está cadastrado! Verifique [TFA001]" ao preencher o grid de Representantes. O que fazer? R: O código informado no grid de Representantes não existe no cadastro de pessoas. Verifique o código ou use F9. Cadastre em TFA001 se necessário.

P: Aparece a mensagem "O Vendedor [código] não está cadastrado! Verifique [TFA007]". O que fazer? R: O código informado no grid de Vendedores não existe no cadastro de vendedores. Verifique o código ou use F9. Cadastre em TFA007 se necessário.

Tabelas de Escrita (INSERT/UPDATE/DELETE)​

TabelaOperacoes
EMPRESADELETE, INSERT, SELECT, UPDATE

Tabelas de Leitura (SELECT)​

TabelaOperacoes
ESTADOSELECT
MUNICIPIOSELECT
PESSOASELECT
REGIAOCOMERCIALSELECT
VENDEDORSELECT