Consulta de Estoque e a aba Retroativo

A tela de Estoque mostra o que está no armazém em cinco visões: Por lote, Por lote cliente, Por produto, Por Endereço e Retroativo. As quatro primeiras respondem 'o que existe hoje'. A Retroativo é diferente: ela reconstrói o estoque em uma data e hora que já passaram — é a aba que responde 'quanto desse cliente estava aqui no dia 30, às 18h'.

1. Onde fica a consulta de estoque

Existem duas portas para a mesma consulta. Em Gestão do Estoque > Estoque as cinco visões aparecem como abas, uma ao lado da outra. Em WMS > Estoque a tela é a mesma, mas as visões ficam no botão 'Visão:' no topo, e os filtros e a barra de ações só aparecem quando você clica em 'Filtros' e em 'Ações'.

A aba Retroativo completa só existe em Gestão do Estoque > Estoque: é lá que ficam o alternador 'Por lote / Por produto/cliente' e a trava que exige o cliente. Na tela WMS > Estoque o Retroativo existe, mas só na visão por lote.

2. O que a aba Retroativo responde

O Retroativo não refaz movimento por movimento. Ele olha cada lote e pergunta duas coisas: esse lote já tinha entrado até a data e hora que você pediu? E ele ainda não tinha saído naquele instante? Se as duas respostas forem sim, o lote entra no resultado.

Por isso o resultado inclui lote que hoje não existe mais. Um lote que saiu ontem aparece normalmente numa consulta de anteontem, com a coluna Data Saída preenchida — é o comportamento certo.

Lote que foi substituído (remontagem de UA, troca de pallet) conta uma vez só: o lote novo só aparece quando o lote que o originou já tinha saído naquele instante.

3. Preencher a data e hora de referência

1. 1

   **Abrir a aba** — Gestão do Estoque > Estoque > aba Retroativo.

2. 2

   **Data/hora de referência** — No campo 'Data/hora de referência', digite dia, mês, ano e hora (DD/MM/AAAA HH:mm). O campo nasce vazio.

3. 3

   **Pesquisar** — Depois de escolher o cliente, clique em Pesquisar. Enter dentro do campo de busca também dispara a consulta.

4. O cliente é obrigatório

Sem nenhum cliente marcado no seletor 'Clientes', a tela recusa a consulta e mostra o aviso: 'Selecione ao menos um cliente para consultar o estoque retroativo.'

Não é burocracia. A consulta retroativa percorre o histórico de lotes; sem o corte por cliente ela varre a base inteira e estoura o tempo antes de devolver qualquer coisa. Com o cliente marcado, a mesma consulta usa o índice e responde.

Dá para marcar vários clientes de uma vez. O seletor só lista quem está cadastrado como cliente e habilitado para o WMS.

5. As duas visões: Por lote e Por produto/cliente

'Por lote' é a visão detalhada: uma linha por lote, com UA, endereço, nota fiscal, fabricação, validade, bloqueio e situação. É a visão para investigar um caso.

'Por produto/cliente' soma tudo: uma linha por produto e cliente, com quantidade, peso líquido, peso bruto e volume. É a visão para conferir saldo com o cliente, porque não tem o barulho do lote.

Trocar de visão mantém os filtros (cliente, data, busca), mas limpa a grade de propósito e não busca sozinho — as colunas mudam. Clique em Pesquisar de novo.

6. Ler as cores e o menu da linha (visão Por lote)

A cor da linha é atalho de leitura: vermelho é lote bloqueado; laranja é lote com status 'ITEM SEM COBERTURA' ou situação 'SEM ORIGEM'. O ícone de alerta no fim da linha repete o aviso de bloqueio.

O menu de cada linha abre quatro consultas: Bloqueios, Logs, Pedidos conferidos e Rastreabilidade. Logs é onde aparece o histórico de alterações daquele lote, inclusive as manutenções.

1. 1

   **Marcar linhas** — Use a caixa de seleção. Com pelo menos uma marcada, o cabeçalho da grade troca os botões.

2. 2

   **Escolher a ação** — Aparecem Manutenção (só com a permissão MANUTENCAO ESTOQUE), Imprimir, Bloqueio e Área de Picking.

7. Totais e exportação

O rodapé mostra os totalizadores das colunas numéricas da visão, calculados sobre todas as linhas trazidas — não só sobre a página que está na tela.

No cabeçalho da grade estão o Excel ('Exportar para Excel'), o PDF ('Gerar Relatório'), 'Configurar visão' e 'Configurar Relatórios'.

Parâmetros que mudam esta tela

Perguntas frequentes

**Cliquei em Pesquisar e a grade ficou vazia, sem mensagem nenhuma.** Falta data válida. O aviso de cliente aparece em uma caixa; o de data não existe — a consulta simplesmente não roda. Preencha DD/MM/AAAA HH:mm e tente de novo.

**Posso consultar o retroativo sem escolher cliente?** Na tela Gestão do Estoque > Estoque, não: a tela recusa. Na tela WMS > Estoque não existe a trava, mas consultar sem cliente varre a base inteira e costuma estourar o tempo. Marque o cliente nas duas.

**O retroativo de hoje bate com a aba Por lote?** Bate quando a hora de referência é posterior ao último movimento do dia. Se você pedir 08:00 de hoje, tudo que saiu depois das 08:00 ainda conta como estoque — e a diferença é justamente o que saiu.

**Apareceu um lote com Data Saída preenchida. Está errado?** Não. Ele saiu depois da data consultada, então naquele instante ele estava no armazém. A coluna Data Saída é a prova de que a saída veio depois.

**Por que a visão Por produto/cliente não deixa marcar linha?** Porque cada linha é a soma de vários lotes. Para agir em um lote específico, volte para a visão Por lote.

**Troquei de visão e perdi o resultado.** É proposital: o conjunto de colunas muda. Os filtros continuam preenchidos — é só clicar em Pesquisar.

Telas relacionadas

**Estoque (Gestão do Estoque)** (/apes-local/stock/store/grid) — Tela com as abas e a aba Retroativo completa

**Estoque (WMS)** (/apes-local/wms/estoque/grid) — Mesma consulta, com seletor de Visão no topo

**Movimentação** (/apes-local/stock/movimentation/grid) — Entradas e saídas que explicam a diferença entre duas datas

**Estoque por Nota Fiscal** (/apes-local/wms/estoque-nota-fiscal) — Saldo agrupado por nota de entrada