📘 Tela: Contrato de Venda/Compra

É onde o negócio fechado com a trading ou a cooperativa vira um registro no sistema: tanto de produto, a tanto por saca, para embarcar entre tal e tal data. A partir daí, cada romaneio de saída abate do contrato — e a tela mostra, a qualquer momento, quanto já embarcou e quanto ainda falta.

O contrato sozinho não tira nada do estoque. Ele é o combinado: registra o que foi acertado e serve de referência. Quem baixa o saldo é o romaneio de saída, caminhão a caminhão. Um contrato de 2.000 toneladas pode ser fechado com o armazém ainda vazio — é o caso da venda futura, acertada antes de a produção entrar.

O contrato é também o lugar onde ficam guardados os parâmetros fiscais da venda, quando há emissão de nota: natureza da operação, série, CFOP, CST, transportadora e informação complementar.

📍 Localização no sistema

Menu: Armazenagem > Contrato de Venda/Compra


🧩 Função principal

Controlar o saldo de cada contrato — quantidade contratada, embarcada e restante — e reunir num só lugar o preço combinado, os descontos de classificação aceitos pelo comprador e os dados fiscais da nota.


🔀 Venda ou Compra

O Tipo é escolhido na criação e não muda depois de salvo. Ele inverte os papéis dos campos de entidade:

  • Venda — o campo principal é Comprador(Entidade), quem está levando o produto; o campo de terceiro é Vendedor (terceiro).
  • Compra — o campo principal passa a ser Vendedor(Entidade) e o de terceiro, Comprador(terceiro).

📝 Campos do cabeçalho

CampoDescrição
SituaçãoAberto, Iniciado, Finalizado, Cancelado e Venda futura. Contrato finalizado ou cancelado não aparece mais para escolha nos romaneios.
Configuração fiscalQual CNPJ da filial emite a nota deste contrato.
Safra Origem / AnoA safra do produto negociado.
MoedaMoeda do contrato. É ela que decide qual bloco de valores fica ativo.
DataData do fechamento do negócio.
Número (nosso)Obrigatório. A numeração da fazenda.
Número (fornecedor)O número que o comprador usa para o mesmo contrato — é por ele que a trading vai se referir ao negócio.
Comprador(Entidade)Obrigatório. Com quem o contrato foi fechado. Preenche o Endereço, que fica só para leitura.
Local de EstoqueObrigatório. De onde o produto sai (ou para onde entra, na compra).
CulturaObrigatória. Além de classificar o contrato, é o campo Unidade dela que define se a quantidade é convertida em sacas ou em arrobas.
ProdutoObrigatório. O que está sendo negociado — algodão em pluma, caroço, milho em grãos.
Data Inicial / Final EmbarqueA janela de embarque combinada.
Quantidade KGObrigatória e maior que zero. O total contratado, em quilos. É sempre em KG que o contrato controla o saldo — as demais unidades são só leitura do mesmo número.
Quantidade SC ou Quantidade @O mesmo total, na unidade em que aquele produto é negociado — e o rótulo do campo muda junto: Quantidade SC para grão (60 kg a saca) e Quantidade @ para algodão (15 kg a arroba). Quem manda é o campo Unidade da Cultura. Digitar de um lado preenche o outro.
Quantidade Embarcada KGSomada pelos romaneios. Não se digita.
Quantidade Restante KGO que falta embarcar. Cai a cada romaneio e é o que decide se o contrato ainda aparece na hora de lançar um novo. Não é uma trava: o sistema não impede que o embarque passe do contratado.
Campo quantidadeQual valor do romaneio é levado para a nota: Líquido Final (o padrão), Líquido Inicial ou Quantidade. Escolhendo Quantidade, o romaneio de saída passa a exibir um campo Quantidade para digitação.
Responsável pelo impostoNós ou Eles — de quem é o imposto da operação. Define em qual totalizador do contrato o imposto dos romaneios é acumulado.
Quem vendeu / Quem comprou (negociante)O corretor ou negociante que intermediou — campo livre.
ObservaçãoCampo livre.

💵 Os valores

O bloco de valores traz Valor Unitário (KG), o valor unitário na unidade do produto (SC ou @, com o rótulo mudando junto), Valor total, V. Frete Total, V. Líquido e V. Impostos Total. Preencher o unitário por quilo atualiza o por saca e o total, e vice-versa. O V. Líquido é obrigatório para salvar.

Há três blocos de valores, um por moeda, e os blocos de moeda estrangeira trazem também a Cotação. Mudar a cotação reprocessa os valores convertidos.


🧪 % Classificação/Desconto

É o bloco que diz como o comprador aceita descontar a carga. Para cada tipo — umidade, impureza, quebrado, ardido, avariado e armazenagem — escolhe-se a tabela de desconto padrão que vale neste contrato. As marcações manual ao lado (umidade, impureza, ardido, avariado e armazenagem) abrem o campo de desconto para digitação em vez de buscar na tabela.

Um tipo sem tabela escolhida simplesmente não aparece no romaneio ligado a este contrato — é assim que se enxuga a tela de quem só desconta umidade e impureza, por exemplo.


🗂 Guias

Aditivos

Registra as alterações de quantidade combinadas depois do fechamento. Cada aditivo tem Tipo (Adicionando ou Retirando), Data, Número, Quantidade KG, a quantidade na unidade do produto, valores unitários e V. Líquido. O aditivo altera a quantidade restante do contrato: adicionando aumenta o saldo a embarcar, retirando diminui.

