Pular para o conteúdo principal

Recebimento

A tela Recebimento é o centro de comando da entrada de mercadoria no CD. Cobre o ciclo inteiro: importar a NF-e de entrada (ou criar o recebimento manualmente a partir do fornecedor / pedido de compra), conferir os volumes que chegaram fisicamente, registrar lotes/validades, lançar os pagamentos do fornecedor, autorizar o checkin e a finalização (quando a empresa usa duplo workflow comercial+operacional), gerar pedidos de devolução para itens divergentes e, ao final, entrar o estoque, registrar custos e disparar webhooks e e-mails.

A tela é grande porque o recebimento concentra responsabilidades fiscal, operacional, financeira e contábil. O fluxo padrão é: criar o recebimento → importar XML ou bipar os itens → iniciar a conferência → bipar fisicamente o que chegou → autorizar (se houver workflow) → lançar pagamentos → finalizar. A tela também tem uma versão mobile específica (subdomínio wms) com bipagem por chave de acesso, captura de foto da etiqueta e leitura automática de lote/validade por inteligência artificial.

As configurações que mudam o comportamento — agendamento obrigatório, duplo workflow de aprovação, criação automática de SKU pelo XML, descontos de impostos no custo, dias mínimos de validade, envio de e-mail e webhook ao finalizar, transferências automáticas de divergências — ficam em Configurações → Parametrizações (vários grupos: Fiscal Recebimento Produto, WMS Recebimento, Produto) e estão resumidas no final desta página.

Índice​

Conceito

Criação e edição

Itens do recebimento

Conferência (desktop)

Recebimento no celular (mobile WMS)

Pagamentos

Finalização e aprovações

Cancelamento e correções

Regras de negócio

Configurações

Referência rápida

O que é a tela Recebimento?​

É a tela onde o time do CD registra a entrada de mercadoria vinda de fornecedores. Cada recebimento agrupa uma NF-e (importada ou lançada manualmente), os itens que entraram fisicamente no estoque, os pagamentos da nota e o histórico de conferência. A partir dela, você importa o XML da NF, bipa os volumes que chegaram, cadastra lote e validade, autoriza o checkin (quando há workflow), lança pagamentos e, ao finalizar, entra o estoque, atualiza o custo médio do SKU, ativa as contas a pagar e dispara webhooks.

📍 Onde: menu lateral → Logística → Recebimento.

Como funciona o fluxo completo (criação até finalização)?​

O recebimento atravessa etapas bem definidas:

  1. Criação — o operador cria um recebimento (por fornecedor manual, por XML do Feed NF ou via pedido de compra). Status inicial: Aberto (0).
  2. Adicionar itens — se foi por XML, os itens já vêm preenchidos com impostos. Se foi manual, o operador adiciona produto por produto (bipando ou pelo botão Adicionar SKU). Pode também conciliar contra o pedido de compra vinculado.
  3. Conferência — quando a mercadoria chega fisicamente, o operador inicia a conferência (status passa para Em conferência, 3). Confere bipando cada produto, registrando lote e validade. Pode ser feita no computador ou no celular (WMS).
  4. Aprovação de checkin (se a empresa usa duplo workflow) — a conferência pode parar em Aguardando validação comercial (5) ou operacional (6), exigindo aprovação por privilégio antes de seguir.
  5. Pagamentos — em paralelo, o time financeiro lança os títulos a pagar do fornecedor (com retenções fiscais quando aplicável).
  6. Finalização — quando tudo está conferido e os pagamentos estão registrados, o operador clica em Finalizar. O sistema entra o estoque, atualiza o custo médio do SKU, libera as contas a pagar para o financeiro, envia e-mail para a lista configurada e dispara webhook para integrações externas.
  7. Aprovação de finalização (se duplo workflow) — a finalização pode passar por Aguardando validação comercial (10) ou operacional (12) antes de chegar ao status final Finalizado (1).

Em qualquer etapa antes da finalização, o recebimento pode ser Cancelado (status 2), ou reaberto (volta para Aberto) se já estava finalizado — desde que não tenha havido venda dos produtos.

Qual a diferença entre Recebimento, Pedido de Compra e Feed NF?​

Pedido de CompraFeed NFRecebimento (esta tela)
Quando ocorreAntes da entrega: a empresa formaliza a compra.Quando o fornecedor emite a NF-e — o XML chega automaticamente pela SEFAZ.Quando a mercadoria chega fisicamente no CD.
FocoNegociação e expectativa.Manifestação fiscal (ciência, confirmação, desconhecimento).Conferência física, entrada de estoque e custo.
OndeCompras → Pedidos de Compra.Notas Fiscais → Feed NF.Logística → Recebimento.
VínculoPode gerar um Recebimento (botão Receber).Pode virar Recebimento via Novo Recebimento → Feed NFE.Vincula ao pedido de compra (pelo código) e à NF do Feed (chave de acesso).

As três telas trabalham em sequência: o pedido de compra antecipa o que vai chegar; o feed NF mostra o que o fornecedor emitiu; o recebimento confere o que efetivamente entrou no estoque.

O que significa cada status do recebimento?​

O recebimento tem 13 status possíveis — o conjunto é maior que o usual porque a empresa pode ter um duplo workflow de aprovação (comercial e operacional) em dois pontos do fluxo: na entrada para conferência (checkin) e na finalização.

StatusSignificado
Aberto (0)Estado inicial. O recebimento pode receber itens, ser editado, vinculado a pedido de compra, ter pagamentos lançados ou ser cancelado.
Finalizado (1)Recebimento concluído: estoque entrou, custo do SKU atualizado, contas a pagar ativadas. Pode ser reaberto se nada foi vendido.
Cancelada (2)Recebimento cancelado (cancela contas a pagar e remove os movimentos de estoque).
Em conferência (3)Conferência iniciada. O operador está bipando os volumes no chão do CD.
Conferência realizada (4)Conferência finalizada pelo operador, aguardando finalização.
Aguardando validação comercial (checkin) (5)Bloqueado: alguém com o privilégio Autorizar checkin recebimento ag. liberação comercial precisa aprovar antes de seguir.
Aguardando validação operacional (checkin) (6)Mesmo bloqueio, mas para o privilégio Autorizar checkin recebimento ag. liberação operacional.
Recebimento autorizado(7) Checkin aprovado — pode iniciar/seguir a conferência.
Recebimento recusado(8) Checkin recusado — não segue.
Finalização autorizada(9) Finalização aprovada — entrou no fluxo final.
Aguardando validação comercial (finalização) (10)Tentou finalizar mas precisa de Autorizar finalização recebimento ag. liberação comercial.
Finalização recusada(11) Finalização recusada — não conclui.
Aguardando validação operacional (finalização) (12)Igual ao 10, mas para o privilégio Autorizar finalização recebimento ag. liberação operacional.

Operações simples (sem duplo workflow) usam só Aberto (0), Em conferência (3), Conferência realizada (4) e Finalizado (1). Os demais aparecem quando as parametrizações de validação estão ativas.

Como criar um Novo Recebimento por fornecedor?​

Útil quando o fornecedor ainda não emitiu a NF-e ou quando a empresa não usa o feed NF — você cria o recebimento manualmente e adiciona os itens depois (ou importa o XML mais tarde):

  1. Na tela Recebimento, clique em Novo Recebimento.
  2. Selecione a * Conta (quando a empresa opera com mais de uma conta) e o * Centro de distribuição que vai receber.
  3. Em Criar recebimento por, escolha Fornecedor.
  4. Selecione (opcionalmente) a Empresa (filial faturadora) e o * Fornecedor. Ao escolher o fornecedor, o sistema verifica se há pedidos de compra disponíveis com aquele fornecedor.
  5. Se aparecer a opção Vincular pedido de compra, escolha o pedido — assim o recebimento já carrega os itens esperados para conciliação.
  6. Clique em Salvar. O sistema cria o recebimento em status Aberto e abre a tela de detalhe em uma nova aba para você adicionar itens, importar XML ou lançar pagamentos.

Pré-requisito: privilégio Criar recebimento.

Como criar um Recebimento via Feed NF (XML automático)?​

Quando o fornecedor já emitiu a NF-e e ela apareceu no Feed NF, é mais rápido importar direto a partir do feed:

  1. Na tela Recebimento, clique em Novo Recebimento.
  2. Selecione a * Conta e o * Centro de distribuição.
  3. Em Criar recebimento por, escolha Feed NFE.
  4. Em * FEED NFE (últimos 7 dias), selecione a NF que quer importar (o campo lista as NFs do feed dos últimos 7 dias).
  5. Em * Importar via, escolha o critério de matching dos SKUs:
    • Todos — tenta na ordem (código de referência → código fornecedor → código integração → código de barras).
    • Código Fornecedor — usa cProd do XML.
    • Código de Barras — usa cEAN.
    • Código de Referência — usa o código de referência interna do SKU.
    • Código Integração — usa o código no canal de venda (hub).
  6. Selecione o * ARMAZÉM onde os produtos vão entrar.
  7. Clique em Salvar. O sistema cria o recebimento e já popula todos os itens (com impostos do XML), os pagamentos (duplicatas do XML) e abre a tela de detalhe em nova aba.

Se nenhum SKU bater pelo critério escolhido, o sistema avisa quais ficaram fora. Quando a parametrização Criar SKU automaticamente no XML está ativa, os SKUs faltantes são cadastrados na hora.

Como vincular um recebimento a um pedido de compra?​

A vinculação carrega os itens do pedido para conciliação e habilita o faturamento parcial quando o recebimento entrou com menos que o pedido:

  1. Na criação (modal Novo Recebimento, modo Fornecedor): após selecionar o fornecedor, se houver pedidos de compra em aberto/parcialmente recebidos, aparece o campo Vincular pedido de compra — escolha o pedido e salve.
  2. Em um recebimento já criado: abra o detalhe, clique em Mais Ações → Vincular Pedido de Compra e escolha o pedido.

Após vincular, as abas Conciliação de Itens Recebimento e Conciliação de Itens Pedido de Compra ficam disponíveis — mostram lado a lado o que estava no pedido versus o que está no recebimento, marcando divergências de quantidade, custo unitário, armazém e SKUs presentes só em um dos lados.

Ao finalizar, o pedido de compra muda de status para Recebido (totalmente) ou Parcial (quando o operador clica em Finalizar apenas o Recebimento e mantém o pedido em aberto para receber o restante depois).

Como editar os dados gerais do recebimento?​

No detalhe (aba Geral, status Aberto), você pode editar:

  • Data emissão NF, Nota fiscal, Chave de acesso, Finalidade, Tipo nota fiscal, Natureza da operação — mas só enquanto a NF não tem protocolo SEFAZ (nProt vazio). Quando o XML já foi assinado, esses campos ficam bloqueados (vêm do XML).
  • Data recebimento (check-in) — quando a mercadoria chegou no CD.
  • Empresa (filial faturadora), Centro de distribuição.
  • Fornecedor / Cliente, CPF/CNPJ (read-only, vem do fornecedor).
  • Frete — valor rateado proporcionalmente ao custo de cada item no recebimento.
  • Comentários.

Após editar, clique em Salvar no topo da tela.

Pré-requisito: privilégio Editar recebimento. Para editar o número da NF, exige também Editar número nota fiscal recebimento.

Como adicionar, editar ou remover itens?​

Na aba Geral do detalhe, seção Produtos:

  • Adicionar item manualmente: botão Adicionar SKU (só quando status é Aberto e o usuário tem o privilégio Adicionar item recebimento). Abre a janela Adicionar Produto com:
    • * Nome (busca de SKU)
    • * Quantidade (com máscara quantityReceipt)
    • * Custo unitário e * Custo total
    • * Armazém, Endereço (ou criar novo endereço pelo "+")
    • CFOP
    • Quando o SKU tem lote (Batch): Data de fabricação, Data de validade, Lote — obrigatórios conforme as configurações do SKU (RastroControl, BestBeforeRequired, BatchRequired).
    • Quando o SKU tem número de série / IMEI: campo de tags onde a quantidade de seriais deve bater com a quantidade do item.
  • Editar item: ícone de lápis na linha (ou duplo clique). Disponível apenas em status Aberto.
  • Remover item: ícone de lixeira na linha. Em status Aberto, com confirmação.

Item adicionado manualmente após uma finalização com custo errado: a edição do custo unitário ainda é permitida (com o privilégio Editar item recebimento) mesmo em status Finalizado — o sistema oferece recalcular o custo médio retroativamente.

Como bipar produtos para adicionar?​

Atalho operacional para lançar muitos itens rapidamente (sem precisar abrir o modal a cada um):

  1. Na aba Geral → Produtos, clique em Bipar SKU.
  2. Abre a janela Bipe o Produto com:
    • Quantidade (default 1).
    • Cód. barras — campo de busca grande, foco automático.
    • Agrupar / Desagrupar — quando agrupado, repetições do mesmo SKU somam quantidade na mesma linha; quando desagrupado, cada bipagem vira uma linha nova.
  3. Bipe o código de cada produto. A cada acerto, o item aparece na lista do modal.
  4. Quando terminar, clique em Salvar para gravar todos os itens de uma vez.

Códigos aceitos na bipagem: código de barras principal, códigos alternativos, código de embalagem (caixa/fardo) com fator multiplicador.

Como configurar lote, validade e fabricação?​

Quando o SKU tem lote (Batch) habilitado, no modal de Adicionar/Editar produto aparecem os campos:

  • Data de fabricação — obrigatória quando o SKU tem Controle de rastreabilidade (RastroControl) ativo.
  • Data de validade — obrigatória quando o SKU tem Validade obrigatória (BestBeforeRequired) ativa.
  • Lote — obrigatório quando o SKU tem Lote obrigatório (BatchRequired) ativo.

Regras adicionais:

  • Data de fabricação não pode ser maior que data de validade.
  • Quando o SKU permite múltiplos lotes no mesmo endereço, o sistema agrupa por (SKU + lote + validade). Sem essa permissão, dois lotes diferentes no mesmo endereço bloqueiam o cadastro.
  • A parametrização Dias mínimos de validade controla se o sistema bloqueia recebimento de itens cuja validade está próxima — exige autorização especial para passar.

Como imprimir etiquetas dos produtos recebidos?​

Útil para etiquetar fisicamente cada caixa ou unidade antes de guardar no armazém:

  1. Na aba Produtos, selecione os itens que quer etiquetar (caixa de seleção à esquerda das linhas).
  2. Aparecem duas opções no rodapé/topo:
    • Imprimir Etiquetas (ZPL) — envia direto para impressora térmica configurada.
    • Etiqueta (PDF) — gera arquivo A4 com a etiqueta para impressão em impressora comum.

Pré-requisito: privilégio Imprimir Etiquetas. A escolha do modelo da etiqueta (cabeçalho, código de barras, lote, validade) é feita em Logística → Etiquetas Produtos.

Como iniciar a conferência?​

A conferência é o passo em que o operador valida que a mercadoria que chegou bate com a NF — bipa cada volume e registra divergências:

  1. Abra o recebimento em status Aberto ou Recebimento autorizado (7).
  2. Verifique que Data recebimento (check-in) está preenchida (data em que a mercadoria chegou).
  3. Clique em Conferência no topo direito da tela (botão com ícone de check).
  4. O sistema valida:
    • Que a data de checkin não é maior que hoje.
    • Que existe agendamento (quando a parametrização Agendamento obrigatório está ativa).
    • Que o agendamento está no horário correto (quando há tolerância configurada).
  5. Se tudo OK, o status muda para Em conferência (3) e abre a janela de bipagem.

Pré-requisito: privilégio Conferir Recebimento. Quando a parametrização Mostrar Botão de Conferência Rápida Packing está ativa, aparece também um botão para conferência rápida sem bipagem individual (exige privilégio próprio).

Como fazer a conferência por bipagem no computador?​

Dentro da janela de conferência:

  1. O cursor já fica no campo de bipagem grande.
  2. Bipe o código de barras de cada volume. A cada acerto, o item move do quadro A conferir para Conferidos.
  3. Para registrar lote e validade durante a conferência, abra a aba Conferência do detalhe e clique em Adicionar — preencha o item, quantidade, lote, fabricação e validade.
  4. Quando todos os itens estão conferidos, clique em Endereçar Lote (se há novos lotes a definir endereço) ou Finalizar Lote para gravar a conferência.

A conferência é auto-salva como rascunho — você pode fechar a janela e retomar depois.

Como gerenciar a conferência salva (aba Conferência)?​

A aba Conferência mostra tudo que foi conferido (consolidado por SKU + lote):

  • Para cada item: quantidade esperada vs quantidade conferida vs diferença, com indicador visual da divergência.
  • Visualizar foto — quando a conferência foi feita no celular, abre a foto da etiqueta capturada.
  • Adicionar item — botão para incluir manualmente uma linha de conferência (com lote, validade, comentário).
  • Editar — corrige quantidade/data/lote de uma linha (status do recebimento precisa ser Aberto, Em conferência ou Conferência realizada).
  • Deletar — remove a linha (mesmo gate de status).

Pré-requisito de edição: privilégio Conferir Recebimento Mostrar Quantidade (para visualizar quantidades) + Adicionar item recebimento (para incluir linhas).

Como funciona o recebimento no celular?​

A tela tem uma versão mobile específica, ativada automaticamente quando o usuário acessa o sistema pelo subdomínio wms em um dispositivo móvel (celular ou coletor de dados). Layout em cards grandes, fonte ampliada, botões grandes para uso com dedo (sem mouse).

Funcionalidades específicas:

  • Lista filtrada por status — abas: Aberto, Em conferência, Aguardando aprovação, Receb. Autorizado, Receb. Recusado.
  • Bipagem direta da chave de acesso — campo grande no topo "Bipe a chave de acesso" (44 dígitos).
  • Conferência por bipagem — bipa o código do SKU diretamente; o sistema soma quantidade no carrinho.
  • Captura de foto — botão de câmera integrado para tirar foto da etiqueta da caixa.
  • Leitura automática por IA — após a foto, o Google Document AI extrai lote, fabricação e validade do texto da etiqueta automaticamente (com validação cruzada com o que o operador digitou).
  • Auto-save de rascunho — cada bipagem grava o progresso para que o operador possa pausar e retomar.

A versão mobile carrega apenas recebimentos dos últimos 30 dias com status 0, 3, 5, 6, 7, 8 (filtros fixos — não há gaveta de filtros no mobile).

Como abrir um recebimento bipando o chNFe?​

No celular, a entrada principal é pela chave de acesso da NF-e:

  1. Na tela inicial mobile do Recebimento, o cursor já está no campo "Bipe a chave de acesso".
  2. Bipe (ou digite) a chave de acesso da NF (44 dígitos). Pressione Enter ou toque em Buscar.
  3. O sistema valida o tamanho (44 caracteres) e busca o recebimento pelo chNFe.
  4. Se o recebimento estiver em status Aberto (0), Em conferência (3) ou Recebimento autorizado (7), abre a tela de conferência.
  5. Se estiver em outro status, abre um alerta amarelo "Recebimento não permite conferência!" mostrando os dados básicos e bloqueando o avanço.

Alternativa: tocar no ícone de seta direita na linha do recebimento na lista (desabilitado para status Recebimento Recusado).

Como fazer a conferência por bipagem no celular?​

Após abrir o recebimento, o sistema sugere Iniciar Conferência num modal de confirmação:

  1. Toque em Confirmar para iniciar (o status passa para Em conferência e a data de checkin é registrada).
  2. O cursor fica no campo "Código de Barras ou Código de Referência".
  3. Bipe o produto. O sistema busca pelo código de barras, código alternativo, código de embalagem (caixa) ou código de referência interna do SKU.
  4. Caso o SKU tenha lote/validade obrigatórios ou o operador tenha o privilégio Permitir adicionar quantidade manualmente mobile: abre um modal pedindo:
    • * Quantidade de caixas (quando bipou código de embalagem).
    • * Quantidade de itens.
    • Data de fabricação, Data de validade, Lote (com asteriscos quando obrigatórios para o SKU).
    • Comentário (livre).
    • Botões de foto: Tirar Foto (foto principal) e Foto Adicional (até 3).
  5. Sem essas obrigatoriedades, cada bipagem soma 1 unidade automaticamente no carrinho (modo "scanner rápido") e o cursor volta para o campo.

Se o código não bate com nenhum SKU do recebimento, abre um modal vermelho "PRODUTO NÃO LOCALIZADO".

Toque em Finalizar Conferência quando terminar — uma confirmação aparece antes de mudar o status.

Como tirar foto da etiqueta e a IA preencher lote e validade?​

Recurso exclusivo do mobile, útil para evitar digitação manual de lote/validade:

  1. No modal de conferência do item, toque em Tirar Foto (foto principal).
  2. O sistema abre a câmera. Tire a foto da etiqueta do produto/caixa.
  3. A foto é comprimida no celular (~1 MB, dimensão até 1920px) antes do upload para reduzir tráfego.
  4. O sistema envia a imagem para o Google Document AI, que lê o texto da etiqueta e devolve os valores extraídos.
  5. O sistema preenche automaticamente:
    • Data de validade (BestBeforeDate)
    • Data de fabricação (ManufacturingDate)
    • Lote (BatchComments)
  6. Se o operador também digitou um valor e a IA encontrou um valor diferente, o sistema avisa "A IA identificou uma possível divergência na data de validade. Sugerimos revisar as informações." — pede uma segunda confirmação antes de salvar.

Adicionalmente, é possível anexar até 3 fotos extras (Foto Adicional) por linha de conferência — úteis para registrar avarias, faltas ou outros documentos.

Quando a parametrização Foto obrigatória na conferência mobile (lote obrigatório) está ativa, o operador não consegue salvar sem ter tirado a foto principal.

Como salvar rascunho e retomar a conferência depois?​

A conferência mobile salva automaticamente o progresso a cada bipagem — não precisa de botão "Salvar":

  • Cada item adicionado ao carrinho é enviado para o sistema em modo rascunho.
  • Se o operador fecha o app, perde conexão ou troca de dispositivo, ao reabrir o mesmo recebimento o sistema recupera os itens já bipados.
  • Para sair sem perder o rascunho, toque em Voltar no topo da tela.
  • Para concluir efetivamente a conferência (mudar o status do recebimento), use Finalizar Conferência.

O rascunho fica gravado mesmo se o operador apertar Voltar depois — só é descartado quando o operador efetivamente finaliza a conferência ou cancela/reabre o recebimento pela tela desktop.

Como lançar pagamentos do recebimento?​

Na aba Geral, seção Pagamentos:

  1. Clique em Adicionar (botão azul) — só visível em status Aberto com o privilégio Adicionar Pagamento Recebimento.
  2. No modal, na aba Pagamento, preencha:
    • * Tipo de pagamento (Boleto, PIX, Cartão, etc.)
    • * Tipo documento (Duplicata, Boleto, etc.)
    • * Plano de contas
    • * Data vencimento
    • * R$ valor
    • Juros, Multa, Desconto (opcionais)
    • Código de barras (boleto, opcional)
    • Comentários
  3. Em Documentos, é possível anexar boleto/comprovante (XML, PDF, imagem) com o tipo de arquivo correspondente.
  4. Clique em Salvar.

Quando o XML da NF tem múltiplas duplicatas, é possível dividir o lançamento em parcelas pelo painel Condição de Pagamento que aparece no rodapé da aba Geral (botão Adicionar Pagamento com configuração de N parcelas).

Editar pagamento: ícone de lápis na linha (privilégio Editar Pagamento Recebimento). Remover pagamento: ícone de lixeira (privilégio Deletar Pagamento Recebimento) — só permitido em status Aberto.

Como gerir retenções de impostos (PIS, COFINS, IR, CSLL)?​

Quando o recebimento tem retenções de impostos (típico de serviços ou produtos com substituição), use a aba Retenções dentro do modal de pagamento:

  1. Ao criar um pagamento, vá para a aba Retenções no topo do modal.
  2. Para cada imposto retido, preencha:
    • Fornecedor de retenção (geralmente a Receita Federal ou órgão equivalente).
    • Valor retido.
    • Data vencimento da guia de retenção.
  3. Salve.

O sistema cria um pagamento "pai" com o valor líquido para o fornecedor, mais um pagamento "filho" para cada retenção (vinculados entre si no histórico). Cada retenção vira um título a pagar separado no Contas a Pagar — geralmente para órgãos públicos com vencimento conforme a regra fiscal.

As alíquotas padrão da empresa (configuráveis: IRRetentionPercent, CSLLRetentionPercent, PISRetentionPercent, COFINSRetentionPercent) podem pré-calcular automaticamente quando o valor é maior que R$ 10.

Como finalizar um recebimento?​

Finalizar é o passo que entra os produtos no estoque e ativa as contas a pagar:

  1. Garanta que todos os itens foram conferidos e os pagamentos lançados.
  2. Clique em Finalizar no topo direito (status precisa ser Aberto, Conferência realizada ou Finalização autorizada).
  3. Se o recebimento está vinculado a um pedido de compra, aparecem duas opções:
    • Sim, Finalizar tudo — finaliza o pedido de compra junto (passa para Recebido).
    • Finalizar apenas o Recebimento — mantém o pedido de compra em status Parcial, para receber o restante depois.
  4. Em qualquer caso, o sistema valida lote/validade obrigatórios, datas, dias mínimos de validade, e executa as ações descritas na próxima pergunta.

Quando há divergência entre o pedido de compra e o que efetivamente entrou (itens a menor), o sistema oferece a opção CreateReturnOrder — gera automaticamente um pedido de devolução para o fornecedor.

Pré-requisito: privilégio Finalizar recebimento.

O que acontece quando o recebimento é finalizado?​

Ao clicar em Finalizar, o sistema executa em sequência:

  1. Estoque entra: cada movimento do recebimento muda para confirmado (passa a contar no saldo do SKU).
  2. Custo médio do SKU é recalculado (a menos que a empresa use custo manual fixo via parametrização).
  3. Contas a pagar ficam ativas — saem do status "não lançado" (4) e ficam disponíveis em Financeiro → Contas a Pagar.
  4. Pedido de compra muda de status (Recebido ou Parcial).
  5. Números de série dos itens são liberados para uso.
  6. E-mail é enviado para a lista configurada em E-mails para receber confirmação ao finalizar (HTML com a lista dos itens recebidos).
  7. Webhook é disparado para sistemas externos (quando o webhook SkuBalancePurchaseReceipt está habilitado).
  8. Pedidos sem estoque são reabertos — pedidos que estavam em Falta produto (11), Aguardando ressuprimento (24) ou similares são revisados; quando o item recebido cobre a falta, o pedido volta para Fechado (1).
  9. Pedido de devolução é gerado (quando o operador escolheu essa opção e há divergências para menos).
  10. Data do movimento pode ser retroagida (quando habilitado) para evitar saldo negativo no cardex em datas anteriores.

A partir daí, o estoque está oficialmente no sistema e o ciclo está fechado.

Como funciona a aprovação do checkin (comercial e operacional)?​

Operações com dupla validação podem configurar que o início da conferência (checkin) precise de aprovação:

  1. Quando o operador clica em Conferência com a parametrização ativa, o sistema não inicia direto — coloca o recebimento em Aguardando validação comercial (5) ou operacional (6) conforme a parametrização.
  2. Um usuário com o privilégio correspondente (Autorizar checkin recebimento ag. liberação comercial ou operacional) abre o recebimento e vê o botão Autorizar Recebimento no topo.
  3. No modal, ele escolhe:
    • Aprovar (verde) — status muda para Recebimento autorizado (7); o operador pode iniciar a conferência.
    • Recusar (vermelho) — status muda para Recebimento recusado (8); a conferência fica bloqueada.
  4. O operador pode opcionalmente adicionar Comentários explicando a decisão.

Casos típicos para o duplo workflow: receber produto com validade próxima (precisa aprovação comercial), receber sem agendamento (precisa aprovação operacional), receber em data divergente do agendamento.

Como funciona a aprovação da finalização?​

Igual ao checkin, mas no momento da Finalização:

  1. Quando o operador clica em Finalizar com a parametrização ativa, o sistema coloca o recebimento em Aguardando validação comercial (finalização) (10) ou operacional (finalização) (12).
  2. Um usuário com o privilégio (Autorizar finalização recebimento ag. liberação comercial ou operacional) abre o recebimento e clica em Autorizar finalizar receb..
  3. No modal, escolhe Aprovar (status → Finalização autorizada, 9) ou Recusar (status → Finalização recusada, 11).
  4. Após aprovação, o sistema executa a finalização normalmente (estoque, custo, contas, webhook).

Este segundo workflow é típico em operações que exigem conferência fiscal antes da entrada definitiva no estoque.

Como reabrir um recebimento já finalizado?​

Apenas administradores costumam reabrir um recebimento finalizado — geralmente para corrigir um erro de quantidade ou custo. As regras:

  1. Acesse o recebimento finalizado e clique em Mais Ações → Abrir Recebimento.
  2. O sistema valida:
    • Não pode ter havido venda dos produtos recebidos (qualquer SKU vendido após a finalização bloqueia a reabertura).
    • Tempo desde a finalização — quando há venda detectada, o sistema permite reabertura apenas se a finalização foi nos últimos 8 dias.
  3. Se passar, o status volta para Aberto (0) e os movimentos de estoque são revertidos (saldo é "desentrado").

Se o sistema bloqueia, a alternativa é editar o custo manualmente (mantém estoque atual) ou gerar um pedido de devolução fiscal para corrigir.

Pré-requisito: privilégio Abrir recebimento.

Como cancelar um recebimento?​

