Modulo Agricola

Controle de contratos de venda agricola

Use esta tela para registrar contratos de venda de produtos agricolas, controlar quantidades contratadas, entregas ja baixadas, saldos em aberto, janelas de entrega e volumes ainda a fixar.

1. Visao geral

Um contrato de venda agricola representa um compromisso comercial entre o produtor e um cliente comprador. Cada contrato possui cabecalho, um ou mais produtos contratados e, quando houver venda vinculada, baixas que reduzem o saldo em aberto.

Cabecalho Cliente comprador, safra digitada livremente, data de fechamento, numero, instrumento, status, local de entrega, condicao de pagamento e observacoes.

Produtos contratados Produto, quantidade, unidade padrao do cadastro, tipo de precificacao, preco ou indice, janela de entrega e tolerancia.

Baixas Entregas/vendas vinculadas ao contrato, com quantidade baixada, unidade, valor e origem.

Aditivos Registro historico de mudancas de quantidade, prazo, preco ou tolerancia.

2. Cards de resumo

Na parte superior, a tela mostra indicadores para acompanhar rapidamente a carteira de contratos:

Card	O que mostra
Contratos	Quantidade de contratos distintos na posicao.
Saldo aberto	Soma dos saldos ainda nao entregues nos itens dos contratos.
Vencendo	Contratos com janela de entrega proxima/vencendo e saldo em aberto.
A fixar	Volume contratado com precificacao "A fixar" ainda sem preco travado.

3. Abas da tela

Contratos: lista principal com contrato, cliente, produto, contratado, entregue, saldo e status.
Janelas vencendo: destaca contratos com prazo de entrega relevante e saldo aberto.
Volume a fixar: mostra itens com risco comercial por ainda dependerem de indice/preco futuro.

Use o lapis para abrir o contrato. Durante o carregamento, o icone vira spinner e os demais comandos de edicao ficam bloqueados.

4. Incluir contrato

Abra o formulario

Clique em Incluir contrato, acima do grid da aba Contratos.

Preencha o cabecalho

Informe comprador, safra, data de fechamento, numero, instrumento e demais dados comerciais.

Grave o contrato

Clique em Gravar contrato. Ao terminar a gravacao, o popup fecha e a posicao e atualizada.

Reabra para inserir produtos

Depois de salvo, abra o contrato pelo lapis e inclua os produtos contratados.

A safra e digitada livremente, por exemplo 24/25, 25-26 ou outra convencao usada pela fazenda.

5. Produtos contratados

Os produtos representam os itens efetivamente vendidos no contrato. A unidade utilizada e a unidade padrao do cadastro do produto, a mesma usada nas compras e vendas, evitando conversoes.

Campo	Descricao
Produto contratado	Produto cadastrado no FarmPlus Solo.
Quantidade	Quantidade contratada vigente. Pode ser alterada por aditivo.
Unidade	Preenchida pela unidade padrao do cadastro do produto.
Tolerancia %	Percentual aceito para considerar o contrato cumprido dentro da margem comercial.
Tipo de precificacao	Fixo, A fixar ou Indexado.
Preco fixo	Valor usado quando o contrato tem preco fechado.
Indice e premio	Referencias usadas quando o preco depende de indicador/mercado.
Janela de entrega	Periodo previsto para cumprimento do contrato.

6. Baixas de venda

As baixas sao geradas ao vincular um item de venda ao contrato. Uma venda pode ter parte vinculada a contrato e parte spot, sem contrato.

A vinculacao e feita na tela de vendas, no comando de contrato da linha do produto. O comprador da venda e o produto vendido precisam coincidir com o comprador e produto do contrato.

Ao baixar uma quantidade, o sistema calcula automaticamente: quantidade contratada - quantidade ja baixada = saldo em aberto.

7. Aditivos

Alteracoes contratuais relevantes devem ser feitas por aditivo, preservando historico. O aditivo pode mudar:

Quantidade contratada;
Janela de entrega;
Preco ou tipo de precificacao;
Tolerancia de quantidade.

O saldo passa a ser controlado com base na quantidade vigente depois do aditivo. O historico original fica registrado para auditoria.

8. Status e saldo

O status do contrato reflete o cumprimento das entregas:

Aberto Parcialmente cumprido Cumprido Cancelado

Aberto: contrato sem entregas baixadas.
Parcialmente cumprido: existe entrega parcial, mas ainda ha saldo.
Cumprido: entregas atingiram a quantidade exigida, respeitando a tolerancia.
Cancelado: contrato cancelado e fora do fluxo normal de baixa.

9. Bloqueios e regras de seguranca

Um contrato so pode ser excluido se nao possuir itens contratados.
Um item contratado nao pode ser excluido se ja possuir baixas ou aditivos.
Produtos usados em contratos nao podem ser excluidos no cadastro de produtos.
Ao excluir uma nota de venda, se algum item estiver baixando contrato, a exclusao da nota e bloqueada.
Ao alterar o produto de uma linha de venda vinculada a contrato, as baixas da linha sao removidas e o saldo do contrato e recalculado.

Essas regras existem para proteger o saldo do contrato e manter rastreabilidade entre venda, baixa e historico contratual.

10. Consultas gerenciais

A tela tambem funciona como painel de controle comercial:

Posicao de contratos: contratado x entregue x saldo por cliente, produto e safra.
Janelas vencendo: contratos que exigem atencao por prazo de entrega.
Volume a fixar: quantidade ainda exposta a definicao de preco.

Use essas consultas para acompanhar compromisso de entrega, risco de precificacao e carteira comercial do produtor.