> ## 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.

# Recolhimento de lote

> Encontre todas as caixas de um lote onde estiverem, rastreie o que foi consumido ou despachado e tire o lote inteiro de uso em uma única etapa

Quando um fornecedor recolhe um lote, você precisa saber onde está cada unidade e impedir que alguém a use. A tela **Recolhimento de lote** encontra todas as caixas de um insumo que têm esse lote, em qualquer status, e coloca em quarentena todas as caixas ainda em uso em uma única etapa confirmada.

## Quem pode fazer

| Tarefa | Permissão | Sem a permissão |
| - | - | - |
| Buscar um lote e ver as caixas | `inventory.read` | A tela diz **Você não tem permissão para ver o estoque. Peça acesso a um administrador.** |
| Colocar o lote em quarentena | `inventory.adjust` | A tela diz **Você pode buscar um lote. Para colocá-lo em quarentena, você precisa de permissão para ajustar o estoque.** |

As duas tarefas só alcançam caixas dos depósitos do seu acesso. Para um recolhimento completo, peça que seja feito por alguém com acesso a todos os depósitos.

## Onde

**Inventário** na navegação principal e depois **Recolhimento de lote** no topo da tela **Estoque**, ou `console.muveya.com/inventory/lots`. A tela tem o título **Recolhimento de lote**: "Encontre todas as caixas de um lote, onde estiverem, e tire o lote de uso em uma única etapa."

## Encontrar todas as caixas de um lote

<Steps>
  <Step title="Escolha o insumo">
    Em **Insumo** (**Escolha o insumo**), escolha o insumo ao qual o lote pertence. Todos os insumos aparecem, ativos ou não. Se ficar vazio, você vê **Escolha o insumo ao qual o lote pertence.**
  </Step>

  <Step title="Digite o lote">
    Digite em **Número do lote**, "Como aparece na embalagem ou no aviso de recolhimento.", com até 120 caracteres. Se ficar vazio, você vê **Informe o número do lote.**
  </Step>

  <Step title="Busque as caixas">
    Pressione **Buscar caixas**. Enquanto busca, você vê **Buscando as caixas deste lote…**.
  </Step>

  <Step title="Leia o resumo">
    Os resultados têm como título o lote e o insumo, por exemplo **Lote L2409-A · Luvas de nitrilo M · GLV-NIT-M**, seguidos de uma contagem como **Caixas encontradas: 6 · Ainda em uso: 4**.
  </Step>
</Steps>

O lote precisa ser igual ao que foi digitado no recebimento das caixas; espaços no início e no fim são ignorados. Os recipientes separados de uma caixa do lote mantêm o lote dela, então também aparecem. Quando nada corresponde, a tela diz **Nenhuma caixa dos seus depósitos tem o lote L2409-A deste insumo. Confira o lote como está impresso; espaços no início ou no fim não importam.**

A lista mostra até 200 caixas, agrupadas por depósito e depois por data de recebimento. Se houver mais, ela acrescenta **Mostrando as primeiras 200 caixas deste lote.**

## Ler os resultados

| Coluna | O que mostra |
| - | - |
| **Caixa** | O código da caixa, como link para a caixa. |
| **Depósito** | Onde a caixa está agora. **Depósito indisponível** se não puder mais ser nomeado. |
| **Status** | O status da caixa. |
| **Em mãos** | As unidades que ela tem agora, com a unidade de medida. |
| **Último movimento** | O movimento mais recente e a data, por exemplo `Consumido · 12 de set. de 2026, 10:40`. **Ainda sem movimentos** quando não há nenhum. |

O que cada status significa para o recolhimento:

| Status | Significado | O que o recolhimento faz |
| - | - | - |
| **Ativa** | Ainda em uso. | Coloca em quarentena. |
| **Em quarentena**, **Vencida**, **Descartada** | Já está fora de uso. | Deixa como está. |
| **Esgotada** | Todas as unidades já saíram da caixa. | Deixa como está. Rastreie as saídas (abaixo). |
| **Em trânsito** | Despachada para um pedido e ainda não recebida. | **Não** a retém. Faça o recolhimento de novo quando ela chegar. |

## Rastrear o que foi consumido ou despachado

A tela do lote mostra onde cada caixa está e o que aconteceu com ela por último. Para seguir cada unidade:

* **Abra cada caixa.** Os **Movimentos** mostram cada saída com a sala ou área, **O que aconteceu**, **Finalidade**, **Responsável**, **Registrado por** e a data. Uma caixa **Esgotada** já liberou todas as unidades. Veja [Caixas e etiquetas](/docs/pt/inventory/boxes).
* **Confira as salas.** Na tela **Uso por sala ou área** (veja [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves)), filtre por sala e datas e compare a data e a quantidade com as saídas da caixa. Membros com `orders.patient_ref.read` também veem a referência de atendimento de cada saída, o que permite à equipe clínica encontrar os atendimentos envolvidos. Essa tela não filtra por lote.
* **Acompanhe os pedidos.** Uma caixa que mostra **Despachado** ou **Em trânsito** saiu para um pedido. Acompanhe o pedido no [Histórico de custódia](/docs/pt/deliveries/custody-history).
* **Acompanhe os recipientes separados.** A caixa original os lista em **Separada em**, e eles também aparecem nos resultados do lote.

## Tirar o lote de uso

