Cadastro de Recebimento
Módulo: Compras Caminho na aplicação: Menu > Compras > Recebimentos > "Novo recebimento" ou ícone Editar em um recebimento existente Última atualização: 20/04/2026
Para que serve
Registra a entrada física de mercadorias oriundas de um pedido de compra confirmado. Ao confirmar o recebimento, o sistema atualiza o estoque no depósito selecionado, registra lotes (quando aplicável) e atualiza as quantidades recebidas no pedido de compra.
Quem pode usar
Usuários com acesso ao módulo Compras.
Como usar (passo a passo)
Criação
- Na Lista de Recebimentos, clique em Novo recebimento.
- Se vier da tela do pedido de compra (botão "Novo recebimento"), o pedido já é pré-selecionado.
- Se vier da listagem de recebimentos sem pedido pré-selecionado, selecione o pedido de compra de origem (apenas pedidos confirmados ou parcialmente recebidos aparecem na lista) e clique em Continuar.
- Informe o Depósito de entrada e a Data de recebimento.
- Informe os dados da NF-e do fornecedor (chave, número e série), se disponíveis.
- Na tabela de Itens do pedido, marque o checkbox de cada item que está sendo recebido neste ato.
- Ajuste a quantidade a receber (preenchida automaticamente com o saldo restante do pedido) e o valor unitário de cada item selecionado.
- Para produtos que controlam lote, expanda a linha (seta à esquerda) e informe o número do lote (obrigatório), data de fabricação e data de validade.
- Clique em Salvar. O sistema redireciona para a tela de edição com o número gerado (
RB<numero>).
Edição (situação Rascunho)
- Clique no ícone Editar (lápis) na linha do recebimento na listagem.
- Altere os campos desejados (depósito, data, NF-e, itens selecionados, quantidades, valores).
- Clique em Salvar para gravar. Os dados são recarregados da API.
Confirmação
- Com o recebimento em rascunho salvo, clique em Confirmar recebimento.
- Leia o aviso: a confirmação registra a entrada de estoque, cria o lote (se aplicável) e atualiza a quantidade recebida no pedido.
- Confirme. O recebimento passa para "Confirmado" e os campos ficam somente leitura.
Cancelamento
Disponível apenas para recebimentos confirmados.
- Clique em Cancelar recebimento.
- Leia o aviso: o estoque será estornado e as movimentações de entrada serão revertidas.
- Informe o motivo (mínimo 3, máximo 255 caracteres) e confirme.
- O recebimento passa para "Cancelado".
Remoção
Disponível apenas para recebimentos em rascunho.
- Clique em Remover e confirme.
- O recebimento é excluído e o usuário é redirecionado para a listagem.
Campos da tela
Seção: Dados do recebimento
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Depósito de entrada | Sim | Selecione o depósito onde a mercadoria será armazenada | Lista apenas depósitos ativos da filial do pedido |
| Data de recebimento | Sim | Data em que os produtos foram recebidos (DD/MM/AAAA) | Padrão: data atual |
| Chave NF-e do fornecedor | Não | Chave de 44 dígitos da nota fiscal do fornecedor | — |
| Número NF-e | Não | Número da nota fiscal do fornecedor | Inteiro, sem separador de milhar |
| Série | Não | Série da nota fiscal (até 5 caracteres) | — |
| Observações | Não | Texto livre (máximo 500 caracteres) | — |
Seção: Pedido de compra (informativo, somente leitura)
Exibe o número do pedido de compra, o fornecedor, a situação do pedido e o valor total.
Seção: Itens do pedido
| Coluna | Descrição |
|---|---|
| (checkbox) | Marca o item para inclusão neste recebimento |
| Produto | Nome do produto; exibe "Controla lote" quando aplicável |
| Un. | Unidade transacionada do item (vinda do pedido de compra / XML). Convertida para unidade padrão na movimentação de estoque usando fator_estoque_snapshot |
| Pedido | Quantidade total do item no pedido |
| Já rec. | Quantidade já recebida em recebimentos anteriores |
| A receber | Quantidade a receber neste ato (editável; máximo = pedido − já rec.) |
| Valor un. | Valor unitário de compra (editável) |
| Total | Quantidade a receber × valor unitário em R$ |
Expansão de lote (linha expandível — produtos com controle de lote)
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Número do lote | Sim (quando produto controla lote e item selecionado) | Código ou número do lote do fabricante | — |
| Data fabricação | Não | Data de fabricação (DD/MM/AAAA) | — |
| Data validade | Não | Data de validade (DD/MM/AAAA) | — |
Totalizador
Exibido no cabeçalho da seção de itens: Total a receber = soma de (quantidade a receber × valor unitário) dos itens selecionados.
Validações e regras
- Só é possível criar um recebimento a partir de um pedido de compra com situação "Confirmado" ou "Rec. Parcial".
- É obrigatório selecionar ao menos um item com quantidade maior que zero para salvar.
- Produtos que controlam lote exigem número do lote preenchido antes de salvar.
- A quantidade a receber não pode exceder o saldo restante (pedido − já recebido).
- Ao confirmar, o estoque é atualizado; ao cancelar, as movimentações são revertidas.
- Campos ficam bloqueados para edição após confirmação ou cancelamento.
- O depósito listado é filtrado pela filial do pedido de compra vinculado.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione o deposito" | Depósito de entrada não selecionado | Selecione um depósito na lista |
| "Obrigatorio" | Campo de data de recebimento não preenchido | Informe a data |
| "Selecione ao menos um item para receber" | Nenhum item marcado ou com quantidade > 0 | Marque ao menos um item e informe a quantidade |
| "Informe o numero do lote para o produto '...'" | Produto com controle de lote selecionado sem número de lote | Expanda a linha e informe o número do lote |
| "Informe o motivo" | Tentativa de cancelar sem preencher o motivo | Informe o motivo no campo exibido |
| "Recebimento atualizado" | Sucesso na atualização | — |
| "Recebimento criado" | Sucesso na criação | — |
| "Recebimento confirmado — estoque atualizado" | Sucesso na confirmação | — |
| "Recebimento cancelado" | Sucesso no cancelamento | — |
| "Recebimento removido" | Sucesso na remoção | — |
| "Erro ao carregar pedido de compra" | Falha ao buscar o pedido vinculado | Verifique a conexão e recarregue |
| "Erro ao carregar recebimento" | Falha ao buscar o recebimento | Verifique a conexão e recarregue |
| "Erro ao carregar pedidos" | Falha ao listar pedidos na tela de seleção | Verifique a conexão e recarregue |
| — | Excesso de quantidade | ⚠️ CONFIRMAR |
Integrações e dependências
- Lista de Recebimentos — tela de origem.
- Cadastro de Pedido de Compra — pedido de origem obrigatório; a situação do pedido é atualizada após confirmação.
- Depósitos — necessário cadastrar ao menos um depósito ativo na filial.
- Estoque — confirmação cria movimentação de entrada; cancelamento reverte.
- Lotes — criados automaticamente na confirmação para produtos com controle de lote.
Dúvidas frequentes
Posso receber parcialmente um pedido? Sim. Marque apenas os itens disponíveis e informe as quantidades. O pedido passará para "Rec. Parcial" e será possível criar novos recebimentos para o saldo restante.
O que acontece com o estoque ao cancelar um recebimento confirmado? As movimentações de entrada são revertidas, diminuindo o estoque das quantidades que haviam sido lançadas.
Posso criar um recebimento sem vinculá-lo a um pedido de compra? Não. Todo recebimento precisa de um pedido de compra em situação "Confirmado" ou "Rec. Parcial".
O campo "Já rec." já inclui recebimentos em rascunho?
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |