Inovação
| Produto: | |
|---|---|
| Linha de Produto: | |
| Segmento: | |
| Tipo de Documento: | Inovação |
| Módulo: | Monitor de PDVs |
| Caminho: | Licenciamento > Histórico de movimentações |
| Função: | Histórico de movimentações de licenças |
| País: | Brasil |
| Ticket: | |
| Requisito/Story/Issue (informe o requisito relacionado) : |
O Monitor PDV não possuía tela para consulta do histórico de movimentações de licenças PDV. Os registros de inserções, remoções e transferências entre lojas e PDVs ficavam armazenados no banco sem interface de acesso para o usuário.
Sem 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.
Permissão de acesso ao Monitor PDV e à página de Histórico de movimentações habilitada para o usuário
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. |
Imagem 1 - Tela de histórico de movimentações
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:
| Coluna | Descrição |
|---|---|
seqlicmovpdv | Identificador da movimentação |
nroempresa | Número da loja de origem |
nrocheckout | Número do PDV de origem |
seqpacote | Identificador do pacote de licença |
descricao | Descrição do tipo de licença |
operacao | Código da operação (I, D, M) |
operacaosdesc | Descrição da operação (Inserção, Remoção, Movimentação) |
status | Código do status (P, F, outros) |
statusdesc | Descrição do status (Pendente, Finalizado, Falha na operação) |
retorno | Mensagem de retorno do processamento |
sequsuario | Identificador do usuário responsável |
apelido | Apelido do usuário responsável |
dtastatus | Data e hora da última atualização de status |
dtainclusao | Data e hora de inclusão da movimentação |
seqlicmovpdvdest | Identificador da movimentação de destino |
nroempresadest | Número da loja de destino |
nrocheckoutdest | Número do PDV de destino |
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.
Tipos de operação:
I — Inserção: associação de nova licença ao PDVD — Remoção: desassociação de licença do PDVM (demais) — Movimentação: transferência de licença entre PDVsStatus de processamento:
P — Pendente: operação aguardando processamentoF — Finalizado: operação concluída com sucessoCampos de destino (nroEmpresaDest, nroCheckoutDest) são preenchidos exclusivamente em operações do tipo Movimentação, identificando o PDV receptor da licença transferida.
Foi disponibilizado o endpoint GET /api/v1/HistoricoMovimentacoes, com suporte a paginação e aos seguintes parâmetros de filtro:
| Parâmetro | Tipo | Descrição |
|---|---|---|
nroEmpresa | Inteiro | Número da loja |
nroCheckout | Inteiro | Número do PDV |
seqUsuario | Inteiro | Código do usuário responsável |
apelido | Texto | Apelido do usuário (pesquisa parcial) |
dtaInclusao | Data | Data de inclusão (filtra o dia completo) |
operacao | Texto | Tipo de operação (I, D ou M) |
O resultado é ordenado pela data de inclusão em ordem decrescente.
Foi implementada a tela Histórico de movimentações no módulo de Licenciamento (Licenciamento > Histórico de Movimentações).
Filtros disponíveis:
| Filtro | Tipo | Comportamento |
|---|---|---|
| Loja | Multiselect | Permite selecionar uma ou mais lojas |
| PDV | Multiselect | Permite selecionar um ou mais PDVs |
| Usuário | Lookup com seleção múltipla | Pesquisa e seleciona um ou mais usuários |
| Data de inclusão | Campo de data | Filtra pelo dia informado |
| Operação | Seletor | [Todos], Inserção, Remoção, Movimentação |
| Atualizar automaticamente | Toggle | Ativa/desativa o recarregamento automático |
Colunas da listagem:
| Coluna | Descrição |
|---|---|
| Loja | Número da loja de origem |
| PDV | Número do PDV de origem |
| Tipo licença | Descrição do tipo de licença |
| Operação | Inserção, Remoção ou Movimentação |
| Status | Pendente, Finalizado ou Falha na operação |
| Retorno | Mensagem do processamento |
| Usuário | Apelido do usuário responsável |
| Data emissão | Data e hora de inclusão |
| Loja destino | Loja receptora (somente em Movimentação) |
| PDV destino | PDV receptor (somente em Movimentação) |
A listagem é paginada com opção de carregar mais registros. O botão Limpar todos os campos redefine todos os filtros, incluindo multiselects e lookup de usuário.
Quando o toggle Atualizar automaticamente está ativo, a listagem é recarregada nos intervalos:
Se estiver na versão 26.01, atualize para o service pack 26.03.001 ou superior.