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

# Receber estoque

> Receba uma entrega em um depósito como uma caixa nova e etiquetada, com o lote, os números de série e a validade que o insumo exige

Receber transforma o que chegou em estoque. Cada recebimento cria **uma caixa nova** em um depósito, grava um movimento `receive` no registro de movimentos e dá à caixa um código que você pode imprimir como etiqueta. Se uma entrega traz vários recipientes que você quer acompanhar separadamente, receba cada um como uma caixa própria.

## Quem pode fazer

* A permissão `inventory.receive` (**Receber entregas**), ou `inventory.adjust`, que a inclui.
* Acesso ao depósito onde você recebe. Só aparecem depósitos ativos do seu acesso.

Quem não tem a permissão não vê o link **Receber**. Se abrir a tela mesmo assim, vê **Você não tem permissão para receber entregas. Peça a um administrador a permissão “Receber entregas”.**

## Onde

**Inventário** na navegação principal e depois **Receber** no topo da tela **Estoque**. O caminho direto é `console.muveya.com/inventory/receive`. A tela tem o título **Receber**: "Escaneie o código do fornecedor ou escolha o insumo, confirme o que chegou e diga quantas."

## Antes de começar

* O insumo precisa existir e estar ativo no [catálogo](/docs/pt/catalog/items), com sua unidade de medida.
* Para receber escaneando, o código do fornecedor precisa estar cadastrado em uma das apresentações do insumo. Veja [Apresentações e códigos](/docs/pt/catalog/presentations-and-codes).
* Confira o que o insumo controla (lote, números de série, data de validade). A tela só pede o que o insumo controla, e exige tudo.

## Passo a passo

Primeiro, em **Como encontrar o que chegou**, escolha **Escanear um código** (selecionado ao abrir a tela) ou **Escolher o insumo**.

<Tabs>
  <Tab title="Escanear um código">
    <Steps>
      <Step title="Leia o código">
        O campo **Código do fornecedor** já fica ativo ao abrir a tela, então um leitor de código de barras pode digitar direto nele. Escaneie ou digite o código e pressione **Buscar**. Enquanto busca, você vê **Buscando…**.
      </Step>

      <Step title="Confira o que o código encontrou">
        Se houver uma correspondência, aparece um cartão com o nome da apresentação, o insumo (nome e SKU) e o conteúdo, por exemplo **Contém 100 × Unidade**. A quantidade que você informar em seguida é uma quantidade dessa apresentação.
      </Step>

      <Step title="Se o código corresponde a mais de uma apresentação">
        A tela diz **Este código corresponde a mais de uma apresentação. Escolha a que chegou.** e lista cada candidata com a apresentação, o insumo, o tipo de código e o código, por exemplo `Caixa com 100 · Luvas de nitrilo M (GTIN 07501234567893)`. Selecione a que chegou. Uma candidata marcada **Retirada: não aceita mais novas entradas.** não pode ser recebida.
      </Step>

      <Step title="Se o código não está cadastrado">
        A tela diz **Esse código ainda não está vinculado a um insumo. Abra o insumo no catálogo e adicione o código em Apresentações, ou escolha o insumo para recebê-lo sem código.** Use **Abrir o catálogo** para cadastrá-lo ou mude para **Escolher o insumo**.
      </Step>
    </Steps>

    Se o dígito verificador do código impresso não bater, você vê **O código impresso não corresponde ao seu dígito verificador. Você ainda pode recebê-lo.** A mercadoria pode ser recebida mesmo assim.
  </Tab>

  <Tab title="Escolher o insumo">
    <Steps>
      <Step title="Busque o insumo">
        Digite em **Buscar insumos** ("Digite parte do nome ou o código do insumo."). A busca ignora maiúsculas e acentos e só lista insumos ativos. Aparecem até 8 resultados em **Insumos encontrados**; se houver mais, você vê uma linha como **Mostrando 8 de 12. Continue digitando para reduzir a lista.**
      </Step>

      <Step title="Selecione">
        Selecione um resultado. Ele aparece em **Insumo**, com **Trocar insumo** para escolher outro.
      </Step>

      <Step title="Diga como chegou">
        Em **Chegou como** (**Escolha como chegou**), escolha uma das apresentações ativas do insumo, mostradas com nome e conteúdo (por exemplo `Caixa com 100 · 100 × Unidade`), ou **Unidades soltas** seguido da unidade base quando você conta unidades individuais.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Depois preencha o formulário de recebimento:

