Consulta de Estoque

A Consulta de Estoque oferece visão abrangente do estoque (incluindo identificação de itens com estoque crítico, sem saldo ou próximos do vencimento), enquanto o Kardex apresenta o registro detalhado (tipo “cardex”) das movimentações de entrada e saída de produtos ao longo do tempo.

1. Acessando a tela de Consulta de Estoque 

Para acessar a tela, entre no sistema BomControle com um usuário que possua permissão no módulo de Estoque. Em seguida, siga os passos abaixo:

• Consulta de Estoque: No menu superior, navegue até Estoque → Dia a Dia → Consulta de Estoque. A tela de pesquisa será exibida, listando movimentações e saldos conforme os filtros padrão.

2. Tela de Consulta de Estoque

2.1 Visão geral da tela

A figura a seguir apresenta o layout da tela Consulta de Estoque. Esses campos serão referenciados nas seções subsequentes, onde explicamos as regras de preenchimento e a origem das informações mostradas:

Figura 1: Layout da tela de Consulta de Estoque 

2.2 Detalhamento dos Filtros(Consulta de Estoque)

Tipo de Data da Pesquisa (Movimentação/Vencimento): Este seletor define como o filtro de datas será interpretado. Por padrão, vem selecionado “Movimentação”, indicando que o período escolhido (campo 2) refere-se às datas das movimentações de estoque. Alternativamente, ao escolher “Vencimento”, o período passará a filtrar pela data de vencimento dos lotes dos produtos.
- Regras: Obrigatório selecionar uma das opções. Muda o critério de busca sem necessitar sair da tela.
- Funcionamento: Em Movimentação, o sistema trará as entradas/saídas ocorridas entre as datas selecionadas. Em Vencimento, o sistema listará os produtos/lotes cujo vencimento esteja dentro do intervalo escolhido (mostrando o estoque atual desses lotes). Observação: No modo Vencimento, a coluna Data (11) continuará exibindo a data da última movimentação conhecida do item; a data de validade em si aparece no campo Lote (14) abaixo do número do lote. Assim, um item pode ser listado por ter vencimento próximo, mesmo que sua última movimentação seja antiga.

Período (Intervalo de datas): Define a data inicial e final para a consulta. Pode ser usado para restringir o horizonte de movimentações ou vencimentos exibidos. Por exemplo, no modo Movimentação, pode-se consultar o último mês de movimentações; no modo Vencimento, verificar lotes que vencem nos próximos 30 dias.
- Regras: Obrigatório informar um intervalo. Por padrão, ao abrir a tela, o sistema já propõe um período (ex.: últimos 30 dias até a data atual) como referência inicial.
- Preenchimento: Clique no campo de data para abrir o seletor de intervalo; escolha a data inicial e final desejadas. Há um ícone de calendário que facilita a seleção.
- Comportamento: Ao aplicar um novo intervalo, no modo Movimentação a lista é automaticamente atualizada assim que o intervalo é selecionado (não é necessário clicar em “Aplicar” apenas para mudar a data). No modo Vencimento, o comportamento é similar – ao selecionar o período de vencimento desejado e confirmar, o sistema refaz a busca automaticamente. O intervalo de datas influencia diretamente quais registros aparecerão no grid:
- Em Movimentação: somente movimentações ocorridas entre a data inicial e final serão listadas. Se um produto não teve movimentações no período escolhido, ele não aparecerá na listagem (mesmo que ainda possua saldo em estoque anterior).
- Em Vencimento: serão listados produtos/lotes cuja data de validade esteja entre a data inicial e final escolhidas, juntamente com suas informações de saldo atual. (Para verificar produtos sem movimentação recente mas com lote a vencer, utilize o modo Vencimento.)

Produto: Permite filtrar a consulta para um produto específico. Ao começar a digitar, o sistema apresenta opções de produtos cadastrados (nome ou código).
- Regras: Opcional – se nenhum produto for selecionado, a consulta considera todos os produtos (respeitando os demais filtros).
- Utilização: Selecione um produto para visualizar apenas as movimentações/saldos daquele item. Isso é útil para analisar detalhadamente um único produto no período. Ao escolher um produto, filtros relacionados (como Lote) podem exibir apenas opções correspondentes a esse produto. Por exemplo, ao selecionar um produto, o filtro Lote  trará somente lotes daquele produto.
- Origem dos dados: A lista de produtos é carregada do cadastro de produtos do sistema (inclui todos os produtos ativos cadastrados na empresa/grupo que o usuário tem acesso).

