Histórico da Página
...
| Produto: |
| ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Linha de Produto: |
| ||||||||||||
| Segmento: |
| ||||||||||||
| Tipo de Documento: | Inovação | ||||||||||||
| Módulo: | Monitor de PDVsPDV | ||||||||||||
| 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) : |
|
02. SITUAÇÃO/REQUISITO
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.
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:
| 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.
Regras de Negócio
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 PDVs
Status de processamento:
P— Pendente: operação aguardando processamentoF— 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:
| 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.
Tela
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.
Atualização Automática
Quando o toggle Atualizar automaticamente está ativo, a listagem é recarregada nos 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
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. |
Imagem 2 - Atualização automática
...
05. REQUISITOS DE VERSÃO
Se estiver na versão 26.0104, atualize para o service pack 26.0304.001 ou superior.
06. DOCUMENTOS RELACIONADOS
DOCUMENTO(S) DE REFERÊNCIA
- Histórico de movimentações de licenças
OUTROS DOCUMENTOS TÉCNICOS
- Não há
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas