Visão geral do estoque

O muveya controla o estoque por caixa: um recipiente físico de um único insumo, com seu próprio código impresso, seu depósito, seu status e, quando o insumo os controla, seu lote, seus números de série e sua data de validade. Cada mudança em uma caixa é gravada em um registro de movimentos que só recebe novas linhas, e as quantidades que você vê são calculadas a partir desse registro. Nada nele é editado ou apagado. Esta página explica a tela principal do estoque, como funcionam as quantidades e os status, cada movimento que o registro pode guardar e qual permissão cada ação exige.

​

Abrir a tela de estoque

Selecione Inventário na navegação principal. A tela que abre tem o título Estoque (“Caixas disponíveis nos depósitos que você pode ver.”). Você também pode ir direto para console.muveya.com/inventory. A opção Inventário aparece para todos os membros, mas a lista só carrega para quem tem a permissão inventory.read. Sem ela, a tela mostra Sua conta não tem permissão para esta ação.

​

O que a lista mostra

Cada linha é uma caixa. A lista inclui caixas em qualquer status, então uma caixa esgotada pode continuar aparecendo com 0 em mãos. O código da caixa não é uma coluna: abra a caixa para vê-lo.

​

Filtrar a lista

Você só vê caixas dos depósitos que o seu acesso na equipe alcança. A lista mostra até 50 caixas, da mais antiga para a mais recente, e não tem próxima página: se você espera mais, refine com os filtros.

​

Estados e mensagens

​

Atalhos no topo da tela

​

Saldos: em mãos, reservado e disponível

Cada caixa tem dois contadores, ambos calculados a partir do registro:

• Em mãos (onHand): as unidades que estão na caixa. Receber soma; consumir, despachar e correções de saída subtraem. Nunca fica abaixo de zero.
• Reservado (reserved): as unidades da caixa reservadas para pedidos aprovados. Reservar nunca muda o que está em mãos.
• Disponível (available): onHand menos reserved. A alocação de pedidos só reserva unidades disponíveis, e separar parte de uma caixa só usa unidades disponíveis.

As quantidades estão sempre na unidade de medida base do insumo (a definida no catálogo), mostrada no seu idioma, por exemplo 24 × Caixa. A unidade de medida é bloqueada quando o insumo é ativado no catálogo (um recebimento também a bloqueia se ainda não estava bloqueada), e cada caixa mantém a unidade de medida com que foi recebida. Uma caixa cuja unidade de medida gravada não pode ser confirmada mostra seus números sem unidade e o aviso A unidade desta caixa precisa de revisão. As quantidades aparecem sem unidade até que alguém a revise.

​

Status de uma caixa

​

O registro de movimentos

O registro é a única fonte da verdade do estoque. Cada movimento guarda seu tipo, a caixa, o insumo, a mudança com sinal no que está em mãos (e no reservado, quando se aplica), quem registrou, quando aconteceu (pelo relógio do servidor), o depósito de onde saiu ou para onde entrou e, quando informado, um motivo. Um erro é corrigido com um novo movimento que o compensa, nunca editando um anterior. Os movimentos de uma caixa aparecem na tela da caixa; veja Caixas e etiquetas. Um consumo que usa a última unidade também deixa a caixa Esgotada. Transferências, mudanças de status e retiradas para pedido registram mudança 0: a caixa mantém suas unidades, só muda de lugar ou de status.

​

FEFO e FIFO

Quando um pedido aprovado é alocado, o muveya reserva unidades caixa por caixa em uma ordem fixa:

• FEFO (o que vence primeiro sai primeiro) vale quando alguma caixa elegível do insumo tem data de validade. As caixas que vencem antes vão primeiro; as caixas sem validade vão por último; empates são resolvidos pela data de recebimento.
• FIFO (o que entra primeiro sai primeiro) vale nos demais casos. O recebimento mais antigo vai primeiro.

Só são elegíveis as caixas com status Ativa cuja validade não passou, no depósito de origem e com a unidade de medida que o pedido espera, e só as unidades disponíveis delas são reservadas. A ordem é calculada pelo servidor e é sempre a mesma. Quando você mesmo consome ou transfere uma caixa, escolhe a caixa ao escaneá-la; o console não sugere nenhuma. Não há uma ação no console para mudar essa ordem em uma alocação.

​

Permissões

As permissões de estoque são concedidas uma a uma em Equipe. Nenhuma função as concede automaticamente: um proprietário ou administrador também precisa delas para ver ou mudar o estoque. Veja Funções e permissões. Cada permissão vale apenas dentro do Acesso aos depósitos do membro (todos os depósitos ou uma lista específica). Uma caixa de um depósito fora desse acesso se comporta exatamente como se não existisse: ao escanear o código, a tela diz que não encontrou a caixa. Transferir uma caixa, tirar uma caixa de uso e colocar um lote em quarentena são ações marcadas como sensíveis. Na versão atual o segundo fator é opcional e não as bloqueia; veja Segurança da conta.

​

Mapa das telas de estoque

Reposição e Correções de estoque também aparecem na navegação principal.

​

Ler o estoque pela API ou MCP

Os mesmos saldos e o mesmo registro podem ser lidos com uma chave de API que tenha o escopo inventory:read: GET /v1/inventory/balances, GET /v1/inventory/boxes/{boxId}, GET /v1/inventory/boxes/{boxId}/balance e GET /v1/inventory/boxes/{boxId}/movements. São somente leitura. Veja API para desenvolvedores. Pelo MCP, a ferramenta inventory.check devolve o que está em mãos, reservado e disponível de um insumo; veja Ferramentas MCP.

​

Páginas relacionadas