Cancelar descarta o recebimento (status muda para Cancelada). Só permitido em status Aberto (0):

  1. No detalhe do recebimento, clique em Mais Ações → Cancelar Recebimento (ou na lista, clique no ícone de lixeira na linha).
  2. Confirme.
  3. O sistema:
    • Apaga os movimentos de estoque vinculados.
    • Apaga as contas a pagar do recebimento.
    • Apaga o XML importado (se houver).
    • Define o status como Cancelada (2).

Quando o recebimento tem contas a pagar já baixadas (com extrato bancário vinculado), o cancelamento é bloqueado: "Contas a pagar já foi quitado. Favor remover o pagamento". Estornar primeiro o pagamento no Contas a Pagar, depois cancelar.

Pré-requisito: privilégio Deletar recebimento.

Como gerar um pedido de devolução para itens divergentes?​

Quando a conferência mostra que veio menos que o XML registrou, é possível gerar automaticamente um pedido de devolução para o fornecedor regularizar fiscalmente:

  1. Ao finalizar, marque a opção Criar pedido de devolução (aparece quando há divergências para menos).
  2. O sistema:
    • Cria um Cliente no cadastro a partir do CNPJ/CPF do fornecedor (se ainda não existir).
    • Gera um pedido com tipo Devolução (TypeOrder.Return = 1), finalidade NFe 4 (Devolução).
    • Para cada item divergente, cria um movimento de saída com os valores fiscais rateados proporcionalmente.
    • Vincula o pedido de devolução ao recebimento (campo Pedido fica preenchido no detalhe).
    • Registra o evento no histórico do pedido: "Pedido de devolução criado a partir do recebimento X".

O pedido de devolução fica pronto para emitir a NF-e de devolução em Vendas → Pedidos (ou Reversa/Devolução).

Por que o sistema bloqueia o cancelamento ou edição?​

Várias regras protegem o recebimento contra alterações incoerentes:

  • "Status não permite atualização" — o recebimento já saiu do Aberto. Para cancelar em status diferente de 0, primeiro reverta para Aberto (com Abrir Recebimento, sujeito às próprias regras).
  • "Contas a pagar já foi quitado. Favor remover o pagamento" — o pagamento do recebimento tem extrato bancário vinculado. Estornar primeiro o pagamento em Financeiro → Contas a Pagar.
  • "Já houve venda de produtos desse recebimento e não pode ser aberto" — os produtos recebidos já foram vendidos. Reabertura bloqueada para preservar a contabilidade.
  • "Já existe o mesmo documento para este fornecedor" — o número da NF já existe no sistema para o mesmo fornecedor. Verifique se não é duplicidade ou ajuste o número.
  • "Já existe a mesma chave de acesso no recebimento X" — o XML já foi importado em outro recebimento.

Para editar número da NF após assinatura, exige o privilégio Editar número nota fiscal recebimento (e o XML não pode ter protocolo SEFAZ).

Por que avisa "data de validade abaixo do mínimo"?​

A parametrização Dias mínimos de validade define o número mínimo de dias até a data de validade que o sistema aceita ao receber:

  • Quando configurada e o item tem validade abaixo do limite, o sistema bloqueia a finalização e muda o status do recebimento para o status configurado em Status quando validade próxima do mínimo (geralmente 10 ou 12 — Aguardando validação).
  • A mensagem é: "SKU X vence em N dias e mínimo dias necessários são M dias".
  • A liberação exige aprovação por um usuário com o privilégio correspondente (Autorizar finalização recebimento).

Útil em operações de alimentos, medicamentos ou outros produtos perecíveis para evitar receber lotes com validade insuficiente para venda.

Por que avisa "XML já importado" ou "documento duplicado"?​

Proteções contra dupla entrada da mesma NF:

  • "XML já importado" — a chave de acesso da NF já consta em outro recebimento. Não é possível importar a mesma NF duas vezes.
  • "Recebimento já tem XML importado" — este recebimento já tem um XML — não é possível sobrepor com outro.
  • "Já existe o mesmo documento para este fornecedor no recebimento X" — o número da NF (sem a chave) é igual a outro recebimento do mesmo fornecedor — verifique se é mesmo duplicidade ou ajuste o número.

Quando a importação falha, o recebimento criado é deletado (rollback automático).

Por que avisa "agendamento obrigatório" ao iniciar conferência?​

Quando a parametrização Agendamento obrigatório no recebimento está ativa, todo recebimento precisa de um agendamento (cadastrado em Logística → Agendamento de Recebimento) antes de iniciar a conferência:

  • "Agendamento obrigatório e recebimento não possui agendamento" — sem agendamento. Cadastrar primeiro no menu Agendamento.
  • "Agendamento está para o dia X" — o agendamento existe mas é para outro dia (ainda futuro ou já passado).
  • "Agendamento está para ser iniciado X com tolerância de N horas" — chegou antes da janela.
  • "Agendamento está para ser finalizado X" — perdeu a janela.

Quando esses bloqueios disparam, o recebimento vai para os status de aguardando validação configurados — um usuário com privilégio especial pode liberar.

Como ativar agendamento obrigatório?​

Operações com janela fixa de descarregamento (típico em CDs de varejo e supermercados):

  1. Acesse Configurações → Parametrizações → WMS Recebimento.
  2. Habilite Agendamento obrigatório no recebimento.
  3. Defina o Status quando obrigatório e não tem agendamento (geralmente 5 — Aguardando validação comercial).
  4. Em Status quando agendamento é de outro dia e Status quando agendamento fora da janela (mesmo dia), escolha os status de bloqueio (geralmente os mesmos).
  5. Configure a tolerância de janela em Configuração de Agendamento (menu Logística → Configuração Agendamento).

Os usuários com Autorizar checkin recebimento (comercial ou operacional) ficam responsáveis por liberar exceções.

Como ativar o duplo workflow de aprovação?​

Para exigir aprovação humana entre etapas do recebimento:

  1. Para o checkin (início da conferência):
    • Ative as parametrizações de status (StatusChangePurchase* para agendamento, StatusChangePurchaseBestBeforeProblem para validade) que enviam o recebimento para Aguardando validação ao iniciar conferência.
    • Conceda os privilégios Autorizar checkin recebimento ag. liberação comercial e/ou operacional aos perfis responsáveis pela aprovação.
  2. Para a finalização:
    • Quando o recebimento entra em status 10 ou 12 ao tentar finalizar (geralmente por divergência de validade), o aprovador com o privilégio Autorizar finalização recebimento ag. liberação comercial ou operacional libera.

