Gestão de Compras

Este guia mostra como registrar a entrada de mercadorias na sua loja: criar compras manualmente ou importar o XML da NF-e do fornecedor, conferir os itens, dar entrada no estoque e gerar as contas a pagar — tudo de forma automática ao confirmar.

O módulo de Compras é o lado da entrada do ciclo de mercadorias, espelhando o módulo de Vendas (a saída). Ao confirmar uma compra, o estoque do local de destino é incrementado, o custo médio dos produtos é recalculado e as contas a pagar são criadas.

Passo 1: Criar uma Nova Compra#

1. Acesse Compras na aba Módulos
2. Clique em Nova Compra
3. Uma compra em rascunho é criada com numeração sequencial automática (1, 2, 3...)

A compra permanece como rascunho até você confirmar. Rascunhos podem ser editados livremente e não afetam o estoque nem os custos.

Dica: Prefere importar a nota fiscal? Veja o Passo 6: Importar XML de NF-e — a compra é pré-preenchida sem digitação.

Passo 2: Informar Fornecedor e Local de Destino#

1. Na seção Fornecedor, clique em Selecionar Fornecedor e busque pelo nome ou CNPJ
2. Na seção Local de Destino, selecione o local de estoque onde a mercadoria vai entrar

O fornecedor e o local são opcionais no rascunho, mas obrigatórios para confirmar a compra. Cada compra entra em um único local de destino.

Passo 3: Adicionar Itens#

1. Na tela da compra, clique em Adicionar Produto
2. Selecione o produto do catálogo
3. Informe a quantidade
4. Informe o custo unitário (o valor pago ao fornecedor por unidade)
5. Opcionalmente, aplique um desconto por item (em R$)
6. Clique em Confirmar

Repita para adicionar mais produtos. Cada item guarda um snapshot do produto (nome e SKU) no momento da adição.

Quantidade fracionada: Só é permitida para produtos cuja unidade de medida aceita fração (ex.: kg, litro). Para unidades inteiras (ex.: peça), informe valores inteiros.

Exemplo#

Passo 4: Confirmar a Compra#

1. Revise os itens e o total da compra
2. Clique em Confirmar Compra
3. Se a compra não tiver parcelas da NF-e, informe a data de vencimento da conta a pagar (padrão: a data de hoje)
4. Confirme

Ao confirmar, o Mozzer executa automaticamente, de forma atômica (tudo ou nada):

• Entrada de estoque: cada item incrementa o saldo do produto no local de destino, com registro de movimentação auditado
• Recálculo de custo: o custo de cada produto é atualizado pela média ponderada (veja abaixo)
• Contas a pagar: uma conta é gerada no Financeiro, vinculada à compra

Depois de confirmada, a compra não pode mais ser editada — apenas cancelada.

Se a entrada de estoque de qualquer item falhar, nenhuma alteração é aplicada — a compra continua em rascunho.

Passo 5: Entenda o Custo Médio Ponderado#

Quando você confirma uma compra, o custo de cada produto é recalculado considerando o estoque que você já tinha e o que está entrando:

novo custo = (estoque atual × custo atual + qtd comprada × custo líquido) / (estoque atual + qtd comprada)
                    

Onde o custo líquido é o custo unitário do item já com o desconto do item aplicado. Se o estoque atual do produto for zero, o novo custo passa a ser o custo líquido da compra.

Exemplo#

Você tem 20 unidades de um café com custo atual de R$ 10,00. Compra mais 30 unidades a R$ 12,00:

novo custo = (20 × 10,00 + 30 × 12,00) / (20 + 30) = 560,00 / 50 = R$ 11,20
                    

O custo do produto passa a ser R$ 11,20, refletindo o custo real de reposição. O custo no vínculo produto-fornecedor também é atualizado com o último custo daquele fornecedor.

O recálculo é registrado na auditoria (valor anterior, novo valor e compra de origem). O cancelamento de uma compra confirmada não desfaz o recálculo do custo médio.

Passo 6: Importar XML de NF-e#

Em vez de digitar, importe o XML da nota fiscal recebida do fornecedor:

1. No módulo de Compras, abra Importar NF-e (atalho na aba Registros do hub)
2. Selecione o Arquivo XML da NF-e (modelo 55, até 2 MB)
3. Opcionalmente, escolha o Local de Destino já nesta tela (você também pode definir depois, na conferência)
4. Clique em Importar — o Mozzer valida e extrai os dados, criando uma compra em rascunho para conferência

Da nota são extraídos: chave de acesso, número/série, data de emissão, emitente (CNPJ e razão social), itens (código do fornecedor, EAN, descrição, NCM, unidade, quantidade, valor, desconto) e as duplicatas de cobrança (vencimentos e valores).

A importação nunca confirma direto — você sempre revisa o rascunho antes de confirmar.

Fornecedor identificado pelo CNPJ#

O fornecedor é resolvido automaticamente pelo CNPJ do emitente. Se o fornecedor ainda não estiver cadastrado, o fluxo oferece criá-lo já pré-preenchido com CNPJ, razão social e endereço do emitente (requer permissão de criar fornecedor).

Duplicatas viram contas a pagar#

