Histórico da Página
...
| 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) : |
|
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
...
.
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.
...
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. |
...
Imagem 1 - Tela de histórico de movimentações
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).
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
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 A tela possui mecanismo de atualização automática configurável pelo usuário. Quando ativado, a listagem é recarregada automaticamente nos seguintes intervalos:
- 60 segundos — quando não há sem registros com status Pendente na listagem atual
- 10 segundos — quando há com ao menos um registro com status Pendente , (para acompanhamento em tempo real do processamento)
05. REQUISITOS DE VERSÃO
Se estiver na versão 26.01, atualize para o service pack 26.0103.001 ou superior.
06. DOCUMENTOS RELACIONADOS
DOCUMENTO(S) DE REFERÊNCIA
- Histórico de movimentaçõesLink do Documento de Referência da rotina mencionada.
OUTROS DOCUMENTOS TÉCNICOS
- Não há
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas