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

# Registrar consumo e transferir caixas

> Registre o que sai de uma caixa e para onde foi, transfira caixas entre depósitos, revise o uso por sala ou área e atribua saídas depois sem descontar duas vezes

O estoque sai de uma caixa de duas formas comuns: alguém usa, ou ele é entregue a uma sala ou área. Esta página mostra como registrar essas saídas, como transferir uma caixa inteira para outro depósito, como ler a tela **Uso por sala ou área** e como atribuir uma saída depois.

## Salas, áreas e como elas contam

As saídas apontam para as **salas e áreas** de uma unidade (por exemplo uma sala de atendimento ou uma área de esterilização). Elas são configuradas por unidade; veja [Salas e áreas](/docs/pt/locations/destinations). Cada uma tem um controle de estoque:

| Controle de estoque | Significado | Saídas que aceita |
| - | - | - |
| **Sem contagem** | "As entregas saem do estoque; o que fica na sala não é contado." | **Entrega à sala ou área** e **Uso direto**. |
| **Estoque contado** | "A sala mantém estoque próprio que é contado." O estoque dela fica em um depósito express, o **Ponto de estoque**. | Só **Uso direto**, e só a partir de uma caixa que já está no ponto de estoque. |

O que aconteceu com o estoque tem dois valores possíveis:

* **Entrega à sala ou área** (`issue`): "Sai do estoque uma única vez; quem usou pode ser atribuído depois sem descontar de novo."
* **Uso direto** (`use`): "Foi usado na hora."

As salas oferecidas dependem de onde a caixa está. Uma caixa em um depósito **Central** pode ir para as salas ativas de qualquer unidade. Uma caixa em um depósito **Express** só pode ir para as salas ativas da unidade desse depósito.

## Registrar um consumo ou uma saída de uma caixa

**Quem pode fazer:** `inventory.consume` (**Registrar consumo**) ou `inventory.adjust`, com acesso ao depósito da caixa. Abrir a caixa também exige `inventory.read`.

**Onde:** a tela da caixa. Escaneie a caixa com **Escanear um código** na tela **Estoque**, ou abra-a pela lista. O formulário de saída é a primeira ação de uma caixa **Ativa**.

<Steps>
  <Step title="Abra a caixa">
    Escaneie ou digite o código. Veja [Caixas e etiquetas](/docs/pt/inventory/boxes).
  </Step>

  <Step title="Quantidade">
    Digite quantas unidades saíram em **Quantidade**. Começa em 1.
  </Step>

  <Step title="Sala ou área">
    Escolha em **Sala ou área** (**Escolha uma sala ou área**). Quando só há uma possível, ela já aparece escolhida. Com várias unidades, cada sala mostra também a unidade, por exemplo `Sala 1 · Clínica Norte`.
  </Step>

  <Step title="O que aconteceu">
    Para uma sala sem contagem, escolha **Entrega à sala ou área** (selecionada por padrão) ou **Uso direto** em **O que aconteceu**. Para uma sala com estoque contado que está no próprio ponto de estoque, a tela diz **Usado a partir do estoque contado desta sala.** e registra um uso direto.
  </Step>

  <Step title="Finalidade">
    Escolha a **Finalidade**: **Não especificada** (padrão), **Procedimento**, **Limpeza**, **Administrativa** ou **Outra**.
  </Step>

  <Step title="Responsável">
    **Responsável** começa com o seu próprio nome. Se você escolher outra pessoa, a dica confirma, por exemplo **Registrado por você, responsável: Ana Rocha.**
  </Step>

  <Step title="Referência de atendimento (opcional)">
    Em **Referência de atendimento (opcional)**, digite o código do sistema clínico: "O código do sistema clínico, nunca o nome do paciente."
  </Step>

  <Step title="Consumir">
    Pressione **Consumir**. A tela confirma **Consumo registrado.** O campo da referência de atendimento é limpo para a próxima saída.
  </Step>
</Steps>

### Quando a sala conta o próprio estoque

Se você escolher uma sala com estoque contado e a caixa estiver em outro lugar, o formulário não deixa consumir. Ele diz, por exemplo, **Sala 2 conta seu próprio estoque. Leve primeiro a caixa inteira até lá; retirar só parte de uma caixa virá depois.**