A seção **Tirar o lote de uso** aparece abaixo dos resultados: "Cada caixa deste lote que ainda está em uso vai para quarentena: deixa de receber movimentos e nunca é separada para um pedido. As caixas já fora de uso ficam como estão."

<Steps>
  <Step title="Confira as caixas em trânsito">
    Se houver caixas a caminho, a tela avisa, por exemplo, **Em trânsito, este recolhimento não as retém: 1. Quando chegarem, busque este lote de novo e coloque-as em quarentena.**
  </Step>

  <Step title="Escolha o motivo">
    Em **Motivo**, mantenha **Recolhida pelo fornecedor** (o padrão) ou escolha **Danificada**, **Vencida**, **Contaminada** ou **Outro**.
  </Step>

  <Step title="Coloque em quarentena">
    Pressione **Colocar o lote em quarentena**.
  </Step>

  <Step title="Confirme">
    Uma caixa de diálogo pergunta **Colocar o lote L2409-A em quarentena?** e diz, por exemplo, "Caixas em uso que vão para quarentena: 4. Elas deixam de receber movimentos e nunca são separadas para um pedido. Não é possível desfazer pelo Console." Ela também repete quantas caixas em trânsito não são retidas. Pressione **Sim, colocar em quarentena**, ou **Manter o lote em uso** para cancelar.
  </Step>

  <Step title="Leia o resultado">
    A tela diz, por exemplo, **Caixas do lote L2409-A em quarentena: 4.**, e depois **Já estavam fora de uso e ficaram como estavam: 2.** e **Em trânsito e não retidas: 1. Quando chegarem, busque este lote de novo e coloque-as em quarentena.** quando se aplicam.
  </Step>
</Steps>

Quando nenhuma caixa está em uso e nenhuma está em trânsito, a seção diz **Todas as caixas deste lote já estão fora de uso.**

### O que o sistema registra

* Para cada caixa **Ativa**: um movimento `quarantine` (**Em quarentena**) com mudança `0`, o motivo e você como quem registrou, e o status da caixa passa para **Em quarentena**. Cada caixa tem o próprio movimento.
* Um registro de auditoria, `inventory.lot.quarantined`, com o insumo, o lote, o motivo, as caixas retidas e as caixas que ficaram como estavam.
* As caixas em qualquer outro status são informadas com o status atual e não mudam.

Uma caixa em quarentena não pode mais ser consumida, transferida, separada, corrigida nem retirada para um pedido. O histórico e a quantidade registrada são mantidos.

### Regras e limites

* O recolhimento age sobre **todas** as caixas do lote nos seus depósitos, inclusive as que ficam além das 200 listadas. O número na caixa de diálogo conta só as caixas listadas.
* Caixas em trânsito não são retidas, porque ao serem recebidas ficam utilizáveis no destino. Quando chegarem, busque o lote de novo e coloque-o em quarentena outra vez.
* Se o resultado se perder (por exemplo, a conexão caiu), a lista recarrega e mostra quais caixas já estão **Em quarentena**. Se alguma ainda estiver **Ativa**, pressione **Colocar o lote em quarentena** de novo: caixas já retidas não são retidas duas vezes. Quando tudo já tinha sido registrado, a tela responde **Este recolhimento já estava registrado. Nada mais mudou.**
* Fazer o recolhimento de novo mais tarde, por exemplo depois de receber mais caixas do lote, retém as novas caixas ativas e informa as demais como já fora de uso.
* Não existe uma ação para tirar uma caixa da quarentena.
* Descartar caixas em quarentena ainda não está disponível no console. Elas continuam em quarentena, o que as mantém fora de qualquer movimento. Se precisar registrar o descarte, escreva para [team@muveya.com](mailto:team@muveya.com).
* Colocar um lote em quarentena é 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 |
| - | - | - |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | Não há mais caixas deste lote nos seus depósitos. | Busque o lote de novo. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | Uma tentativa anterior deste recolhimento foi registrada com outro motivo. | Busque o lote de novo e repita. |
| **Não foi possível confirmar a operação. Verifique sua conexão e a lista antes de tentar novamente.** | A conexão falhou. | Confira os status na lista recarregada e repita se ainda houver caixas com status **Ativa**; nada é retido duas vezes. |
| **Sua conta não tem permissão para esta ação.** | Você não tem `inventory.adjust`. | Fale com um administrador. |

## Lista de verificação do recolhimento

1. Busque o lote e coloque-o em quarentena.
2. Tire as caixas em quarentena da prateleira e mantenha-as à parte.
3. Rastreie as saídas das caixas já usadas.
4. Acompanhe as caixas em trânsito e coloque-as em quarentena quando chegarem.
5. Busque o lote de novo depois de qualquer novo recebimento desse insumo.

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Caixas e etiquetas" icon="box-open" href="/docs/pt/inventory/boxes">
    Histórico de uma caixa e como tirar uma única caixa de uso.
  </Card>

  <Card title="Registrar consumo e transferir caixas" icon="arrow-right-arrow-left" href="/docs/pt/inventory/use-and-moves">
    Uso por sala ou área e referências de atendimento.
  </Card>

  <Card title="Histórico de custódia" icon="route" href="/docs/pt/deliveries/custody-history">
    Para onde foi uma caixa despachada.
  </Card>

  <Card title="Receber estoque" icon="truck-ramp-box" href="/docs/pt/inventory/receive">
    Como os números de lote são registrados no recebimento.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.