<Steps>
  <Step title="Quantas">
    Informe a quantidade em **Quantas** (para unidades soltas o campo diz **Quantas, em** seguido da unidade). Começa em 1 e precisa ser um número inteiro maior que zero.
  </Step>

  <Step title="Código da caixa (opcional)">
    Digite o código escrito no recipiente, ou deixe **Código da caixa (opcional)** vazio: "Deixe vazio e um código é gerado para a caixa."
  </Step>

  <Step title="Depósito">
    Escolha o **Depósito**. Se só houver um depósito disponível para você, ele já aparece escolhido.
  </Step>

  <Step title="Dados de rastreabilidade">
    Preencha **Número do lote**, **Data de validade** e **Números de série** quando aparecerem. Veja as regras abaixo.
  </Step>

  <Step title="Confira o total">
    A tela repete o resultado em unidades base, por exemplo **Entra como 300 × Unidade**. Confira antes de confirmar: essa é a quantidade que entra no registro.
  </Step>

  <Step title="Receber">
    Pressione **Receber**. O botão fica desativado até que tudo o que é obrigatório esteja completo.
  </Step>

  <Step title="Etiquete a caixa">
    A tela confirma **Recebido na caixa BX-7K3QM9.** com dois links: **Abrir a caixa BX-7K3QM9** e **Imprimir a etiqueta de BX-7K3QM9**. O formulário é limpo para o próximo item e, no modo de escaneamento, o campo do código volta a ficar ativo.
  </Step>
</Steps>

## Quantidades, apresentações e unidades de medida

* **Apresentação**: a quantidade é multiplicada pelo conteúdo da apresentação. Três caixas com 100 unidades entram como 300 unidades. A caixa guarda a apresentação, sua versão e a quantidade, que depois aparecem como **Recebida como** na caixa.
* **Unidades soltas**: a quantidade já está em unidades base.
* O registro sempre guarda unidades base. A unidade de medida do insumo é bloqueada quando ele é ativado no catálogo; um recebimento também a bloqueia se ainda não estava bloqueada.
* Só é possível receber apresentações ativas. Uma apresentação retirada enquanto você está na tela mostra **Esta apresentação está retirada e não aceita mais novas entradas.**
* Se alguém corrigir a apresentação enquanto você recebe, nada é recebido e a tela mostra o novo conteúdo, por exemplo **Esta apresentação foi corrigida enquanto você recebia: agora é Caixa com 50, 50 × Unidade (versão 3). Nada foi recebido: revise a quantidade e receba de novo.** Enquanto o novo conteúdo carrega, a tela diz **Esta apresentação foi corrigida enquanto você recebia. Nada foi recebido: carregando o que ela contém agora…**
* Se a unidade de medida do insumo mudar enquanto você recebe, nada é recebido: **A unidade deste insumo mudou enquanto você recebia. Nada foi recebido: revise a quantidade e receba de novo.**

## Lote, números de série e data de validade

| Campo | É pedido quando | Regras |
| - | - | - |
| **Número do lote** | O insumo controla lotes. | Obrigatório. Não pode ficar em branco. Até 120 caracteres. Espaços no início e no fim são removidos; o resto é gravado como foi digitado e é o que o [Recolhimento de lote](/docs/pt/inventory/lot-recall) busca. |
| **Data de validade** | O insumo controla validade. | Obrigatória. Precisa ser hoje ou uma data posterior (UTC). Uma data passada é recusada. |
| **Números de série** | O insumo controla números de série. | Exatamente um número de série por unidade base recebida (a quantidade multiplicada pelo conteúdo). A dica conta quantos foram informados, por exemplo **2 de 3 inseridos, separados por vírgulas ou quebras de linha**. O campo tem uma única linha e Enter envia o formulário, então separe-os com vírgulas. Sem vazios, sem repetidos, até 120 caracteres cada. Um número de série que já foi recebido para este insumo, em qualquer caixa e qualquer status, é recusado. |

