Pular para o conteúdo principal

RNF035 — Relatório RNF035

Fonte​

  • Source: source/RNF035/

Perguntas Frequentes​


Perguntas Gerais​

P: Qual é a finalidade da tela RNF035? R: O RNF035 é um relatório de ticket médio de notas fiscais de saída, com foco na análise de vendas por cliente e/ou vendedor. Ele considera apenas notas fiscais de saída (TP_NOTA = 'S') com status válido (ST_NOTA = 'V'). O relatório oferece quatro modelos distintos:

  • Ticket Médio Diário/Semanal (T): usa a VIEW_RNF035 para exibir colunas diárias de valor e atendimentos por período de até 7 dias. Permite ordenar por vendedor, por valor ou por atendimentos.
  • Ticket Médio Anual (A): usa a mesma VIEW_RNF035 para comparativo anual, com período máximo de 7 anos.
  • Gráfico (G): exibe um gráfico de linha do ticket médio por hora do dia usando a VIEW_RNF035_GRAFICO. Período máximo de 1 dia.
  • Curva de Clientes (C): consulta diretamente as tabelas NOTA, ITEMNOTA, ITEM, TIPOCALCULO, PESSOA e MOVIMENTACAO, exibindo por cliente o total líquido, a média por nota e a contagem de notas/itens. Suporta quebra por mês, por ano ou sem quebra, e também modo analítico por item.

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

  • Empresa: campo obrigatório.
  • Data Inicial e Data Final: período obrigatório. O formato varia conforme o modelo selecionado (diário, anual ou com hora para o gráfico).
  • Modelo: seleção do tipo de relatório (T = Ticket Diário, A = Anual, G = Gráfico, C = Curva de Clientes).
  • Ordem (modelos T): ordena por vendedor, por valor ou por número de atendimentos.
  • Quebra (modelo C): agrupa os dados por mês, por ano ou sem quebra.
  • Quebra por Vendedor (modelo C): permite exibir os dados segmentados por vendedor.
  • Clientes: lista de clientes para filtrar. O checkbox permite inverter o filtro para excluir os clientes selecionados.
  • Vendedores: lista de vendedores para filtrar. O checkbox permite inverter o filtro para excluir os vendedores selecionados.
  • Produtos: lista de produtos para filtrar por item.
  • Grupos: lista de grupos de produto para filtrar.
  • SubGrupos: lista de subgrupos de produto para filtrar.
  • Excluir Devoluções: exclui notas marcadas como devolução (ST_DEVOLUCAO = 'N').
  • Excluir Mestras/Remessas: exclui notas mestras (ST_MESTRA = 'N').
  • Gera Financeiro: filtra apenas notas que geram financeiro (CD_TIPOCONTA IS NOT NULL).
  • Gera Receita: filtra apenas notas que geram receita (ST_RECEITA = 'S').
  • Analítico por Item (modelo C): detalha os dados por produto dentro de cada cliente.
  • Ordenação do Ticket do Cliente (modelo C): define a coluna e a direção de ordenação dos clientes.

P: O RNF035 salva os filtros ao fechar? R: Sim. O RNF035 utiliza Grava_FiltroPrograma ao fechar e Recupera_FiltroPrograma ao abrir. Os filtros configurados são salvos por empresa e usuário e restaurados na próxima abertura.


P: Como funciona o suporte a múltiplos vendedores por nota (ST_VARIOSVENDEDORES)? R: Quando o parâmetro ST_VARIOSVENDEDORES = 'S' na tabela PARMFATUR da empresa, o modelo Curva de Clientes (C) com a opção "Quebra por Vendedor" ativada consulta a tabela ITEMNOTAVENDEDOR para identificar os vendedores por item de nota, ao invés de usar o vendedor único da nota. Isso permite análises mais precisas em empresas que trabalham com comissão de múltiplos vendedores por item.


