Exibir origem

01. DADOS GERAIS

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

No PDV Monitor, não havia 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 — ficavam armazenados na tabela tb_licmovpdv, sem interface de consulta disponível 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 andamento.

03. PRÉ-REQUISITOS

Execução do script Scripts/26.01.001/DSUPPDVCURIE-2059.pdc na base Oracle do PDV Monitor, conectado com o usuário consincomonitor, via Command Window do PL/SQL Developer
Existência das tabelas: tb_licmovpdv, tb_licmovdespdv, tb_usuario, tb_licpacote
Permissão de acesso ao controle PDVM500141 para os usuários que utilizarão a funcionalidade

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

TOTVS Varejo Supermercados PDV > DT Implementação de Histórico de Movimentações de Licenças PDV > image-2026-2-20_9-35-28.png

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 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:

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 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:

60 segundos — quando não há registros com status Pendente na listagem atual
10 segundos — quando há 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.01.001 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA

Link do Documento de Referência da rotina mencionada.
Link de Documentos de Referência adicionais que se relacionam com a rotina.
OUTROS DOCUMENTOS TÉCNICOS
Link de DTs que compartilham conteúdo ou processos com a rotina abordada.