Os campos de dados que o insumo não controla não aparecem e nada é gravado para eles. Quando faltam dados de rastreabilidade obrigatórios ou eles não são válidos, inclusive uma data de validade no passado, o recebimento é recusado com **Este insumo precisa do lote, dos números de série ou da data de validade para ser recebido. Confira-os e receba de novo.**

## Códigos de caixa

* Se você deixar o código vazio, o muveya gera um: `BX-` seguido de seis caracteres entre dígitos e letras maiúsculas, sem I, L, O nem U (por exemplo `BX-7K3QM9`), fácil de ditar e de copiar à mão.
* Um código digitado tem os espaços do início e do fim removidos, pode ter até 64 caracteres e precisa ser único na sua clínica odontológica. Um código já em uso mostra **Outra caixa já usa este código. Troque-o ou deixe vazio.** abaixo do campo.
* A etiqueta imprime o código como código de barras Code 128. Use letras sem acento, dígitos e símbolos comuns; um código com outros caracteres é impresso só como texto, sem código de barras.

Para imprimir a etiqueta, siga **Imprimir a etiqueta de** e depois **Imprimir etiqueta** na tela da caixa. Veja [Caixas e etiquetas](/docs/pt/inventory/boxes).

## O que o sistema registra

* Uma caixa nova com status **Ativa**: código, insumo, depósito, quantidade em unidades base, horário do recebimento (relógio do servidor), unidade de medida e, quando se aplicam, a apresentação (com versão e quantidade), o lote, os números de série e a data de validade.
* Um movimento `receive` (**Recebido**) que soma a quantidade ao que está em mãos, com você como a pessoa que registrou.
* Um saldo para a caixa: em mãos igual à quantidade, nada reservado.
* Os alertas de estoque do insumo são avaliados de novo pouco depois (veja [Reposição e alertas de estoque](/docs/pt/inventory/replenishment-and-alerts)).

## Novas tentativas: um recebimento nunca é registrado duas vezes

Cada recebimento que você inicia leva uma chave interna de operação que se mantém mesmo quando algo falha.

* Se a conexão cair ou o servidor não responder, a tela diz **Não foi possível confirmar se este recebimento foi registrado. Receba de novo com os mesmos dados: ele nunca será registrado duas vezes.** Pressione **Receber** de novo sem mudar nada. Ou o recebimento é registrado agora, ou você vê **Já estava registrado, na caixa BX-7K3QM9.** com a caixa que já existe.
* Um clique duplo ou pressionar várias vezes também cria uma única caixa.
* Se você mudar os dados e a primeira tentativa já tinha sido registrada, você vê **Uma tentativa anterior já foi registrada com outros dados. Confira o estoque antes de receber de novo.** Confira a tela **Estoque** filtrada pelo insumo. Depois dessa mensagem, o próximo **Receber** conta como um recebimento novo.
* Depois de um recebimento bem-sucedido o formulário é limpo e o próximo **Receber** é uma caixa nova. Duas entregas idênticas recebidas uma depois da outra são duas caixas, como deve ser.

## Regras e limites

| Regra | Limite |
| - | - |
| Quantidade | Número inteiro de 1 a 1.000.000. |
| Total em unidades base | Até 1.000.000.000. |
| Código da caixa | Opcional, até 64 caracteres, único na clínica odontológica. |
| Número do lote | Até 120 caracteres, não pode ficar em branco. |
| Números de série | Um por unidade base, únicos, até 120 caracteres cada. |
| Data de validade | Hoje ou posterior (UTC). |
| Depósito | Ativo e dentro do seu acesso a depósitos. |
| Apresentação | Ativa e do insumo escolhido. |

