Guia do Usuário

App Apis - Gestão de Colheita

Versão 3.19.0 | Atualizado em Agosto/2026

1. Primeiro Acesso

Nesta seção, você vai aprender a abrir o app e fazer login pela primeira vez.

[SCREENSHOT: tela_login]

1.1 Fazendo Login

1
Digite seu e-mail No campo "E-mail", digite o e-mail que você usou quando fez o cadastro.
2
Digite sua senha No campo "Senha", digite sua senha. Ela é sensível a letras maiúsculas e minúsculas.
3
Toque em "Entrar" O botão verde "Entrar" vai enviar seus dados e fazer login.
Esqueceu sua senha? Toque em "Esqueci minha senha" na tela de login. Você vai receber um e-mail com instruções para criar uma nova senha.

1.2 Ativando a Biometria

Após o primeiro login, o app pode perguntar se você quer ativar o acesso por biometria (impressão digital ou Face ID). Isso facilita futuros acessos.

1
Toque em "Sim" quando aparecer o pedido O app vai pedir permissão para usar a biometria do celular.
2
Confirme com sua digital ou rosto Siga a instrução do celular para registrar sua biometria.
Com a biometria ativada, da próxima vez que abrir o app, basta usar sua digital ou olhar para o celular para entrar. Não precisa digitar senha!

1.3 O que Acontece Depois do Login

Após fazer login com sucesso, o app vai direcionar você automaticamente para:

  • Detalhe da Safra - Se você já tem uma safra em andamento
  • Lista de Safras - Se ainda não tem nenhuma safra criada
Não se preocupe! O app lembra onde você parou. Na próxima vez que abrir, vai voltar para a mesma tela.

Segurança

Bloqueio Automático

Se você ficar mais de 3 minutos sem usar o app, ele vai bloquear e pedir sua senha ou biometria para continuar. Isso protege seus dados.

3. Gerenciamento de Safras

Uma safra é o período em que você planta e colhe um tipo de cultura, como café, soja ou milho. Aqui você vai aprender a criar e gerenciar suas safras.

Algumas informações da fazenda, como cadastro de áreas e dados gerais, devem ser configuradas diretamente pelo painel em sistema.apiscolheita.com.br antes de criar suas safras no app.

3.1 O que é uma Safra

Cada safra representa um ciclo completo de plantio e colheita. Por exemplo:

  • "Café 2025/2026"
  • "Safra 2025"

Cada safra tem seus próprios dados de produção, custos e vendas.

3.2 Criando sua Primeira Safra

[SCREENSHOT: tela_nova_safra]
1
Toque no botão "Cadastrar nova safra" Na aba "Safra" ou na lista de safras, toque no botão para criar uma nova safra.
2
Preencha o nome da safra Exemplo: "Café 2025/2026" ou "Café Abril 2026".
3
Selecione o tipo de cultura Escolha entre as opções disponíveis (Café, Soja, Milho, etc.).
4
Informe as datas Data de início e data prevista de término da safra.
5
Toque em "Salvar" A safra será criada e aparecerá na sua lista.

3.3 Visualizando Lista de Safras

[SCREENSHOT: lista_safras]

Na aba "Safra" ou no menu lateral, toque em "Lista de Safras". Você verá todas as suas safras organizadas por data.

Cada safra mostra:

  • Nome - Identificação da safra
  • Status - Se está em andamento, colheita ou finalizada
  • Datas - Período da safra
Toque em uma safra para ver todos os detalhes: produção, custos, vendas e muito mais.

3.4 Detalhes da Safra

[SCREENSHOT: detalhe_safra_geral]

Ao abrir uma safra, você verá 3 abas internas:

Aba "Geral"

Mostra um resumo completo da safra: status, datas, produção total, custos, valor da saca e gráficos de desempenho.

Aba "Manejo"

Registre e acompanhe todos os custos de manejo: defensivos, fertilizantes, mão de obra, máquinas e mais.

Aba "Colheita"

Registre a produção diária de cada trabalhador, gere comprovantes e acompanhe totalizadores.

4. Manejo e Custos

O manejo registra todos os custos envolvidos na produção e colheita: defensivos, fertilizantes, mão de obra, máquinas e mais.

4.1 Registrando Custos de Manejo

[SCREENSHOT: cadastro_manejo]
1
Abra a safra e vá na aba "Manejo" Toque na safra desejada e selecione a aba "Manejo".
2
Toque em "Novo Manejo" Um formulário vai abrir para registrar o custo.
3
Selecione a categoria de custo Escolha entre: Defensivos, Fertilizantes, Mão de Obra, Máquinas, Sementes, Outros.
4
Informe os detalhes Descrição do produto/serviço, quantidade, unidade de medida e valor.
5
Selecione as áreas relacionadas Marque em quais áreas esse custo foi aplicado.
6
Toque em "Salvar" O custo será registrado e somado ao total da safra.

