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

# Correções de estoque

> Corrija o que uma caixa contém de acordo com a prateleira e revise, aprove, rejeite ou retire as correções que precisam de uma segunda pessoa

Uma **correção** indica que o registro estava errado: a caixa na prateleira tem mais ou menos unidades do que o muveya diz. Uma correção nunca edita um movimento anterior. Ela acrescenta ao registro de movimentos um movimento novo, com sinal, que compensa a diferença, então o histórico sempre mostra o que foi registrado primeiro e o que o corrigiu.

Correções pequenas são aplicadas assim que você as registra. Uma correção acima do seu **limite de aprovação** não é aplicada: ela aguarda em **Correções de estoque** até que outra pessoa com permissão a aprove na própria sessão.

## Quem pode fazer

| Ação | Permissão (rótulo no console) |
| - | - |
| Ver uma caixa e a lista de **Correções de estoque** | `inventory.read` (**Ver estoque**) |
| Registrar uma correção em uma caixa | `inventory.adjust` (**Ajustar e contar estoque**) |
| Aprovar ou rejeitar uma correção pendente | `inventory.adjust`, e não ter sido você quem a solicitou |
| Retirar uma correção pendente | A pessoa que a solicitou, enquanto ainda tiver `inventory.adjust` |
| Alterar o limite de aprovação de um insumo em um depósito | `inventory.adjust` (veja [Reposição e alertas de estoque](/docs/pt/inventory/replenishment-and-alerts)) |

Cada ação também fica limitada aos depósitos que o seu acesso na equipe alcança: você nunca vê nem decide a correção de uma caixa de outro depósito.

<Note>
  `inventory.adjust` inclui receber, registrar consumo e transferir caixas, mas **não** inclui `inventory.read`. Um membro que corrige o estoque precisa das duas permissões para abrir as telas que listam caixas. As permissões são explicadas em [Funções e permissões](/docs/pt/account/roles-and-permissions).
</Note>

## Corrigir uma caixa

O formulário de correção fica na página da caixa. Ele aparece só para membros com `inventory.adjust`, e só enquanto a caixa está **Ativa**: uma caixa em quarentena, vencida, descartada, esgotada ou em trânsito não aceita correções.

<Steps>
  <Step title="Abra a caixa">
    Vá até **Inventário** e selecione a caixa na lista, ou use **Escanear um código** e leia a etiqueta (veja [Caixas e etiquetas](/docs/pt/inventory/boxes)). A página é `console.muveya.com/inventory/boxes/` seguida da caixa.
  </Step>

  <Step title="Preencha Corrigir esta caixa">
    Na seção **Corrigir esta caixa**, escolha a **Correção**, digite a **Quantidade** e escolha o **Motivo**.
  </Step>

  <Step title="Registre">
    Selecione **Registrar correção**. O botão fica desativado até que a quantidade seja um número inteiro de pelo menos 1.
  </Step>

  <Step title="Leia o resultado">
    Abaixo do botão, o formulário diz **Correção registrada.** quando a correção foi aplicada, ou **Enviada para aprovação. Outra pessoa com permissão para corrigir o estoque precisa aprová-la.** com o link **Ver correções de estoque** quando ela precisa aguardar uma segunda pessoa.
  </Step>
</Steps>

### Campos

| Campo | Opções e regras |
| - | - |
| **Correção** | **Subtrair do registro** (uma saída, a opção padrão) ou **Somar ao registro** (uma entrada). |
| **Quantidade** | Número inteiro de 1 a 1.000.000, na unidade base do insumo (a mesma unidade que **Em mãos** mostra na caixa). Uma saída nunca pode deixar a caixa abaixo de zero. |
| **Motivo** | Um dos códigos de motivo abaixo. Obrigatório. O padrão é **Correção de contagem**. |

Ao lado do formulário, o link **Contar este insumo aqui** abre uma contagem rápida desse insumo no depósito da caixa. Se você não tem certeza de quantas unidades existem de fato, conte em vez de estimar: veja [Contagens físicas](/docs/pt/inventory/counts).

Se a mesma correção chegar duas vezes ao muveya (um toque duplo ou uma nova tentativa depois de perder a conexão), ela é registrada uma única vez e o formulário diz **Já estava registrado.** Depois de uma correção bem-sucedida a quantidade é apagada, e a próxima correção que você registrar é tratada como nova.

## Motivos

Uma correção sempre leva um código de motivo. O console oferece uma lista fechada, para que todas as correções possam ser comparadas entre si. A mesma lista é usada nas diferenças de contagem.

| Código de motivo | Rótulo no console |
| - | - |
| `count_correction` | **Correção de contagem** |
| `damaged` | **Danificado** |
| `unrecorded_use` | **Uso não registrado** |
| `other` | **Outro** |

O motivo fica gravado no movimento do registro (e na solicitação pendente, quando existe). Uma correção não tem campo de texto livre.

## Quando uma correção precisa de uma segunda pessoa

Cada insumo em cada depósito tem um **limite de aprovação efetivo**. Uma correção cuja quantidade é **maior** que esse limite não é aplicada: ela vira uma solicitação pendente.

| Situação | Limite efetivo | Resultado |
| - | - | - |
| Nenhum limite definido para o insumo nesse depósito | 100 | Uma correção de 100 é aplicada; uma de 101 aguarda. |
| Limite definido no formulário de mínimo (0 a 100) | O valor definido | Com 5, uma correção de 5 é aplicada; uma de 6 aguarda. |
| Limite definido como 0 | 0 | Toda correção aguarda. |
| O insumo está marcado como **Insumo de alto valor** no catálogo | 0 | Toda correção aguarda, independentemente do limite. |
| O muveya não consegue ler o insumo | 0 | Toda correção aguarda. |

Um limite só pode deixar a regra mais rígida: nenhuma configuração permite uma correção acima de 100 sem uma segunda pessoa. O limite é definido no campo **Limite de aprovação** do formulário de mínimo, descrito em [Reposição e alertas de estoque](/docs/pt/inventory/replenishment-and-alerts). Nas diferenças de contagem, a quantidade comparada é a diferença entre o contado e o esperado.

Mais duas regras se aplicam às correções pendentes:

* **Uma por vez por caixa.** Enquanto uma correção de uma caixa aguarda, outra correção da mesma caixa que também precise de aprovação é recusada com **Esta caixa já tem uma correção aguardando aprovação.**
* **O que a pessoa solicitante viu fica congelado.** A solicitação guarda a quantidade em mãos da caixa, seu último movimento físico e o limite vigente quando foi criada. A aprovação só é aplicada se a caixa não mudou fisicamente desde então.

```mermaid theme={null}
flowchart TD
  A[Registrar correção] --> B{Quantidade acima do limite?}
  B -- Não --> C[Movimento de correção gravado]
  B -- Sim --> D[Pendente em Correções de estoque]
  D --> E{Outra pessoa decide}
  E -- Aprova, caixa sem mudanças --> C
  E -- Aprova, caixa mudou --> F[Desatualizada: nada é gravado]
  E -- Rejeita --> G[Rejeitada: nada é gravado]
  D -- Quem solicitou retira --> H[Retirada: nada é gravado]
```

## A tela Correções de estoque

Selecione **Correções de estoque** na navegação principal, ou o link **Correções de estoque** na tela **Estoque**. A página é `console.muveya.com/inventory/approvals`. A descrição diz: "As correções acima do limite aguardam aqui até que outra pessoa com permissão as aprove."

Todos os membros veem a entrada; a lista só carrega para membros com `inventory.read`, e só para os depósitos que o acesso deles alcança.

### Filtro e colunas

Use **Mostrar** para alternar entre **Pendentes** (o padrão) e **Decididas**. As solicitações aparecem da mais recente para a mais antiga, de 20 em 20. Quando há mais, a tela diz **Há mais solicitações do que as exibidas. Decida estas para ver as próximas.**

| Coluna | O que mostra |
| - | - |
| **Insumo** | O nome e o SKU do insumo, por exemplo `Luvas de nitrilo M · GLV-NIT-M`. |
| **Depósito** | O depósito da caixa. |
| **Caixa** | O código impresso da caixa, por exemplo `BX-000123`. |
| **Mudança** | A quantidade com sinal e a unidade, por exemplo `−12 Unidade` para uma saída ou `+3 Unidade` para uma entrada. |
| **Origem** | **Correção** para uma correção registrada na página da caixa, ou **Contagem: contado 88, esperado 100** para uma diferença de contagem. |
| **Motivo** | O rótulo do motivo. |
| **Solicitado por** | O nome de quem solicitou, ou **Um membro da equipe** quando o nome não está disponível. |
| **Quando** | Quando a correção foi solicitada. |
| **Decisão** | O que você pode fazer, ou o que foi decidido. |

### O que a coluna Decisão oferece a você

| Você é | Você vê |
| - | - |
| Um membro com `inventory.adjust` que não a solicitou | **Aprovar** e **Rejeitar** |
| Quem solicitou | **Aguardando outra pessoa** e **Retirar** |
| Um membro sem `inventory.adjust` | **Somente um membro que pode corrigir o estoque decide** |

### Aprovar

<Steps>
  <Step title="Confira a solicitação">
    Leia o insumo, a caixa, a mudança, a origem e o motivo. Se puder, olhe a caixa na prateleira.
  </Step>

  <Step title="Selecione Aprovar">
    O muveya confere de novo, naquele momento, que a caixa continua ativa, no mesmo depósito e sem movimentos físicos desde a solicitação. Em uma contagem, também confere se a contagem continua em andamento e se a janela de medição continua válida.
  </Step>

  <Step title="Leia o resultado">
    **Aprovada. A correção foi registrada.** A solicitação passa para **Decididas** como **Aprovada por** seguido do seu nome.
  </Step>
