Pular para o conteúdo principal

RNF033 — Relatório de Pontos por Cliente

Fonte​

  • Source: source/RNF033/

Perguntas Frequentes​

Perguntas Gerais​

P: Qual é a finalidade da tela RNF033? R: O RNF033 é um relatório de pontuação de clientes baseado no valor das notas fiscais de saída emitidas. Ele calcula a quantidade de pontos que cada cliente acumulou no período, conforme a regra de fator de pontos configurada nos parâmetros de faturamento (PARMFATUR.VL_FATORPONTOS). O relatório considera apenas notas fiscais de saída (TP_NOTA = 'S') com status válido (ST_NOTA = 'V'). Existe um campo opcional Valor do Ponto que permite sobrepor o valor do ponto definido nos parâmetros.

Dois modelos estão disponíveis:

  • Sintético (RNF033_S): exibe, por cliente, o valor total das notas, a quantidade de pontos acumulados e o valor monetário dos pontos.
  • Analítico (RNF033_A): detalha cada nota fiscal do cliente com data de emissão, vencimento, vendedor, forma de pagamento, condição de pagamento, valor da nota e pontuação acumulada no período.

P: Como funciona o cálculo de pontos no RNF033? R: Os pontos são calculados pela função DIVIDENDO(valor_total, fator_pontos), onde fator_pontos é obtido da tabela PARMFATUR para a empresa selecionada. O valor monetário dos pontos é dado por quantidade_pontos * valor_do_ponto. O campo Valor do Ponto (VL_PONTO) na tela permite informar um valor de referência alternativo; se não preenchido, o sistema usa o próprio fator de pontos dos parâmetros.

P: Quais filtros estão disponíveis no RNF033? R: Os filtros disponíveis são:

  • Empresa: campo preenchido automaticamente com a empresa da sessão atual. Obrigatório.
  • Data Inicial e Data Final: período de emissão das notas fiscais a considerar.
  • Modelo: seleção entre Sintético e Analítico.
  • Valor do Ponto: valor opcional para sobrepor o fator de pontos configurado nos parâmetros.
  • Pessoas: lista de clientes para filtrar. Permite múltiplos clientes.
  • Tipo de Pessoa: lista de tipos de pessoa para filtrar clientes por categoria.

P: O RNF033 salva os filtros ao fechar? R: Sim. O RNF033 utiliza a função Grava_FiltroPrograma ao fechar e Recupera_FiltroPrograma ao abrir. Os filtros configurados são salvos automaticamente por empresa e usuário, e restaurados na próxima abertura do relatório.

P: Como adicionar clientes ou tipos de pessoa ao filtro? R: Para clientes, clique na grade de Pessoas e pressione F9 para abrir a pesquisa de pessoas ativas. Para tipos de pessoa, clique na grade de Tipo de Pessoa e pressione F9 para abrir a pesquisa de tipos cadastrados. Múltiplos registros podem ser adicionados às listas. Para remover um registro, selecione-o na grade e clique no botão Limpar (F4).

P: Quais atalhos de teclado estão disponíveis no RNF033? R: Os atalhos disponíveis são:

  • F4: Limpar o registro selecionado na lista ativa ou reiniciar o formulário.
  • F5: Novo — reinicia o formulário de filtros.
  • F8: Imprimir — gera o relatório com os filtros configurados.
  • F9: Pesquisar — abre a tela de busca para o campo em foco.
  • F12: Sair — fecha o módulo.

Mensagens de Validação e Erros​

P: Recebi a mensagem "O Valor do Ponto não está Parametrizado! Verifique [MFA001]" ao tentar imprimir. O que fazer? R: Esta mensagem indica que a tabela PARMFATUR não possui registro para a empresa selecionada, ou o campo VL_FATORPONTOS não está configurado. O RNF033 depende desse parâmetro para calcular a pontuação. Acesse o módulo MFA001 (Parâmetros de Faturamento) e configure o Fator de Pontos para a empresa correspondente.

P: Recebi a mensagem "A Empresa não está Cadastrada [ADM002]!" ao informar o código da empresa. O que fazer? R: O código de empresa informado não existe no cadastro. Verifique se o código está correto ou utilize F9 para pesquisar e selecionar uma empresa válida. O cadastro de empresas é realizado no módulo ADM002.

P: Recebi a mensagem "A Data Inicial não pode ser Maior que a Data Final!" O que fazer? R: A Data Inicial informada é posterior à Data Final. Corrija as datas para que a Data Inicial seja anterior ou igual à Data Final.

P: Recebi a mensagem "A Data Final não pode ser Menor que a Data Inicial!" O que fazer? R: A Data Final informada é anterior à Data Inicial. Ajuste a Data Final para ser igual ou posterior à Data Inicial.

P: Recebi a mensagem "A Pessoa Física / Jurídica não está Ativa [TFA001]!" ao informar um código de cliente. O que fazer? R: O cliente informado existe no cadastro, porém está com o status Inativo (ST_ATIVA = 'N'). Para incluí-lo no filtro, o cliente precisa ser reativado no módulo TFA001. Caso contrário, selecione apenas clientes ativos.

P: Recebi a mensagem "A Pessoa Física / Jurídica não está Cadastrada [TFA001]!" ao informar um código de cliente. O que fazer? R: O código de cliente informado não existe no cadastro de pessoas. Verifique o código informado ou utilize F9 para pesquisar e selecionar um cliente válido. O cadastro de pessoas é realizado no módulo TFA001.

P: Recebi a mensagem "O Tipo de Pessoa não está Cadastrada [TFA005]!" ao informar um tipo de pessoa. O que fazer? R: O código de tipo de pessoa informado não existe no cadastro TIPOPESSOA. Verifique o código ou utilize F9 para pesquisar e selecionar o tipo de pessoa correto. O cadastro de tipos de pessoa é realizado no módulo TFA005.

Dúvidas sobre o Relatório​

P: Por que algumas notas não aparecem no relatório de pontuação? R: O RNF033 considera apenas notas com ST_NOTA = 'V' (válidas) e TP_NOTA = 'S' (saída). Notas canceladas, excluídas ou de entrada não são computadas. Verifique o status das notas no módulo CNF001.

P: Qual a diferença entre o modelo Sintético e o Analítico? R: O modelo Sintético consolida os dados por cliente, exibindo o total de valor e pontos acumulados no período. O modelo Analítico detalha cada nota fiscal individualmente, mostrando todas as notas do cliente com seus valores e a pontuação acumulada no período até aquela nota.

P: Como o campo "Valor do Ponto" na tela afeta o cálculo? R: Se o campo VL_PONTO for preenchido na tela, o sistema usará esse valor como referência para calcular o valor monetário dos pontos (quantidade_pontos * VL_PONTO). Se não for preenchido, o sistema usa o VL_FATORPONTOS da tabela PARMFATUR. Isso permite simular cenários com valores de ponto diferentes do configurado nos parâmetros.

Mensagens exibidas​

Levantadas de source/RNF033/ pela camada 0 (commit 96fc51e236).

Mais 7 mensagens com texto literal no código: RNF033.

Tabelas de Escrita (INSERT/UPDATE/DELETE)​

TabelaOperacoes
EMPRESADELETE, INSERT, SELECT, UPDATE
PESSOADELETE, INSERT, SELECT, UPDATE
TIPOPESSOADELETE, INSERT, SELECT, UPDATE

Tabelas de Leitura (SELECT)​

TabelaOperacoes
CONDPAGTOSELECT
ENDERECOPESSOASELECT
FORMAPAGTOSELECT
MUNICIPIOSELECT
NOTASELECT
PARMFATURSELECT