Histórico da Página

...

02. SITUAÇÃO/REQUISITO

No O Monitor PDV Monitor, não havia possuía tela dedicada para consulta e acompanhamento do histórico de movimentações de licenças PDV. Os registros de movimentações — inserções, remoções e transferências de licenças entre lojas — e PDVs ficavam armazenados na tabela tb_licmovpdv, no banco sem interface de consulta disponível acesso para o usuário final.

A ausência dessa funcionalidade impedia o acompanhamento do ciclo de vida das licenças PDV, dificultando a identificação de operações com status pendente, que podem indicar falhas no processo de liberação, remoção ou transferência de licenças entre pdvs.

A demanda surgiu da necessidade de oferecer visibilidade operacional sobre essas movimentações, permitindo que o usuário identifique ocorrências pendentes, consulte o histórico por loja, PDV, usuário responsável e tipo de operação, além de acompanhar em tempo real o processamento das movimentações em andamentoSem essa tela, não era possível acompanhar o andamento das movimentações, identificar operações com falha ou verificar quem realizou cada operação.

03. PRÉ-REQUISITOS

...

• Permissão de acesso ao Monitor PDV e à página de Histórico de movimentações habilitada para o usuário

• Versão mínima do Monitor PDV: 26.03.001

...

Nota
Alterações ou parametrizações incorretas podem comprometer o desempenho e causar falhas no sistema. Sempre que necessário, consulte um especialista ou a equipe responsável para garantir a configuração correta.

04. SOLUÇÃO

...

...

Tela

...

Banco de Dados

Foi criada a view Oracle vw_m_historicomovlicenca, que consolida os dados de movimentações de licenças PDV a partir das tabelas tb_licmovpdv, tb_licmovdespdv, tb_usuario e tb_licpacote, utilizando outer joins para preservar registros sem usuário, sem pacote associado ou sem destino de movimentação.

A view expõe as seguintes informações:

O script de implantação DSUPPDVCURIE-2059.pdc realiza o registro do controle na tabela tb_controle (sequencial 500141) e a criação da view.

Regras de Negócio

Tipos de operação:

• I — Inserção: associação de nova licença ao PDV
• D — Remoção: desassociação de licença do PDV
• M (demais) — Movimentação: transferência de licença entre PDVs

Status de processamento:

• P — Pendente: operação aguardando processamento
• F — Finalizado: operação concluída com sucesso
• Demais — Falha na operação: ocorreu erro durante o processamento

Campos de destino (nroEmpresaDest, nroCheckoutDest) são preenchidos exclusivamente em operações do tipo Movimentação, identificando o PDV receptor da licença transferida.

API

Foi disponibilizado o endpoint GET /api/v1/HistoricoMovimentacoes, com suporte a paginação e aos seguintes parâmetros de filtro:

O resultado é ordenado pela data de inclusão em ordem decrescente.

Tela

Foi implementada a tela Histórico de Movimentações no módulo de Licenciamento do PDV Monitor, acessível pelo caminho Licenciamento > Histórico de Movimentações.

A tela disponibiliza:

• Filtros de consulta: número da loja, número do PDV, código do usuário, apelido do usuário, data de inclusão e tipo de operação
• Listagem paginada com carregamento incremental ("Mostrar mais registros")
• Colunas exibidas: Número loja, Número PDV, Tipo licença, Operação, Status, Retorno, Usuário, Data emissão, Loja destino, PDV destino
• Seletor de operação com as opções: [Todos], Inserção, Remoção, Movimentação
• Indicador de data e hora da última atualização da listagem

Atualização Automática

A tela possui mecanismo de atualização automática configurável pelo usuário. Quando ativado, a listagem é recarregada automaticamente nos seguintes intervalos:

...

A tela Histórico de Movimentações foi implementada no módulo de Licenciamento e é o ponto central da funcionalidade. Por meio dela, o usuário pode consultar todo o histórico de operações sobre licenças PDV, aplicar filtros combinados por loja, PDV, usuário, data e tipo de operação, e identificar rapidamente movimentações com falha ou pendentes de processamento.

Caminho de acesso: Licenciamento > Histórico de movimentações

Image Added

Imagem 1 - Tela de histórico de movimentações

Informações
Para acompanhar movimentações em andamento, ative o toggle Atualizar registros automaticamente. Quando há registros com status Pendente, o sistema reduz o intervalo de atualização para 10 segundos. Sem pendências, o intervalo é de 60 segundos.

Image Added

Imagem 2 - Atualização automática

...

05. REQUISITOS DE VERSÃO

Se estiver na versão 26.0104, atualize para o service pack 26.0104.001 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA

• Histórico de movimentações de licençasLink do Documento de Referência da rotina mencionada.
  

  OUTROS DOCUMENTOS TÉCNICOS

• Não há