* Com `inventory.transfer`, pressione **Levar esta caixa para Sala 2**. A caixa vai para o ponto de estoque da sala e a tela confirma **A caixa já está em Sala 2.** Depois você pode registrar o uso.
* Sem essa permissão, o formulário diz **Peça a alguém que possa transferir caixas para levar esta caixa até Sala 2.**

<Tip>
  Para levar só parte de uma caixa a uma sala com estoque contado, primeiro separe essas unidades em um novo recipiente (veja [Caixas e etiquetas](/docs/pt/inventory/boxes)) e depois transfira esse recipiente para o ponto de estoque da sala.
</Tip>

### Quando a unidade não tem salas nem áreas

O formulário diz **Esta unidade ainda não tem salas nem áreas, então este consumo não dirá para onde foi.** Você ainda pode registrar a saída; ela é gravada sem sala. Quem pode administrar unidades também vê **Configurar salas e áreas**. Essas saídas não aparecem em **Uso por sala ou área**.

### Regras

| Regra | Detalhe |
| - | - |
| Quantidade | Número inteiro de 1 a 1.000.000, e não mais do que a caixa tem em mãos. |
| Unidades reservadas | O limite é o que está em mãos, não o disponível: o console não impede usar unidades reservadas para um pedido. Confira antes **Reservado** na lista **Estoque**. |
| Caixa | **Ativa** e sem ter passado da data de validade. |
| Sala ou área | Ativa; da unidade da caixa, a menos que a caixa esteja em um depósito central. Uma sala com estoque contado só aceita uso direto a partir do ponto de estoque. Se a unidade tem salas, escolher uma é obrigatório. |
| Responsável | Um membro ativo da equipe. |
| Referência de atendimento | Opcional. De 1 a 64 caracteres: letras, números e `. _ : / -`, começando por letra ou número, sem espaços. |

A referência de atendimento é guardada selada. Ela nunca aparece no histórico da caixa; em **Uso por sala ou área** só é mostrada para membros com a permissão `orders.patient_ref.read`. Nunca digite ali o nome ou o documento de um paciente.

### O que o sistema registra

Um movimento `consume` que subtrai a quantidade do que está em mãos, com o depósito da caixa como origem, a sala ou área, o que aconteceu, a finalidade, o responsável, a referência de atendimento selada e você como quem registrou. Quando o que está em mãos chega a zero, a caixa passa para **Esgotada**. No histórico da caixa o movimento aparece como **Consumido**, ou **Entregue** quando foi uma entrega a uma sala ou área. Essas saídas alimentam o [relatório de consumo](/docs/pt/reports/consumption).

Pressionar de novo ou tentar outra vez depois de perder a resposta registra a saída uma única vez e responde **Já estava registrado.**

### O que pode dar errado

| Mensagem | Causa | O que fazer |
| - | - | - |
| **Use letras, números e . \_ : / - sem espaços.** | A referência de atendimento tem um espaço ou outro caractere. | Digite só o código. **Consumir** fica desativado até ela ser válida. |
| **Esta sala conta seu próprio estoque. Leve primeiro a caixa até lá.** | Uma entrega foi enviada a uma sala com estoque contado. | Transfira a caixa para o ponto de estoque da sala e registre um uso direto. |
| **Esta caixa pertence a outra unidade que não a da sala ou área escolhida. Verifique onde está a caixa.** | A sala é de outra unidade, ou a caixa foi transferida nesse meio-tempo. | Escolha uma sala da unidade da caixa ou recarregue a caixa. |
| **Essa sala ou área não está mais ativa. Escolha outra.** | A sala foi desativada. | Escolha outra sala. |
| **A pessoa responsável não está mais na equipe. Escolha outra pessoa.** | O responsável saiu da equipe. | Escolha outra pessoa. |
| **Use o código do sistema clínico, sem espaços.** | O servidor recusou a referência de atendimento. | Corrija o código. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | A caixa não está mais ativa, passou da validade ou tem menos do que a quantidade. | Recarregue a caixa e confira o que ela tem em mãos. |
| **Confira os dados informados antes de tentar novamente.** | Um valor está fora do intervalo. | Corrija a quantidade. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | A caixa está fora dos seus depósitos ou não existe mais. | Confira o código. |
| **Sua conta não tem permissão para esta ação.** | Você não tem `inventory.consume`. | Fale com um administrador. |