P: Qual a diferença entre os checkboxes de cliente e vendedor no filtro? R: Os checkboxes chkPESSOA e chkVendedor invertem o comportamento do filtro:

  • Quando desmarcados (padrão): os clientes/vendedores informados na lista são incluídos na consulta (IN).
  • Quando marcados: os clientes/vendedores informados na lista são excluídos da consulta (NOT IN), ou seja, o relatório mostra todos exceto os selecionados.

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

  • F3: Procurar.
  • F4: Limpar o registro selecionado na lista ativa.
  • F5: Novo — reinicia o formulário de filtros.
  • F6: Salvar.
  • F8: Imprimir — gera o relatório.
  • 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 "É Obrigatório Informar a Empresa para Realizar a Consulta!" ao tentar imprimir. O que fazer? R: O campo Empresa é obrigatório no RNF035. Preencha o código da empresa no campo correspondente ou utilize F9 para pesquisar. O sistema bloqueia a geração do relatório sem esse campo preenchido.


P: Recebi a mensagem "Obrigatório Informar a Data Inicial do Período para Realizar a Consulta!" O que fazer? R: O campo Data Inicial é obrigatório. Preencha a data inicial antes de gerar o relatório. O formato do campo varia conforme o modelo selecionado: data simples para os modelos T e C, apenas ano para o modelo A e data com hora para o modelo G.


P: Recebi a mensagem "Obrigatório Informar o Data Final do Período para Realizar a Consulta!" O que fazer? R: O campo Data Final é obrigatório. Preencha a data final antes de gerar o relatório.


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 "O Período Máximo Permitido é de 7 dias. Verifique!" no modelo Ticket Diário (T). O que fazer? R: O modelo Ticket Médio Diário (T) permite no máximo um intervalo de 7 dias entre a Data Inicial e a Data Final. Ajuste o período para não ultrapassar esse limite. Para períodos maiores, utilize o modelo Anual (A) ou a Curva de Clientes (C).


P: Recebi a mensagem "O Período Máximo Permitido é de 7 anos. Verifique!" no modelo Anual (A). O que fazer? R: O modelo Anual (A) permite no máximo um intervalo de 7 anos. Restrinja o período de consulta para respeitar esse limite.


P: Recebi a mensagem "O Período Máximo Permitido é de 1 Dia. Verifique!" no modelo Gráfico (G). O que fazer? R: O modelo Gráfico (G) é projetado para analisar o ticket médio por hora dentro de um único dia. A Data Inicial e a Data Final devem ser o mesmo dia (com horas diferentes). Ajuste as datas para que a diferença seja de 0 dias (mesmo dia, intervalo de horas).


P: Recebi a mensagem "A consulta não retornou registros!" O que fazer? R: Esta mensagem indica que nenhuma nota fiscal foi encontrada com os filtros informados. Verifique:

  1. Se o período informado possui notas fiscais de saída válidas para a empresa selecionada.
  2. Se os filtros de cliente, vendedor, produto, grupo ou subgrupo não estão muito restritivos.
  3. Se as opções de exclusão (devoluções, mestras, financeiro, receita) não estão filtrando todos os registros.
  4. Se a empresa possui parâmetros de faturamento cadastrados no módulo MFA001.

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 uma empresa válida. O cadastro de empresas é realizado no módulo ADM002.


P: Recebi a mensagem "A Pessoa não está Cadastrada! [TFA001]" ao informar um cliente. O que fazer? R: O código de pessoa informado na grade de Clientes não existe no cadastro. Verifique o código ou utilize F9 para pesquisar e selecionar um cliente válido no módulo TFA001.


P: Recebi a mensagem "O Produto não está Cadastrado! [TPO001]" ao informar um produto. O que fazer? R: O código de item informado na grade de Produtos não está cadastrado e ativo na tabela ITEM. Verifique o código ou utilize F9 para pesquisar. O cadastro de produtos é realizado no módulo TPO001.


P: Recebi a mensagem "O Grupo não está Cadastrado! [TPO006]" ao informar um grupo. O que fazer? R: O código de grupo informado não existe na tabela GRUPO. Verifique o código ou utilize F9 para pesquisar e selecionar um grupo válido. O cadastro de grupos é realizado no módulo TPO006.


P: Recebi a mensagem "O SubGrupo não está Cadastrado! [TPO007]" ao informar um subgrupo. O que fazer? R: O código de subgrupo informado não existe na tabela SUBGRUPO. Verifique o código ou utilize F9 para pesquisar e selecionar um subgrupo válido. O cadastro de subgrupos é realizado no módulo TPO007.


P: Recebi a mensagem "Vendedor não está Cadastrado! [TFA007]" ao informar um vendedor. O que fazer? R: O código informado na grade de Vendedores não existe na tabela VENDEDOR. Verifique o código ou utilize F9 para pesquisar e selecionar um vendedor válido. O cadastro de vendedores é realizado no módulo TFA007.


P: Recebi a mensagem "Os Parâmetros de Faturamento para a Empresa não estão Cadastrados [MFA001]!" O que fazer? R: A tabela PARMFATUR não possui registro para a empresa selecionada. Acesse o módulo MFA001 (Parâmetros de Faturamento) e cadastre os parâmetros para a empresa correspondente antes de gerar o relatório.


P: Recebi a mensagem "Este registro não pode ser excluído pois existe movimentações relacionadas" O que fazer? R: Esta mensagem (código C-0000) é exibida ao tentar excluir um registro de filtro que possui dependências. Na prática, no RNF035, isso pode ocorrer ao tentar excluir um item de alguma grade que ainda está em uso. Verifique os registros relacionados antes de tentar a exclusão.


Dúvidas sobre o Relatório​

P: O que representa o "Ticket Médio" no contexto do RNF035? R: O ticket médio é calculado como o valor líquido total das notas dividido pela quantidade de notas distintas (SUM(IT.VL_LIQUIDO) / COUNT(DISTINCT NR_LANCAMENTO||CD_SERIE||CD_EMPRESA||TP_NOTA)). Ele representa o valor médio gasto por nota fiscal de cada cliente no período analisado.


P: O modelo Gráfico (G) exibe quais informações? R: O modelo Gráfico abre uma janela com um gráfico de linhas (TDBChart com TLineSeries) exibindo o ticket médio por hora do dia por vendedor. Os dados são obtidos da VIEW_RNF035_GRAFICO. O eixo Y (esquerdo) é automaticamente ajustado ao valor máximo de ticket médio encontrado acrescido de 5.


P: O modelo Analítico por Item no modo Curva de Clientes exibe quais campos adicionais? R: Quando a opção "Analítico por Item" está marcada no modo Curva de Clientes (C), o relatório (layout RNF035_ITEMC) exibe, além dos dados do cliente, o código e descrição de cada item, a quantidade total (por peso ou quantidade conforme o tipo de cálculo), o total líquido de valor, a média por nota e o valor de desconto médio por unidade. O agrupamento inclui o item como dimensão adicional.

Tabelas de Escrita (INSERT/UPDATE/DELETE)​

TabelaOperacoes
EMPRESADELETE, INSERT, SELECT, UPDATE

Tabelas de Leitura (SELECT)​

TabelaOperacoes
GRUPOSELECT
ITEMSELECT
ITEMNOTASELECT
ITEMNOTAVENDEDORSELECT
ITEMPRODUCAOSELECT
MOVIMENTACAOSELECT
PARMFATURSELECT
PESSOASELECT
SUBGRUPOSELECT
TIPOCALCULOSELECT
VENDEDORSELECT

Procedures Chamadas​

ProcedureTabelas Acessadas
VIEW_RNF035ITEM (SELECT), ITEMNOTA (SELECT), ITEMNOTAVENDEDOR (SELECT), MOVIMENTACAO (SELECT), NOTA (SELECT), PARMFATUR (SELECT) +1
VIEW_RNF035_GRAFICOITEM (SELECT), ITEMNOTA (SELECT), ITEMNOTAVENDEDOR (SELECT), MOVIMENTACAO (SELECT), NOTA (SELECT), PARMFATUR (SELECT) +1

Tabelas via Procedures (acesso indireto)​

TabelaOperacoes
ITEMSELECT
ITEMNOTASELECT
ITEMNOTAVENDEDORSELECT
MOVIMENTACAOSELECT
NOTASELECT
PARMFATURSELECT
PESSOASELECT