Gestão de Compras

Este guia mostra como registrar a entrada de insumos na sua propriedade: 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 insumos, 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 insumos é 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 o insumo 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 Insumo
2. Selecione o insumo 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 insumos. Cada item guarda um snapshot do insumo (nome e SKU) no momento da adição.

Quantidade fracionada: Só é permitida para insumos 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 Agronfe executa automaticamente, de forma atômica (tudo ou nada):

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

Compra paga em grão é a exceção da última linha: ela não gera conta a pagar, porque a dívida está nas travas do barter.

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 insumo é 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 insumo for zero, o novo custo passa a ser o custo líquido da compra.

Em compra paga em grão, o custo que entra na conta é o custo em grão do item — o rateio do valor das travas —, e não o custo líquido da nota. Ver Barter.

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 insumo passa a ser R$ 11,20, refletindo o custo real de reposição. O custo no vínculo insumo-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 Agronfe 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 insumos automaticamente, em duas etapas:

1. Por EAN/GTIN: o código de barras do item da nota é comparado ao código de barras do insumo
2. Por código do fornecedor: o código do insumo na nota (cProd) é comparado ao código registrado no vínculo insumo-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 insumo por nome, SKU ou código de barras e selecione-o. A associação persiste o código do fornecedor no vínculo insumo-fornecedor, de modo que a próxima importação do mesmo fornecedor associe automaticamente
• Criar insumo: crie um insumo novo pré-preenchido com a descrição, EAN, NCM e unidade do XML (requer permissão de criar insumo)
• Remover item: exclua da compra um item que não entra no estoque (ex.: serviço ou frete cobrado na mesma nota)

Unidade divergente#