## Transferir uma caixa para outro depósito

**Quem pode fazer:** `inventory.transfer` (**Transferir caixas entre depósitos**) ou `inventory.adjust`, com acesso aos dois depósitos.

**Onde:** a tela da caixa, **Depósito de destino** e **Transferir**.

<Steps>
  <Step title="Escolha o destino">
    Em **Depósito de destino**, escolha um dos depósitos ativos que você alcança. O depósito atual da caixa não aparece.
  </Step>

  <Step title="Transfira">
    Pressione **Transferir**. Não há caixa de diálogo de confirmação.
  </Step>

  <Step title="Confira o resultado">
    A tela confirma, por exemplo, **Transferida para Express Norte.** Repetir a ação responde **Já estava registrado.**
  </Step>
</Steps>

Quando não há outro depósito disponível, a tela diz **Não há outro depósito para onde você possa transferir esta caixa.**

### Regras

* Uma transferência leva a **caixa inteira**. Para mover só uma parte, separe essas unidades antes e transfira o novo recipiente.
* A caixa precisa estar **Ativa** e sem ter passado da validade. O destino precisa estar ativo e ser diferente do depósito atual.
* A caixa mantém código, lote, validade e quantidades. As unidades reservadas para um pedido continuam reservadas, e a caixa ainda pode ser retirada para esse pedido no novo depósito.
* Transferir uma caixa é 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 o sistema registra

Dois movimentos com mudança `0` e uma mesma identidade de transferência: `transfer_out` (**Saída por transferência**) na origem e `transfer_in` (**Entrada por transferência**) no destino. O depósito da caixa muda na mesma etapa, então a lista **Estoque** já a mostra no novo lugar.

### O que pode dar errado

| Mensagem | Causa | O que fazer |
| - | - | - |
| **Confira os dados informados antes de tentar novamente.** | A caixa já está nesse depósito. | Recarregue a caixa. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | O destino foi desativado, ou a caixa não está mais ativa ou passou da validade. | Escolha outro depósito ou tire a caixa de uso. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | A caixa ou o destino estão fora do seu acesso. | Peça acesso ao depósito a um administrador. |
| **Sua conta não tem permissão para esta ação.** | Você não tem `inventory.transfer`. | Fale com um administrador. |

## Revisar o uso por sala ou área

**Quem pode fazer:** `inventory.read` para consultar; `inventory.consume` ou `inventory.adjust` para atribuir saídas.

**Onde:** **Uso por sala ou área** no topo da tela **Estoque**, ou `console.muveya.com/inventory/usage`. A tela diz: "O que saiu do estoque para cada sala ou área, e quanto já está atribuído."

### Filtros

| Filtro | Detalhe |
| - | - |
| **Sala ou área** | **Todas as salas e áreas**, ou uma sala (ativa ou não). |
| **De** e **Até** | Dias do calendário, ambos incluídos. Começam nos últimos sete dias, contando hoje. O início precisa ser igual ou anterior ao fim e o intervalo pode ter no máximo 92 dias; caso contrário, a tela diz **Escolha uma data inicial igual ou anterior à final, com no máximo 92 dias de diferença.** |

Só aparecem as saídas registradas **com** uma sala ou área, de caixas dos seus depósitos: "Aqui aparecem apenas os consumos registrados com uma sala ou área." Sem nenhuma, a tela diz **Não há saídas com sala ou área nestas datas.**

### Totais

Uma linha por sala, insumo e unidade de medida. Quantidades de insumos ou unidades de medida diferentes nunca são somadas.

| Coluna | Significado |
| - | - |
| **Sala ou área** | A sala. **Sala indisponível** se não puder mais ser nomeada. |
| **Insumo** | Nome e SKU. **Insumo indisponível** se não puder mais ser nomeado. |
| **Unidade** | A unidade de medida das quantidades. |
| **Entregue** | Unidades entregues à sala. |
| **Uso direto** | Unidades usadas diretamente. |
| **Atribuído** | Quanto dessas saídas uma atribuição posterior explicou. |