Estoque (Local de estoque): Filtro para selecionar um estoque ou depósito específico onde o produto está armazenado.
- Regras: Opcional – caso não selecionado, considera movimentações em todos os estoques.
- Utilização: Ao clicar, são listados os nomes dos estoques (almoxarifados, filiais, etc.) cadastrados. Escolher um estoque limitará a busca para movimentações ocorridas somente naquele local. Por exemplo, é possível filtrar o histórico apenas do “Estoque Matriz” ou “Depósito 2”.
- Origem dos dados: Os estoques disponíveis correspondem aos cadastros de locais de estoque na empresa (configurados no módulo de Estoque). Somente estoques ativos e vinculados às empresas selecionadas (7) serão listados.

Lote: Permite filtrar por um lote específico de produto.
- Regras: Opcional – sem lote selecionado, inclui todos os lotes. Só se aplica a produtos controlados por lote.
- Utilização: Ao selecionar um produto (3), este campo exibe os lotes existentes daquele produto (que já tiveram movimentação). Selecione o código/identificação de um lote para restringir a busca às movimentações desse lote apenas. Caso nenhum produto tenha sido escolhido, será necessário digitar/selecionar manualmente o lote desejado (o sistema buscará no universo de lotes registrados, mas é recomendável escolher o produto primeiro para facilitar).
- Origem dos dados: Os lotes são obtidos a partir das movimentações e cadastros de lotes do produto no sistema. Cada lote possui uma identificação e, quando aplicável, uma data de validade associada (mostrada no grid).

Status: Filtro de situação do estoque com relação a parâmetros mínimos/críticos. As opções são: Mínimo, Sem estoque e Crítico.
- Regras: Opcional – se não selecionado, não aplica filtro de status (lista todos os itens independentemente do nível de estoque).
- Definições:
- Mínimo: produtos cujo saldo atual está no mínimo ou abaixo do estoque mínimo definido para eles.
- Sem estoque: produtos com saldo zero (0) em estoque (ou negativo, caso haja possibilidade de saldo negativo, indicando ausência total do item).
- Crítico: produtos cujo saldo está no nível crítico ou abaixo do estoque crítico definido.
- Utilização: Escolha um desses status para listar somente produtos nessa condição. Por exemplo, selecionar “Crítico” exibirá apenas os itens com quantidade em estoque muito baixa (<= crítico).
- Origem dos dados: Os valores de estoque mínimo e crítico de cada produto são definidos no cadastro de produtos. O sistema calcula o status comparando o saldo em estoque (resultado das movimentações) com esses parâmetros no momento da consulta.

Empresa: Este filtro aparece apenas se o usuário possui acesso a mais de uma empresa no sistema. Permite selecionar uma ou múltiplas empresas cujos estoques deseja consultar simultaneamente.
- Regras: Opcional – se nenhuma empresa for selecionada manualmente, o sistema considera uma empresa padrão (geralmente a empresa atualmente ativa na sessão ou todas as empresas acessíveis, conforme configuração padrão do filtro). É possível marcar mais de uma empresa para consolidar os dados.
- Utilização: Marque as empresas cujos dados de estoque deseja incluir na busca. Por exemplo, um usuário de nível corporativo pode selecionar 2 empresas diferentes para ver o estoque consolidado de ambas no grid.
- Origem dos dados: A lista exibe as empresas que o usuário tem permissão de acessar. Ao aplicar o filtro, o sistema busca as movimentações de estoque nos registros vinculados a essas empresas.

Aplicar (botão Filtrar): Após definir os filtros desejados, clique em Aplicar para executar a busca e atualizar o grid de resultados.
- Regras: Fica habilitado somente quando algum filtro foi alterado (produto, estoque, lote, status ou empresa). Se nenhum critério for modificado (além do período, que atualiza automaticamente), o botão permanece desabilitado indicando que os dados exibidos já correspondem aos filtros atuais.
- Função: Ao clicar, o sistema carregará os dados do estoque conforme os parâmetros informados. Isso inclui consultar todas as movimentações de entrada e saída registradas que atendam aos filtros e calcular os saldos, custos médios e valores correspondentes para exibir nas colunas.
- Comportamento adicional: Depois de clicar em Aplicar, o botão Recarregar (9) será habilitado e o Aplicar fica desabilitado novamente até que se mude algum filtro.