NF-E - Paramêtros p/ Emissão de Nota Eletrônica

Nem todo contrato emite nota. Venda interna — o milho que vai para o confinamento da própria fazenda, por exemplo — é registrada em contrato só para controlar a quantidade. Nesse caso, basta deixar esta guia e a de detalhes em branco: o contrato funciona normalmente e o romaneio de saída segue baixando o estoque; o que não vai existir é o Gerar NF.

Quando há emissão, é aqui que ficam os dados que a nota vai usar: Meio pagamento, Modalidade do frete, Transportador (se for fixo), Centro de custo, Série, Natureza da operação, Espécie e a Informação complementar — o texto legal que sai no rodapé da nota, onde cabem campos automáticos (o botão acima do campo lista quais estão disponíveis, como o motorista e o CPF do veículo). O botão Copiar Parâmetros de outro contrato traz tudo isso de um contrato já configurado.

NF-E - Detalhes (produtos)

Os itens que entram na nota, com Produto, NCM, Unidade, Quantidade, Valor unitário e o bloco de ImpostosCFOP, CST de ICMS, PIS, COFINS e IPI, com as alíquotas e a redução de base. Ao escolher o CST, a alíquota padrão cadastrada vem junto. É esta guia que o romaneio consulta ao gerar a nota: sem item aqui, a nota não sai.

Arquivo

Anexos do contrato — o PDF assinado, o aditivo digitalizado. Cada anexo tem Título, Descrição, nome do arquivo e Observação, e a lista traz um botão visualizar que abre o documento.


💰 Finalizar e Gerar Financeiro

  • Finalizar encerra o contrato; no contrato já finalizado, o mesmo botão pergunta se você quer reabrir.
  • Gerar Financeiro abre a janela que transforma o valor líquido do contrato em parcelas a receber no financeiro. O campo ao lado do botão mostra o título já gerado.

📋 A lista

A lista filtra por Safra e por Tipo (Venda, Compra ou Todos), e traz a Situação como etiqueta colorida, além de quantidade, valor líquido, quantidade embarcada e restante — dá para ler o andamento de todos os contratos da safra numa tela só. O botão Ver estoque abre o saldo atual sem sair daqui, e Relatórios ▼ lista os relatórios liberados para esta tela.

Resultado: com os contratos cadastrados:
  • Dá para saber, a qualquer momento, quanto falta embarcar de cada contrato
  • Na hora do embarque, quem lança o romaneio já encontra o contrato certo, com o saldo à vista
  • Havendo emissão de nota, ela sai do romaneio com os parâmetros fiscais combinados

❓ Perguntas frequentes

O contrato não aparece para escolher no romaneio. Por quê?

Três motivos cobrem quase todos os casos: o contrato está finalizado ou cancelado, a quantidade restante chegou a zero, ou ele é de outra safra/filial que não a selecionada no filtro da lista de romaneios. Confira a situação e a quantidade restante na lista de contratos.

Combinei mais quantidade com o comprador. Crio outro contrato?

Não precisa: use a guia Aditivos, com o tipo Adicionando. A quantidade restante do contrato aumenta e o histórico do que foi combinado depois fica registrado. Para reduzir, o tipo é Retirando.

O romaneio não gera a nota fiscal. O que falta no contrato?

Quase sempre é a parte fiscal incompleta: natureza da operação e série na guia de parâmetros, ou item sem CST de ICMS, PIS, COFINS e IPI, ou produto sem NCM e sem unidade na guia de detalhes. Também é exigido o código IBGE do município na entidade do contrato e na transportadora. O aviso na tela indica qual dos itens está faltando.

Vendo para dentro da própria fazenda, sem nota. Dá para usar contrato?

Dá, e é um uso comum — o milho que vai para o confinamento, por exemplo. Cadastre o contrato normalmente e deixe as guias de NF-E em branco: você continua controlando quantidade contratada, embarcada e restante, e o romaneio de saída continua baixando o estoque. Só não haverá nota a emitir.

Fechei contrato antes de colher. O sistema deixa?

Deixa. O contrato registra o combinado, não o estoque — quem baixa saldo é o romaneio de saída. Venda futura, fechada antes de a produção entrar, é lançada normalmente, e a situação Venda futura existe justamente para deixar isso claro na lista.

Para que serve o campo "Campo quantidade"?

Para dizer qual peso do romaneio vale como quantidade da nota. O normal é Líquido Final — o peso já descontado. Escolhendo Quantidade, o romaneio de saída ganha um campo próprio de quantidade, usado quando o que se cobra não é o peso da balança.

A quantidade converteu em arroba e eu esperava saca. Por quê?

A saca é sempre de 60 kg e a arroba, de 15 kg — isso não se configura em lugar nenhum. O que o sistema precisa saber é em qual das duas aquele produto é negociado, e isso vem do campo Unidade da Cultura: em SC - Sacas o campo se chama Quantidade SC e divide os quilos por 60; em @ - Arroba, vira Quantidade @ e divide por 15. Se converteu na unidade errada, o ajuste é no cadastro da cultura. O saldo do contrato, em todo caso, continua sendo controlado em quilos.

Finalizei um contrato por engano. Dá para voltar atrás?

Dá. Selecione o contrato e clique de novo em Finalizar: no contrato já finalizado, o botão pergunta se você quer reabri-lo, e ele volta para a situação Aberto.