DT Ajustes de log na MRL_FiltroVerbaSemAcordo

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Durante o processo de geração de acordos na tela de Apuração de Verba sem Acordo Promocional, foi identificado que o log de filtros gravado na tabela MRL_FiltroVerbaSemAcordo apresentava duas inconsistências:

1. Campos ausentes: os filtros MARCA e SEGMENTO não eram registrados, deixando o log incompleto e prejudicando a rastreabilidade das informações utilizadas na geração do acordo.
   
   
2. Divergência de valores: o log era gravado com base nos valores exibidos em tela no momento do clique no botão Gerar Acordo Promocional, e não exatamente nos filtros utilizados na busca. Assim, caso o usuário alterasse algum campo após a pesquisa, mas antes de gerar o acordo, os dados registrados no log ficavam incoerentes em relação à consulta que originou os registros exibidos.
   
   

Essa situação gerava inconsistências de auditoria e dificultava a conferência das condições que originaram cada acordo.

03. PRÉ-REQUISITOS

Realizar o cadastro de uma verba de bonificação sem acordo promocional

Caminho: Módulo Acordos e Verbas > Administração > Verba Bonificação

Imagem 1 - Verbas de Bonificação

Realizar vendas para consumir a verba

04. SOLUÇÃO

Para corrigir o problema, foram realizadas as seguintes alterações:

• Aplicação (VerbaSemAcordoPromocional.app)
  
  
• O botão pbtGeraAcordoPromoc foi ajustado para chamar a nova função fInsereVerbaSemAcordo.
  
  
• A função fInsereFiltrosGeracaoAcordo, que antes inseria os filtros diretamente em MRL_FILTROVERBASEMACORDO, passou a salvar os filtros em uma tabela temporária.
  
  
• A nova função fInsereVerbaSemAcordo foi criada para transferir os filtros salvos na tabela temporária para a procedure pkg_Mrl_VerbaSellOutApuracao.
  
  

Com isso, o log de filtros passa a ser registrado de forma completa e coerente, refletindo exatamente os critérios de busca utilizados pelo usuário no momento da geração do acordo.

Passo a passo:

1. Acesse a tela Verba Sem Acordo Promocional.
   
   
2. Informe um Período de vigência (exemplo: 29/08/2020 a 29/08/2026).
   
   
3. Informe os filtros desejados, todos informados serão gravados na Mrl_VerbaSellOutApuracaoLogExec.
4. Marque a opção “Exibir apenas produtos que tiveram vendas não apuradas”.
   
   
5. Clique no botão de Busca e selecione verbas não apuradas.
   
   
6. Após realizar uma busca, alterar algum campo de filtro sem clicar em Buscar novamente.
   
   
7. Clique no botão Gerar Acordo Promocional. 

Evidências:

Imagem 2 - Verbas de Bonificação Sem Acordo Promocional

Exemplo da estrutura de log gerada na Mrl_VerbaSellOutApuracaoLogExec:

Sequência do Log: Número de identificação único para este registro.

Usuário da Execução:  Nome do usuário do sistema que disparou a apuração.

Data/Hora da Execução:  O momento exato (dia e hora) em que a apuração foi executada.

Origem da Aplicação: Número identificador do processo de origem. 

Agrupar por Fornecedor: Indica se a apuração foi configurada para agrupar os resultados por fornecedor (‘S’ para Sim, ‘N’ para Não).

Empresa: O número da empresa para a qual a apuração foi executada.

Fornecedor: Código sequencial do fornecedor que foi incluído no filtro da apuração.

Comprador: Código sequencial do comprador que foi incluído no filtro da apuração.

Parâmetro Período Apuração: Parâmetro que define o período automático de apuração.

Parâmetro Apuração Parcial: Indicador referente ao parâmetro dinâmico APUR_VERBA_PARC do grupo VERBA_SEM_ACORDO.

Data Inicial: A data de início do período que foi apurado.

Data Final: A data de fim do período que foi apurado.

ID da Sessão: O identificador da sessão de banco de dados que executou o processo.

ID da Instância: O identificador da instância do banco de dados.

Usuário da Máquina: O nome do usuário de rede (máquina) que solicitou a execução.

Terminal: O nome do computador (terminal) que solicitou a execução.

Módulo: O módulo do sistema que originou a chamada.

Endereço IP: O endereço IP da máquina que solicitou a apuração.

Lote do Processo: O número do lote de processo ao qual esta execução de log pertence.

Observação: Um campo de texto livre para observações sobre a execução.

Mensagem de Exceção: Armazena qualquer mensagem de erro que tenha ocorrido durante o processo.

Produto: O código sequencial do produto incluído no filtro da apuração.

Família: O código sequencial da família incluída no filtro da apuração.

Indicador de Identificação: Indica o tipo de identificação usada no filtro.

Identificação: Descrição da identificação utilizada.

Apenas Produtos com Venda: Indica se a apuração considerou apenas produtos com venda (‘S’ para Sim, ‘N’ para Não).

Tipo de Acordo: O código do tipo de acordo utilizado na geração.

Tipo de Acordo (Acréscimo): O código do tipo de acordo de acréscimo, se aplicável.

Agrupar Valor por Família: Indica se os valores do acordo foram agrupados por família (‘S’ para Sim, ‘N’ para Não).

Marca: Código sequencial da marca incluída no filtro da apuração.

Segmento: O número do segmento comercial incluído no filtro da apuração.

Parâmetro Data Base Geração: Indicador referente ao parâmetro dinâmico DATA_BASE_GERACAO_ACORDO do grupo VERBA_SEM_ACORDO.

Parâmetro Prazo Venc. Fornecedor: Indicador referente ao parâmetro dinâmico UTIL_PRAZO_VENC_FORNECEDOR do grupo VERBA_SEM_ACORDO.

Parâmetro Tipo Verba Diferenciado: Indicador referente ao parâmetro dinâmico DIF_TIPO_VERBA_ACO do grupo VERBA_SEM_ACORDO.

Parâmetro Enviar Dados do Produto: Indicador referente ao parâmetro dinâmico ENV_DADOS_PROD_ANOT_TIT do grupo VERBA_SEM_ACORDO.

05. REQUISITOS DE VERSÃO

Se estiver na versão 25.01, atualizar o sistema para o service pack 25.01.043 ou superior.

Se estiver na versão 25.07, atualizar o sistema para o service pack 25.07.018 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA

• Clique aqui e veja mais sobre a Verba sem Acordo Promocional - MAC0046.
• Clique aqui e veja mais sobre a Verba Bonificação - MAX0302.
  

  OUTROS DOCUMENTOS TÉCNICOS

• Não há