Recarregar (botão Atualizar): Realiza a consulta com os mesmos filtros atuais, trazendo dados atualizados do estoque.
- Disponibilidade: Fica habilitado quando os filtros estão aplicados (nenhuma mudança pendente). Se você alterar algum filtro, o Recarregar é temporariamente desativado até clicar em Aplicar.
- Uso típico: Utilize este botão para atualizar a listagem após alguma alteração externa (por exemplo, entradas/saídas realizadas em outra tela enquanto a consulta permanece aberta) ou em consultas prolongadas, para garantir que os números reflitam o momento mais atual. Ele refaz a busca no servidor com os mesmos critérios, sem que seja necessário refazer os filtros.

Limpar Filtros: Restaura todos os filtros aos valores padrão iniciais da tela.
- Disponibilidade: Fica habilitado somente se houver algum filtro preenchido ou modificado pelo usuário (produto, estoque, lote, status ou empresa). Se todos esses campos estiverem em seus valores padrão/vazios, o botão permanece desativado.
- Ação ao clicar: O sistema limpa as seleções de produto, estoque, lote, status e empresa. O período de datas retorna ao padrão inicial (por exemplo, últimos 30 dias até hoje) e o tipo de data volta para Movimentação (padrão). Em seguida, é automaticamente realizada uma nova busca com esses parâmetros reiniciados, atualizando o grid para o estado inicial. Isso é útil para começar uma nova consulta do zero após ter aplicado vários filtros.

2.3 Detalhamento das colunas do grid de pesquisa (Consulta de Estoque)

A figura a seguir apresenta as colunas do grid da tela Consulta de Estoque. Os campos serão detalhados nas seções subsequentes, onde explicamos as regras de preenchimento e a origem das informações mostradas:

Figura 2: Colunas do grid de pesquisa

Coluna Data: Mostra a data referente à movimentação ou cálculo exibido naquela linha. Em modo de pesquisa por movimentação, representa a data em que ocorreu movimentação de entrada/saída no estoque. Em modo de pesquisa por vencimento de lote, esta coluna geralmente exibe a data da última movimentação daquele produto/lote (já que o critério de listagem foi a validade, a data da coluna pode não estar dentro do período de validade selecionado, servindo apenas como referência de última atividade).
- Formato: Dia/Mês/Ano (dd/MM/aaaa).
- Agrupamento por data: Se houve múltiplas movimentações no mesmo dia para o mesmo produto/estoque/lote, o sistema consolida em uma única linha por dia – ou seja, somando todas entradas e saídas daquele dia (veja colunas 15 e 16) e apresentando o saldo resultante no final do dia.

Coluna Produto: Exibe o nome do produto associado ao registro de estoque. Logo abaixo do nome, em fonte menor, aparece a unidade de medida do produto (por exemplo, UN, KG, CX), indicando em que unidade estão expressos os valores de quantidade.
- Dica visual: Se o nome do produto for muito extenso, ele é apresentado de forma abreviada com reticências, porém passando o mouse é possível ver o nome completo (tooltip). A unidade sempre é mostrada por extenso ao passar o mouse também.
- Origem dos dados: Os nomes e unidades são carregados do cadastro de produtos. A unidade exibida é a unidade de controle de estoque do produto (ex.: unidade, quilograma, litro etc.).

Coluna Estoque: Indica o nome do local de estoque (depósito/filial) onde se referem as movimentações ou saldo apresentados na linha. Por exemplo, “Estoque Central”, “Loja 2” etc. Isso permite diferenciar movimentações do mesmo produto em diferentes locais.
- Dica visual: Semelhante ao campo Produto, caso o nome do estoque seja longo ele poderá aparecer truncado, mas o nome completo pode ser visto ao passar o mouse.
- Origem dos dados: Nomes dos estoques conforme cadastrados no sistema. Cada registro de movimentação guarda a qual estoque pertence, e é essa informação que é exibida aqui.

