Login
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Login
O Login é a porta de entrada do aplicativo do motorista: é a primeira tela que o motorista vê ao abrir o app e o ponto obrigatório antes de qualquer outra funcionalidade (visualização de carga, rota, execução de entregas).
Visão Geral
O Login é a porta de entrada do aplicativo do motorista: é a primeira tela que o motorista vê ao abrir o app e o ponto obrigatório antes de qualquer outra funcionalidade (visualização de carga, rota, execução de entregas). Nela o motorista se autentica com CPF e senha cadastrados previamente, ou é autenticado automaticamente pelo próprio aplicativo quando já existe uma sessão salva de um login anterior. Após a autenticação bem-sucedida, o motorista é encaminhado para a tela inicial do aplicativo (se a conta estiver ativa) ou para a tela de confirmação de cadastro (se o cadastro ainda estiver pendente). A partir do Login também é possível recuperar a senha, criar um novo cadastro de motorista ou solicitar a exclusão da própria conta.
Pré-requisitos
- O motorista precisa ter CPF e senha previamente cadastrados no sistema; sem isso, o login manual é sempre rejeitado.
- Para o login manual (online): o dispositivo precisa ter conexão com a internet. Sem conexão, a tentativa é interrompida antes de chegar ao sistema.
- Para o login automático (offline): é necessário que o motorista já tenha feito login com sucesso alguma vez neste mesmo dispositivo (o aplicativo guarda os dados desse login para reaproveitar) e que a permissão de localização do dispositivo esteja concedida. Sem uma dessas duas condições, o login automático não ocorre e a tela volta a pedir CPF e senha manualmente (ou, se a permissão estiver negada, exibe um aviso e permanece na tela de login).
- Na primeira vez que o motorista usa o aplicativo (ou enquanto não confirmar sua escolha), é necessário aceitar o uso de dados de localização para poder concluir qualquer login, manual ou automático; sem esse aceite, o aplicativo bloqueia o avanço mesmo com CPF e senha corretos.
Fluxo Operacional
- O motorista abre o aplicativo. Se já existir uma sessão salva de um login anterior neste dispositivo e a permissão de localização estiver concedida, o aplicativo tenta autenticar automaticamente, sem exigir nova digitação.
- Se não houver sessão salva (ou a permissão de localização estiver negada), o motorista preenche CPF e senha na tela de login e toca em “Entrar”.
- Caso seja a primeira vez que o motorista usa o aplicativo (ou ainda não tenha decidido sobre o uso de localização), o app exibe o aviso de uso de dados de localização; o motorista precisa confirmar para prosseguir. Em aparelhos Android, o app exibe em seguida um aviso com os requisitos mínimos do dispositivo.
- O aplicativo envia CPF e senha para validação.
- Se a validação for bem-sucedida, o motorista é encaminhado para a tela inicial do aplicativo (conta ativa) ou para a tela de confirmação de cadastro (cadastro pendente).
- Se a validação falhar, o aplicativo exibe a mensagem de erro correspondente e o motorista permanece na tela de login para tentar novamente.
- A partir da tela de login, o motorista também pode: recuperar a senha esquecida, criar um novo cadastro ou solicitar a exclusão da própria conta.
Interface e Comportamentos
Formulário de CPF e Senha na Tela de Login
A tela de login apresenta dois campos obrigatórios: CPF (com máscara de digitação no formato 000.000.000-00) e Senha (com opção de alternar entre texto oculto e visível através de um ícone no próprio campo). Ambos os campos exigem apenas que não estejam vazios — o aplicativo não valida o formato do CPF nem a complexidade da senha nesta tela; essa validação de fato acontece ao confirmar o login.
Diálogo de Uso de Localização e Requisitos Mínimos
Enquanto o motorista não tiver confirmado sua concordância com o uso de dados de localização, o aplicativo exibe esse aviso antes de permitir a conclusão de qualquer login (automático ou manual). O aviso apresenta o texto “Este aplicativo coleta dados de localização para habilitar o rastreamento durante as entregas, mesmo quando o aplicativo está fechado ou não em uso.”, seguido de “Estes dados são utilizados somente para finalidades decorrentes ou relacionadas a realização e gestão das entregas.”, “Para desligar o rastreamento basta se deslogar do aplicativo.” e “Ao instalar o aplicativo DeliveryB2B, você confirma que concorda com nossa Política de Privacidade e nossos Termos de uso.”, com links para a Política de Privacidade e para os Termos de Uso. Ao tocar em “Continuar”, o aplicativo solicita a permissão de localização em segundo plano e grava a confirmação do motorista, para não perguntar novamente nas próximas vezes.
Em dispositivos Android, imediatamente após essa confirmação o aplicativo exibe também um aviso com os requisitos mínimos recomendados do aparelho: “Para utilizar esse Aplicativo, seu aparelho deve ter as seguintes especificações mínimas:”, seguido da lista “- Processador octa-core de 1,8 GHz ou maior”, “- Memória RAM: 3 GB ou mais”, “- Bateria: 4.000 mAh ou mais”, “- 5 GB ou mais de espaço livre”, “- Tipo de GPS: GPS, A-GPS, GLONASS” e “- Sistema operacional de fábrica: Android 6+”. Em outras plataformas este aviso não aparece.
Botão “Entrar” na Tela de Login
Ao tocar em “Entrar”, o comportamento depende de dois fatores — se o formulário está preenchido corretamente e se o motorista já confirmou o uso de localização:
- Formulário válido e uso de localização já confirmado anteriormente: o aplicativo envia CPF e senha para autenticação imediatamente, exibindo um indicador de carregamento no próprio botão enquanto aguarda a resposta.
- Formulário válido, mas uso de localização ainda não confirmado: o aplicativo exibe primeiro o aviso de uso de localização (e, no Android, o de requisitos mínimos); se o motorista confirmar, o login é então enviado; se o motorista não confirmar (fechar o aviso sem aceitar), o aplicativo exibe “Permissão de localização negada!” e não envia o login.
- Formulário inválido (CPF ou senha vazios): nenhuma ação é disparada; o próprio campo em branco exibe “Campo obrigatório” abaixo dele.
Encerrar o Aplicativo pela Tela de Login
Ao pressionar o botão de voltar do dispositivo estando na tela de login, o aplicativo não fecha imediatamente: exige um segundo toque em até 2 segundos, exibindo “Toque duas vezes para sair” no primeiro toque. Se o segundo toque ocorrer dentro desse intervalo, o aplicativo é encerrado.
Exclusão de Conta pela Tela de Login
A tela de login oferece a opção “Excluir conta” para o motorista que deseja remover permanentemente sua conta. Ao tocar nela, o aplicativo exibe um diálogo de confirmação com o texto “Podemos prosseguir com a exclusão de sua conta. Se essa realmente for sua decisão, basta confirmar e faremos isso para você. Lembre-se de que essa ação é irreversível e todos seus dados serão removidos permanentemente.”, com links para a Política de Privacidade e para os Termos de Uso. Ao confirmar, o aplicativo abre no navegador do dispositivo a página de solicitação de remoção de conta — a exclusão em si não é feita dentro do aplicativo.
Feedbacks ao Usuário
Na tela de login, o aplicativo comunica ao motorista o resultado de cada tentativa de entrada (manual ou automática) através de avisos e mensagens exatas, listados a seguir.
| Situação | Feedback | Texto exato |
|---|---|---|
| Campo CPF ou Senha deixado em branco | Aviso abaixo do campo | “Campo obrigatório” |
| CPF ou senha não enviados | Aviso (snackbar) | “CPF ou senha incorreto(s).” |
| CPF não cadastrado no sistema | Aviso (snackbar) | “Motorista não encontrado.” |
| Conta do motorista inativa | Aviso (snackbar) | “Conta expirada.” |
| Senha informada não confere | Aviso (snackbar) | “CPF ou senha incorreto(s).” |
| Sem conexão com a internet ao tentar logar | Aviso (snackbar) | “Sem conexão de internet!” |
| Falha de rede ao tentar logar (sem mensagem específica) | Aviso (snackbar) | “Erro ao realizar o login!” |
| Login automático (offline) sem dados salvos válidos | Aviso (snackbar) | “Erro ao logar offline” |
| Uso de localização não confirmado ao tentar entrar | Aviso (snackbar) | “Permissão de localização negada!” |
| Login automático (offline) bloqueado por permissão de localização negada | Aviso (snackbar) | “Permissão de localização negada!” |
| Login bem-sucedido mas uso de localização ainda não confirmado | Aviso (snackbar) | “Permissão de localização negada!” |
| Recuperação de senha concluída com sucesso (retorno à tela de login) | Aviso (snackbar), com 1 segundo de atraso | “Senha atualizada com sucesso” |
Regras de Negócio
- Se o CPF ou a senha não forem informados na tentativa de login, o sistema rejeita com “CPF ou senha incorreto(s).”.
- Se não existir motorista cadastrado com o CPF informado, o sistema rejeita com “Motorista não encontrado.”.
- Se o motorista for encontrado mas a conta estiver com status inativo, o sistema rejeita com “Conta expirada.”.
- Se a senha informada não conferir com a senha cadastrada, o sistema rejeita com a mesma mensagem “CPF ou senha incorreto(s).” usada para campos vazios — o sistema não distingue, na mensagem devolvida ao motorista, entre “campo vazio” e “senha incorreta”.
- No momento do login bem-sucedido, o aplicativo identifica se o motorista opera no modo crossdock, com base no vínculo do motorista com uma empresa naquele momento: motorista com vínculo ativo com alguma empresa opera fora do modo crossdock; motorista sem nenhum vínculo ativo no momento opera no modo crossdock. Esse indicador de crossdock é usado tanto no fluxo de entregas do dia quanto para configurar o rastreamento de localização do motorista.
- Mudanças no vínculo do motorista com a empresa ou no status da conta feitas enquanto o motorista já está com a sessão aberta só passam a valer a partir de um novo login — se uma dessas informações for alterada pelo escritório, é necessário sair do aplicativo e entrar novamente para que a mudança tenha efeito.
- Quando a conta do motorista já está ativa, o aplicativo o encaminha para a tela inicial logo após o login. Quando o cadastro do motorista ainda está pendente de confirmação, o aplicativo o encaminha para a tela de confirmação de cadastro em vez da tela inicial, mesmo com CPF e senha corretos.
- No login automático (offline), o aplicativo reaproveita os dados do último login salvo neste dispositivo, sem precisar de conexão; se não houver dados salvos disponíveis no momento em que o login automático é acionado, o aplicativo rejeita com “Erro ao logar offline”.
- O login automático (offline) só é concluído se a permissão de localização do dispositivo estiver concedida (Sempre ou Durante o uso); caso contrário, é bloqueado com “Permissão de localização negada!” e o motorista precisa prosseguir manualmente.
- Enquanto um aviso de erro de login já estiver sendo exibido na tela, novos avisos de erro são ignorados pelos 2 segundos seguintes, para não exibir a mesma mensagem em duplicidade.
- Ao sair do aplicativo (encerrar a sessão), o aplicativo apaga toda a sessão salva localmente (incluindo a lista de cargas já carregadas) e para o rastreamento de localização em segundo plano. Esse encerramento é imediato e local ao aparelho — a partir daí, uma nova entrada só pode começar com um login manual (online) completo.
Comportamento Offline e Dados Locais
Ao concluir um login manual com sucesso, o aplicativo guarda no aparelho os dados do motorista autenticado (identificador, dados de acesso, nome, telefone, CPF e indicador de crossdock). Esses dados salvos são o que permite o login automático nas próximas vezes que o aplicativo for aberto neste mesmo dispositivo, sem precisar de conexão com a internet — desde que a permissão de localização continue concedida.
Ao sair do aplicativo (encerrar a sessão), todos esses dados salvos são apagados do aparelho, assim como a lista de cargas já carregadas; a partir daí, uma nova entrada só pode começar com um login manual (online) completo.
Geolocalização e Rastreamento
O uso de localização em segundo plano é condição para concluir o login (manual ou automático): enquanto o motorista não confirmar o aviso de uso de dados de localização, nenhum login é concluído, mesmo com CPF e senha corretos.
Assim que o login é concluído com sucesso e o uso de localização já foi confirmado, o aplicativo passa a acompanhar a posição do motorista mesmo com o aplicativo fechado ou em segundo plano, enviando essa posição ao sistema. Esse rastreamento é interrompido apenas quando o motorista sai do aplicativo (encerra a sessão).
Troubleshooting
Login rejeitado com CPF ou senha incorreto(s)
Cenário: o motorista tentou entrar com CPF e/ou senha em branco, ou com a senha errada para o CPF informado.
Mensagem exibida: “CPF ou senha incorreto(s).”
O que fazer: conferir se ambos os campos foram preenchidos e se a senha está correta; se o problema persistir, usar “Esqueceu a senha?” para redefinir a senha.
Login rejeitado informando que o motorista não foi encontrado
Cenário: o motorista tentou entrar com um CPF que não está cadastrado no sistema.
Mensagem exibida: “Motorista não encontrado.”
O que fazer: confirmar se o CPF foi digitado corretamente; se estiver correto, entrar em contato com o suporte para verificar o cadastro.
Login rejeitado por conta expirada
Cenário: o motorista tem cadastro no sistema, mas a conta está com status inativo.
Mensagem exibida: “Conta expirada.”
O que fazer: entrar em contato com o suporte/administrador responsável pela reativação da conta.
Login não é enviado por falta de conexão com a internet
Cenário: o motorista tentou fazer login manual sem conexão com a internet no dispositivo.
Mensagem exibida: “Sem conexão de internet!”
O que fazer: conectar-se a uma rede Wi-Fi ou dados móveis e tentar novamente.
Erro ao tentar logar sem mensagem específica
Cenário: a tentativa de login falhou por um problema de comunicação que não devolveu uma mensagem de erro específica.
Mensagem exibida: “Erro ao realizar o login!”
O que fazer: tentar novamente; se persistir, verificar a conectividade do dispositivo e, se o problema continuar, contatar o suporte.
Login automático (offline) falha ao abrir o aplicativo
Cenário: o aplicativo tentou autenticar automaticamente ao abrir, mas não encontrou dados válidos de um login anterior.
Mensagem exibida: “Erro ao logar offline”
O que fazer: fazer login manualmente com CPF e senha.
Aplicativo não avança após login por permissão de localização negada
Cenário: o motorista concluiu o login com CPF e senha corretos, mas não confirmou o uso de dados de localização (ou a confirmação foi recusada).
Mensagem exibida: “Permissão de localização negada!”
O que fazer: conceder a permissão de localização do aplicativo nas configurações do dispositivo e tentar o login novamente.
Aplicativo fecha inesperadamente ao tocar em “Entrar” logo após abrir a tela de login
Cenário: o motorista preenche CPF e senha e toca em “Entrar” muito rapidamente, logo que a tela de login abre.
Mensagem exibida: Nenhuma — o aplicativo se fecha (encerra) sem aviso antes de processar o toque em “Entrar”.
O que fazer: abrir o aplicativo novamente e aguardar alguns instantes na tela de login antes de tocar em “Entrar”.
Nenhum aviso aparece mesmo quando o download do modelo de reconhecimento falha
Cenário: logo após o login, o aplicativo tenta baixar em segundo plano um arquivo usado para reconhecimento automático, e esse download falha.
Mensagem exibida: Nenhuma — o aplicativo continua funcionando normalmente, sem avisar o motorista sobre a falha do download.
O que fazer: nenhuma ação imediata é necessária; se funcionalidades de leitura automática apresentarem problema mais tarde, reabrir o aplicativo (ou reinstalar, em último caso) costuma corrigir.
Um único toque no botão voltar não fecha o aplicativo na tela de login
Cenário: o motorista pressiona o botão de voltar do dispositivo estando na tela de login, esperando sair do aplicativo.
Mensagem exibida: “Toque duas vezes para sair”
O que fazer: tocar em voltar uma segunda vez, em até 2 segundos, para efetivamente sair do aplicativo.
Casos de Uso
Caso 1 — Primeiro login de um motorista recém-cadastrado
O motorista José, com CPF 123.456.789-00 já cadastrado pelo administrador, abre o aplicativo pela primeira vez. Ele digita o CPF e a senha e toca em “Entrar”. Como é o primeiro acesso, o aplicativo exibe o aviso de uso de localização; José confirma. Por estar em um aparelho Android, o aplicativo mostra também os requisitos mínimos recomendados; José toca em “Continuar”. O login é então concluído: como José não tem vínculo ativo com nenhuma empresa no momento, o aplicativo o identifica como operando em modo crossdock, com status de conta ativa. O aplicativo salva a sessão, passa a rastrear a localização e encaminha José para a tela inicial.
Caso 2 — Login automático (offline) ao reabrir o aplicativo
A motorista Maria já fez login com sucesso neste aparelho anteriormente. Ao reabrir o aplicativo no dia seguinte, sem digitar nada, o aplicativo identifica a sessão salva, confere que a permissão de localização continua concedida e autentica Maria automaticamente, levando-a direto à tela inicial sem precisar de conexão com a internet.
Caso 3 — Senha incorreta seguida de nova tentativa bem-sucedida
O motorista Carlos digita o CPF corretamente, mas erra a senha. O aplicativo exibe “CPF ou senha incorreto(s).” em um aviso na tela. Carlos apaga a senha, digita novamente de forma correta e toca em “Entrar” outra vez; desta vez a validação é bem-sucedida e Carlos é encaminhado para a tela inicial.
Caso 4 — Motorista com cadastro pendente é direcionado para confirmação
A motorista Ana informa CPF e senha corretos, mas seu cadastro ainda está pendente de confirmação. Mesmo com as credenciais corretas, o aplicativo não a encaminha para a tela inicial: em vez disso, ele a direciona para a tela de confirmação de cadastro, onde o processo de cadastro deve ser concluído antes de operar normalmente.