4.2 Categorias de Custo

Categoria Exemplos
Defensivos Herbicidas, Fungicidas, Inseticidas
Fertilizantes NPK, Ureia, Calcário, Gesso
Mão de Obra Colhedores, Máquinas operadoras, Vigias
Máquinas Combustível, Manutenção, Horas de uso
Sementes Sementes, Inoculantes, Tratamentos
Outros Transporte, Armazenagem, Diversos

4.3 Visualizando Gráficos

[SCREENSHOT: graficos_manejo]

Na aba "Manejo", você encontra gráficos que mostram:

  • Total por categoria - Gráfico de barras com o custo de cada categoria
  • Evolução dos custos - Linha temporal mostrando quando os custos foram registrados
  • Custo por área - Mapa visual com as áreas e seus respectivos custos

Mapa de Áreas

O app exibe um mapa com os polígonos das áreas de plantio. Você pode ver visualmente quais áreas têm mais custo de manejo.

4.4 Filtrando Lançamentos por Categoria

[SCREENSHOT: filtro_categoria_manejo]

Na aba "Manejo", na tela de Lançamentos, você pode filtrar os custos registrados de acordo com a categoria, facilitando a análise quando há muitos registros.

1
Vá na aba "Manejo" e abra "Lançamentos" Toque no ícone de lista para ver o histórico de custos da safra.
2
Toque no filtro "Categoria" Um seletor permite escolher uma categoria específica ou a opção "Todas".
3
Escolha a categoria desejada A lista e o contador "Lançamentos (N)" são atualizados para mostrar apenas os custos da categoria selecionada.
Dica: o filtro exibe apenas as categorias que possuem ao menos um lançamento registrado, evitando opções vazias. Para voltar a ver todos os custos, selecione "Todas".

5. Controle de Colheita

Aqui você vai aprender a configurar a impressora, registrar a produção diária, cadastrar trabalhadores e gerar comprovantes.

Para usar as funcionalidades de colheita, primeiro é necessário tocar no botão "Iniciar Colheita" na aba "Colheita" da safra. Só então o app libera as funções do modo colheita.

5.1 Configurando a Impressora Térmica

Antes de gerar comprovantes, configure sua impressora térmica bluetooth para impressão na hora.

1
Vá no menu lateral e toque em "Configurar Impressora" O app vai mostrar as impressoras bluetooth disponíveis.
2
Ative o Bluetooth no celular Se não estiver ativo, o app vai solicitar ativação.
3
Selecione sua impressora Toque no nome da impressora para parear. Aguarde a confirmação de conexão.
Certifique-se de que a impressora está ligada e com papel antes de tentar imprimir. A impressão só funciona com Bluetooth ativo.

5.2 Registrando Produção Diária

[SCREENSHOT: cadastro_producao]
1
Abra a safra e vá na aba "Colheita" Toque na safra desejada e selecione a aba "Colheita" na parte de cima.
2
Toque em "Nova Produção" Um formulário vai abrir para registrar a produção do dia.
3
Selecione o trabalhador Escolha o trabalhador que realizou a colheita. Se ainda não está cadastrado, veja a próxima seção.
4
Selecione a área Escolha a área do plantio onde ocorreu a colheita.
5
Informe a quantidade Digite a quantidade colhida em sacas ou quilogramas.
6
Toque em "Salvar" A produção será registrada e o comprovante será gerado automaticamente.

5.3 Cadastrando Trabalhadores

1
Na aba "Colheita", toque em "Trabalhadores" Vai abrir a lista de trabalhadores já cadastrados.
2
Toque em "Cadastrar" para adicionar novo Preencha o nome completo do trabalhador.
3
Toque em "Salvar" O trabalhador estará disponível para selecionar nas próximas produções.
Só é necessário cadastrar o trabalhador uma vez. Depois, ele fica disponível para todas as safras.

5.4 Gerando Comprovante

[SCREENSHOT: comprovante]

Após salvar uma produção, um comprovante é gerado automaticamente com:

  • Código único - Ex.: COL-20251103-001
  • Dados do trabalhador - Nome
  • Área colhida - Identificação da área
  • Quantidade - Sacas ou quilogramas
  • Data e hora - Momento do registro
O código único serve para identificar e rastrear cada produção registrada no sistema.

5.5 Imprimindo na Térmica