Coluna Lote: Apresenta a identificação do lote do produto quando aplicável. Se o item possui controle de lote e o movimento/saldo refere-se a um lote específico, será mostrado seu código ou número. Caso o produto não possua lotes (ou a movimentação não especifique um lote), aparece a indicação “Sem lote”.
- Abaixo da identificação do lote, é exibida a data de vencimento daquele lote, se houver. Se o lote possui uma data de validade futura, ela aparece no formato MM/aaaa ou dd/MM/aaaa (conforme cadastrado). Se o lote já estiver vencido em relação à data atual, essa data é destacada em vermelho para chamar atenção. Se não há data de validade associada, é exibido “Sem vencimento”.
- Importância: Este campo permite acompanhar não apenas quantidades, mas também qual lote do produto está em estoque e até quando ele é válido, fundamental para gestão de validade e rastreabilidade.

Coluna Entrada: Quantidade total de produto que entrou no estoque na data em questão, no local e lote especificados. Inclui somatório de todas as entradas (notas fiscais de compra, devoluções, ajustes de entrada, transferências recebidas etc.) ocorridas naquele dia.
- Unidade: expressa na unidade de medida do produto (conforme coluna 12).
- Interpretação: Por exemplo, se no dia 05/10/2025 houve duas entradas do produto X (uma de 100 unidades e outra de 50 unidades) no mesmo estoque e lote, a coluna Entrada exibirá “150” para a data 05/10/2025 dessa combinação, consolidando o total que ingressou no estoque nesse dia.

Coluna Saída: Quantidade total de produto que saiu do estoque na data especificada, para aquele produto/estoque/lote. Abrange todas as baixas registradas no dia – vendas, consumo interno, transferências enviadas, ajustes de saída, etc.
- Unidade: também na unidade do produto.
- Interpretação: Seguindo o exemplo, se no dia 05/10/2025 houve duas saídas (por exemplo, venda de 80 unidades e ajuste de -5 unidades) do produto X no lote Y, a coluna Saída mostrará “85” naquele dia (somando todas as saídas). Saídas aumentam esse valor e reduzem o saldo.

Coluna Saldo: Indica o saldo final em estoque do produto no encerramento daquela data, considerando todas as entradas e saídas até aquele ponto. É o quantitativo disponível após processar as movimentações do dia.
- Cálculo: O saldo apresentado em cada linha geralmente corresponde ao saldo do dia anterior + Entradas do dia – Saídas do dia. Na primeira data do período consultado, o saldo considera também o que já existia de estoque antes (início do período). Em outras palavras, o sistema calcula dinamicamente o saldo sequencialmente ao longo do período selecionado.
- Valor zero ou negativo: Se o saldo for 0, significa que ao final daquele dia não havia nenhuma unidade do produto no estoque (pode indicar que tudo foi consumido/retirado). Em casos raros de saldo negativo (se o sistema permitir movimentação que deixe negativo, ou em situações de ajuste), o número negativo seria exibido, indicando quantidade em falta.

Coluna C. Médio (R$) – Custo Médio: Este campo apresenta o custo médio unitário do produto em Reais, calculado até aquela data. O custo médio é atualizado a cada entrada de estoque (compra ou movimentação de entrada que altere custo), seguindo o método de custeio médio ponderado.
- Formato: Valor monetário com duas casas decimais, em R$.
- Interpretação: Caso o produto tenha tido entradas com diferentes custos ao longo do tempo, esta coluna reflete o custo médio das unidades em estoque naquele dia. Por exemplo, se em certo dia após diversas compras o custo médio do item passou a R$ 10,50 por unidade, esse valor será exibido em todas as linhas dali em diante até que uma nova entrada altere o custo.
- Observação: O custo médio é fundamental para valorizar o estoque e calcular corretamente o valor total (coluna 19). Ele é mantido pelo sistema automaticamente; o usuário não insere manualmente, apenas visualiza aqui.

Coluna Vl. Total (R$) – Valor Total: Informa o valor total do estoque do produto naquela data, em Reais. É obtido multiplicando-se o saldo (coluna 17) pelo custo médio (coluna 18) da respectiva data.
- Formato: Valor monetário em R$, podendo incluir centavos.
- Significado: Representa quanto vale, em moeda, o estoque disponível daquele produto no local e lote indicados, naquela data. Por exemplo, se o saldo era 50 unidades e o custo médio R$ 10,00, o valor total será R$ 500,00. Conforme as movimentações alteram quantidade e eventualmente custo médio, essa coluna reflete o valor financeiro correspondente.
- Importante: Esta informação é útil para análises contábeis e de patrimônio (valor do estoque) e também para priorizar consumo/vendas de lotes de maior valor, se necessário.