Se a unidade comercial da NF-e for diferente da unidade do insumo (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 insumo, a conferência destaca o item para sua revisão. É apenas um aviso — não bloqueia a confirmação.

Barter — insumo pago em grão

No barter você compra o insumo da revenda e paga em grão da safra, não em dinheiro. A nota do insumo continua existindo, com o valor que a revenda escreveu nela — o que muda é como ela é paga.

No Agronfe o barter amarra três registros:

• a compra do insumo, que passa a ser paga em grão e por isso não gera conta a pagar
• uma trava por lote de grão comprometido, cada uma com o preço-referência que as duas partes assinaram
• um contrato de entrega por trava — o mesmo contrato do guia de Vendas, com a revenda como Fornecedor em vez de Cliente

Registrar o barter#

1. Registre a compra do insumo normalmente (Passos 1 a 3) e deixe em rascunho — o barter nasce sobre o rascunho
2. Acesse Compras e abra Barter
3. Clique em Novo barter e escolha a compra — o fornecedor vem dela, o barter não escolhe outra contraparte
4. Informe a data do acordo e, se houver, a referência do contrato que a revenda emitiu
5. Adicione uma trava por cultura e safra: cultura, safra, produto, unidade de negociação, quantidade, janela de entrega e o preço-referência
6. Salve

Cada trava cria o contrato de entrega correspondente. Ou nascem o barter e todas as travas, ou não nasce nenhum — não existe barter com metade dos contratos.

Uma compra tem no máximo um barter vivo. Cancelar o barter libera a nota para um barter novo.

O preço-referência#

O preço-referência é o valor da unidade de negociação que as duas partes combinaram. É ele que transforma grão em dinheiro nos dois sentidos: no custo do insumo e no saldo devedor do encerramento.

• Informado: você digita o preço que negociou
• Sugerido: o Agronfe divide o total da nota pela quantidade travada e oferece o resultado — você aceita ou substitui

A trava pode nascer sem preço-referência, enquanto a negociação não fechou. Ela aparece como Sem preço-referência — nunca como R$ 0,00 — e a compra não confirma enquanto faltar o preço de qualquer trava.

Confirmar a compra paga em grão#

Confirmar segue o mesmo caminho de qualquer compra (Passo 4): entrada de estoque e recálculo de custo. Duas coisas mudam:

• Nenhuma conta a pagar é gerada — a dívida não é em dinheiro, ela está nas travas
• O custo do insumo é o da troca — o valor das travas é rateado entre os itens da nota, proporcional ao subtotal de cada item, e vira o custo em grão de cada insumo

O valor de face continua na tela ao lado, intacto: ele é o que a nota diz, e a nota não muda. A soma do custo em grão de todos os itens fecha exatamente com a soma dos valores das travas.

O rateio acontece uma vez, na confirmação. Enquanto a compra é rascunho os itens ainda mudam — por isso o custo em grão só aparece depois de confirmar.

Entregar o grão: a liquidação#

O grão que paga o barter sai como qualquer carga: por romaneio ou por expedição de armazém. A diferença é a contraparte.

1. No romaneio (ou na expedição), escolha a contraparte Fornecedor e selecione a revenda
2. Aponte o contrato da trava — a lista traz os contratos daquele fornecedor para aquele produto, com o saldo que falta entregar
3. Feche a carga

Ao fechar, a quantidade abate a trava, exatamente como uma entrega abate um contrato de venda. Reabrir a carga devolve à trava exatamente o que ela tirou.

A liquidação não gera receita. O grão não foi vendido: ele pagou uma dívida cujo custo já entrou na safra pela compra do insumo. Reconhecer receita aqui contaria o mesmo evento duas vezes — uma como custo de insumo, outra como receita de grão — e o erro apareceria como margem alta. Por isso a carga de barter não aparece no seletor de romaneios da venda, e a receita da safra não se mexe quando o caminhão sai.

Sobra e saldo devedor#

• Sobra: você entregou mais do que travou. A diferença aparece como Sobra, valorizada ao preço-referência da trava. Ela é um crédito com o fornecedor — não vira conta a receber e não abate a próxima compra sozinho; você a usa na negociação seguinte
• Onde ver o crédito: na trava, dentro do barter, e somado na ficha do fornecedor (Produtos → Fornecedores → abrir o fornecedor), em Crédito de barter, com a lista das travas que o formaram. É o número da conversa de acerto, não do financeiro: ele não aparece no fluxo de caixa porque ninguém vai cobrá-lo
• Saldo devedor: faltou grão. Ele só vira dinheiro quando você encerra o barter

Encerrar o barter#

Encerrar é dizer que a dívida em grão acabou — o que faltou será pago em dinheiro.

1. Abra o barter e clique em Encerrar
2. A tela mostra o critério antes do botão, trava a trava: a quantidade em aberto × o preço-referência congelado
3. Informe o motivo (obrigatório) e o vencimento
4. Confirme

O que estava em aberto é congelado e vira uma conta a pagar no Financeiro, com o critério escrito na descrição. Se todas as travas estiverem quitadas, o barter encerra sem título.

A conversão é sempre ao preço-referência, o único preço que as duas partes assinaram — nunca à cotação do dia. Se o grão subiu, a revenda pode cobrar mais do que o título registra, e a diferença é acerto fora do sistema. O critério fica na tela para que a diferença seja esperada, não descoberta.

Cancelar o barter#

1. Abra o barter e clique em Cancelar
2. Informe o motivo (obrigatório)
3. Confirme

O cancelamento estorna a compra (reversão de estoque auditada) e cancela os contratos das travas — tudo junto, ou nada.

Dois bloqueios, cada um nomeando o que impede:

• Trava já entregue — se qualquer carga já abateu uma trava, o cancelamento é recusado, nomeando o romaneio ou a expedição. O grão fisicamente saiu da fazenda
• Insumo já aplicado — se qualquer insumo da nota já desceu para o talhão em operação de campo, o cancelamento é recusado, nomeando a operação e a data. O custo já entrou no custo por hectare de uma operação realizada

Para corrigir um barter lançado errado depois da primeira aplicação, estorne a operação de campo primeiro, na ordem certa.

Como em qualquer compra, o cancelamento não desfaz o recálculo do custo médio — ele reverte o estoque, não o histórico de custo.

O barter na safra#

A tela da safra mostra o grão comprometido somado e separado por origem: o que está em contrato de venda e o que está em barter. O total continua o mesmo; o que passa a existir é a quebra.

A receita esperada não cresce com barter. A trava não tem fixação de preço, porque o preço-referência é preço de compra — o que o insumo custou —, não preço de venda de grão.

Barter no relatório gerencial e no do escritório contábil#

A entrega de grão para a revenda é, fiscalmente, uma operação de venda — e o seu contador vai escriturá-la como tal, com nota fiscal. Gerencialmente, no Agronfe, ela não é receita: é o pagamento de uma dívida cujo custo já entrou na safra pela compra do insumo.

Os dois relatórios divergem exatamente no barter, e isso é esperado, não erro. O Agronfe não emite nota fiscal; o lado fiscal da operação continua com o escritório contábil.

Permissões do barter#

Encerrar exige, além de purchase:barter:update, a permissão finance:payable:create: quem não pode criar título não encerra.

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 insumos é 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 insumo, 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 insumo no local de destino; reversão no cancelamento. O estoque nunca fica negativo
• Catálogo: o custo dos insumos é 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) — exceto na compra paga em grão, que não gera título
• Fornecedores: o vínculo insumo-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), Barter 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#

As permissões do barter estão na seção Barter.

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

Dicas#

• Cadastre fornecedores e insumos 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 Agronfe a reconhecer o insumo 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