Quando a NF-e traz duplicatas, cada uma gera uma conta a pagar com o vencimento e o valor da duplicata. Compras sem duplicatas geram uma conta única com o total e o vencimento que você informar.

Passo 7: Conferir e Associar os Itens da NF-e#

Os itens da nota são associados aos seus produtos automaticamente, em duas etapas:

1. Por EAN/GTIN: o código de barras do item da nota é comparado ao código de barras do produto
2. Por código do fornecedor: o código do produto na nota (cProd) é comparado ao código registrado no vínculo produto-fornecedor

Itens não associados ficam marcados como pendentes. A compra não pode ser confirmada enquanto houver item pendente.

Resolver itens pendentes#

Para cada item pendente, você pode:

• Associar manualmente: busque o produto por nome, SKU ou código de barras e selecione-o. A associação persiste o código do fornecedor no vínculo produto-fornecedor, de modo que a próxima importação do mesmo fornecedor associe automaticamente
• Criar produto: crie um produto novo pré-preenchido com a descrição, EAN, NCM e unidade do XML (requer permissão de criar produto)
• Remover item: exclua da compra um item que não entra no estoque (ex.: item que não é mercadoria para revenda)

Unidade divergente#

Se a unidade comercial da NF-e for diferente da unidade do produto (ex.: compra em caixa, venda em unidade), o item exige confirmação manual da quantidade convertida antes de a compra poder ser confirmada.

Alerta de variação de custo: Se o custo de um item importado divergir mais de 50% do custo atual do produto, a conferência destaca o item para sua revisão. É apenas um aviso — não bloqueia a confirmação.

Cancelar uma Compra#

Compra confirmada#

1. Abra a compra e clique em Cancelar Compra
2. Informe o motivo do cancelamento (obrigatório)
3. Confirme

O estoque dos produtos é revertido automaticamente (movimentação de reversão auditada) e as contas a pagar pendentes vinculadas são canceladas.

Bloqueios: Se o estoque atual não comportar a reversão de algum item, o cancelamento é bloqueado e os itens são listados. Se houver conta a pagar já paga (ou parcialmente paga), o cancelamento exige o estorno prévio no Financeiro.

Compra em rascunho#

1. Abra o rascunho e clique em Cancelar Compra
2. Informe o motivo do cancelamento (obrigatório, como em qualquer compra)
3. Confirme — o rascunho é cancelado sem efeitos colaterais (sem movimentação de estoque)

Duplicar uma Compra#

Para pedidos recorrentes ao mesmo fornecedor, abra uma compra e clique em Duplicar. Uma nova compra em rascunho é criada com o fornecedor, o local e os itens copiados (custos atuais editáveis). Metadados de NF-e não são copiados — a nova compra é de origem manual.

Status de uma Compra#

Acompanhar Compras#

Listagem#

1. Acesse Compras na aba Módulos
2. Veja a lista com número, data, status, fornecedor, origem e total de cada compra
3. Use os filtros para refinar:

A busca aceita o número da compra ou o número da NF-e.

Detalhes da compra#

Clique em uma compra para ver todas as informações:

• Número, status, fornecedor e local de destino
• Lista de itens com produto, quantidade, custo, desconto e subtotal
• Totais da compra
• Metadados da NF-e (quando importada): chave, número, série e emissão
• Histórico de eventos: criação, confirmação e cancelamento com motivo

Integração com Estoque, Catálogo e Financeiro#

O módulo de compras se integra automaticamente com outros módulos ao confirmar:

• Estoque: entrada de mercadoria no local de destino; reversão no cancelamento. O estoque nunca fica negativo
• Catálogo: o custo dos produtos é recalculado pela média ponderada
• Financeiro: as contas a pagar são geradas (uma por duplicata da NF-e, ou uma conta única com o vencimento informado)
• Fornecedores: o vínculo produto-fornecedor é atualizado com o último custo e o código do fornecedor

Módulo de Compras no Hub#

O módulo de Compras tem duas abas no hub:

• Insights — cartões de visão geral e dicas contextuais do módulo
• Registros — atalhos para os submódulos: Compras (lista) e Importar NF-e

Dicas do Módulo#

A aba Insights exibe dicas contextuais para ajudar no uso do módulo:

• Registre sua Primeira Compra — importe o XML da NF-e ou registre a compra manualmente para atualizar estoque, custos e contas a pagar

Clique em Saiba mais em qualquer dica para ver o guia completo com exemplos e links de documentação.

Permissões#

Os fluxos de criar fornecedor ou produto durante a importação reutilizam as permissões supplier:supplier:create e catalog:product:create.

Dicas#

• Cadastre fornecedores e produtos primeiro: Tenha seus fornecedores e o catálogo configurados antes de registrar compras
• Importe a NF-e: Use o XML da nota para eliminar digitação e reduzir erros
• Confira antes de confirmar: Revise quantidades, custos e itens pendentes — após confirmar, a compra não pode ser editada
• Aprenda com as associações: Associar um item manualmente ensina o Mozzer a reconhecer o produto na próxima importação do mesmo fornecedor
• Revise variações de custo: Itens com custo muito acima do habitual são destacados na conferência
• Documente cancelamentos: Informe motivos detalhados para facilitar auditorias
• Acompanhe o custo médio: Confirmar compras com disciplina mantém suas margens e preços corretos