1
No comprovante, toque no ícone de impressora O app vai enviar os dados para a impressora térmica via Bluetooth.
2
Aguarde a impressão Em poucos segundos, o comprovante será impresso.

5.6 Visualizando Totalizadores

[SCREENSHOT: totalizadores_colheita]

Na aba "Colheita", você encontra resumos e gráficos de:

  • Produção total - Soma de todas as produções da safra
  • Produção por trabalhador - Quem produziu mais
  • Produção por área - Quais áreas tiveram melhor desempenho
  • Evolução diária - Gráfico mostrando a produção ao longo do tempo

5.7 Lista de Produções e Pagamentos

Abaixo dos totalizadores, você encontra:

  • Lista de Produções - Todas as produções registradas, com opção de editar ou excluir
  • Pagamentos - Acompanhe e registre os pagamentos realizados aos trabalhadores

6. Vendas e Pluviômetro

Registre suas vendas de sacas e acompanhe o índice de chuva na propriedade.

6.1 Registrando uma Venda

[SCREENSHOT: tela_vendas]
1
Toque na aba "Vendas" Na parte inferior da tela, selecione a aba "Vendas".
2
Toque em "Nova Venda" Um formulário vai abrir para registrar a venda.
3
Selecione a safra Escolha a safra da qual está vendendo o grão.
4
Informe a quantidade e o preço Digite o número de sacas vendidas e o preço unitário por saca.
5
Toque em "Salvar" A venda será registrada e o saldo será atualizado.

6.2 Entendendo o Saldo Disponível

[SCREENSHOT: resumo_vendas]

Na tela de vendas, você vê um resumo com:

  • Total Produzido - Quantidade total colhida na safra
  • Total Vendido - Quantidade já vendida
  • Saldo Disponível - Quanto ainda pode vender (Produzido - Vendido)
O saldo disponível é calculado automaticamente. Se você tentar vender mais do que produziu, o app vai alertar.

6.3 Cadastrando Chuva (Pluviômetro)

[SCREENSHOT: tela_pluviometro]
1
Toque na aba "Pluviômetro" Na parte inferior da tela, selecione a aba "Pluviômetro".
2
Toque em "Novo Registro" Um formulário vai abrir para registrar a chuva.
3
Informe a data e a quantidade Selecione a data em que a chuva caiu e digite a quantidade em milímetros (mm).
4
Toque em "Salvar" O registro será salvo e o gráfico será atualizado.
Registre a chuva diariamente para ter um histórico completo. Isso é útil para analisar a relação entre chuva e produtividade.

7. Patrimônio da Fazenda

O módulo Patrimônio ajuda a registrar e acompanhar os bens e investimentos de longo prazo da fazenda: máquinas, benfeitorias, plantios, infraestrutura e veículos. Diferente dos custos de manejo (despesas da safra), o patrimônio representa o acúmulo de valor da propriedade ao longo dos anos.

O módulo funciona normalmente offline. Os registros ficam salvos no celular e são sincronizados quando a internet volta.

7.1 Acessando o Módulo

1
Toque no ícone do menu lateral No canto superior esquerdo da tela, toque nas três linhas horizontais (hamburger).
2
Toque em "Patrimônio" Você será levado à lista de bens da fazenda.

7.2 Cadastrando um Bem ou Investimento

[SCREENSHOT: cadastro_patrimonio]
1
Na lista de patrimônio, toque em "Novo" O formulário de cadastro vai abrir.
2
Escolha o tipo de registro
  • Ativo - para bens como máquinas, veículos e benfeitorias. Mostra campos de vida útil, valor residual e depreciação.
  • Investimento - para aplicações na terra, como plantios e preparo de solo. Mostra o campo de área em hectares e o custo por hectare.
3
Preencha os dados do bem Nome, categoria, valor de aquisição, data de aquisição e os campos específicos do tipo escolhido.
4
Defina o status do bem
  • Em uso - está sendo usado atualmente
  • Vendido - foi vendido
  • Descartado - não faz mais parte do patrimônio
5
Adicione uma foto (opcional) Toque em "Adicionar Foto" para tirar uma foto pela câmera ou escolher da galeria. A foto é anexada ao registro.
6
Toque em "Salvar" O bem será registrado. Enquanto você preenche, o app mostra o preview da depreciação em tempo real (quando há vida útil) e o custo por hectare (quando há área).
O valor residual é quanto o bem ainda valerá ao final da vida útil. Ele reduz a depreciação anual calculada pelo app.

7.3 Consultando a Lista de Patrimônio

[SCREENSHOT: lista_patrimonio]