Empresas pequenas geralmente operam sem duplo workflow (status 0 → 3 → 4 → 1 diretamente). Operações grandes ou reguladas (farmacêutica, alimentar) usam para garantir conformidade.

Como criar SKU automaticamente ao importar XML?​

Quando o XML contém produtos que ainda não estão cadastrados no sistema, o operador pode deixar o sistema criar os SKUs automaticamente durante a importação:

  1. Acesse Configurações → Parametrizações → WMS Recebimento.
  2. Habilite Criar SKU automaticamente quando não existe no XML.
  3. Opcionalmente habilite Permitir gerar novo código de referência se já existir para permitir cadastrar um SKU mesmo quando outro com o mesmo código de referência já existe (gera um novo código).

Sem a parametrização, o XML que contém produtos não cadastrados falha com a mensagem "SKU(s) não cadastrados: ..." — o operador precisa cadastrar manualmente em Produtos → SKUs antes de importar.

Os SKUs criados automaticamente vêm com o tipo padrão (Produto), categoria e marca da primeira disponível, e alíquota fiscal do CST/CSOSN do XML. Geralmente exigem revisão manual depois para ajustar preço, dimensão e curva ABC.

Como descontar PIS, COFINS, ICMS no custo do produto?​

Em regimes tributários onde a empresa credita PIS, COFINS ou ICMS (recuperação tributária), esses impostos não devem entrar no custo do produto:

  1. Acesse Configurações → Parametrizações → Fiscal Recebimento Produto.
  2. Habilite conforme o regime:
    • Subtrair COFINS no custo — recupera COFINS.
    • Subtrair PIS no custo — recupera PIS.
    • Subtrair ICMS no custo (CST não-ST) — recupera ICMS em CSTs normais.
    • Subtrair ICMS no custo (CST 10/70/201/202) — recupera ICMS em CSTs com ST.
  3. Adicione CFOPs que devem ter custo zerado em CFOPs com custo zerado (entradas de bonificação, devolução de venda, etc.).

O cálculo padrão do custo é: Custo = vProd + vICMSST + vFCPST + vIPI - vDesc + vFrete + vOutros - (impostos configurados para subtrair).

Como configurar dias mínimos de validade?​

Para alertar/bloquear recebimento de itens com validade próxima do vencimento:

  1. Acesse Configurações → Parametrizações → WMS Recebimento.
  2. Em Dias mínimos de validade, informe o número de dias (ex.: 30).
  3. Em Status quando validade próxima do mínimo, escolha o status de bloqueio (10 ou 12 — Aguardando validação para finalização).

A partir daí, recebimentos com itens cujo validade está abaixo do mínimo são bloqueados na finalização — exigem aprovação por usuário com Autorizar finalização recebimento.

Como receber e-mail ou webhook ao finalizar?​

Para notificar pessoas ou sistemas externos quando um recebimento é finalizado:

  • E-mail: em Configurações → Parametrizações → WMS Recebimento, preencha E-mails para receber confirmação ao finalizar com uma lista separada por vírgula. Toda finalização dispara um e-mail HTML com a lista de itens recebidos.
  • Webhook: em Configurações → Parametrizações → Webhook, habilite Webhook ao finalizar recebimento (SKU Balance) e configure a URL de destino em Integrações → Webhook. Cada item recebido vira uma mensagem com SKU, lote, armazém, quantidade e timestamp.

Útil para integração com ERP externo, BI fiscal, sistemas de auditoria ou notificação interna.

Como exigir foto obrigatória na conferência mobile?​

Para garantir registro fotográfico da etiqueta de cada item conferido no celular:

  1. Acesse Configurações → Parametrizações → WMS Recebimento.
  2. Habilite Foto obrigatória na conferência mobile (lote obrigatório).

A partir daí, o botão Tirar Foto no modal de conferência mobile fica marcado com asterisco (*) e o operador não consegue salvar a linha sem ter capturado pelo menos uma foto principal. Útil para operações que precisam de evidência fotográfica para rastreabilidade de lote.

Resumo de parametrizações​

Configurações da empresa que afetam esta tela. Para ativar ou desativar, acesse Configurações → Parametrizações, abra o submenu indicado e habilite ou desabilite a parametrização.