</Steps>

Se a caixa mudou depois da solicitação, nada é gravado: a solicitação fica desatualizada e você vê **A caixa mudou; é preciso solicitar a correção ou contar novamente.** Só contam como mudança os movimentos físicos (recebimentos, consumos, transferências, separações, retiradas para pedidos, despachos, devoluções, correções, quarentena, vencimento e descarte). Reservar ou liberar unidades para um pedido não desatualiza uma solicitação.

### Rejeitar

Selecione **Rejeitar**. Abre uma caixa de diálogo com o título **Rejeitar esta correção** e um campo opcional **Motivo (opcional)** de até 500 caracteres. Selecione **Rejeitar** de novo para confirmar, ou **Cancelar** para voltar. O resultado é **Rejeitada. Nada mudou no estoque.**

O motivo da rejeição é gravado com a decisão e na auditoria, mas a lista **Decididas** não o exibe.

### Retirar

Se você solicitou a correção e ela não é mais necessária (por exemplo, você encontrou as unidades que faltavam), selecione **Retirar**. O resultado é **Retirada. Nada mudou no estoque.** Só quem solicitou pode retirar.

### Solicitações decididas

| Aparece como | Status | O que aconteceu |
| - | - | - |
| **Aprovada por** e um nome | `approved` | Um movimento de correção foi gravado. |
| **Rejeitada por** e um nome | `rejected` | Nada foi gravado. |
| **Retirada** | `withdrawn` | Quem solicitou retirou. Nada foi gravado. |
| **Desatualizada: a caixa mudou** | `stale` | Alguém tentou aprovar depois que a caixa mudou. Nada foi gravado; solicite a correção de novo ou conte a caixa novamente. |

Estados vazios: **Nada aguardando aprovação.** e **Ainda não há correções decididas.**

## Separação de funções

* **Duas pessoas, duas sessões.** Quem aprova é sempre a pessoa conectada que seleciona **Aprovar**. Ninguém pode ser indicado como aprovador com antecedência, e a solicitação não é enviada a uma pessoa específica: qualquer pessoa habilitada pode decidir.
* **Você não pode aprovar sua própria solicitação.** Se tentar (por exemplo, em outra aba), o muveya recusa com **Você não pode aprovar sua própria solicitação.** e registra a tentativa recusada na auditoria.
* **Quem aprova precisa da mesma autoridade.** Precisa ter `inventory.adjust` e acesso ao depósito da caixa.
* **As duas pessoas ficam no registro.** O movimento de correção indica quem solicitou como a pessoa que registrou e quem aprovou como segunda pessoa.
* **Só uma decisão vale.** Se duas pessoas aprovarem ao mesmo tempo, só uma correção é gravada. A outra pessoa vê **Alguém já decidiu esta solicitação.**

## O que fica no registro

* **Um movimento de correção.** Uma entrada é gravada como `adjust_gain` e aparece em **Movimentos** da caixa como **Correção (entrada)**; uma saída é gravada como `adjust_loss` e aparece como **Correção (saída)**. O movimento leva a quantidade, o código de motivo, o depósito, quem registrou e, se foi aprovado, quem aprovou.
* **Nunca uma edição.** Para desfazer uma correção errada, registre a correção oposta com um motivo. A primeira continua no histórico.
* **Nada enquanto aguarda.** Uma solicitação pendente, rejeitada, retirada ou desatualizada não grava nada no registro.
* **Uma caixa que chega a zero.** Uma saída que deixa a caixa com 0 em mãos a marca como **Esgotada**. Uma caixa esgotada não aceita mais movimentos, então não pode ser corrigida depois. Se mais tarde aparecerem unidades dessa caixa, registre-as com [Receber estoque](/docs/pt/inventory/receive).
* **Auditoria.** Cada etapa deixa um evento de auditoria:

| Ação de auditoria | Quando |
| - | - |
| `inventory.adjust` | Um movimento de correção foi gravado (direto ou após a aprovação). |
| `inventory.adjust.requested` | Uma correção foi enviada para aprovação. |
| `inventory.adjust.approved` | Outra pessoa aprovou. |
| `inventory.adjust.rejected` | Outra pessoa rejeitou. |
| `inventory.adjust.withdrawn` | Quem solicitou retirou. |
| `inventory.adjust.stale` | Uma aprovação encontrou a caixa alterada. |
| `inventory.adjust.denied` | Alguém tentou aprovar a própria correção. |