Botão Exportar: Localizado na barra de ações fixa no rodapé, este botão permite exportar os dados exibidos no grid para uma planilha Excel.
- Formato de exportação: O sistema gera um arquivo no formato .xlsx contendo todas as colunas de informação. A exportação inclui não apenas as colunas visíveis, mas também colunas adicionais pertinentes (por exemplo, a unidade do produto em uma coluna separada “Unidade”, a descrição completa do lote, etc., conforme pré-definido para relatórios).
- Uso: Clique em Exportar e o sistema preparará o arquivo; caso haja muitos registros, pode demorar alguns segundos. Você será então solicitado a baixar o arquivo (o nome padrão do arquivo para Consulta de Estoque é algo como consulta-estoque.xlsx).
- Observação: A exportação é útil para realizar análises fora do sistema, gerar gráficos ou compartilhar dados de estoque. Todos os filtros aplicados na tela serão respeitados na geração do arquivo (ou seja, exportará exatamente os dados que você está vendo, abrangendo todas as páginas, não apenas a primeira).

Origem dos dados exibidos: Os resultados apresentados na tela de Consulta de Estoque são obtidos a partir do registro de movimentações de estoque do sistema. Internamente, ao aplicar os filtros, o BomControle busca todas as movimentações (entradas, saídas, transferências, ajustes etc.) que se encaixam nos critérios e calcula o saldo cumulativo dia a dia. Esse cálculo utiliza procedimentos de banco de dados para somar entradas e saídas e recalcular custos médios, garantindo que as informações refletidas sejam consistentes com todas as operações de estoque já registradas. Em resumo, a tela não mostra um campo estático cadastrado, mas sim um histórico calculado dinamicamente a partir dos dados de movimentação, o que assegura que saldos e valores estejam sempre atualizados conforme as operações realizadas no sistema.

4. Diferenças entre Consulta de Estoque e Kardex

Embora as duas telas apresentem informações similares sobre o estoque, elas possuem objetivos e funcionalidades ligeiramente diferentes:

• Âmbito da Consulta: A tela Consulta de Estoque foi concebida para fornecer uma visão gerencial do saldo de estoque em determinado período, permitindo identificar situações de estoque baixo ou produtos vencendo, possivelmente abrangendo múltiplos produtos e estoques de uma só vez. Já o Kardex foca em detalhar o histórico de movimentações, tradicionalmente de um produto por vez, funcionando como um “cartão de estoque” eletrônico onde se acompanha dia a dia o entra-e-sai e o saldo.

• Nível de Detalhamento: No grid de resultados, as colunas exibidas são praticamente as mesmas em ambos (Data, Produto, Estoque, Lote, Entrada, Saída, Saldo, Custo Médio, Valor Total). No entanto, a Consulta de Estoque tende a ser usada para listagens mais amplas e resumidas – por exemplo, mostrando apenas linhas relevantes (pode filtrar produtos com movimentação recente ou com status crítico). O Kardex, por sua vez, é utilizado para detalhamento completo de um item, potencialmente exibindo linha a linha todos os dias em que houve movimentação. Em outras palavras, a Consulta pode te mostrar “o quê requer atenção no estoque de forma geral”, enquanto o Kardex te mostra “tudo o que aconteceu com este item no estoque”.

Conclusão

Em resumo, use a Consulta de Estoque para uma visão ampla e gerencial (comparar múltiplos itens, localizar problemas de estoque, verificar estoques de várias empresas ao mesmo tempo, identificar lotes vencendo, etc.) e use o Kardex para dissecar o histórico detalhado de um item específico (auditar todas as movimentações de um produto, conferir cálculos de saldo e custo médio dia a dia, ou investigar divergências no saldo de determinado lote). As duas ferramentas se complementam na gestão do estoque: a primeira aponta “onde olhar” e a segunda permite “olhar em detalhes” o item de interesse. Com ambas, o usuário final tem meios de controlar quantitativos e valores de estoque de forma confiável, pois as informações vêm diretamente das movimentações registradas no BomControle, assegurando transparência e rastreabilidade completa das operações de entrada e saída de produtos.