📘 Tela: Safra
A safra é o ciclo produtivo da fazenda — "Safra Verão 2027/2028", "Safrinha 2030". Na upCampo, ela é o recorte que separa um ano agrícola do outro: toda ordem de serviço, todo romaneio e todo lançamento nasce amarrado a uma safra, e é por isso que o custo e a produtividade de um ciclo não se misturam com os do anterior.
É também aqui que ficam os parâmetros de colheita, por cultura e produto — quais descontos aparecem no romaneio de entrada e qual tabela cada um consulta. Sem esse registro, a colheita daquela cultura não é lançada.
📍 Localização no sistema
Menu: Lavoura > Safra
🧩 Função principal
A safra é o ponto de referência para os lançamentos agrícolas. Ela será relacionada em:
- Plantio da Safra
- Ordens de Serviço
- Romaneio de Colheita
- Contrato de Venda
- Movimentação de Produtos
📝 Campos do cadastro
Para cadastrar uma safra, na prática só o Nome/Descrição é obrigatório — mas vale preencher as datas, que delimitam o ciclo:
| Campo | Descrição |
|---|---|
| Nome/Descrição | Obrigatório. Como a fazenda chama o ciclo (ex.: SAFRA 2025/2026, SAFRINHA 2026, VERÃO 24/25). |
| Código | Identificador da safra. |
| Data Inicial (a partir) | Início do ciclo (ex.: 01/09/2025 numa safra de verão). |
| Data final (até) | Fim do ciclo (ex.: 31/01/2026). |
| Valor Unitário Dólar | Cotação usada como referência para aquela safra. |
| Ativo | Define se a safra continua disponível para uso. |
| ID armaz. nuvem | Código interno de sincronização. Não deve ser alterado manualmente. |
| Safra Jonh Deere (Integração) | Safra correspondente na plataforma John Deere, usada pela integração. |
| ID Referência | Código da safra no sistema externo. Em empresas configuradas para integração, ele passa a ser obrigatório para salvar. |
⚙️ Os quatro controles da safra
Quatro caixas de seleção, logo abaixo do nome, controlam o que se pode fazer naquele ciclo:
- Ativo: mantém a safra em uso
- Esconder no login: impede que a safra seja exibida na tela de seleção inicial ao entrar no sistema. Ideal para safras antigas que já foram encerradas.
- Bloquear lcto em Plantio S.: impede a criação ou edição de plantios vinculados a essa safra.
- Bloquear lcto em O.S: impede que essa safra seja utilizada em novas ordens de serviço. Útil para evitar lançamentos indevidos em safras já finalizadas.
🔄 Conectar nesta safra
Botão de atalho que troca a safra corrente sem precisar sair e entrar de novo no sistema. Ele aparece em dois lugares: como coluna na lista, com um botão Conectar em cada linha, e como botão Conectar nesta safra no alto do cadastro aberto. Ao clicar, o sistema confirma a troca e a safra escolhida passa a valer para toda a navegação.
🔧 A lista e a visualização
A lista traz Código, Descrição, Data inicial, Data final, Ativo, Esconder no login, ID Referência/Integração e a coluna Conectar nesta safra.
No alto da tela, ao lado do título, há o seletor Visualização:
- Padrão: a lista e o cadastro, como descrito aqui
- Dashboard: troca a tela por um painel de indicadores da safra, que se atualiza sozinho de tempos em tempos — dá para escolher qual dashboard exibir, pausar a atualização automática ou recarregar na hora
🌾 Guia: Parametros de colheita
Esta guia é usada para configurar os padrões de desconto aplicados durante a colheita. É uma linha por cultura: a soja tem um conjunto de descontos, o milho tem outro.
| Campo | Descrição |
|---|---|
| Cultura | Obrigatório. A cultura a que esses parâmetros se aplicam. |
| Produto | Obrigatório. O produto que será lançado no estoque após o romaneio de colheita. |
| Desconto padrão Umidade, Impureza, Quebrado, Ardido, Avariado e Armazenagem | A tabela de desconto que o sistema aplica em cada um desses itens. |
| Tabela de Desconto padrão Recebimento e Outros | As duas tabelas restantes, para o desconto no recebimento e para os demais. |
| Umidade manual, Impureza manual, Quebrado manual, Ardido manual, Avariado manual, Armazenagem manual, Recebimento manual e Outros manual | Marcadas, permitem digitar aquele desconto direto no romaneio, em vez de aplicar a tabela. |
Esses parâmetros são aplicados automaticamente no momento do romaneio e impactam diretamente o cálculo do peso líquido que entra no estoque.
🧬 Guia: Variedade - Casa de vegetação/Estufas
Essa guia é utilizada principalmente em contextos de pesquisa e experimentação.
Permite o cadastro de:
- Variedade cultivada em estufa ou casa de vegetação — obrigatória
- Área Total (ha) de cultivo
- Quantidade por variedade
- Ativo, para tirar de uso sem apagar o registro
Esses registros podem ser posteriormente relacionados no Plantio da Safra, garantindo rastreabilidade e controle das unidades experimentais.
📂 Guia: Arquivo
A guia Arquivo permite organizar os documentos relacionados àquela safra. Os arquivos são integrados com uma pasta específica do Google Drive.
Cada arquivo tem Data, Nome do arquivo e Descrição, e o botão Visualizar abre o documento em outra aba.
Ideal para manter o histórico documental da safra centralizado e acessível — contrato de venda, mapa, laudo, o que a safra produziu de papel.
- Você pode iniciar os registros de Plantio da Safra
- Todas as atividades, custos, contratos e produções ficarão organizadas por ciclo produtivo
- A gestão será facilitada com o histórico completo por safra
❓ Perguntas frequentes
Como esconder safras antigas da tela de login?
Marque Esconder no login no cadastro da safra. Ela deixa de aparecer na seleção inicial, o que é útil para safras já encerradas.
Como impedir que lancem coisas em uma safra já encerrada?
A tela tem dois bloqueios independentes: Bloquear lcto em Plantio S. e Bloquear lcto em O.S. Eles evitam criação ou edição de registros indevidos em safras finalizadas. Marcar só o Esconder no login não basta: ele apenas tira a safra da tela de seleção inicial.
Preciso sair do sistema para trocar de safra?
Não. Use o botão Conectar nesta safra, que alterna sem precisar deslogar — a safra escolhida passa a valer para toda a navegação. Ele fica tanto na coluna da lista, um por linha, quanto no alto do cadastro aberto.
O que é obrigatório para cadastrar uma safra?
Só o Nome/Descrição, como "SAFRA 2025/2026" ou "SAFRINHA 2026". O resto são configurações opcionais — com uma exceção: em empresas configuradas para integração, o ID Referência também passa a ser exigido.
De onde vêm os descontos aplicados no romaneio de colheita?
Da guia Parametros de colheita da safra, onde se define, por cultura, qual tabela de desconto vale para umidade, impureza, quebrado, ardido, avariado, armazenagem, recebimento e outros. É ali também que se escolhe o produto que entra no estoque depois da colheita.
Quero digitar o desconto na hora do romaneio, sem usar a tabela. Dá?
Dá. Na guia Parametros de colheita, marque a opção manual correspondente — Umidade manual, Impureza manual, e assim por diante. Aí aquele desconto passa a ser digitado no romaneio em vez de sair da tabela.
Onde vejo os indicadores da safra?
No seletor Visualização, no alto da tela, troque de Padrão para Dashboard. O painel se atualiza sozinho de tempos em tempos, e você pode escolher qual dashboard exibir, pausar a atualização ou recarregar na hora.