## O que pode dar errado

| Mensagem | Causa | O que fazer |
| - | - | - |
| **Você não tem um depósito onde receber. Peça acesso a um administrador.** | Nenhum depósito ativo está no seu acesso. | Peça a um administrador um depósito em [Equipe](/docs/pt/account/team). |
| **Nenhum insumo ativo corresponde a “gaze”.** | A busca não encontrou insumos ativos. | Tente outra palavra ou o SKU, ou crie o insumo no catálogo. |
| **Esta apresentação está retirada e não aceita mais novas entradas.** | A apresentação foi retirada. | Escolha outra apresentação ou **Unidades soltas**. |
| **Outra caixa já usa este código. Troque-o ou deixe vazio.** | O código de caixa digitado já existe. | Digite outro código ou deixe vazio. |
| **Este insumo precisa do lote, dos números de série ou da data de validade para ser recebido. Confira-os e receba de novo.** | Faltam dados de rastreabilidade ou eles não são válidos, ou a data de validade já passou. | Confira a embalagem e corrija os campos. |
| Uma mensagem que cita números de série, como **Estes números de série já foram recebidos para este insumo: SN-0042. Um número de série identifica uma única unidade: confira a embalagem ou corrija a caixa original com um ajuste.** | Um número de série pertence a uma caixa existente do insumo. Nada foi recebido. | Compare os números de série com a embalagem. Se a caixa anterior estiver errada, veja [Correções de estoque](/docs/pt/inventory/corrections). |
| **Esta apresentação foi corrigida enquanto você recebia…** | A apresentação mudou depois que você a abriu. Nada foi recebido. | Confira o novo conteúdo e a quantidade e receba de novo. |
| **A unidade deste insumo mudou enquanto você recebia. Nada foi recebido: revise a quantidade e receba de novo.** | A unidade de medida do insumo mudou. | Revise a quantidade e receba de novo. |
| **Uma tentativa anterior já foi registrada com outros dados. Confira o estoque antes de receber de novo.** | Uma tentativa anterior foi registrada com outros dados. | Confira o estoque antes de receber de novo. |
| **Não foi possível confirmar se este recebimento foi registrado. Receba de novo com os mesmos dados: ele nunca será registrado duas vezes.** | O servidor não respondeu. | Pressione **Receber** de novo com os mesmos dados. |
| **Confira os dados informados antes de tentar novamente.** | Um valor está fora dos limites, por exemplo um código de caixa com mais de 64 caracteres. | Corrija o valor. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | O depósito foi desativado, ou a unidade de medida do insumo não está confirmada no catálogo. | Escolha um depósito ativo ou peça a quem administra o catálogo que confirme a unidade. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | O insumo ou o depósito não existe mais ou está fora do seu acesso. | Recarregue e escolha de novo. |
| **Sua conta não tem permissão para esta ação.** | Sua permissão foi removida. | Fale com um administrador. |

## Receber pelo WhatsApp

Membros vinculados ao WhatsApp também podem receber estoque pelo celular. Esses recebimentos seguem as mesmas regras e caem no mesmo registro. Veja [Operações pelo WhatsApp](/docs/pt/whatsapp/operations).

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Caixas e etiquetas" icon="box-open" href="/docs/pt/inventory/boxes">
    Abra a caixa nova e imprima a etiqueta.
  </Card>

  <Card title="Apresentações e códigos" icon="barcode" href="/docs/pt/catalog/presentations-and-codes">
    Cadastre os códigos do fornecedor para poder escaneá-los.
  </Card>

  <Card title="Visão geral do estoque" icon="boxes-stacked" href="/docs/pt/inventory/overview">
    Saldos, status e registro de movimentos.
  </Card>

  <Card title="Entrega e recebimento" icon="truck" href="/docs/pt/deliveries/delivery-and-receipt">
    Receber caixas que chegam de um pedido é outro fluxo.
  </Card>
</CardGroup>


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