Atualizar Rota
Criado por Igor Ribeiro em 09 de outubro de 2026
Atualizado por Igor Ribeiro em 09 de outubro de 2026
Atualizar Rota
A tela de Atualizar Rota permite ao coletor trocar, a qualquer momento do dia, a rota (percurso) de coleta que está em uso no aplicativo, escolhendo entre as rotas que já estão disponíveis no aparelho a partir da última sincronização com o ERP.
Visão Geral
A tela de Atualizar Rota permite ao coletor trocar, a qualquer momento do dia, a rota (percurso) de coleta que está em uso no aplicativo, escolhendo entre as rotas que já estão disponíveis no aparelho a partir da última sincronização com o ERP. Ela é aberta a partir do ícone de bússola no topo da tela de Propriedades, sem nenhuma confirmação prévia, e, ao ser confirmada, leva o coletor de volta à tela de Propriedades — agora refletindo a nova rota escolhida.
Pré-requisitos
- O coletor precisa estar com a sessão ativa no aplicativo; é dessa sessão que a tela de Atualizar Rota obtém a placa do veículo atualmente associada ao coletor.
- A lista de rotas oferecida para escolha depende inteiramente de uma sincronização de dados já ter ocorrido antes: se o aplicativo nunca sincronizou nenhuma rota (ou se nenhuma rota chegou a ser vinculada ao coletor pela sincronização), a tela abre sem nenhuma rota para escolher e sem avisar o motivo (ver Troubleshooting).
- A tela não depende de conexão com a internet no momento em que é usada: tanto a visualização das rotas disponíveis quanto a gravação da rota escolhida acontecem inteiramente com dados já salvos no aparelho.
Fluxo Operacional
- O coletor toca no ícone de bússola no topo da tela de Propriedades e é levado direto à tela de Atualizar Rota, sem nenhuma pergunta de confirmação antes de abri-la.
- Assim que a tela abre, o aplicativo já carrega, em segundo plano, a placa do veículo atual do coletor e a lista de rotas disponíveis; enquanto isso, o botão de confirmar mostra um indicador de carregamento.
- Quando existe mais de uma rota disponível, o coletor pode escolher outra rota no seletor; a rota que já estava em uso para o coletor vem pré-selecionada automaticamente.
- O coletor toca em “Confirmar” para efetivar a troca; o aplicativo tenta gravar a nova rota escolhida como a rota corrente e, na sequência, leva o coletor para a tela de Propriedades.
- Alternativamente, o coletor pode tocar no botão de fechamento (rotulado “Cancelar” ou “Sair”, conforme o caso — ver Interface e Comportamentos) para voltar à tela anterior sem efetivar nenhuma troca.
- Como a tela de Atualizar Rota não é substituída pela tela de Propriedades ao confirmar (fica empilhada por baixo), se o coletor voltar a partir da tela de Propriedades logo em seguida, ele retorna novamente à tela de Atualizar Rota (ver Troubleshooting).
Interface e Comportamentos
Identificação da Tela
O título exibido no topo da tela de Atualizar Rota é o texto fixo “Definir rota / linha”.
Seletor de Rota na Tela de Atualizar Rota
Acima do seletor, a tela mostra o texto fixo “Escolha a rota”. O seletor em si só aparece quando existe ao menos uma rota disponível (sincronizada previamente a partir do ERP); cada opção mostra o código e o nome da rota. Quando não existe nenhuma rota disponível, o espaço do seletor fica completamente vazio, sem nenhum texto no lugar (ver Troubleshooting T-01).
Pré-seleção Automática da Rota
Ao carregar a lista de rotas, o aplicativo tenta localizar, entre as rotas disponíveis, aquela que já estava configurada como a rota corrente do coletor, e a deixa pré-selecionada no seletor. Se a rota anteriormente configurada não for encontrada entre as disponíveis — por exemplo, se o coletor nunca tinha escolhido uma rota antes, ou se a rota configurada anteriormente não está mais entre as disponíveis — o aplicativo pré-seleciona a primeira rota da lista (que vem sempre ordenada pelo código da rota, do menor para o maior), sem avisar o coletor de que essa escolha foi automática.
Botão de Fechamento (“Cancelar” / “Sair”)
O botão de fechamento da tela de Atualizar Rota mostra o texto “Cancelar” quando o coletor já tem uma placa de veículo configurada no momento em que a tela é aberta, e mostra o texto “Sair” quando o coletor ainda não tem nenhuma placa configurada. Em ambos os casos, porém, o toque no botão executa exatamente a mesma ação: fechar a tela e voltar à anterior — o texto “Sair” não leva a nenhuma ação adicional além do fechamento simples (ver Troubleshooting T-04).
Botão “Confirmar” e Indicador de Carregamento
O botão “Confirmar” mostra o texto “Confirmar” em condições normais. Enquanto o aplicativo está preparando os dados da tela (ao abri-la) ou processando a confirmação, o botão passa a mostrar um indicador de carregamento em seu lugar e fica inativo ao toque, impedindo um segundo toque durante esse intervalo.
Regras de Negócio
- Ao abrir a tela de Atualizar Rota, o aplicativo busca a placa do veículo já associada ao coletor logado; se o coletor ainda não tiver nenhuma placa registrada, o aplicativo assume uma placa vazia para essa tela.
- Se a placa obtida não estiver vazia, o botão de fechamento da tela é liberado como “Cancelar”; se estiver vazia, passa a “Sair” — sem, no entanto, mudar o que o botão efetivamente faz (ver Interface e Comportamentos).
- A lista de rotas oferecida para escolha é sempre a cópia já sincronizada anteriormente a partir do ERP; a tela de Atualizar Rota não busca uma lista nova no servidor nesse momento.
- A lista de rotas é sempre ordenada pelo código da rota, em ordem crescente; não existe outro critério de ordenação.
- Se não houver nenhuma rota sincronizada, o aplicativo não pré-seleciona nenhuma rota e não exibe nenhum seletor (ver Troubleshooting T-01).
- Se houver ao menos uma rota: o aplicativo pré-seleciona a rota que já estava em uso para o coletor, quando ela ainda existe entre as disponíveis; caso contrário (coletor sem rota configurada antes, ou a rota anterior não existe mais entre as disponíveis), pré-seleciona automaticamente a primeira rota da lista ordenada.
- Ao tocar em “Confirmar”, o aplicativo só efetiva a troca quando existe uma rota corretamente selecionada no seletor. Se não houver nenhuma rota selecionada (por exemplo, quando não havia nenhuma rota disponível para escolha), a troca é simplesmente ignorada, sem nenhum aviso ao coletor, e o aplicativo avança para a tela de Propriedades do mesmo jeito, como se a troca tivesse sido concluída (ver Troubleshooting T-02).
- A lista de rotas oferecida pelo aplicativo depende de uma configuração do ERP controlada pelo administrador do sistema: dependendo dela, o coletor vê apenas as rotas atribuídas ao seu próprio cadastro, ou vê todas as rotas cadastradas no sistema, de qualquer motorista. Essa configuração não pode ser alterada pelo coletor nem pelo aplicativo.
Comportamento Offline e Dados Locais
A tela de Atualizar Rota funciona inteiramente a partir de dados já salvos no aparelho, sem nenhuma chamada ao servidor no momento em que é usada: tanto a lista de rotas oferecida para escolha quanto a placa do veículo do coletor vêm de uma sincronização anterior (feita em outra tela/momento). A rota escolhida pelo coletor ao confirmar também é gravada apenas localmente no aparelho, como a rota corrente do coletor — essa gravação não depende de conexão com a internet e não é enviada ao ERP nesse momento.
Troubleshooting
A tela de Atualizar Rota abre sem nenhuma opção de rota para escolher
Cenário: o coletor abre a tela de Atualizar Rota e, no lugar do seletor de rota, não aparece nada.
Mensagem exibida: Nenhuma — o espaço do seletor de rota simplesmente fica vazio, sem nenhum aviso.
O que fazer: confirmar que os dados do aplicativo foram sincronizados recentemente com o ERP; se já foram, verificar junto ao administrador do ERP se existe alguma rota cadastrada e vinculada a este coletor — dependendo da configuração do sistema, um coletor sem nenhuma rota vinculada ao seu cadastro não recebe nenhuma rota para escolher.
Depois de confirmar, a rota do coletor não muda, mas o aplicativo segue normalmente para a tela de Propriedades
Cenário: o coletor toca em “Confirmar” na tela de Atualizar Rota (tipicamente quando não havia nenhuma rota disponível para escolher) e é levado para a tela de Propriedades como se a troca tivesse dado certo.
Mensagem exibida: Nenhuma — o aplicativo não informa se a rota foi realmente trocada ou não.
O que fazer: orientar o coletor a voltar à tela de Atualizar Rota (pelo ícone de bússola na tela de Propriedades) e conferir se existe alguma rota disponível para escolha; se não existir nenhuma, seguir a orientação do cenário T-01.
Ao voltar da tela de Propriedades, o coletor retorna à tela de Atualizar Rota
Cenário: o coletor confirma a troca de rota, chega à tela de Propriedades e, em seguida, aciona o botão de voltar do aparelho.
Mensagem exibida: Nenhuma — é um comportamento normal da navegação do aplicativo.
O que fazer: informar que isso é esperado: a tela de Atualizar Rota permanece “por baixo” da tela de Propriedades depois da confirmação, então o botão de voltar leva de volta a ela. Para encerrar essa tela, o coletor pode tocar em “Cancelar”/”Sair”.
O botão “Sair” da tela de Atualizar Rota não encerra a sessão do coletor
Cenário: o coletor abre a tela de Atualizar Rota sem ainda ter uma placa configurada (o botão aparece com o texto “Sair”) e toca nele esperando encerrar a sessão ou sair do aplicativo.
Mensagem exibida: Nenhuma.
O que fazer: informar que, nesta tela, tanto “Cancelar” quanto “Sair” apenas fecham a tela de Atualizar Rota e voltam à tela anterior — nenhum dos dois encerra a sessão do coletor.
Casos de Uso
Caso 1 — Coletor troca de rota no meio do dia
O coletor já está com a rota “12 – Linha Norte” configurada e, ao chegar perto do fim do percurso, precisa seguir para outra rota. Ele toca no ícone de bússola na tela de Propriedades, abre a tela de Atualizar Rota, encontra “12 – Linha Norte” já pré-selecionada, escolhe “07 – Linha Sul” no seletor e toca em “Confirmar”. O aplicativo grava a nova rota e leva o coletor de volta à tela de Propriedades, agora refletindo a rota “07 – Linha Sul”.
Caso 2 — Coletor sem nenhuma rota vinculada ao seu cadastro
Um coletor recém-cadastrado, cujo administrador ainda não vinculou nenhuma rota a ele no ERP, sincroniza os dados e abre a tela de Atualizar Rota. O seletor de rota aparece vazio, sem nenhum aviso. Ele toca em “Confirmar” mesmo assim e é levado normalmente para a tela de Propriedades, sem que nenhuma rota tenha sido de fato associada a ele.
Caso 3 — Coletor desiste da troca de rota
O coletor abre a tela de Atualizar Rota por engano, percebe que não precisa trocar de rota agora e toca no botão de fechamento (mostrando “Cancelar”, pois ele já tem uma placa configurada). A tela se fecha e nenhuma alteração é feita na rota corrente.