### Saídas

| Coluna | Significado |
| - | - |
| **Quando** | Data e hora da saída. |
| **Insumo**, **Quantidade**, **Unidade** | O que saiu. |
| **Sala ou área** | Para onde foi. |
| **O que aconteceu** | **Entrega à sala ou área** ou **Uso direto**. |
| **Finalidade**, **Responsável** | O que foi registrado com a saída. |
| **Registrado por** | Quem registrou. |
| **Pendente** | Unidades da saída que nenhuma atribuição posterior explicou ainda. O responsável escolhido ao registrar a saída não reduz esse valor. |
| **Referência de atendimento** | Só para membros com `orders.patient_ref.read`, e só quando alguma saída tem uma. |
| **Ações** | **Atribuições** com a quantidade, para expandi-las, e **Atribuir** enquanto houver algo pendente. |

A tela lê até 2.000 saídas. Acima disso, diz **Esta é uma visão parcial. Restrinja as datas para ver todas as saídas.** e os totais contam só o que foi lido. Se o carregamento falhar, pressione **Tentar de novo**.

## Atribuir uma saída depois

Uma entrega a uma sala sai do estoque uma única vez. Depois, você pode dizer quem usou quanto e para quê, sem descontar o estoque de novo.

<Steps>
  <Step title="Encontre a saída">
    Em **Uso por sala ou área**, encontre a linha e pressione **Atribuir**. O botão só aparece enquanto **Pendente** for maior que zero.
  </Step>

  <Step title="Preencha a atribuição">
    **Quantidade a atribuir** começa com todo o pendente. Escolha o **Responsável** (você, por padrão) e a **Finalidade** e, se quiser, digite uma **Referência de atendimento (opcional)**.
  </Step>

  <Step title="Salve">
    Pressione **Salvar atribuição**. A tela confirma **Atribuição registrada.** e o campo de quantidade mostra o que ainda está pendente. Pressione **Fechar** quando terminar.
  </Step>

  <Step title="Consulte as atribuições">
    Pressione **Atribuições** com a quantidade, por exemplo **Atribuições (2)**, para ver cada uma com **Quando**, **Quantidade**, **Responsável**, **Finalidade**, **Registrado por** e, para membros com `orders.patient_ref.read`, **Referência de atendimento**.
  </Step>
</Steps>

### Regras

* Só é possível atribuir saídas registradas com uma sala ou área, sejam entregas ou usos diretos.
* O total atribuído nunca pode passar da quantidade da saída. Para dividir uma saída entre várias pessoas, salve várias atribuições.
* Uma atribuição não movimenta estoque e não pode ser editada nem apagada.
* O responsável precisa ser um membro ativo da equipe. A referência de atendimento segue o mesmo formato de uma saída.
* Salvar de novo a mesma atribuição responde **Já estava registrado.** e não acrescenta nada.

### O que pode dar errado

| Mensagem | Causa | O que fazer |
| - | - | - |
| **Isso excede o que ainda está pendente desta saída.** | A quantidade é maior que o pendente. | Diminua a quantidade. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | A saída já está totalmente atribuída. | Recarregue a tela. |
| **Confira os dados informados antes de tentar novamente.** | O responsável não está mais na equipe, ou um valor não é válido. | Escolha outra pessoa ou corrija o valor. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | A saída veio de um depósito fora do seu acesso. | Peça ajuda a alguém com acesso a esse depósito. |

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Salas e áreas" icon="door-open" href="/docs/pt/locations/destinations">
    Configure onde os insumos são usados e como as salas contam o estoque.
  </Card>

  <Card title="Caixas e etiquetas" icon="box-open" href="/docs/pt/inventory/boxes">
    Escaneie uma caixa, separe parte dela e consulte o histórico.
  </Card>

  <Card title="Relatório de consumo" icon="chart-line" href="/docs/pt/reports/consumption">
    O consumo ao longo do tempo.
  </Card>

  <Card title="Depósitos" icon="warehouse" href="/docs/pt/locations/warehouses">
    Depósitos centrais e express.
  </Card>
</CardGroup>


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