Propriedades
Criado por Igor Ribeiro em 06 de outubro de 2026
Atualizado por Igor Ribeiro em 06 de outubro de 2026
Propriedades
A tela de Propriedades é o painel principal do coletor dentro do percurso do dia: é para ela que o aplicativo leva o coletor depois do login, da sincronização de dados e da confirmação de rota/veículo, e é a partir dela que o coletor abre o registro de cada coleta.
Visão Geral
A tela de Propriedades é o painel principal do coletor dentro do percurso do dia: é para ela que o aplicativo leva o coletor depois do login, da sincronização de dados e da confirmação de rota/veículo, e é a partir dela que o coletor abre o registro de cada coleta. Nela o coletor vê todas as propriedades do percurso corrente, acompanha quais já têm coleta ou não-coleta registrada, acessa o menu lateral com as demais funções do aplicativo (criar carga, enviar coleta, histórico de envios, sincronizar, alterar rota/veículo, tanques, mapa, idioma e encerrar sessão) e pode, ao final do percurso, registrar de uma vez a não-coleta para todas as propriedades que ainda não tiveram nenhuma visita lançada.
Pré-requisitos
- Para usar a tela de Propriedades, o coletor precisa estar com a sessão ativa e com os dados do dia já sincronizados (percurso, propriedades do percurso e motivos de não-coleta); sem essa sincronização prévia, a lista de propriedades da tela aparece vazia.
- A tela de Propriedades depende de haver uma carga em uso no aplicativo — ela é criada automaticamente na primeira vez que o coletor entra nesta tela no dia, e é o identificador dela que aparece no cabeçalho do menu lateral.
- Na tela de Propriedades, permissão de localização do aparelho e GPS ativo são opcionais: eles só enriquecem com coordenadas os registros de não-coleta feitos em lote por esta tela; sem eles, o registro é salvo normalmente, apenas sem localização.
Fluxo Operacional
- O coletor chega à tela de Propriedades já com a lista do percurso do dia carregada, ordenada pela ordem de visita planejada.
- Pode pesquisar uma propriedade pelo nome dela, pelo nome do produtor ou pelo código do produtor; ao limpar a pesquisa, a lista completa do percurso volta a aparecer.
- Para cada propriedade, o coletor confere o selo de contagem (quantas visitas já foram registradas) e a cor dele (se são coletas, não-coletas, ou as duas).
- Ao tocar em uma propriedade liberada, o coletor é levado para continuar um registro já existente (se a propriedade já tiver alguma coleta) ou para iniciar um novo registro de coleta (se ainda não tiver nenhuma).
- Ao tocar em uma propriedade bloqueada, o coletor recebe um aviso e permanece na lista.
- A qualquer momento, o coletor pode abrir o menu lateral para acessar as demais funções do aplicativo.
- Perto do fim do percurso, o coletor pode tocar no ícone de pendências (habilitado apenas quando restam propriedades sem nenhum registro) para abrir o formulário de lote e registrar de uma vez a não-coleta em todas as propriedades ainda pendentes, informando motivo e observação.
- Ao pressionar o botão de voltar do aparelho, o coletor é sempre questionado se deseja sair do aplicativo.
Interface e Comportamentos
Lista de Propriedades do Percurso
A lista principal da tela de Propriedades mostra todas as propriedades do percurso corrente do coletor, ordenadas pela ordem de visita planejada (da menor para a maior). O título da tela mostra o código e o nome do percurso, obtidos a partir da primeira propriedade da lista. Cada propriedade aparece com: o número da ordem de visita (ou um ícone genérico, quando a propriedade não tem ordem definida), o nome da propriedade em maiúsculas, a identificação do produtor (código e nome, ou apenas o que estiver disponível) e, quando houver, o selo de contagem de registros já feitos nela.
Campo de Pesquisa
O campo de pesquisa no topo da tela de Propriedades filtra a lista por nome da propriedade, nome do produtor ou código do produtor, sempre dentro do percurso corrente; com o campo vazio, a tela volta a mostrar a lista completa do percurso, na mesma ordenação padrão.
Propriedade Bloqueada
Na tela de Propriedades, quando uma propriedade está marcada como bloqueada, o nome dela e o nome do produtor aparecem em vermelho na lista. Ao tocar nela, o aplicativo não avança: mostra um aviso informando que a propriedade está bloqueada para coleta e que o coletor deve entrar em contato com o responsável, com um botão para apenas fechar o aviso.
Selo de Contagem de Registros
Na tela de Propriedades, cada propriedade da lista mostra um selo numérico somente quando já existe pelo menos um registro (coleta ou não-coleta) feito nela; o número é a quantidade total de registros. A cor do selo indica a mistura dos registros: verde quando todos são coletas efetivas, amarelo-ouro quando todos são registros de não-coleta, e verde-oliva quando há os dois tipos misturados na mesma propriedade.
Toque em Propriedade Liberada
Na tela de Propriedades, ao tocar em uma propriedade liberada, o aplicativo guarda o código dela como a propriedade corrente e verifica se ela já tem alguma coleta registrada: se tiver, abre a lista de coletas já feitas nela; se não tiver nenhuma, monta um novo rascunho de registro (copiando da propriedade o código, o percurso, o nome da propriedade e do percurso, o produtor e o tipo de resfriamento, mais a placa do veículo do coletor) e abre a tela de registro de uma nova coleta já com esses dados preenchidos.
Ícones do Topo da Tela
No topo da tela de Propriedades há dois ícones: um de bússola, que leva diretamente à tela de alteração de rota, sem nenhuma confirmação prévia; e um de lista de pendências, que mostra a quantidade de propriedades do percurso ainda sem nenhum registro e só fica habilitado para toque quando essa quantidade é maior que zero — ao tocar, abre o formulário de lote de não-coleta.
Formulário de Lote de Não-Coleta
O formulário de lote de não-coleta da tela de Propriedades é aberto como uma janela deslizante na parte inferior da tela. Assim que a tela de Propriedades é aberta, o aplicativo já carrega em segundo plano a lista de motivos de não-coleta disponíveis e pré-seleciona automaticamente o primeiro motivo da lista, antes mesmo de o coletor abrir o formulário. No formulário, o coletor escolhe o motivo e preenche a observação (até 150 caracteres, em até 3 linhas); o rodapé mostra, em tempo real, a quantidade de propriedades do percurso ainda sem registro. O botão de confirmar só fica habilitado quando a observação tem mais de 4 caracteres preenchidos e um motivo está selecionado; fora disso, o botão permanece desabilitado (cinza, sem ação ao toque). Ao fechar o formulário (por confirmar ou cancelar), o aplicativo prepara o botão salvar desabilitado para a próxima abertura.
Menu Lateral
O cabeçalho do menu lateral da tela de Propriedades mostra o nome do coletor logado (ou, na falta de nome cadastrado, o nome de usuário; e um texto genérico de motorista caso nenhum dos dois esteja disponível), a placa do veículo atual (ou um aviso de placa não informada) e o identificador da carga em uso no momento. Abaixo do cabeçalho, o menu lista: Criar carga, Enviar coleta, Ver coletas da carga, Histórico de coletas (condicional — ver abaixo), Sincronizar dados, Alterar rota/linha, Alterar veículo, Listar tanques, Ver mapa da rota, Alterar idioma, Sobre e Encerrar sessão.
Opções do Menu Lateral sem Confirmação
No menu lateral da tela de Propriedades, as opções “Ver coletas da carga”, “Enviar coleta”, “Alterar rota/linha”, “Alterar veículo”, “Listar tanques” e “Ver mapa da rota” levam diretamente às respectivas telas assim que tocadas, sem nenhum diálogo de confirmação antes de navegar.
Criar Carga
No menu lateral da tela de Propriedades, ao escolher “Criar carga”, o aplicativo verifica se é permitido iniciar uma nova carga. Se permitido, mostra uma confirmação explicando que as próximas coletas passarão a ser armazenadas sob a nova carga, podendo ser enviadas ao servidor depois; ao confirmar, a carga anterior é encerrada e a tela de Propriedades é atualizada para refletir a nova carga. Se não for permitido, mostra um aviso informando que há propriedades do percurso da carga atual ainda sem coleta ou sem registro de não-coleta preenchidos, e nenhuma nova carga é criada.
Histórico de Coletas no Menu
A opção “Histórico de coletas” só aparece no menu lateral quando o aplicativo confirma que o servidor retorna alguma informação de coletas já enviadas; enquanto essa verificação não responde, ou se ela indicar que não há nada a mostrar, a opção fica completamente oculta (não aparece nem desabilitada — ver Troubleshooting).
Sincronizar Dados pelo Menu da Tela de Propriedades
A opção “Sincronizar dados” do menu lateral pede confirmação avisando que a sincronização pode levar alguns segundos e exige Wi-fi ou dados móveis ativos; ao confirmar, o aplicativo abre a tela de sincronização.
Alterar Idioma pelo Menu da Tela de Propriedades
A opção “Alterar idioma” abre uma lista com os idiomas disponíveis (português, inglês, espanhol e francês). Ao escolher um idioma e confirmar, o aplicativo avisa que será fechado para aplicar a alteração e, após um tempo fixo de espera, se fecha sem apagar os dados do usuário.
Encerrar Sessão pelo Menu da Tela de Propriedades
A opção “Encerrar sessão” pede confirmação avisando que o aplicativo será fechado e as informações do usuário serão perdidas, sendo necessário fazer login e sincronizar os dados novamente. Ao confirmar, o aplicativo apaga os dados salvos do usuário e a lista de motivos de não-coleta sincronizada, e então se fecha.
Botão de Voltar do Aparelho
Ao acionar o botão físico/gesto de voltar na tela de Propriedades, o aplicativo sempre pergunta se o coletor deseja sair do aplicativo; ao confirmar, o aplicativo se fecha sem apagar os dados salvos do usuário (diferente de “Encerrar sessão”, que apaga os dados). Quando o menu lateral está aberto no momento em que o voltar é acionado, o aplicativo fecha o menu e, na sequência, ainda assim exibe a pergunta de saída (ver Troubleshooting).
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Toque em propriedade bloqueada | Diálogo de aviso | “Propriedade bloqueada para coleta, favor entrar em contato com responsável” |
| Criar carga permitido | Diálogo de confirmação | “Ao criar carga suas coletas serão armazenadas no dispositivo, podendo enviá-las posteriomente para o servidor. Deseja criar carga?” |
| Criar carga não permitido | Diálogo de aviso | “Não é possível criar carga. Existe rota na carga atual com propriedades que não possuem Coleta ou Não Coleta preenchidas” |
| Confirmar saída do aplicativo (botão voltar) | Diálogo de confirmação | “Deseja sair do aplicativo?” |
| Confirmar sincronizar dados | Diálogo de confirmação | “A sincronização de dados pode levar alguns segundos. Certifique-se que a Wi-fi ou os Dados móveis estão ativos e que possui internet. Deseja iniciar?” |
| Confirmar alteração de idioma | Diálogo de confirmação | “As configurações de idioma requerer que o sistema seja reiniciado. Confirme caso deseje aplicar as alterações” |
| Aplicativo fechando para aplicar idioma | Mensagem de processamento | “Configurando o idioma, aguarde.\nO aplicativo será encerrado” |
| Confirmar encerrar sessão | Diálogo de confirmação | “Deseja encerrar sua sessão?” |
| Conteúdo do aviso de encerrar sessão | Texto do diálogo | “Ao confirmar, o aplicativo será fechado e as informações do usuário serão perdidas. Havendo a necessidade de fazer login e sincronizar os dados novamente” |
| Lote de não-coleta em processamento | Mensagem de espera | “Aguarde, estamos persistindo os dados” |
| Lote de não-coleta salvo (ao menos uma propriedade) | Mensagem de sucesso | “Registro salvo com sucesso” |
| Lote de não-coleta sem nenhuma propriedade salva | Mensagem de erro | “Erro ao salvar o registro. Tente novamente” |
Regras de Negócio
- O nome da propriedade é sempre exibido em letras maiúsculas, sem espaços nas pontas. A identificação do produtor é exibida como “código – nome” quando os dois estão preenchidos; se faltar um dos dois, a tela mostra apenas o que estiver disponível, sem o separador.
- Uma propriedade é considerada bloqueada para coleta quando o status de bloqueio dela é um dos dois valores que indicam bloqueio; qualquer outro valor (incluindo a ausência de informação) é tratado como propriedade liberada.
- A lista de propriedades do percurso (com ou sem pesquisa) é sempre ordenada pela ordem de visita planejada da propriedade dentro do percurso.
- Só é permitido criar uma nova carga quando todas as propriedades dos percursos que já têm alguma coleta na carga atual (e que pertencem ao motorista logado) possuem, cada uma, pelo menos um registro de coleta ou de não-coleta; basta uma propriedade sem nenhum registro para bloquear a criação da nova carga. Se ainda não existe nenhuma carga ativa, a criação é sempre permitida.
- Ao salvar um registro de não-coleta (seja individual, seja pelo lote), o aplicativo zera os campos de tanque, quantidade de litros, temperatura, tipo de resfriamento, teste de alizarol e observação técnica da coleta, pois esses dados não se aplicam a uma visita sem coleta efetiva.
- Cada registro de não-coleta gerado pelo lote recebe o motivo e a observação informados no formulário, mais o código do motorista, o nome de usuário e a placa do veículo do coletor logado no momento da confirmação.
- As propriedades que chegam ao aplicativo são somente aquelas que têm um percurso de coleta associado e cujo produtor rural está com o cadastro em situação ativa no ERP; propriedades de produtores inativos não são enviadas ao aplicativo, independentemente do status de bloqueio individual da propriedade.
- O status de bloqueio de uma propriedade é um atributo próprio dela no ERP, independente da situação de cadastro do produtor rural — uma propriedade pode estar bloqueada mesmo com o produtor ativo, e vice-versa.
Comportamento Offline e Dados Locais
A lista de propriedades, a pesquisa, os selos de contagem, o toque para registrar coleta e o lote de não-coleta funcionam inteiramente com os dados já sincronizados no aplicativo (propriedades, percurso, motivos e os próprios registros de coleta), sem exigir conexão com o servidor nesta tela. A única verificação que depende de uma resposta do servidor neste momento é a que decide se a opção “Histórico de coletas” aparece no menu lateral; as demais opções do menu (Criar carga, Sincronizar dados, Alterar rota/veículo, Listar tanques, Ver mapa da rota, Alterar idioma, Encerrar sessão) apenas abrem outras telas ou diálogos, sem depender de conexão nesta tela.
Geolocalização e Rastreamento
Ao confirmar o lote de não-coleta, o aplicativo tenta capturar a localização atual do coletor para anexar a cada registro criado, mas apenas quando a permissão de localização está concedida e o GPS do aparelho está ativo no momento da confirmação (com limite de alguns segundos para obter a posição). Se qualquer uma das duas condições não for atendida, cada registro é salvo normalmente, porém sem localização, sem nenhum aviso ao coletor sobre isso.
Troubleshooting
Propriedade aparece bloqueada e não abre o registro de coleta
Cenário: o coletor toca em uma propriedade cujo nome aparece em vermelho na lista.
Mensagem exibida: “Propriedade bloqueada para coleta, favor entrar em contato com responsável”
O que fazer: orientar o coletor a contatar o responsável pelo cadastro da propriedade no ERP; o aplicativo não permite prosseguir enquanto o bloqueio não for removido na origem.
Não consegue criar uma nova carga
Cenário: o coletor escolhe “Criar carga” no menu lateral.
Mensagem exibida: “Não é possível criar carga. Existe rota na carga atual com propriedades que não possuem Coleta ou Não Coleta preenchidas”
O que fazer: orientar o coletor a concluir o registro (coleta ou não-coleta) em todas as propriedades pendentes do percurso da carga atual — inclusive pelo lote de não-coleta, se for o caso — antes de tentar criar a nova carga novamente.
Lote de não-coleta não salva nenhuma propriedade
Cenário: o coletor confirma o formulário de lote de não-coleta, mas nenhum registro é efetivamente salvo.
Mensagem exibida: “Erro ao salvar o registro. Tente novamente”
O que fazer: orientar o coletor a tentar novamente; se o erro persistir, verificar o espaço de armazenamento do aparelho e, se necessário, encaminhar ao suporte técnico.
Opção “Histórico de coletas” não aparece no menu lateral
Cenário: o coletor abre o menu lateral esperando encontrar o histórico de coletas enviadas.
Mensagem exibida: Nenhuma — a opção simplesmente não aparece na lista do menu, mesmo com o aplicativo conectado.
O que fazer: confirmar que o aparelho está com conexão ativa; a opção só aparece depois que o coletor tiver ao menos uma coleta já enviada ao servidor — um coletor que nunca enviou nenhuma coleta não verá essa opção, mesmo estando conectado.
Botão de confirmar do lote de não-coleta não habilita
Cenário: o coletor abre o formulário de lote de não-coleta e tenta confirmar.
Mensagem exibida: Nenhuma — o botão permanece desabilitado (cinza) até os dois requisitos serem atendidos.
O que fazer: orientar o coletor a selecionar um motivo e digitar uma observação com mais de 4 caracteres; o botão habilita automaticamente assim que os dois estiverem preenchidos.
Pergunta de sair do aplicativo aparece ao fechar o menu lateral
Cenário: o coletor abre o menu lateral e, em seguida, aciona o botão de voltar do aparelho para fechá-lo.
Mensagem exibida: “Deseja sair do aplicativo?”
O que fazer: informar que isso é um comportamento conhecido do aplicativo; o coletor pode tocar em “Cancelar” para continuar normalmente na tela de Propriedades, sem sair do aplicativo.
Casos de Uso
Caso 1 — Coletor registra uma nova coleta em uma propriedade do percurso
O coletor abre a tela de Propriedades, localiza a propriedade “Sítio Boa Vista” na lista (sem nenhum selo, indicando que ainda não há registro nela) e toca sobre ela. Como a propriedade está liberada e ainda não tem nenhuma coleta, o aplicativo abre a tela de registro já com o nome da propriedade, o produtor e a placa do veículo preenchidos, pronta para o coletor informar os dados da coleta.
Caso 2 — Coletor fecha o percurso registrando não-coleta em lote
Ao final da rota, restam três propriedades sem nenhum registro. O coletor toca no ícone de pendências (habilitado, mostrando “3”), escolhe o motivo “Produtor ausente” e escreve a observação “Propriedade fechada no horário da coleta”, e confirma. O aplicativo cria um registro de não-coleta para cada uma das três propriedades, exibe a mensagem de sucesso e o ícone de pendências passa a mostrar “0”.
Caso 3 — Coletor tenta visitar uma propriedade bloqueada
O coletor toca em uma propriedade cujo nome aparece em vermelho na lista. Em vez de abrir o registro de coleta, o aplicativo mostra o aviso de propriedade bloqueada; o coletor fecha o aviso e segue para a próxima propriedade da lista.
Caso 4 — Coletor tenta criar uma nova carga antes de terminar o percurso
Com duas propriedades do percurso ainda sem nenhum registro, o coletor escolhe “Criar carga” no menu lateral. O aplicativo exibe o aviso de que não é possível criar a carga enquanto houver propriedades sem coleta ou não-coleta preenchidas, e nenhuma nova carga é criada até que o coletor finalize o registro das propriedades pendentes.
