Gestão de Vendas
Este guia mostra como registrar o que sai da propriedade: a carga de grão que passou pela balança e a venda de produto de estoque.
São dois caminhos na mesma tela de venda, e eles convivem. O grão entra por um romaneio; o insumo entra como item de catálogo, exatamente como sempre entrou.
O modelo: a carga existe antes do preço
Na venda de loja, preço e entrega acontecem no mesmo instante. Na venda de grão, não: o caminhão sai hoje e o preço fecha depois.
Por isso o romaneio é um registro próprio, que vive sozinho enquanto for preciso:
- O caminhão é pesado duas vezes — cheio e vazio. A diferença é o peso líquido
- A carga é classificada — umidade, impureza e avariados descontam peso
- Os serviços são lançados — secagem, limpeza, taxa. Eles descontam dinheiro
- A origem é apontada — de qual cultivo saiu o grão
- O romaneio é fechado — e o peso líquido final é congelado
- Dias depois, o preço fecha — a venda puxa os romaneios da semana e você digita o preço por saca
- A venda é confirmada — vira recebível, e a receita aparece no cultivo e na safra
| Você quer registrar | Faça |
|---|---|
| Um caminhão que saiu com soja | Um romaneio |
| Como a sua soja é julgada na balança | Um padrão de classificação, uma vez por cultura |
| O grão que você comprometeu e ainda não colheu | Um contrato, com as suas fixações de preço |
| O preço que você fechou com o comprador | Uma venda, com os romaneios dentro |
| A venda de um saco de adubo que sobrou | Uma venda, com item de catálogo — o caminho de sempre |
Quando a venda é antecipada, a história começa antes ainda: o contrato registra o compromisso meses antes de existir carga para pesar, e é dele que o preço da nota vai sair.
As duas contas ficam separadas de propósito. A classificação tira quilos; o serviço tira reais. É essa separação que permite conferir a sua conta contra a nota do comprador, linha a linha, em vez de discutir um número final que ninguém consegue abrir.
Romaneio: o caminhão pesado duas vezes
Registrar a carga#
- Acesse Vendas no menu e abra Romaneios
- Clique em Novo Romaneio
- Informe a data da carga e o produto pesado (obrigatório — é ele que vira o item de venda)
- Escolha a contraparte, se já souber para quem vai — Cliente para quem compra o grão, Fornecedor para a revenda que recebe grão como pagamento de insumo
- Informe o peso bruto e a tara, em quilos
O peso líquido aparece na hora: bruto menos tara. Ele não é digitado.
A tara tem de ser menor que o peso bruto. Um caminhão vazio mais pesado que o cheio é erro de digitação, e o registro é recusado com a mensagem dizendo isso.
Transporte e nota do comprador#
Duas seções opcionais, preenchidas conforme você tem a informação na mão:
- Transporte — placa do veículo, motorista e transportadora
- Nota do comprador — o número da nota dele, o peso líquido e o valor líquido que ele apurou
A nota do comprador é o que alimenta a conferência. Você pode deixá-la em branco agora e voltar quando o papel chegar.
Destino da carga: venda ou depósito
Nem toda carga que sai da lavoura vai para um comprador. Às vezes ela vai para o armazém de uma cooperativa — o grão continua seu, só mudou de lugar.
Na seção Destino da carga, com o romaneio aberto, escolha:
| Destino | O que significa |
|---|---|
| Venda | O padrão. A carga vai para um comprador e, mais cedo ou mais tarde, vira item de uma venda |
| Depósito | A carga vai para um armazém de terceiro. Não é vendida agora |
Duas seções de armazém aparecem, independentes do destino escolhido:
- Armazém de origem (opcional): de qual dos seus armazéns o grão saiu, se ele já estava guardado antes de subir no caminhão. Deixe em branco quando a carga vem direto da lavoura
- Armazém de destino: só aparece, e só é exigido, quando o destino é Depósito — e precisa ser um armazém de terceiro, com depositário cadastrado. Sem um armazém de terceiro cadastrado, cadastre o depositário no local antes de registrar o depósito
Uma carga de depósito não é vendida nem abate contrato: ela põe grão no armazém. Trocar o destino de Venda para Depósito remove qualquer contrato já apontado na carga — depósito e contrato não convivem na mesma carga, porque depositar não é entregar (veja O que o contrato não faz).
Mudar o destino só é possível com o romaneio aberto.
O romaneio existe sem venda#
Esta é a diferença que muda tudo. Um romaneio recém-criado não pertence a venda nenhuma, e pode ficar assim por tempo indeterminado. A carga saiu; o preço fecha quando fechar.
| Situação | O que significa | O que dá para fazer |
|---|---|---|
| Aberto | Em preenchimento | Editar tudo, classificar, lançar serviço, apontar origem, fechar |
| Fechado | Peso líquido final congelado | Levar para uma venda; reabrir |
| Vinculado à venda | Está dentro de uma venda | Somente leitura, até a venda ser cancelada ou o romaneio retirado |
Só se edita romaneio aberto. Com a carga fechada ou vinculada, a tela avisa e não deixa salvar.
Excluir é permitido enquanto o romaneio não está numa venda. Se estiver, a mensagem pede para retirá-lo da venda primeiro — apagar uma carga que já virou receita esconderia dinheiro registrado.
Padrão de classificação: como a sua cultura é julgada
O padrão é o cadastro que faz o desconto ser calculado, e não digitado de cabeça. É trabalho de uma vez por cultura, normalmente no começo da safra.
Cadastrar o padrão#
- Acesse Vendas no menu e abra Padrões de classificação
- Clique em Novo Padrão
- Escolha a cultura e dê um nome (
Soja — safra 2025/26) - Escolha a forma de aplicação: cascata ou soma
- Informe a tolerância de divergência — o quanto o seu peso pode diferir do peso do comprador antes de a carga ser marcada. Em branco, vale 0,5%
- Adicione as regras, uma por tipo: umidade, impureza e avariados
Cada regra tem a base (tolerância) em percentual, a fórmula, o fator e a ordem de aplicação.
As duas fórmulas#
| Fórmula | Conta | Quando se usa |
|---|---|---|
| Proporcional | (medido − base) ÷ (100 − base) × 100 |
Umidade, na maior parte dos contratos |
| Direta | (medido − base) × fator |
Impureza e avariados, onde o desconto é linear |
O fator só é usado pela fórmula direta.
Grão mais seco que a base não gera bônus#
Se o medido é menor ou igual à base, o desconto é zero. Nunca negativo.
Umidade de 13% contra uma base de 14% não devolve peso: o desconto é zero e o peso líquido final fica igual ao líquido. Pagar a mais por grão seco é cláusula de contrato, e contrato não é o que este cadastro descreve.
Cascata ou soma#
- Cascata — cada desconto incide sobre o peso já descontado pelo anterior, na ordem das regras
- Soma — os percentuais são somados e aplicados uma vez sobre o peso líquido
Os dois modos com os mesmos percentuais dão pesos finais diferentes. Use o que está escrito no seu contrato.
Editar um padrão não mexe em carga fechada#
Ao salvar a edição, a tela informa quantos romaneios já usaram aquele padrão — e que nenhum deles muda. O padrão foi copiado para dentro de cada carga no momento do fechamento, e é aquela cópia que vale.
A edição vale para as próximas cargas. Para recalcular uma carga antiga, é preciso reabrir o romaneio.
Aposentar em vez de excluir#
Um padrão aposentado deixa de ser oferecido em cargas novas, e os romaneios que já o usaram continuam como estão. É o caminho normal na virada de safra.
Excluir é bloqueado quando há romaneio usando o padrão, com a contagem na mensagem. Cada cultura tem um padrão em uso por vez.
Classificar a carga
Com o romaneio aberto, escolha o padrão de classificação no formulário e lance a seção Classificação.
Cada linha é um tipo — umidade, impureza ou avariados — e o que você digita é o percentual medido, o que a nota do comprador informou. A base, a fórmula e o fator vêm do padrão: deixe em branco para usar o que está cadastrado.
Só existe uma linha por tipo na mesma carga.
A quebra em quilos, item a item#
Cada linha mostra, lado a lado, o que foi medido, a base e o quanto aquilo custou em peso:
| Item | Medido | Base | Desconto | Desconto (kg) |
|---|---|---|---|---|
| Impureza | 1,4% | 1% | 0,4% | 109,040 kg |
| Umidade | 16,2% | 14% | 2,558% | 694,559 kg |
| Avariados | 6% | 8% | 0% | 0,000 kg |
Sobre um líquido de 27.260 kg, em cascata, o peso líquido final fica em 26.456,401 kg.
Repare no avariados: 6% contra uma base de 8% desconta zero, e a carga fecha normalmente. Um item dentro da tolerância nunca trava o fechamento.
Ajustar o padrão nesta carga#
Preencher a base, a fórmula ou o fator na própria linha sobrescreve o padrão só para aquela carga, e a linha passa a aparecer marcada como Ajustado. Serve para o dia em que o comprador aplicou outra regra e você quer registrar o que realmente aconteceu, sem mexer no cadastro.
Sem padrão cadastrado, a carga ainda fecha#
Deixe o padrão em branco e o romaneio fica marcado como Sem padrão (classificação manual). Aí a base e a fórmula passam a ser obrigatórias em cada linha — sem cadastro, não há de onde herdá-las.
Serviços: o que desconta dinheiro
Secagem, limpeza, armazenagem, taxa e frete não tiram peso da carga: tiram valor do que você recebe. Por isso ficam numa seção própria.
Na seção Serviços, adicione uma linha por cobrança:
- Escolha o tipo — secagem, limpeza, armazenagem, taxa, frete ou outro
- Escolha a base de cálculo: valor fixo ou por unidade de peso
- Informe o valor unitário e, no valor fixo, o valor total
Na base por unidade de peso, o valor total é calculado: valor unitário × peso líquido em quilos. Você informa a tarifa que o comprador cotou; a multiplicação é com o sistema.
| Serviço | Base | Valor unitário | Total |
|---|---|---|---|
| Secagem | Por unidade de peso | R$ 0,035/kg | R$ 954,10 |
| Taxa | Valor fixo | — | R$ 45,00 |
| Total de serviços | R$ 999,10 |
Serviço com valor zero é aceito e continua visível — uma cobrança que o comprador dispensou vale como zero registrado, não como linha que nunca existiu. Valor negativo é recusado.
O total dos serviços vira o desconto do item de venda quando a carga entra numa venda. A classificação nunca entra aí: ela já cobrou o que tinha de cobrar, em quilos.
Armazenagem cobrada na carga é diferente da fatura do período. O tipo Armazenagem aqui é para uma cobrança desta carga especificamente — quando o comprador ou o depositário tarifam por carga recebida. A cobrança mensal que o depositário faz pelo grão que fica parado no armazém é outro lançamento, feito no Financeiro, na seção Fatura de Armazenagem. O sistema não oferece os dois caminhos para o mesmo custo: cobrança por carga é linha de serviço do romaneio; cobrança do período é fatura.
Origem: de qual cultivo saiu a carga
É a origem que dá dono à receita. Sem ela, o dinheiro entra na fazenda e não chega ao talhão.
Na seção Origem, cada linha tem o cultivo e o peso em quilos. A tela nasce com uma linha, que é o caso comum: um caminhão, um talhão.
A soma tem de fechar com o peso líquido#
O rodapé mostra o total das origens e o quanto falta distribuir. A última linha já vem oferecendo o restante.
Se sobrar ou faltar peso, o fechamento é recusado, com os dois números na mensagem. É a única checagem dura do romaneio, e existe porque uma origem que não fecha rateia a receita errado para sempre.
Repare que as origens fecham contra o peso líquido (bruto menos tara), não contra o peso líquido final. O grão que a classificação descontou saiu do talhão do mesmo jeito.
A carga que veio de dois talhões#
Colheita que pegou o fim de um talhão e o começo de outro é uma carga com duas origens:
| Origem | Peso |
|---|---|
| Talhão 7 · Soja 2026/27 | 16.000 kg |
| Talhão 9 · Soja 2026/27 | 11.260 kg |
| Total | 27.260 kg |
Quando a venda fechar, o valor do item é rateado pela participação de peso de cada origem, e as partes somam exatamente o valor do item — o centavo do arredondamento vai para a origem de maior peso.
Origem sem cultivo é permitida#
Grão que já estava no barracão e ninguém sabe de qual talhão veio: deixe o cultivo em branco. A linha aparece como Sem safra e o valor dela vira receita não alocada.
A receita não alocada é contada, mostrada à parte e nunca espalhada entre os cultivos que têm dono. Distribuí-la seria inventar um número: você não sabe de onde veio o grão, e o sistema também não.
Os dois avisos#
- Cultivo de safra encerrada é aceito, com aviso. A carga saiu de verdade; recusar o registro não a desfaria
- Origens de culturas diferentes na mesma carga geram aviso — um caminhão leva um produto só
Nenhum dos dois bloqueia.
Fechar a carga
Fechar é o que congela o peso líquido final.
Na tela de fechamento você vê o peso líquido, o total das origens e o que falta distribuir. Confirmando, o Agronfe grava o peso final junto com os parâmetros do padrão que o produziram.
Ele não é recalculado depois. Editar o padrão em novembro não mexe na carga que fechou em março — e é isso que faz uma safra encerrada continuar fechando anos depois.
Uma carga com armazém move o saldo de grão#
Se a carga aponta um armazém de origem ou um armazém de destino, fechá-la também move o saldo de grão desses armazéns — sempre pelo peso final, nunca pelo peso líquido puro: a quebra da classificação (acima) já saiu do peso antes de chegar lá.
- Com armazém de origem: o peso final sai do saldo daquele armazém, tenha a carga ido para venda ou para depósito
- Com destino Depósito: o peso final entra no saldo do armazém de terceiro
Uma carga sem nenhum armazém apontado — direto da lavoura, para um comprador — não mexe em saldo de grão nenhum, exatamente como antes desta funcionalidade existir.
Reabrir#
Reabrir descarta o peso líquido final congelado e devolve o romaneio para aberto. Ele é recalculado no próximo fechamento, com o padrão como está hoje.
Reabrir só é possível enquanto a carga não está numa venda confirmada. Se estiver, retire o romaneio da venda ou cancele a venda primeiro.
Reabrir desfaz exatamente o movimento de grão que o fechamento gerou — nunca uma reconta. Se a recusa do estorno não permitir desfazer o movimento, a reabertura também é recusada, e nada fica gravado pela metade.
Contrato: o compromisso vem antes da carga
O romaneio começa quando o caminhão sobe na balança. O contrato começa meses antes, quando ainda não há grão nenhum para pesar — o produtor vende antes de colher.
Em fevereiro você compromete 5.000 sacas de soja para entregar em maio. Em março trava o preço de 2.000 delas. Em abril trava mais 1.500. Em maio os caminhões saem, e cada carga abate o que ainda falta entregar — ao preço de março, não ao de maio.
Por isso o contrato é um registro próprio, como o romaneio: ele nasce antes da carga e é consumido por ela.
O contrato compromete quantidade; a fixação compromete preço. São dois compromissos independentes, a entrega consome os dois, e é a combinação deles que diz quanto a safra ainda vale.
| Você quer | Faça |
|---|---|
| Registrar que já vendeu 5.000 sacas para maio | Um contrato |
| Travar o preço de parte dessa quantidade | Uma fixação, dentro do contrato |
| Abater a carga que saiu | Apontar o contrato no romaneio |
| Faturar ao preço que travou | Levar o romaneio para uma venda — o preço vem junto |
| Ver quanto da safra ainda está livre | O bloco Vendido e livre, na tela da safra |
Acesse Vendas no menu e abra Contratos. A lista traz número, contraparte, modo de preço, a data limite de entrega e o saldo que falta entregar, com o contrato que vence primeiro no topo. A busca aceita contrato, contraparte ou produto, e o botão de Filtros refina por situação, contraparte, cultura e safra.
Comprometer: registrar o contrato#
- Em Contratos, clique em Novo contrato
- Escolha a contraparte — Cliente ou Fornecedor
- Escolha o produto negociado, a cultura e a safra
- Escolha a unidade de negociação — saca 60 kg, saca 50 kg, tonelada, arroba ou quilo
- Informe a quantidade, na unidade de negociação
- Informe a janela de entrega: início e fim
- Escolha o modo de preço — Preço fixo ou Preço indexado
- No preço fixo, informe também o preço unitário
O contrato ganha número próprio e nasce Em aberto.
Contraparte, produto, cultura, safra e unidade não mudam depois de assinado: mudar qualquer um deles seria outro contrato, não uma correção deste. A tela diz isso na hora da edição.
A unidade de negociação é copiada para dentro do contrato no momento da criação — o mesmo congelamento que o padrão de classificação sofre ao fechar a carga. Corrigir o cadastro da unidade em novembro não mexe num contrato assinado em fevereiro.
Contrato com contraparte Fornecedor é a trava de um barter. Ele nasce junto com o barter, em Compras, e não se cria por aqui na prática: quem o cria é o registro do insumo que será pago em grão. Ele também não aceita fixação de preço — o preço da trava é o preço-referência do barter, que é preço de compra, não de venda.
Os dois modos de preço#
| Modo | O que significa | Quem fixa |
|---|---|---|
| Preço fixo | O preço já está acertado no papel | O sistema, sozinho, no ato da criação |
| Preço indexado | O preço fecha depois, em partes | Você, uma faixa de cada vez |
No preço fixo, o Agronfe registra a fixação integral no momento em que o contrato é criado — a quantidade toda, ao preço informado. Ela aparece na lista de fixações marcada como Decorrência do preço fixo, e não como algo que você lançou. É a mesma linha de fixação que o modo indexado produz; ela só não passou pela sua mão.
Por isso um contrato a preço fixo não aceita fixação nova: não sobra quantidade para fixar. A tela recusa dizendo exatamente isso.
E por isso, também, um aditivo de quantidade num contrato a preço fixo estorna a fixação integral e a reemite na quantidade nova — mesmo preço, mesma data, a razão do aditivo registrada no estorno. O contrato continua inteiramente fixado, e as duas linhas ficam à vista, como qualquer estorno.
No preço indexado, o contrato nasce sem preço: cada faixa é fixada depois, uma de cada vez.
Alterar a quantidade e cancelar#
Alterar a quantidade exige razão, e ela fica registrada. A seção Aditivos do contrato guarda cada mudança — de quanto para quanto, por quê e quando.
A redução é recusada abaixo do maior entre o já entregue e o já fixado. Reduzir abaixo do fixado deixaria fixação sem contrato que a sustente; abaixo do entregue deixaria saldo negativo sem carga que o explique.
Janela de entrega e observações se editam sem razão.
Cancelar o contrato também exige razão. Nada é apagado: o que já foi entregue continua nos romaneios e as fixações seguem visíveis. O que muda é que o saldo em aberto some do comprometido da safra, e o contrato deixa de ter receita a receber.
Fixar: travar o preço de parte da quantidade#
- Abra o contrato e toque em Fixar preço
- Informe a data da fixação — ela não pode estar no futuro
- Informe a quantidade desta faixa
- Escolha como o preço é informado: Preço direto ou Referência e base
- Confirme
No Preço direto você digita o preço unitário e acabou.
Em Referência e base são três campos, e os três ficam gravados:
| Campo | O que é |
|---|---|
| Referência | A bolsa, o contrato ou a cotação usada — o nome que estava na conversa |
| Preço de referência | Quanto ela valia naquele dia, já em reais e na unidade do contrato |
| Prêmio de base | O ajuste entre a bolsa e a sua praça. Pode ser negativo — é um desconto sobre a referência |
O preço resultante é referência mais prêmio de base, e é ele que vale dali em diante. A tela mostra a conta enquanto você digita, para conferência; o número que fica gravado é o que o sistema deriva, uma vez, no momento em que a fixação é confirmada.
Guardar os três, e não só o resultado, é o que permite conferir a negociação meses depois: duas fixações com a mesma referência e bases diferentes contam uma história que um preço único esconderia.
A soma das fixações vigentes nunca passa a quantidade do contrato. A tentativa é recusada com os dois números e com quanto ainda resta para fixar.
Fixação não se edita#
Fixou 2.000 sacas a R$ 130,00 e digitou errado? A correção é estornar com razão e fixar de novo — e as duas linhas ficam visíveis, a estornada marcada como Estornada, com a razão e a data ao lado.
Não é rigor burocrático. Depois que a fixação alcança o faturamento, editá-la reescreveria o preço de uma nota já emitida e a receita já reconhecida. O par estorno + refixação deixa a história legível para quem for conferir o contrato seis meses depois.
Só as fixações vigentes contam. A estornada permanece no registro e sai de todas as somas: quantidade fixada, preço médio e receita esperada.
O Preço médio fixado do contrato é a média ponderada das fixações vigentes. Sem nenhuma, a tela diz Nenhuma fixação vigente — e não zero, que se leria como grão dado de graça.
Entregar: o romaneio abate o contrato#
O contrato é apontado no próprio romaneio, na seção Contrato.
- Registre o romaneio com a contraparte — Cliente ou Fornecedor — e o produto, e salve
- Volte a editar a carga: a seção Contrato passa a oferecer os contratos daquela contraparte para aquele produto
- Escolha o contrato — cada opção mostra a contraparte e o saldo que falta entregar
- Feche a carga
Um romaneio tem no máximo uma contraparte: cliente, fornecedor, ou nenhuma. Trocar a contraparte derruba o contrato já escolhido, porque um contrato de cliente nunca casa com carga entregue a fornecedor — nem quando a mesma empresa é as duas coisas.
A seção só oferece contratos depois que o romaneio está salvo, porque a lista é montada a partir da contraparte e do produto já gravados na carga. Uma carga sem contraparte não tem contra o que abater.
O abatimento acontece no fechamento, junto com o congelamento do peso líquido final. Ao fechar, o peso final em quilos é convertido uma única vez para a unidade do contrato, pelo fator que o contrato congelou, e arredondado em três casas.
Esse número — o mesmo que a tela mostra — é o que abate o saldo, o que decide se cabe aviso e o que decide quando o contrato passa a Cumprido. Não existe um segundo número por trás dele.
Um romaneio abate um contrato uma única vez. Reabrir a carga devolve ao contrato exatamente a quantidade que ela havia abatido, e não uma reconta. Cancelar a venda que continha a carga reabre o romaneio, e a devolução acontece pelo mesmo caminho.
Um contrato já Cumprido continua aceitando carga: o saldo fica negativo, e isso não é erro de conta — é grão que saiu além do que estava comprometido.
Isto vale para grão que passa pela balança. Grão que já está armazenado, sem carga nova para pesar, abate o mesmo contrato por outro caminho — veja Expedição: vender o grão que já está no armazém.
A carga entregue ao fornecedor liquida um barter#
Contrato com contraparte Fornecedor é a trava de um barter — o insumo que você comprou e paga em grão. A carga aponta a trava pelo mesmo caminho de sempre, e abate o mesmo saldo.
O que muda é o que acontece depois: essa carga não vira receita. Ela não entra no seletor de romaneios da venda, não gera item de venda e não mexe na receita realizada nem na esperada da safra. O grão não foi vendido — ele pagou uma dívida cujo custo já entrou na safra quando o insumo foi comprado. Registrar receita aqui contaria o mesmo evento duas vezes.
Sobra e saldo devedor da trava aparecem no barter, em Compras — não aqui.
A seção Saldo do contrato, no detalhe, junta os dois compromissos num lugar só:
| Situação | Em aberto, Cumprido ou Cancelado |
| Comprometido | A quantidade que o contrato promete |
| Entregue | O que as cargas fechadas já abateram |
| Saldo a entregar | Comprometido menos entregue. Num contrato cancelado o rótulo muda para Saldo não entregue: o número é o mesmo, mas ninguém deve mais essa quantidade |
| Fixado | Quanto do comprometido já tem preço travado |
| Exposto ao mercado | Comprometido menos fixado |
| Entregue sem preço | Entregue menos fixado |
| Preço médio fixado | A média ponderada das fixações vigentes |
| Receita esperada | O que o fixado ainda não entregue vale |
Faturar: a nota nasce com o preço fixado#
Daqui em diante o caminho é o da venda: rascunho, Adicionar romaneio, unidade de negociação, preço. A diferença é que o preço já vem preenchido.
Ele vem das fixações do contrato, consumidas em FIFO — a mais antiga liquida primeiro, por data de fixação. As cargas consomem na ordem em que foram fechadas, e essa ordem não muda se você retirar e recolocar um romaneio numa venda: o item nasce com o preço que lhe cabia.
A carga que atravessa duas fixações nasce com a média ponderada da parte que consumiu de cada uma, e a tela mostra a composição, faixa a faixa:
Preço do contrato #12: 300,000 sc a BRL 130,0000 · 140,940 sc a BRL 138,0000
A parte que passa do total fixado entra sem preço de fixação. Se a carga inteira saiu além do fixado, não há preço a sugerir — e a tela diz que isso não é preço zero, e pede o preço acordado. Grão entregue além do que foi travado é grão vendido ao mercado do dia, e o mercado do dia o sistema não conhece.
Sobrescrever o preço preenchido continua permitido, e a sobrescrita fica registrada, como em qualquer item de venda. Romaneio sem contrato mantém o comportamento de sempre: o preço é digitado.
Se a linha da venda estiver sendo negociada numa unidade diferente da unidade do contrato, a tela avisa: o preço sugerido é por unidade do contrato, e converter é com você antes de confirmar.
Acompanhar a safra: o bloco Vendido e livre#
Na tela da safra, em Safras e cultivos, o bloco Vendido e livre responde à pergunta da próxima ligação do comprador: quanto desta safra eu ainda posso vender?
Ele mostra, por cultura e por unidade de negociação:
| Número | O que é |
|---|---|
| Comprometido | O que os contratos desta safra somam — os cumpridos entram, os cancelados não. Abaixo dele, a quebra por origem: o que está em contrato de venda e o que está em barter |
| Fixado | Quanto desse comprometido já tem preço travado |
| Entregue | Quanto já saiu contra esses contratos |
| Exposto ao mercado | Comprometido menos fixado |
| Preço médio fixado | A média ponderada das fixações vigentes |
| Receita esperada | O que o fixado ainda não entregue vale |
| Colhido | O que a safra produziu, vindo das colheitas lançadas |
| Livre para vender | A produção menos o comprometido |
A quebra por origem mostra só as origens que existem: safra sem barter não ganha uma linha de barter zerada. O livre já descontava as duas desde sempre — o que passa a existir é a separação, não um número novo. E a receita esperada não cresce com barter: a trava não tem fixação de preço.
O livre é medido contra a meta de produtividade da safra — não contra grão já colhido — enquanto a colheita não ultrapassa a meta; a partir daí ele passa a ser medido contra o colhido. A tela diz qual das duas bases usou. É o mesmo cuidado do aviso de excesso: seguir o número mais alto disponível evita alarme falso no meio da colheita.
Quando o livre não pode ser calculado, a tela diz Não dá para calcular e explica o motivo, em vez de mostrar zero:
- A cultura tem contrato em mais de uma unidade nesta safra. Converter compromisso inventaria um número que nenhum contrato assinou
- A safra não tem meta nem colheita registrada para a cultura. Sem base de produção não há de onde subtrair o comprometido — o livre é desconhecido, não é zero
Livre para vender não é o saldo de grão. O saldo de grão é colhido menos entregue: o que ainda está fisicamente com você. O livre é produção menos comprometido: o que ainda dá para prometer a alguém. Grão colhido e já comprometido aparece no saldo e não aparece no livre, e os dois estão certos.
Exposto ao mercado e Entregue sem preço são números diferentes#
São os dois números que mais se parecem no contrato, e eles medem coisas distintas.
| Número | O que é | A conta |
|---|---|---|
| Exposto ao mercado | Grão que você deve a um preço que ninguém travou | comprometido − fixado |
| Entregue sem preço | Grão que já saiu da fazenda além de tudo que foi fixado | entregue − fixado |
Um contrato de 1.000 sacas com 400 fixadas e 300 entregues:
| Exposto ao mercado | 600 sacas — das 1.000 que você deve, 400 têm preço e 600 não |
| Entregue sem preço | zero — as 300 que saíram couberam inteiras dentro das 400 fixadas |
Só a partir da 401ª saca entregue é que Entregue sem preço deixa de ser zero. Um é risco de preço sobre o que ainda vai sair; o outro é preço em aberto sobre o que já saiu.
Receita esperada não é receita#
Receita esperada é o que o fixado ainda não entregue vale. Nada mais.
Ela cai conforme você entrega — e isso não é perda. O que saiu virou receita realizada do outro lado, na receita da safra que a venda confirmada produz. São os dois lados do mesmo contrato, e é assim que a soma fecha.
Nunca some os dois números. Somá-los conta a mesma saca duas vezes, e o erro aparece como margem alta — a forma de erro que ninguém denuncia.
Sem fixação vigente, a tela diz que não há como calcular em vez de mostrar zero. Num contrato cancelado, ela diz que não há receita a receber.
Os avisos avisam e deixam passar#
Três situações rendem aviso e nenhuma delas bloqueia:
| Aviso | Quando aparece | Por que não bloqueia |
|---|---|---|
| A safra já está comprometida acima do que se espera produzir | Ao registrar o contrato | Comprometer acima da produtividade é decisão legítima — dá para comprar grão de terceiro e completar |
| Já foi entregue mais do que o contrato compromete | Ao fechar a carga | A carga saiu de verdade; recusar o registro não a desfaria |
| A carga veio de uma safra que este contrato não nomeia | Ao fechar a carga | Entregar grão de safra passada contra contrato novo acontece, e travar o caminhão seria o remédio errado |
O aviso traz os dois números que o motivaram, e a gravação prossegue. O
aviso de entrega além do comprometido traz também a diferença, e o de safra
divergente nomeia as duas safras — a do contrato e a de onde o grão saiu.
O primeiro aparece numa janela, ao salvar o contrato, e você confirma que
leu antes de a tela sair: ele é dito uma vez, na assinatura, e não volta a
aparecer no detalhe depois.
Sem meta de produtividade cadastrada não há o primeiro aviso. A ausência do parâmetro não vira um zero contra o qual tudo pareceria excessivo.
O grão entregue continua pertencendo à safra de origem do romaneio mesmo quando abate um contrato de outra safra. O compromisso é de uma safra; o grão é de onde saiu do chão.
O que o contrato não faz, e por quê#
Contrato com fornecedor é a trava do barter. A contraparte pode ser cliente ou fornecedor, e a troca de insumo por grão entra exatamente por essa porta: a carga entregue ao fornecedor abate o contrato como qualquer outra, e não vira receita. Como se registra está no guia de Compras.
Depósito em armazém de terceiro não abate contrato. Depósito não é entrega: o grão mudou de lugar, não de dono. Só o romaneio que sai para a contraparte abate o compromisso.
A referência da fixação é digitada. O Agronfe não busca cotação de bolsa: você informa o preço de referência já convertido para reais, na unidade do contrato. O que o sistema garante é que os três números da negociação fiquem gravados e congelados — não que a cotação existiu.
Da carga para a venda
Com o preço fechado, o romaneio vira dinheiro sem você redigitar peso nenhum.
- Acesse Vendas e clique em Nova Venda (ou abra um rascunho existente)
- Salve o rascunho — os romaneios só entram numa venda que já existe
- Na seção Romaneios, clique em Adicionar romaneio
- Escolha a carga na lista de romaneios disponíveis
- Escolha a unidade de negociação — saca de 60 kg, saca de 50 kg, tonelada, arroba ou quilo
- Informe o preço por unidade, o valor cotado com o comprador
- Clique em Adicionar à venda
A lista mostra apenas romaneios fechados e ainda não vendidos. Carga aberta não aparece; carga que já está em outra venda também não.
O que o sistema traz e o que você digita#
Cada romaneio vira um item de venda. A quantidade é o peso líquido final convertido para a unidade escolhida, e o desconto é o total dos serviços. Só o preço por unidade é editável — peso e descontos vêm da carga, e digitá-los de novo só criaria uma segunda versão da verdade.
Se a carga aponta um contrato, nem o preço é digitado: ele já vem preenchido pela fixação que a entrega consumiu, e continua editável.
| Peso líquido final | 26.456,401 kg |
| Unidade de negociação | Saca 60 kg |
| Quantidade | 440,940 sc |
| Preço por unidade | R$ 128,00 |
| Subtotal | R$ 56.440,32 |
| Desconto (serviços do romaneio) | − R$ 999,10 |
| Total do item | R$ 55.441,22 |
Vários romaneios na mesma venda#
É o caso normal. A semana de entregas para o mesmo comprador entra como uma venda com quatro, cinco itens — cada carga com sua própria origem, seu próprio peso e seu próprio preço, se os preços foram diferentes.
Retirar um romaneio#
Retirar romaneio devolve a carga para a lista de disponíveis, e ela volta a ser editável. Nada é excluído.
Se você tentar levar para uma venda um romaneio que outra venda já pegou, o Agronfe recusa dizendo em qual venda ele está. Uma carga pertence a no máximo uma venda — é o que impede o mesmo caminhão de ser faturado duas vezes.
Expedição: vender o grão que já está no armazém
Às vezes o grão já está na cooperativa quando o comprador aparece — não há caminhão para pesar, porque a carga já saiu há semanas, pelo depósito. A expedição é como você entrega esse grão: ela abate o contrato e leva o preço para a venda, sem um romaneio novo.
Registrar a expedição#
- Acesse Vendas e abra Expedições
- Clique em Nova expedição
- Escolha o Armazém de onde o grão sai, a Cultura, a Safra e a Data da saída
- Informe a Quantidade, na unidade de produção da cultura
- Escolha o Produto e, se houver, a contraparte — Cliente ou Fornecedor
- Se a contraparte tiver um contrato em aberto para essa cultura, escolha-o em Contrato — a lista já está filtrada pela contraparte escolhida e mostra o produto e o saldo que falta entregar
- Clique em Registrar expedição
Expedição com contraparte Fornecedor liquida a trava de um barter, pelo mesmo caminho e com a mesma regra da carga pesada: ela abate o saldo da trava e não vira receita.
A cultura e a safra são declaradas por você, não adivinhadas. O grão se mistura no armazém, e não guarda mais de qual cultivo veio — a mesma razão pela qual a transferência entre armazéns também pede a safra na saída.
Sem fase de rascunho#
Diferente do romaneio, a expedição não existe aberta: no instante em que você a registra, o saldo do armazém já foi debitado e o contrato apontado já foi abatido. Não há "fechar" depois — a expedição nasce pronta.
Por isso ela não tem campos que se editam depois de criada. Para corrigir um erro, cancele a expedição (abaixo) e registre outra.
Saldo insuficiente avisa e prossegue#
Se a quantidade da expedição passa do saldo do armazém, o Agronfe avisa a diferença e registra assim mesmo — o saldo fica negativo. É a mesma lógica do romaneio: travar a expedição por causa de um saldo que pode estar subdeclarado é pior do que o aviso.
O mesmo vale para o contrato: expedir mais do que o contrato ainda compromete é aceito, com aviso; e expedir grão de uma safra diferente da que o contrato nomeia também é aceito, com aviso citando a safra do contrato.
O preço vem das fixações, como no romaneio#
Quando você leva a expedição para uma venda — em Adicionar expedição, ao lado de Adicionar romaneio —, o preço nasce das fixações do contrato consumidas em FIFO por data, com média ponderada quando a expedição atravessa duas, exatamente como acontece com o romaneio. Sem contrato, ou com a parte que passa do total fixado, o preço é digitado.
Cancelar uma expedição#
Cancelar expedição devolve ao contrato exatamente a quantidade que ela havia abatido — nunca uma recontagem — e devolve a mesma quantidade ao saldo do armazém. A expedição deixa de ser listada; cancelá-la de novo não devolve nada uma segunda vez.
Uma expedição que já está numa venda não pode ser cancelada direto: retire-a da venda primeiro.
O que a expedição não carrega#
Ela não entra na receita por cultivo. O grão foi misturado no armazém antes de ser expedido, então esta entrega não guarda de qual cultivo veio: a receita dela entra na receita da safra, mas não é atribuída a nenhum cultivo. A quantidade continua contando no entregue da safra.
Ela não é um romaneio. Uma safra que só teve expedição — nenhuma carga passou pela balança — mostra 0 romaneios na contagem de entregas, com quantidade entregue maior que zero: a tela explica que aquela quantidade saiu por expedição de grão armazenado, e não por carga.
A venda de produto de estoque
O caminho de sempre continua inteiro. Adubo que sobrou, semente revendida, qualquer item do catálogo: nada disso mudou.
Adicionar produtos#
- Na seção Itens, clique em Adicionar Produto
- Selecione o produto do catálogo
- Informe a Qtd
- O Preço Un. é digitado a cada venda — não há tabela de preço no agro, o preço é o que foi negociado
- Se for o caso, informe um Desconto por item, em R$
- Confirme
O preço unitário é fixado no momento da adição: se o preço do produto mudar depois, as vendas anteriores não mudam junto.
Responsável#
Uma venda tem um responsável. Ao criar a venda você já entra selecionado; troque enquanto o rascunho está aberto, escolhendo entre os usuários ativos. Depois da confirmação, o responsável fica congelado.
O nome fica gravado como estava no dia da venda: se a pessoa for renomeada depois, a venda antiga continua dizendo quem a fez.
Cliente#
No campo Cliente, busque e selecione o comprador. Vendas sem cliente associado são permitidas. Vincular mantém o histórico no cadastro dele.
Descontos#
- Por item — o subtotal vira
(quantidade × preço) − desconto - Geral da venda — abatido sobre a soma dos subtotais
Num item que veio de romaneio, o desconto já está preenchido com os serviços da carga.
Pagamento e confirmação
- Revise os itens e o total
- Na seção Opções, toque em Registrar Pagamento
- Escolha a Forma de Pagamento e informe o Valor
- Para Dinheiro, informe o Valor Recebido — o troco é calculado
- Se precisar, toque em Adicionar Pagamento para incluir outra forma
- Toque em Confirmar Pagamento
Ao confirmar o pagamento, a venda passa a Confirmada. Não há um botão separado de confirmação.
As formas disponíveis são Pix (padrão), Dinheiro, Cartão de Crédito, Cartão de Débito, Transferência e Outro. A soma dos pagamentos precisa alcançar o total da venda; faltando, a confirmação é recusada com o quanto falta.
O grão não baixa estoque#
Item que veio de romaneio não consulta e não baixa estoque. O grão nunca entrou no estoque: ele saiu do talhão e foi para o caminhão, e procurar um saldo de silo que nunca existiu só produziria uma recusa sem sentido.
Item de catálogo continua baixando normalmente — inclusive na mesma venda. Uma venda com uma carga de soja e dois sacos de adubo confirma com o adubo saindo do estoque e a soja não.
Ao confirmar, o romaneio fica congelado: peso, classificação, serviços e origens viram somente leitura, e o recebível é criado no Financeiro sobre o total já líquido dos serviços.
Se a confirmação for recusada por falta de estoque numa venda de grão, o item foi lançado como produto de catálogo, sem romaneio — e caiu no caminho de estoque. Registre o romaneio da carga e traga-o pela ação Adicionar romaneio.
Cancelar uma venda
Venda confirmada#
- Abra a venda e, na seção Opções, toque em Cancelar Venda
- Informe o Motivo do Cancelamento (obrigatório, até 500 caracteres)
- Confirme
Os romaneios voltam para abertos e reaparecem na lista de disponíveis, editáveis de novo — um erro de preço não obriga a redigitar três caminhões. O histórico do vínculo fica preservado.
O estoque dos itens de catálogo é restaurado. Os itens de grão não geram estorno, porque não houve baixa. Numa venda mista, só o insumo volta.
O recebível é cancelado junto, e a receita do cultivo cai para o valor anterior na hora.
Vendas canceladas não podem ser reativadas.
Rascunho#
Abra o rascunho e toque em Descartar Rascunho. Ele é apagado sem justificativa e sem movimentação de estoque. Os romaneios que estavam nele voltam a ficar disponíveis.
Conferência com o comprador
O comprador pesa de novo e classifica de novo. Divergência é normal; divergência que ninguém viu é que custa dinheiro.
Preencha, na seção Nota do comprador do romaneio, o peso líquido e o valor líquido que ele apurou. O Agronfe mostra:
| O que aparece | |
|---|---|
| Diferença de peso | Em quilos, entre o seu peso final e o dele |
| Diferença percentual | A mesma diferença, em % |
| Diferença de valor | Em R$, entre o líquido da fazenda e o dele |
| Quem pesou a mais | A fazenda ou o comprador, com a diferença |
| Conferência | Dentro da tolerância desta carga, ou passa dela |
A comparação é entre os dois pesos finais — o número que o comprador imprime já vem líquido da classificação dele. A tolerância é a que estava no padrão no dia em que a carga fechou: uma carga de março continua sendo julgada em setembro pela régua de março.
A diferença de valor só existe depois que o romaneio entra numa venda com preço. Antes disso não há o seu lado da conta para comparar.
Nada disso bloqueia. É informação para a conversa com o comprador, não trava. Na lista de romaneios, o filtro Somente cargas divergentes reúne as que passaram da tolerância.
Receita, margem e saldo de grão
Aqui é onde a venda encontra o talhão. Três números, em três lugares.
Receita por cultivo e por safra#
Na tela de custo do cultivo e na de custo da safra — as mesmas do módulo de Operações de campo —, o bloco Receita mostra:
- Receita total e receita por hectare
- Receita por unidade entregue (R$ por saca)
- Entregue, com a contagem de vendas e romaneios que formaram o número
A receita por hectare usa a mesma área plantada que o custo por hectare usa. Se fossem dois denominadores diferentes, a margem seria a subtração de duas frações incomparáveis.
Só venda confirmada entra. Rascunho não entra; cancelada sai.
Esta é a receita realizada: grão que saiu e foi faturado. Ela não se confunde com a receita esperada do contrato, que é o que ainda está fixado e não entregue. As duas nunca se somam.
Receita não alocada#
Aparece ao lado do total, com a contagem de romaneios sem cultivo, e é da fazenda inteira e de todo o período — não só daquele cultivo ou daquela safra.
Ela nunca é redistribuída entre os cultivos e, por isso, não entra em nenhuma margem. É o número que responde "quanto eu vendi sem saber de onde veio".
Margem#
Logo abaixo, o bloco Margem: receita menos custo, com margem por hectare e margem %.
A margem herda as marcas dos dois lados e não esconde nenhuma:
- Custo incompleto — há linha de insumo ou de máquina sem valor, e a margem está calculada sobre um custo menor que o real
- Sem receita registrada — o cultivo tem custo e nenhuma venda ainda. A margem é o custo, negativo, e a tela diz isso em vez de aparecer vazia
Ver a margem exige as duas permissões, field_ops:operation:read e sale:sale:read. Quem tem só uma vê só o bloco correspondente, sem erro.
Saldo de grão#
Na tela do cultivo e na da safra, o bloco Saldo de grão mostra colhido, armazenado, perdido, entrada externa e entregue, na unidade de produção da cultura — cada número vindo do módulo que o publica, montados na mesma tela:
- Colhido vem das colheitas lançadas em Safras e cultivos
- Armazenado vem do saldo por armazém em Grão Armazenado — a soma de todos os locais daquela cultura e safra
- Perdido e Entrada externa (grão comprado ou devolvido) também vêm do mesmo lugar
- Entregue vem das origens dos romaneios e das expedições em vendas não canceladas
- Saldo é o que sobra da conta — o que ainda está com você
É uma leitura, não uma reserva: não há bloqueio de estoque, movimento nem trava. Registrar um romaneio ou uma expedição faz o saldo cair; cancelar a venda ou a expedição faz o saldo voltar.
Ausência não é zero. Se ninguém lançou entrada de grão para uma cultura, a tela diz que não há registro de armazenagem, em vez de mostrar armazenado igual a zero — são fatos diferentes, e confundi-los esconderia grão que existe.
Entregue maior que colhido não é recusado — aparece um aviso com a diferença, sugerindo conferir as colheitas lançadas ou as origens dos romaneios e expedições. Colheita subdeclarada é comum, e travar o caminhão por causa dela seria o remédio errado.
O saldo de grão responde quanto ainda está com você. Quanto ainda dá para prometer a alguém é outra pergunta, e quem responde é o bloco Vendido e livre da safra.
Grão entregue por expedição soma no entregue, não na contagem de romaneios#
A contagem de romaneios que forma o entregue (na receita por cultivo e por safra, acima) só conta cargas que passaram pela balança. Uma expedição entra na quantidade entregue da safra, mas não é romaneio — ela não aparece nessa contagem.
Isso produz uma tela que é correta e, à primeira vista, estranha: uma safra vendida inteiramente por expedição mostra 0 romaneios ao lado de uma quantidade entregue positiva. Não é um bug — é o grão que saiu do armazém sem carga nova para pesar.
E, pelo mesmo motivo, essa quantidade não entra na receita de nenhum cultivo. O grão expedido já estava misturado no armazém: a receita dessa entrega aparece na safra, mas não em nenhum cultivo específico — diferente do romaneio, que carrega a origem por talhão desde a carga (veja Origem).
PDF e CSV
PDF do romaneio#
Na seção Opções do romaneio, Gerar PDF produz o documento da carga: número, data, produto, comprador, transporte, os três pesos, a classificação item a item, os serviços linha a linha com subtotais próprios e o peso líquido final.
São os dois blocos separados que tornam a conferência possível: você compara os quilos com os quilos dele e os reais com os reais dele.
Um romaneio ainda aberto imprime marcado como provisório, porque o peso líquido final só é congelado no fechamento.
PDF da venda#
Na seção Opções da venda, Gerar PDF exporta o comprovante, com prévia antes de compartilhar.
CSV de romaneios#
Na lista de romaneios, Exportar CSV baixa o que o filtro aplicado selecionou. Se a exportação atingir o limite do arquivo, o Agronfe avisa que nem todos os romaneios do filtro entraram — estreite o filtro para levar o resto.
CSV de receita da safra#
Na tela de custo da safra, Exportar receita (CSV) baixa a receita por cultivo.
As linhas de origem sem cultivo não entram no arquivo, e o Agronfe informa quantas ficaram de fora e quanto elas somam: o total do arquivo é menor que o da tela por exatamente essa diferença.
Acompanhar
Lista de romaneios#
Busque por número, comprador ou produto. O botão de Filtros refina por:
| Filtro | Opções |
|---|---|
| Situação | Aberto, Fechado, Vinculado à venda |
| Período | Intervalo de datas da carga |
| Divergência | Somente cargas divergentes |
Lista de vendas#
A lista mostra o número da venda, o selo de situação, o cliente, a data e o total. Os filtros são Status (rascunho, confirmada, cancelada), Período e Responsável.
| Situação | O que dá para fazer |
|---|---|
| Rascunho | Editar, adicionar romaneio, registrar pagamento, duplicar, gerar PDF, descartar |
| Confirmada | Visualizar, cancelar, duplicar, gerar PDF |
| Cancelada | Visualizar, duplicar, gerar PDF |
Detalhes da venda#
O detalhe reúne informações básicas, itens, romaneios, pagamentos, totais e — nas canceladas — o motivo, quem cancelou e quando.
Duplicar#
Duplicar Venda cria um rascunho com os mesmos itens, copiando cliente e desconto geral e usando os preços atuais dos produtos. Observações não são copiadas, e itens cujo produto foi removido ou inativado são omitidos.
Os itens que vieram de romaneio não são copiados. Aquela carga já foi vendida, e uma cópia dela ou duplicaria a receita de um caminhão ou apontaria para uma carga que a nova venda não pode ter. O próximo caminhão entra pela ação Adicionar romaneio.
Romaneios parados#
O painel inicial pode exibir o widget Romaneios parados: cargas entregues que continuam abertas, sem preço fechado, há 30 dias ou mais. É o lembrete de que grão saiu da fazenda e ainda não virou dinheiro.
Registrar a carga pelo assistente
O Assistente de IA registra a carga por voz, no pátio, enquanto o caminhão é pesado — em vez de à noite, de memória.
Ele consegue criar o romaneio, lançar a classificação, listar os romaneios e consultar a receita de um cultivo. O número do romaneio é atribuído pelo sistema, e o peso líquido nunca é ditado: ele é bruto menos tara.
O fechamento continua sendo feito na tela, porque é ele que congela o peso final.
Sobre contrato ele lê e não escreve: consulta um contrato, lista os contratos e diz quanto de uma safra já está comprometido — o suficiente para responder ao comprador no telefone. Registrar contrato e fixar preço continuam sendo feitos na tela: são compromissos que se assinam, não que se ditam.
O assistente respeita as suas permissões exatamente como as telas respeitam.
Permissões
| Permissão | O que libera |
|---|---|
sale:sale:list |
Acessar a lista de vendas |
sale:sale:read |
Ver detalhes da venda, a receita e a margem |
sale:sale:create |
Criar e duplicar vendas |
sale:sale:update |
Editar e descartar rascunhos, vincular e retirar romaneios |
sale:sale:confirm |
Registrar pagamento e confirmar |
sale:sale:cancel |
Cancelar vendas confirmadas |
sale:scale_ticket:read |
Ver romaneios — e é o que habilita o seletor de romaneio na venda |
sale:scale_ticket:create |
Registrar romaneio |
sale:scale_ticket:update |
Editar, classificar, lançar serviço, apontar origem, fechar e reabrir |
sale:scale_ticket:delete |
Excluir romaneio |
sale:grading_standard:read |
Ver padrões de classificação |
sale:grading_standard:create |
Cadastrar padrão |
sale:grading_standard:update |
Editar, aposentar e reativar padrão |
sale:grading_standard:delete |
Excluir padrão |
sale:contract:read |
Ver contratos, saldo, preço médio, receita esperada e o bloco Vendido e livre da safra — e é o que habilita o seletor de contrato no romaneio |
sale:contract:create |
Registrar contrato |
sale:contract:update |
Alterar quantidade (com razão), janela de entrega e observações |
sale:contract:fix_price |
Fixar preço e estornar fixação |
sale:contract:delete |
Cancelar contrato |
sale:delivery:read |
Ver expedições e escolhê-las na venda |
sale:delivery:create |
Registrar expedição |
sale:delivery:delete |
Cancelar expedição |
Classificação, serviço e origem não têm permissão própria: são sub-recursos do romaneio e seguem sale:scale_ticket:update. O destino do romaneio (venda ou depósito) segue a mesma regra — e mover grão para um armazém de terceiro exige também inventory:grain_lot:transfer (veja Grão Armazenado).
Fixação e aditivo também não têm permissão de leitura própria: quem vê o contrato vê as duas listas. Escrever é que se separa — travar preço (sale:contract:fix_price) é decisão diferente de mudar quantidade (sale:contract:update).
Alterar um romaneio que aponta contrato exige também sale:contract:read. Sem ela a carga continua visível, mas a tela avisa que salvar será recusado — em vez de deixar você digitar e descobrir depois.
A receita e a margem também não têm permissão própria — ficam sob sale:sale:read, do mesmo jeito que o custo fica sob field_ops:operation:read. Para ver a margem é preciso ter as duas.
O saldo de grão aparece nas telas de cultivo e de safra para quem tem sale:sale:read — o entregue vem daqui. Sem essa permissão o bloco simplesmente não aparece, e o resto da tela de cultivo continua funcionando.
Problemas comuns
"Não consigo fechar o romaneio."
As origens não fecham com o peso líquido. A mensagem traz os dois números; ajuste a linha de origem até o "falta distribuir" zerar.
"Não consigo editar o romaneio."
Ele não está aberto. Se está numa venda, retire-o dela; se está fechado, reabra.
"O romaneio não aparece na hora de adicionar à venda."
Ele precisa estar fechado e não vinculado. Carga aberta e carga que já está em outra venda não são oferecidas.
"Este romaneio já está na venda #N."
Uma carga pertence a uma venda só. Retire-a de lá, ou escolha outra carga.
"A confirmação foi recusada por falta de estoque, mas eu estou vendendo grão."
O item foi lançado como produto de catálogo, sem romaneio, e caiu no caminho de estoque. Registre o romaneio e traga a carga por Adicionar romaneio.
"Editei o padrão e o peso final do romaneio não mudou."
É proposital. O padrão foi congelado na carga no fechamento. Para recalcular, reabra o romaneio e feche de novo.
"A umidade veio abaixo da base e não gerou bônus."
Também é proposital. O desconto é zero, nunca negativo — prêmio por qualidade é cláusula de contrato, não regra de classificação.
"A receita da safra não bate com a soma dos cultivos."
Confira a receita não alocada: são os romaneios sem cultivo. Ela é contada à parte e nunca é distribuída. Aponte a origem daqueles romaneios para trazê-la para dentro.
"O saldo diz que entreguei mais do que colhi."
Ou falta lançar colheita no cultivo, ou alguma origem de romaneio está com o peso ou o cultivo errado. O aviso traz a diferença; ele nunca impede a entrega.
"Não consigo excluir o padrão de classificação."
Há romaneios que o usaram. Aposente o padrão: ele some das cargas novas e o histórico continua explicável.
"Cancelei a venda e os romaneios sumiram."
Eles voltaram para abertos e estão na lista de romaneios. Feche-os de novo — ou leve-os direto para outra venda, se nada mudou na carga.
"O contrato não aparece para eu apontar no romaneio."
Três condições: o romaneio precisa estar salvo com contraparte e produto, o contrato precisa ser da mesma contraparte e do mesmo produto, e precisa estar em aberto. A lista é montada a partir do que já está gravado na carga.
"Não consigo fixar preço neste contrato."
Ou ele é a preço fixo — e já nasceu com a fixação integral, sem quantidade sobrando — ou está cancelado.
"A fixação foi recusada por passar do contrato."
A soma das fixações vigentes não pode ultrapassar a quantidade comprometida. A mensagem diz quanto já está fixado e quanto ainda resta.
"Errei a fixação e não consigo editar."
É proposital. Estorne com a razão e lance a fixação certa. As duas linhas ficam visíveis, e é isso que torna o contrato explicável depois.
"Entreguei e o saldo do contrato não mudou."
O abatimento acontece no fechamento da carga, não ao salvá-la. Romaneio aberto não abate nada.
"O preço não veio preenchido quando adicionei o romaneio à venda."
A carga saiu além do total fixado, e não há fixação para atribuir a ela. Isso não é preço zero: informe o preço que foi acordado.
"A receita esperada caiu depois que eu entreguei."
É o comportamento certo. O que saiu deixou de ser esperado e virou receita realizada do outro lado. Somar as duas contaria a mesma saca duas vezes.
"O livre da safra aparece como 'Não dá para calcular'."
Ou a cultura tem contrato em mais de uma unidade de negociação nesta safra, ou a safra não tem meta de produtividade nem colheita lançada. A tela diz qual dos dois é. Em nenhum dos casos o livre é zero — ele é desconhecido.
"Não consigo escolher armazém de destino no romaneio."
O campo só aparece quando o destino é Depósito. Escolha Depósito na seção Destino da carga primeiro.
"O romaneio de depósito recusa o armazém de destino."
O armazém de destino precisa ser de terceiro, com depositário cadastrado. Cadastre o depositário no local (veja Armazém de terceiro e depositário) antes de tentar de novo.
"Troquei o destino para Depósito e o contrato sumiu da carga."
É proposital. Depósito e contrato não convivem: depositar não é entregar, então a carga de depósito não pode apontar contrato nenhum.
"A expedição registrou saldo negativo no armazém."
A quantidade expedida passou do saldo que o sistema tinha registrado para aquele armazém. Não é erro — é aviso: confira se falta lançar uma entrada de grão ou se a quantidade digitada está certa.
"A safra mostra 0 romaneios, mas tem grão entregue."
O grão saiu por expedição, não por carga pesada na balança — a contagem de romaneios não inclui expedição, embora a quantidade entregue inclua.
"A receita da expedição não aparece em nenhum cultivo."
É o comportamento esperado: o grão se mistura fisicamente no armazém, então o vínculo com o cultivo não sobrevive até a expedição. A receita entra na safra, não em nenhum cultivo específico.