> ## Documentation Index > Fetch the complete documentation index at: https://muveya.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Caixas e etiquetas > Encontre uma caixa pelo código, consulte os dados e o histórico, imprima a etiqueta, separe parte dela e tire-a de uso A caixa é a unidade que o muveya acompanha: um recipiente de um único insumo, com um código impresso. Esta página mostra como encontrar uma caixa, tudo o que a tela da caixa exibe, como imprimir e reimprimir a etiqueta, como separar parte dela em um novo recipiente e como tirá-la de uso. ## Encontrar uma caixa ### Escanear ou digitar o código **Quem pode fazer:** membros com `inventory.read` e acesso ao depósito da caixa. **Onde:** **Inventário** e depois **Escanear um código** no topo da tela **Estoque**, ou `console.muveya.com/inventory/scan`. A tela tem o título **Escanear**: "Leia uma etiqueta ou digite o código." O campo **Código da caixa** já fica ativo ao abrir a tela, então um leitor de código de barras digita direto nele. Você também pode digitar o código à mão. Pressione **Buscar** (um leitor que envia Enter faz isso por você). Enquanto busca, você vê **Buscando…**. Se o código existir nos seus depósitos, a tela da caixa abre. O código precisa ser igual ao da etiqueta; espaços no início e no fim são ignorados. Quando nada é encontrado, a tela diz **Não encontramos essa caixa.** A mesma mensagem aparece quando a caixa está em um depósito fora do seu acesso ou quando você não tem `inventory.read`: o muveya nunca revela se um código existe em um depósito que você não pode ver. ### Outras formas de abrir uma caixa * Na lista **Estoque**, selecione o nome do insumo em uma linha. * No [Recolhimento de lote](/docs/pt/inventory/lot-recall), selecione o código de uma caixa. * Na confirmação depois de [receber](/docs/pt/inventory/receive) ou de separar, selecione **Abrir a caixa** ou **Abrir**. * Nos links **Separada de** e **Separada em** de outra caixa. ## A tela da caixa O caminho é `/inventory/boxes/:boxId`. O título é o código da caixa e a linha abaixo é o status dela (por exemplo **Ativa** ou **Esgotada**). **Voltar ao estoque** retorna à lista. Enquanto carrega, você vê **Carregando caixa…**. ### Dados | Campo | O que mostra | | - | - | | **Insumo** | Nome e SKU. | | **Depósito** | Onde a caixa está agora. | | **Em mãos** | As unidades da caixa, com a unidade de medida, por exemplo `80 × Unidade`. | | **Recebida como** | Só em caixas recebidas como apresentação: a quantidade, o nome da apresentação e a versão recebida, por exemplo `3 × Caixa com 100 (versão 2)`. Se essa apresentação não puder mais ser lida: `3 × apresentação não disponível (versão 2)`. | Se a unidade gravada da caixa não puder ser confirmada, a tela acrescenta **A unidade desta caixa precisa de revisão. As quantidades aparecem sem unidade até que alguém a revise.** A tela da caixa não mostra o lote, a data de validade nem os números de série. O lote e a validade aparecem na prévia da etiqueta (veja abaixo). Os números de série não aparecem em nenhuma parte do console; eles são devolvidos por `GET /v1/inventory/boxes/{boxId}` na API pública (veja [API para desenvolvedores](/docs/pt/api-reference/introduction)). ### Recipientes separados Quando uma caixa foi separada de outra, ou outros recipientes foram separados dela, a tela mostra: | Rótulo | O que mostra | | - | - | | **Separada de** | O código da caixa original, como link. | | **Separada em** | Cada recipiente separado desta caixa: o código (um link), a quantidade com que começou e o status atual (por exemplo `20 · Ativa`), e **Imprimir a etiqueta de** seguido do código. Aparecem até 50 recipientes, do mais antigo ao mais recente. | Uma caixa relacionada que está em um depósito fora do seu acesso não é citada. ### Movimentos A tabela **Movimentos** lista todo o registro da caixa, do mais antigo ao mais recente. Sem movimentos, ela diz **Ainda não há movimentos.** | Coluna | O que mostra | | - | - | | **Tipo** | O movimento, por exemplo **Recebido**, **Consumido**, **Entrada por transferência** ou **Separação (saída)**. Uma saída entregue a uma sala ou área mostra **Entregue**. Veja todos os tipos em [Visão geral do estoque](/docs/pt/inventory/overview). | | **Mudança** | A mudança com sinal no que está em mãos, com a unidade, por exemplo `+300 × Unidade` ou `−5 × Unidade`. Transferências, reservas, retiradas para pedido e mudanças de status mostram `0`. | | **Onde** | A sala ou área de uma saída; nos outros casos, o depósito em que a caixa entrou ou de onde saiu. | | **Finalidade** | Nas saídas: **Procedimento**, **Limpeza**, **Administrativa** ou **Outra**. | | **Responsável** | Nas saídas: o profissional indicado como responsável. | | **Registrado por** | Quem registrou o movimento. Alguém que não está mais na equipe, ou uma etapa automática como a alocação de um pedido, aparece como **Fora da equipe**. | | **Quando** | Data e hora em que o movimento aconteceu. | Uma coluna sem valor para aquele movimento mostra um traço. As referências de atendimento nunca aparecem nesta tabela; veja [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves). ## Imprimir ou reimprimir uma etiqueta A seção **Etiqueta** está em todas as telas de caixa: "Imprima e cole no contêiner para que um leitor encontre esta caixa." Selecione **Ver a etiqueta de BX-7K3QM9**. Os links **Imprimir a etiqueta de** que aparecem depois de um recebimento ou de uma separação abrem a caixa com a etiqueta já visível. A etiqueta mostra o código como código de barras Code 128, o código em texto logo abaixo, o nome e o SKU do insumo, como a caixa foi recebida (por exemplo `3 × Caixa com 100`) e, quando a caixa os tem, **Lote** e **Validade** com a data. Pressione **Imprimir etiqueta**. A caixa de diálogo de impressão do navegador abre e a página imprime só a etiqueta, em preto sobre branco, com 62 mm de largura, no canto superior esquerdo da folha. Você pode reimprimir uma etiqueta quantas vezes precisar; imprimir não registra nada. Um código com caracteres diferentes de letras simples, dígitos e símbolos comuns é impresso só como texto, sem código de barras. ## Ações em uma caixa ativa Os formulários abaixo só aparecem enquanto a caixa está **Ativa**, e cada um só para quem tem a permissão correspondente. Quando a caixa está em qualquer outro status, a tela diz **Esta caixa está fechada e não aceita mais movimentos.** | Seção | Permissão | Guia | | - | - | - | | Quantidade, sala ou área e **Consumir** | `inventory.consume` | [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves) | | **Depósito de destino** e **Transferir** | `inventory.transfer` | [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves) | | **Separar parte desta caixa** | `inventory.transfer` | Abaixo | | **Corrigir esta caixa** e **Contar este insumo aqui** | `inventory.adjust` | [Correções de estoque](/docs/pt/inventory/corrections), [Contagens físicas](/docs/pt/inventory/counts) | | **Tirar a caixa de uso** | `inventory.adjust` | Abaixo | `inventory.adjust` inclui `inventory.consume` e `inventory.transfer`. ## Separar parte de uma caixa Separar tira algumas unidades de uma caixa para um novo recipiente etiquetado no mesmo depósito, por exemplo para levar 20 luvas a uma sala enquanto o resto da caixa fica na prateleira. **Quem pode fazer:** `inventory.transfer` (**Transferir caixas entre depósitos**) ou `inventory.adjust`, com acesso ao depósito da caixa. **Onde:** a tela da caixa, seção **Separar parte desta caixa**: "Retire algumas unidades para um novo recipiente. Ele mantém o lote e a validade desta caixa." Digite as unidades em **Quantidade a separar**. A dica mostra o máximo, por exemplo **Até 12 unidades livres.** Digite o código que você vai escrever no novo recipiente em **Etiqueta do novo recipiente (opcional)**, ou deixe vazio: "Se deixar em branco, uma etiqueta será sugerida." Pressione **Separar**. A tela confirma, por exemplo, **20 separados em BX-7K3QM9-F1. Escreva este código no novo recipiente.**, mostra o código em uma linha própria e oferece **Abrir BX-7K3QM9-F1** e **Imprimir a etiqueta de BX-7K3QM9-F1**. ### Regras * A quantidade é um número inteiro de 1 até o menor valor entre as unidades disponíveis da caixa e o que ela tem em mãos menos um. Sempre fica pelo menos uma unidade na caixa: para levar tudo, transfira a caixa inteira. * Só é possível separar unidades livres, nunca unidades reservadas para pedidos. Quando não há nada livre, a seção diz **Esta caixa não tem unidades livres para separar.** * A caixa precisa estar **Ativa**, sem ter passado da data de validade, sem controle de números de série e com a unidade de medida confirmada. * Uma etiqueta digitada tem até 64 caracteres, sem os espaços do início e do fim, e precisa ser única na sua clínica odontológica. Sem etiqueta, o muveya usa o código original seguido de `-F` e um número: `BX-7K3QM9-F1`, depois `BX-7K3QM9-F2`, pulando códigos já em uso. * O novo recipiente fica com status **Ativa**, no mesmo depósito, com o mesmo insumo, lote, data de validade, data de recebimento e unidade de medida. Ele não fica vinculado a uma apresentação: a quantidade está em unidades base. Ele não leva nenhuma reserva. ### O que o sistema registra * Um movimento `split_out` (**Separação (saída)**) na caixa original, subtraindo a quantidade. * Uma caixa nova vinculada à original. * Um movimento `split_in` (**Separação (entrada)**) na caixa nova, somando a mesma quantidade. Os dois movimentos compartilham uma mesma identidade de separação, e o total em mãos do insumo não muda. Pressionar de novo ou tentar outra vez depois de perder a resposta nunca separa duas vezes: a resposta é **Já estava registrado.** Durante a [preparação de pedidos](/docs/pt/deliveries/picking), o muveya pode separar uma caixa por conta própria para que um pedido saia exatamente com as unidades reservadas para ele. Essas separações aparecem no mesmo histórico. ### O que pode dar errado | Mensagem | O que fazer | | - | - | | **Informe um número inteiro de 1 a 12.** | Digite um número inteiro dentro do intervalo mostrado. | | **Use no máximo 64 caracteres.** | Encurte a etiqueta. | | **Essa etiqueta já está em outra caixa. Escreva uma diferente.** | Escreva outra etiqueta ou deixe vazio. | | **Não é possível separar tudo o que a caixa contém. Para movê-la inteira, transfira-a.** | Separe menos ou transfira a caixa. | | **Só é possível separar unidades livres: o restante está reservado para pedidos.** | Separe menos unidades. | | **Esta caixa registra números de série e ainda não pode ser separada.** | Caixas com números de série ainda não podem ser separadas. | | **A unidade desta caixa não foi verificada, então ela não pode ser separada. Verifique primeiro a unidade do insumo.** | Peça a quem administra o catálogo que confirme a unidade no [catálogo](/docs/pt/catalog/items). | | **Esta caixa está vencida e não pode ser separada.** | A data de validade já passou. Tire a caixa de uso. | | **Esta caixa não pode mais ser separada no estado atual.** | A caixa não está mais ativa. Recarregue a página. | ## Tirar uma caixa de uso **Quem pode fazer:** `inventory.adjust` (**Ajustar e contar estoque**), com acesso ao depósito da caixa. **Onde:** a última seção da tela da caixa, **Tirar a caixa de uso**: "A quarentena a separa para verificação; caixas vencidas e descartadas saem do estoque utilizável. O histórico é mantido." Só aparece enquanto a caixa está **Ativa**. Em **O que acontece com ela** (**Escolher…**), escolha **Quarentena**, **Marcar como vencida** ou **Descartar**. Se você pressionar **Continuar** sem escolher, vê **Escolha o que acontece com a caixa.** Em **Por quê**, escolha **Danificada**, **Vencida**, **Contaminada**, **Recolhida pelo fornecedor** ou **Outro**. Pressione **Continuar**. Uma caixa de diálogo pergunta, por exemplo, **Quarentena: caixa BX-7K3QM9?** com o texto "A caixa deixa de receber movimentações. Isso não pode ser desfeito pelo Console." Pressione **Sim, fazer**, ou **Manter a caixa ativa** para cancelar. A tela diz **A caixa BX-7K3QM9 agora está: Em quarentena.** Repetir a ação mostra **Isso já estava registrado.** | Opção | Novo status | Movimento | | - | - | - | | **Quarentena** | **Em quarentena** | `quarantine` | | **Marcar como vencida** | **Vencida** | `expire` | | **Descartar** | **Descartada** | `dispose` | ### O que o sistema registra Um movimento do tipo escolhido, com mudança `0`, o motivo escolhido e você como quem registrou, junto com o novo status da caixa, em uma única etapa. O histórico e o que está em mãos ficam como estavam, mas a caixa sai do estoque utilizável: não pode mais ser consumida, transferida, separada, corrigida nem reservada para pedidos. ### Regras e limites * O console só oferece isto para caixas com status **Ativa**. O muveya também aceita descartar uma caixa que já está em quarentena ou vencida, mas ainda não há um botão para isso; escreva para [team@muveya.com](mailto:team@muveya.com) se precisar registrar. * Não existe uma ação para voltar uma caixa para **Ativa**. * Para tirar de uso todas as caixas de um lote de uma vez, use o [Recolhimento de lote](/docs/pt/inventory/lot-recall). * É uma ação marcada como sensível. Na versão atual o segundo fator é opcional e não a bloqueia; veja [Segurança da conta](/docs/pt/account/security). ### O que pode dar errado | Mensagem | Causa | O que fazer | | - | - | - | | **O registro mudou ou já existe. Confira antes de tentar novamente.** | A caixa deixou de estar ativa nesse meio-tempo. | Recarregue a caixa. | | **Este registro não está disponível na conta de clínica odontológica ativa.** | A caixa não está mais em um depósito que você alcança. | Confira a localização com alguém que possa vê-la. | | **Sua conta não tem permissão para esta ação.** | Você não tem `inventory.adjust`. | Fale com um administrador. | ## Páginas relacionadas Consuma de uma caixa ou transfira-a. Corrija a quantidade registrada de uma caixa. Retenha todas as caixas de um lote. Como as caixas são retiradas e separadas na preparação dos pedidos. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.