Os eventos de auditoria levam apenas identificadores, quantidades, códigos de motivo e datas, nunca custos nem dados de pacientes.

## Saídas e reservas

Uma saída reduz o que a caixa tem em mãos. Ela **não** cancela as unidades que a caixa reserva para pedidos aprovados (a quantidade **Reservado**), e o muveya nunca inventa unidades para cobri-las.

* Uma saída não pode ser maior do que a quantidade em mãos da caixa. Uma saída dentro do limite é recusada na hora com **A caixa não tem essa quantidade.**; uma saída que aguarda aprovação é conferida no momento da aprovação e, se a caixa não tiver mais essa quantidade, a solicitação termina desatualizada.
* Uma saída pode deixar a caixa com menos unidades em mãos do que as reservadas. Na tela **Estoque**, **Disponível** (em mãos menos reservado) passa a mostrar um número negativo: esse é o **déficit** que esses pedidos enfrentam.
* A tela **Reposição** (veja [Reposição e alertas de estoque](/docs/pt/inventory/replenishment-and-alerts)) conta uma caixa com déficit como zero unidades utilizáveis, nunca como número negativo, para que o excedente de outra caixa não o esconda.
* Uma caixa é despachada inteira, então uma caixa cuja quantidade em mãos não coincide mais com o que um pedido reservou não pode ser despachada para esse pedido (veja [Preparar e despachar um pedido](/docs/pt/deliveries/picking)). Revise os pedidos que dependem dessa caixa em [Criar e acompanhar pedidos](/docs/pt/orders/create-and-track).

## O que pode dar errado

| Mensagem | Código | O que fazer |
| - | - | - |
| **Esta caixa já tem uma correção aguardando aprovação.** | `inventory.adjustment_already_pending` | Abra **Correções de estoque**. Quem solicitou pode retirar; qualquer outra pessoa habilitada pode aprovar ou rejeitar. Depois registre a correção novamente. |
| **A caixa não tem essa quantidade.** | `inventory.insufficient_stock` | Confira **Em mãos** na caixa. Conte a caixa se o número parecer errado. |
| **Você não pode aprovar sua própria solicitação.** | `inventory.second_actor_required` | Peça a outro membro com **Ajustar e contar estoque** que decida. |
| **A caixa mudou; é preciso solicitar a correção ou contar novamente.** | `inventory.adjustment_request_stale` | Confira os movimentos da caixa e depois registre a correção novamente ou conte a caixa. |
| **Alguém já decidiu esta solicitação.** | `inventory.adjustment_request_not_pending` | Mude **Mostrar** para **Decididas** para ver o resultado. |
| **Sua conta não tem permissão para esta ação.** | `common.forbidden` | Falta `inventory.read` ou `inventory.adjust`. Peça a um administrador. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | `inventory.box_not_found`, `inventory.adjustment_request_not_found` | A caixa ou a solicitação não existe nos seus depósitos. Confira a clínica odontológica ativa e o seu acesso na equipe. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | Por exemplo `inventory.box_state_conflict`, `inventory.measurement_unverified` | A caixa não está mais ativa ou a unidade dela precisa de revisão. Recarregue a página da caixa antes de tentar de novo. |
| **Confira os dados informados antes de tentar novamente.** | `common.invalid_request` | Confira a quantidade e o motivo. |
| **Não foi possível concluir a solicitação. Tente novamente.** | Qualquer outra falha | Tente de novo. Se persistir, escreva para [team@muveya.com](mailto:team@muveya.com). |

<Note>
  Registrar uma correção e decidir uma correção são ações marcadas como sensíveis. Na versão atual o segundo fator é opcional e não as bloqueia. Mesmo assim, você pode configurá-lo em [Segurança da conta](/docs/pt/account/security).
</Note>

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Visão geral do estoque" icon="boxes-stacked" href="/docs/pt/inventory/overview">
    Saldos das caixas, status e todos os movimentos do registro.
  </Card>

  <Card title="Caixas e etiquetas" icon="box" href="/docs/pt/inventory/boxes">
    Encontre uma caixa, leia os movimentos e tire-a de uso.
  </Card>

  <Card title="Contagens físicas" icon="clipboard-list" href="/docs/pt/inventory/counts">
    Conte um insumo e transforme diferenças em correções.
  </Card>

  <Card title="Reposição e alertas de estoque" icon="bell" href="/docs/pt/inventory/replenishment-and-alerts">
    Defina mínimos e o limite de aprovação.
  </Card>

  <Card title="Funções e permissões" icon="user-shield" href="/docs/pt/account/roles-and-permissions">
    O que **Ajustar e contar estoque** permite.
  </Card>

  <Card title="Criar e acompanhar pedidos" icon="cart-shopping" href="/docs/pt/orders/create-and-track">
    Pedidos que têm unidades reservadas.
  </Card>
</CardGroup>


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