A lista mostra os bens agrupados por categoria. Você pode:

  • Buscar - digitar o nome do bem para filtrar em tempo real
  • Filtrar por tipo - Todos, Ativos, Investimentos, Vendidos ou Descartados
  • Ordenar - por data, valor ou nome
  • Deslizar o item - para a esquerda para editar ou para a direita para excluir (com confirmação)

No rodapé da lista, você vê os totais em Ativos e em Investimentos.

Badge de Sincronização

Registros ainda não sincronizados com o servidor aparecem com um indicador visual na lista.

7.4 Detalhes e Depreciação

[SCREENSHOT: detalhes_patrimonio]

Ao tocar em um bem, você vê a tela de detalhes com as informações completas:

  • Foto (toque para ampliar em tela cheia)
  • Informações gerais - tipo, categoria, status e localização
  • Valores e depreciação - valor de aquisição, depreciação anual, valor atual, depreciação acumulada e % depreciado (com barra de progresso)
  • Documentos - nota fiscal e fornecedor
  • Observações
A depreciação é calculada automaticamente pelo app usando o método linear: o bem perde valor de forma constante a cada ano até atingir o valor residual.

7.5 Dashboard Patrimonial

[SCREENSHOT: dashboard_patrimonio]

Na lista de patrimônio, toque em "Dashboard" para abrir uma visão consolidada:

  • Cards de resumo - valor total, quantidade de itens, valor patrimonial líquido (com depreciação) e alertas de bens próximos da troca
  • Distribuição por categoria - gráfico mostrando onde está investido o dinheiro
  • Evolução de aquisições por ano - gráfico de barras
  • Top investimentos - os maiores valores registrados
  • Depreciação acumulada ao longo do tempo - gráfico de linha comparando valor total e valor líquido
  • Alertas de vida útil - tabela com os bens com mais de 80% depreciados, que podem estar próximos da troca

7.6 Comparativo de Investimentos

[SCREENSHOT: comparativo_patrimonio]

Para comparar os investimentos entre anos, toque em "Comparativo" na lista de patrimônio ou no menu lateral:

  • Selecione os anos - marque os anos que deseja comparar (ex.: 2023, 2024, 2025)
  • Filtre por categoria - opcional
  • Toque em "Aplicar Filtros" - a tabela mostra o total investido, total em ativos, total em investimentos, novos bens, custo médio e a variação entre os anos

Gráficos de barras empilhadas mostram a composição dos investimentos por categoria em cada ano, e o gráfico de linha acompanha a evolução do valor patrimonial total.

Ajuda

Encontre respostas para as dúvidas mais comuns e problemas frequentes.

Dúvidas Frequentes

Como faço para recuperar minha senha?

Na tela de login, toque em "Esqueci minha senha". Digite seu e-mail e siga as instruções que serão enviadas.

Meus dados estão seguros?

Sim! Todos os dados são salvos primeiro no celular de maneira segura e depois sincronizados com o servidor. Mesmo sem internet, seus dados estão protegidos.

Posso usar o app em vários celulares?

Sim. Basta fazer login com as mesmas credenciais em outro celular. Os dados serão sincronizados automaticamente.

Como faço para comparar safras?

No menu lateral, toque em "Comparativo de Safras". Selecione 2 ou mais safras para comparar. Você verá diferenças em produção, custos e chuva.

Onde encontro o Patrimônio da fazenda?

No menu lateral, toque em "Patrimônio". Lá você cadastra bens, consulta o dashboard patrimonial e o comparativo de investimentos.

O app funciona sem internet?

Sim! O app é feito para funcionar em áreas rurais com sinal instável. Todos os dados são salvos localmente e sincronizados quando a internet voltar.

Onde configuro os dados da minha fazenda?

As informações gerais da fazenda e o cadastro de áreas devem ser feitos pelo painel web em sistema.apiscolheita.com.br. Após configurar pelo painel, os dados ficam disponíveis no app.

Problemas Comuns

O app não está sincronizando os dados

Verifique sua conexão com a internet. Vá no menu lateral e toque em "Atualizar Dados" para forçar a sincronização.

A impressora térmica não está imprimindo

Verifique se: (1) A impressora está ligada, (2) O Bluetooth está ativo no celular, (3) A impressora está pareada corretamente. Vá em "Configurar Impressora" no menu lateral.

Escolhi a safra errada, como faço?

Não se preocupe. Você pode voltar à lista de safras a qualquer momento tocando na aba "Safra" ou no menu lateral.

Contato do Suporte

Precisa de ajuda?

Entre em contato com nossa equipe de suporte pelo e-mail contato@apiscolheita.com.br