ParametrizaçãoSubmenuO que muda quando ativada
Subtrair COFINS no custoFiscal Recebimento ProdutoCOFINS do XML é subtraído do custo do produto na importação.
Subtrair PIS no custoFiscal Recebimento ProdutoPIS é subtraído do custo do produto.
Subtrair ICMS no custo (CST não-ST)Fiscal Recebimento ProdutoICMS é subtraído em CSTs normais.
Subtrair ICMS no custo (CST 10/70/201/202)Fiscal Recebimento ProdutoICMS é subtraído nos CSTs com substituição tributária.
Validar NF na SEFAZFiscal Recebimento ProdutoAntes de importar, valida assinatura e schema da NF via SEFAZ usando o certificado digital.
CFOPs com custo zeradoFiscal Recebimento ProdutoLista de CFOPs (ex.: 1949, 2949) cujos itens entram com custo zero.
Atualizar NCM/CEST do SKU ao importarFiscal Recebimento ProdutoSobrescreve NCM/CEST do SKU com o que vier do XML.
Exigir alíquota de entrada PIS/COFINS no fornecedorFiscal Recebimento ProdutoBloqueia import quando fornecedor não tem alíquota de entrada cadastrada.
Usar último endereço do itemWMS RecebimentoAo importar XML, usa o último endereço onde o item foi armazenado naquele armazém.
Criar SKU automaticamente quando não existe no XMLWMS RecebimentoCria SKU novo durante importação para produtos ainda não cadastrados.
Permitir gerar novo código de referência se já existirWMS RecebimentoPermite criar SKU mesmo com código de referência já existente (gera novo código).
E-mails para receber confirmação ao finalizarWMS RecebimentoLista de e-mails (separados por vírgula) que recebem o e-mail HTML ao finalizar o recebimento.
Recalcular cardex ao receberWMS RecebimentoRetroage a data do movimento se o cardex ficaria negativo em datas anteriores.
Criar contas a pagar como Não lançadoWMS RecebimentoContas a pagar do recebimento ficam em status "Não lançado" (4) — só ativam ao finalizar.
Reabrir pedidos sem estoque ao finalizarWMS RecebimentoPedidos em Falta produto, Aguardando ressuprimento, etc. voltam para Fechado quando o recebimento cobre a falta.
Atualizar Código de Barras ao importar XMLWMS RecebimentoSe o cEAN do XML diverge do cadastro, move o atual para Código de Barras Adicional e atualiza o principal.
Usar data do recebimento como data do movimentoWMS RecebimentoDefine NOW() como RecordTimestamp do movimento ao finalizar (em vez de manter a data herdada do XML).
Dias mínimos de validadeWMS RecebimentoMínimo de dias até a validade aceitos sem bloqueio.
Status quando validade próxima do mínimoWMS RecebimentoStatus (10 ou 12 — Aguardando validação) aplicado quando algum item está abaixo do mínimo de validade.
Habilitar bipagem da chave de acesso na telaWMS RecebimentoMostra campo grande no topo da tela para abrir recebimento bipando o chNFe.
Agendamento obrigatório no recebimentoWMS RecebimentoBloqueia início de conferência quando não há agendamento.
Status quando obrigatório e não tem agendamentoWMS RecebimentoStatus aplicado quando o agendamento é obrigatório e ausente.
Status quando agendamento é de outro diaWMS RecebimentoStatus aplicado quando o agendamento existe mas é para outro dia.
Status quando agendamento fora da janela (mesmo dia)WMS RecebimentoStatus quando o agendamento existe no dia mas fora da tolerância de hora.
Foto obrigatória na conferência mobile (lote obrigatório)WMS RecebimentoNo mobile, exige foto da etiqueta antes de salvar cada linha de conferência.
Exibir apenas recebimentos de fornecedorWMS RecebimentoEsconde Reversa/Devolução da lista de Recebimento.
Endereço padrão da operaçãoWMS RecebimentoEndereço fixo onde os produtos entram automaticamente (ignora endereços vindos do XML).
Mostrar todos fornecedores (sem categoria)WMS RecebimentoLista todos os fornecedores no Novo Recebimento, sem filtrar por categoria do usuário.
Usar custo manual (Custo Set)ProdutoUsa o custo fixo cadastrado no SKU em vez de recalcular pelo recebimento.
Pedido de compra obrigatórioPedido de compraRecebimento exige vínculo com pedido de compra.
Não permitir excluir contas pagar com recebimentoFinanceiroBloqueia exclusão de conta a pagar vinculada a recebimento.
Webhook ao finalizar recebimento (SKU Balance)WebhookDispara webhook por item recebido ao finalizar.
Webhook ao criar recebimentoWebhookDispara webhook ao criar um recebimento novo.
Restringir lista por categoria de fornecedor do usuárioGovernançaOperador só vê recebimentos de fornecedores das categorias vinculadas a ele.
Aviso de Recebimento na cotação (Melhor Envio)Melhor EnvioMarca a cotação como "Aviso de Recebimento".

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar RecebimentoAcesso à tela, à lista, ao detalhe e às ações de visualizar/imprimir.
Criar recebimentoBotão Novo Recebimento e o fluxo de criação por Fornecedor ou Feed NFE.
Editar recebimentoEdição de campos do cabeçalho (data checkin, frete, comentários, fornecedor) e dos lançamentos básicos.
Editar número nota fiscal recebimentoEditar campos da NF (número, chave de acesso, finalidade, tipo) quando a NF não está assinada na SEFAZ.
Deletar recebimentoCancelar recebimento em status Aberto.
Finalizar recebimentoBotão Finalizar — encerra o recebimento, entra estoque e ativa contas.
Abrir recebimentoBotão Abrir Recebimento — reverte status para Aberto (sujeito a regras de venda).
Conferir RecebimentoBotão Conferência e acesso à janela de bipagem.
Conferir Recebimento Mostrar QuantidadeVisualiza as quantidades conferidas vs esperadas na aba Conferência.
Adicionar item recebimentoBotão Adicionar SKU e Bipar SKU + adicionar linha de conferência.
Editar item recebimentoEditar quantidade, custo, lote, validade dos itens.
Deletar item recebimentoRemover itens do recebimento.
Imprimir EtiquetasBotões de impressão de etiquetas (ZPL e PDF).
Adicionar Pagamento RecebimentoBotão Adicionar na seção de pagamentos.
Editar Pagamento RecebimentoEdição de pagamentos já lançados.
Deletar Pagamento RecebimentoRemoção de pagamentos lançados.
Tab TimelineAba Timeline (Logs) no detalhe do recebimento — histórico de alterações.
Exportar RecebimentoExportação da lista de recebimentos para Excel.
Ação em Massa RecebimentoItem Ação em Massa no menu Mais Ações (atualmente "Finalizar Recebimentos" em massa).
Autorizar checkin recebimento ag. liberação comercialBotão Autorizar Recebimento quando status é 5 (Aguardando validação comercial).
Autorizar checkin recebimento ag. liberação operacionalBotão Autorizar Recebimento quando status é 6 (Aguardando validação operacional).
Autorizar finalização recebimento ag. liberação comercialBotão Autorizar finalizar receb. quando status é 10.
Autorizar finalização recebimento ag. liberação operacionalBotão Autorizar finalizar receb. quando status é 12.
Permitir adicionar quantidade manualmente mobileNo celular, habilita os campos Quantidade de itens e Quantidade de caixas para edição manual. Sem o privilégio, cada bipagem soma 1 unidade automaticamente (modo scanner rápido).
Visualizar valores recebimentoVisualização das colunas R$ produtos, R$ NF, R$ pagamento e da aba Itens Nota Fiscal. Sem o privilégio, valores ficam ocultos.