RNF040 — Vendas Agrupadas por Produtos
Fonte
- Source:
source/RNF040/
Perguntas Frequentes
Perguntas Gerais
P: Qual é a finalidade da tela RNF040? R: O RNF040 gera um relatório analítico de vendas por produto com comparativo por variáveis (vendedores, municípios ou clientes ao longo do tempo), chamado "Mapa de Vendas". Utilizando a view VIEW_RNF040 do banco de dados, o relatório exibe até 20 colunas variáveis comparativas, somando quantidades e valores de venda de cada produto para cada variável. Possui três tipos de visualização: por Vendedor (V), por Município (M) e por Cliente (C).
P: Quais são os tipos de relatório disponíveis no RNF040? R: Os três tipos são:
- V (Vendedor): Compara as vendas de cada produto entre os vendedores cadastrados. Cada coluna variável representa um vendedor.
- M (Município): Compara as vendas de cada produto entre os municípios de destino dos clientes. Cada coluna representa um município.
- C (Cliente): Compara as vendas de cada produto entre os clientes. Cada coluna representa um cliente.
Em todos os tipos, são exibidas até 20 variáveis (colunas) com quantidade e valor de venda por produto.
P: Quais são os filtros disponíveis no RNF040? R: Os filtros disponíveis são:
- Empresa: Código da empresa emissora.
- Período de Emissão: Data inicial e data final (campo N.DT_EMISSAO).
- Status da Nota: Válida (V), Cancelada (C), Excluída (E), Bloqueada (B) ou Todos (T).
- Tipo de Produto: Todos (T), Somente Sementes (S) ou Exceto Sementes (N).
- Financeiro: Todas, com contas ou sem contas financeiras.
- Tipo de Relatório (cmbTipo): Vendedor (V), Município (M) ou Cliente (C).
- Ordenação: Por código do produto ou por descrição do produto.
- Pessoas (Clientes): Lista de clientes. Possui opção de exclusão (checkbox chkExclusaoPessoa): quando marcado, exclui os clientes listados em vez de incluir.
- Vendedores: Lista de vendedores. Possui opção de exclusão (chkExclusaoVendedores).
- Itens (Produtos): Lista de produtos. Possui opção de exclusão (chkExclusaoProdutos).
- Grupo: Lista de grupos de produto. Possui opção de exclusão (chkExclusaoGrupo).
- Subgrupo: Lista de subgrupos. Possui opção de exclusão (chkExclusaoSubGrupo).
- Município: Lista de municípios de destino. Possui opção de exclusão (chkExclusaoMunicipio).
- Região Comercial: Lista de regiões comerciais (tabela REGIAOCOMERCIAL vinculada a municípios). Possui opção de exclusão (chkExclusaoRegiao).
P: O que é a opção de "Exclusão" nos grids de filtro? R: Quando o checkbox de exclusão de um grid está marcado (por ex.: chkExclusaoPessoa), o filtro passa a funcionar de forma inversa: em vez de incluir apenas os registros listados no grid, o relatório exclui esses registros e traz todos os demais. Por exemplo, se você listar 3 clientes e marcar "Exclusão", o relatório mostrará as vendas de todos os clientes exceto os 3 listados.
P: Qual atalho de teclado posso usar para gerar o relatório? R: Utilize a tecla F8 para acionar a impressão/geração do relatório. Demais atalhos: F4 (Limpar linha selecionada), F5 (Novo/Limpar filtros), F12 (Sair).
Mensagens de Validação e Erros
P: Aparece "A Empresa não está Cadastrada [ADM002]!" R: O código de empresa informado não existe no cadastro. Utilize F9 para pesquisar ou verifique no módulo ADM002.
P: Aparece "O Código do Produto não está Cadastrado [TPO001]!" R: O produto informado no grid de Itens não existe na tabela ITEM. Verifique no módulo TPO001 ou utilize F9.
P: Aparece "A Data Inicial não pode ser Maior que a Data Final!" R: O intervalo de datas de emissão está com a data inicial superior à final. Corrija o período informado.
P: Aparece "A Data Final não pode ser Menor que a Data Inicial!" R: Similar ao anterior. A data final está anterior à data inicial no filtro de período.
P: Aparece "A Pessoa Física / Jurídica não está Cadastrada [TFA001]!" R: O código de cliente no grid de Pessoas não existe no cadastro. Consulte o módulo TFA001 ou utilize F9.
P: Aparece "O Vendedor não está Cadastrado [TFA007]!" R: O código de vendedor informado não existe no cadastro de vendedores. Consulte o módulo TFA007 ou utilize F9.
P: Aparece "O Código do SubGrupo não está Cadastrado [TPO007]!" R: O subgrupo informado no grid não existe. Consulte o módulo TPO007 (Cadastro de Subgrupos).
P: Aparece "O Código do Grupo não está Cadastrado [TPO006]!" R: O grupo informado no grid não existe. Consulte o módulo TPO006 (Cadastro de Grupos).
P: Aparece "O Município não está Cadastrado [TFA003]!" R: O município informado no grid não existe na tabela MUNICIPIO. Consulte o módulo TFA003 ou utilize F9.
P: Aparece "Região Comercial Não Cadastrada!! Verifique [TFA014]" R: O código de região comercial informado não existe na tabela REGIAOCOMERCIAL. Consulte o módulo TFA014 (Cadastro de Regiões Comerciais).
Dúvidas sobre o Funcionamento
P: Como o relatório apresenta até 20 colunas variáveis? R: A VIEW_RNF040 do banco de dados realiza uma pivotagem dos dados, distribuindo os valores de venda por produto em até 20 colunas (O_CD_VARIAVEL1 a O_CD_VARIAVEL20, O_QT_ITEM1 a O_QT_ITEM20, O_VL_VENDA1 a O_VL_VENDA20). Cada coluna representa uma variável (vendedor, município ou cliente), e o sistema exibe apenas as colunas com dados. Se existirem mais de 20 variáveis para o período, as excedentes não serão exibidas.
P: Qual é a diferença entre os layouts V, M e C? R: Todos utilizam a mesma VIEW_RNF040, mas com parâmetro diferente:
- V: Agrupa por vendedor; cada coluna representa um vendedor e suas vendas por produto.
- M: Agrupa por município de destino; cada coluna representa um município.
- C: Agrupa por cliente; cada coluna representa um cliente e seu histórico de compras por produto.
Os layouts de impressão correspondentes são RNF040_V, RNF040_M e RNF040_C.
P: Para que serve o filtro de "Região Comercial"? R: A Região Comercial agrupa municípios em áreas geográficas comerciais (ex.: Região Norte, Região Sul). Ao filtrar por região, o relatório inclui (ou exclui, com o checkbox) todos os municípios pertencentes à região selecionada, facilitando análises por área de atuação dos vendedores.
P: O filtro "Financeiro" afeta o que no relatório? R: O filtro Financeiro utiliza o campo CD_TIPOCONTA da tabela de movimentação (via alias "A"): "Com contas" inclui apenas notas ligadas a movimentações com tipo de conta financeira cadastrado; "Sem contas" inclui apenas notas sem conta financeira. "Todas" não aplica restrição.
P: Por que o relatório pode não exibir todos os produtos esperados? R: Os possíveis motivos são: filtros de produto, grupo, subgrupo ou exclusão de produto restringindo o resultado; status de nota incorreto (se marcou "Apenas Válidas" mas as notas estão canceladas); período de emissão não abrangendo as datas das notas; ou a VIEW_RNF040 não retornando dados porque não há vendas no período para os critérios informados.
Mensagens exibidas
Levantadas de source/RNF040/ pela camada 0 (commit 96fc51e236).
Mais 11 mensagens com texto literal no código: RNF040.
Tabelas de Escrita (INSERT/UPDATE/DELETE)
| Tabela | Operacoes |
|---|---|
| EMPRESA | DELETE, INSERT, SELECT, UPDATE |
| GRUPO | DELETE, INSERT, SELECT, UPDATE |
| ITEM | DELETE, INSERT, SELECT, UPDATE |
| MUNICIPIO | DELETE, INSERT, SELECT, UPDATE |
| PESSOA | DELETE, INSERT, SELECT, UPDATE |
Tabelas de Leitura (SELECT)
| Tabela | Operacoes |
|---|---|
| MUNICIPIOREGIAOCOMERCIAL | SELECT |
| REGIAOCOMERCIAL | SELECT |
| SUBGRUPO | SELECT |
Procedures Chamadas
| Procedure | Tabelas Acessadas |
|---|---|
| VIEW_RNF040 | ENDERECOPESSOA (SELECT), ITEM (SELECT), ITEMNOTA (SELECT), MOVIMENTACAO (SELECT), MUNICIPIO (SELECT), NOTA (SELECT) +3 |
Tabelas via Procedures (acesso indireto)
| Tabela | Operacoes |
|---|---|
| ENDERECOPESSOA | SELECT |
| ITEM | SELECT |
| ITEMNOTA | SELECT |
| MOVIMENTACAO | SELECT |
| MUNICIPIO | SELECT |
| NOTA | SELECT |
| PESSOA | SELECT |
| TIPOCALCULO | SELECT |
| VENDEDOR | SELECT |