Nova Carga
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Nova Carga
A tela de Nova Carga é o ponto em que o motorista começa a trabalhar em uma carga: nela, o motorista informa a placa do veículo para buscar as entregas atribuídas a ela, ou o aplicativo já retoma automaticamente uma carga que ficou pendente de uma sessão anterior, sem que o motorista precise informar a placa de novo.
Visão Geral
A tela de Nova Carga é o ponto em que o motorista começa a trabalhar em uma carga: nela, o motorista informa a placa do veículo para buscar as entregas atribuídas a ela, ou o aplicativo já retoma automaticamente uma carga que ficou pendente de uma sessão anterior, sem que o motorista precise informar a placa de novo. Ao encontrar a carga, o motorista é levado para a tela de Cargo (quando a busca foi manual, pela placa) ou direto para a tela de Cargas (quando a retomada foi automática), de onde segue para a execução das entregas.
Pré-requisitos
Para que a tela de Nova Carga funcione, as seguintes condições precisam estar atendidas:
- Motorista autenticado no aplicativo. Sem estar com a sessão ativa, nenhuma busca de carga é feita.
- Permissão de localização configurada como “permitir sempre”. Se estiver configurada apenas como “durante o uso do app”, o aplicativo exibe um alerta pedindo que o motorista mude a permissão antes de prosseguir. Nenhuma busca de carga (automática ou manual) é feita enquanto essa condição não for atendida.
- GPS do aparelho ativado. Se o GPS estiver desligado, o aplicativo exibe um alerta pedindo que o motorista o ative antes de prosseguir. Assim como a permissão, esta condição bloqueia qualquer busca de carga enquanto não for atendida.
- Placa do veículo no formato correto (apenas para a busca manual). O motorista precisa informar a placa antes de tocar em “Buscar”; sem isso, a busca não é enviada.
Fluxo Operacional
- O motorista abre a tela de Nova Carga.
- O aplicativo verifica a permissão de localização e o GPS do aparelho; se alguma dessas condições não estiver atendida, um alerta correspondente é exibido e a tela aguarda que o motorista resolva a pendência.
- Com as permissões atendidas, o aplicativo verifica se existe uma carga pendente salva no aparelho de uma sessão anterior ainda não concluída. Se existir, ele tenta retomá-la automaticamente, sem que o motorista precise informar a placa.
- Se não havia carga pendente para retomar, a tela permanece exibindo o campo de placa do veículo, aguardando que o motorista a informe.
- O motorista digita a placa do veículo — os caracteres são convertidos automaticamente para maiúsculas — e toca em “Buscar”.
- Antes de enviar a busca, o aplicativo reconfirma a permissão de localização e o GPS, e valida o formato da placa digitada.
- Enquanto a busca (automática ou manual) está em andamento, o botão de busca exibe um indicador de carregamento.
- Se a busca encontra cargas, o motorista é levado para a tela de Cargo (busca manual, por placa) ou para a tela de Cargas (retomada automática), sem poder voltar à tela de Nova Carga pelo botão de voltar do aparelho.
- Se a busca falha, uma notificação de erro aparece pouco depois, e o motorista permanece na tela de Nova Carga para corrigir o problema e tentar novamente.
Interface e Comportamentos
Campo de Placa do Veículo na Tela de Nova Carga
O único campo do formulário da tela de Nova Carga é a placa do veículo. Ele aceita exatamente 7 caracteres, no formato três letras, um número, um caractere que pode ser letra ou número, e dois números — compatível tanto com o padrão antigo de placas quanto com o padrão Mercosul. Todo caractere digitado é automaticamente convertido para maiúsculas conforme o motorista digita.
Botão de Busca na Tela de Nova Carga
Na tela de Nova Carga, o botão “Buscar” inicia a busca manual de carga pela placa informada. Antes de agir, ele reconfirma que a permissão de localização “permitir sempre” e o GPS estão ativos; se essa reconfirmação falhar, a busca não é feita e o alerta de permissão correspondente pode reaparecer. Em seguida, o formulário é validado: se o campo de placa estiver vazio ou incompleto, a busca também não é feita — apenas o texto de erro correspondente aparece abaixo do campo, sem alerta ou notificação adicional. Enquanto uma busca está em andamento (automática ou manual), o botão exibe um indicador de carregamento e fica desabilitado para um novo toque.
Retorno das Configurações do Aparelho
Se o motorista foi enviado às configurações do aparelho a partir de um dos alertas de permissão de localização ou de GPS, e volta ao aplicativo, a tela de Nova Carga é fechada automaticamente, retornando à tela anterior — independentemente de a permissão ter sido efetivamente concedida nas configurações. O motorista precisa reabrir a tela de Nova Carga para tentar novamente.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| GPS do aparelho desligado | Alerta, com botão para abrir as configurações de localização | “Para o rastreamento correto do trajeto, é necessário ativar a localização.” |
| Permissão de localização concedida apenas para “durante o uso do app” | Alerta, com botão para abrir as configurações do aplicativo | “Para o rastreamento correto do trajeto, é necessário mudar a permissão de localização para ‘permitir todo tempo’ nas permissões de aplicativo.” |
| Campo de placa deixado em branco ao tocar em “Buscar” | Texto de erro abaixo do campo | “Campo obrigatório” |
| Placa digitada não preenche o formato de 7 caracteres | Texto de erro abaixo do campo | “Placa inválida” |
| Busca de carga (automática ou manual) sem nenhuma entrega encontrada | Notificação de erro, exibida cerca de 1 segundo após a resposta | “Não há cargas” |
| Retomada automática da carga pendente sem dados de entrega válidos para continuar | Notificação de erro, exibida cerca de 1 segundo após a resposta | “Nada para atualizar” |
| Busca de carga fora do modo crossdock chega sem a placa do veículo | Notificação de erro, exibida cerca de 1 segundo após a resposta | “Placa inválida.” |
Regras de Negócio
Permissões de localização
Na tela de Nova Carga, as permissões de localização só são consideradas atendidas quando, ao mesmo tempo, a permissão está definida como “permitir sempre” e o GPS do aparelho está ativado — a ausência de qualquer uma delas é tratada como permissão não atendida. A permissão é sempre checada antes do GPS: se a permissão ainda estiver incorreta, o aplicativo exibe apenas o alerta de permissão e nem chega a avaliar o estado do GPS naquela tentativa. O alerta de GPS só pode aparecer depois que a permissão já está correta. Essa verificação completa é feita tanto ao abrir a tela (antes de tentar a retomada automática) quanto ao tocar em “Buscar” (antes de validar e enviar a placa).
Retomada automática de carga pendente
Ao abrir a tela de Nova Carga, com as permissões de localização atendidas, o aplicativo verifica se há, salvos no aparelho, dados de uma entrega pendente e dados de uma viagem pendente, e se nenhuma carga já está carregada na sessão atual. Se essas três condições forem verdadeiras ao mesmo tempo, o aplicativo dispara automaticamente a retomada da carga, usando o registro de entrega salvo, sem que o motorista informe a placa. Se qualquer uma delas não for atendida, nenhuma ação automática ocorre, e a tela permanece aguardando que o motorista informe a placa manualmente.
Formato e validação da placa do veículo
Na tela de Nova Carga, o campo de placa aceita exatamente 7 caracteres — três letras, um número, um caractere alfanumérico e dois números — e converte automaticamente para maiúsculas. O campo é obrigatório: se deixado em branco, o aplicativo bloqueia a busca manual. Se o motorista digitar um valor que não preencha os 7 caracteres do formato esperado, o aplicativo também bloqueia a busca. Quando o campo está vazio, apenas a validação de preenchimento se aplica — a validação de formato da placa não rejeita um campo vazio, evitando que as duas mensagens de erro apareçam ao mesmo tempo.
Feedback de falha na busca
Na tela de Nova Carga, quando a busca de carga (automática ou manual) falha, o aplicativo aguarda cerca de 1 segundo e então exibe uma notificação de erro com a mensagem específica daquela falha — exceto em uma situação interna de reinicialização da tela, caso em que nenhuma notificação é exibida ao motorista.
Navegação após busca bem-sucedida
Quando a busca manual de carga pela placa é bem-sucedida, o aplicativo leva o motorista para a tela de Cargo, sem possibilidade de voltar à tela de Nova Carga pelo botão de voltar do aparelho. Quando a retomada automática da carga pendente é bem-sucedida, o aplicativo leva o motorista diretamente para a tela de Cargas, também sem possibilidade de voltar.
Comportamento Offline e Dados Locais
Ao ser aberta, a tela de Nova Carga verifica os dados de entrega e de viagem salvos no aparelho antes de tentar falar com o servidor, para decidir se retoma uma carga pendente automaticamente. Esse mesmo mecanismo — que prioriza os dados salvos no aparelho antes de consultar o servidor — é o que a tela de Cargo usa; na tela de Nova Carga ele é acionado automaticamente ao abrir, sem exigir que o motorista informe a placa primeiro.
Troubleshooting
Busca não é feita e aparece um alerta pedindo para ativar a localização
Cenário: o motorista toca em “Buscar” (ou abre a tela com uma carga pendente salva) com a permissão de localização já em “permitir sempre”, mas com o GPS do aparelho desligado.
Mensagem exibida: “Para o rastreamento correto do trajeto, é necessário ativar a localização.”
O que fazer: ativar o GPS pelo botão do próprio alerta ou pelas configurações do aparelho e repetir a operação.
Busca não é feita e aparece um alerta pedindo permissão de localização “sempre”
Cenário: o motorista toca em “Buscar” (ou abre a tela com uma carga pendente salva) com a permissão de localização concedida apenas para “durante o uso do app”.
Mensagem exibida: “Para o rastreamento correto do trajeto, é necessário mudar a permissão de localização para ‘permitir todo tempo’ nas permissões de aplicativo.”
O que fazer: tocar no botão do alerta para abrir as configurações do aplicativo e alterar a permissão para “permitir sempre”. Ao retornar ao aplicativo, a tela de Nova Carga se fecha automaticamente — é necessário reabri-la e tentar a busca novamente.
Busca por placa não é feita e aparece “Campo obrigatório”
Cenário: o motorista toca em “Buscar” com o campo de placa vazio.
Mensagem exibida: “Campo obrigatório”
O que fazer: informar a placa do veículo e tocar em “Buscar” novamente.
Busca por placa não é feita e aparece “Placa inválida” abaixo do campo
Cenário: o motorista toca em “Buscar” com uma placa que não preenche os 7 caracteres do formato esperado.
Mensagem exibida: “Placa inválida”
O que fazer: completar a placa no formato correto (três letras, um número, um caractere alfanumérico e dois números) e tocar em “Buscar” novamente.
Busca retorna “Não há cargas”
Cenário: o motorista buscou pela placa, ou o aplicativo tentou retomar automaticamente uma carga pendente, e nenhuma entrega vinculada foi encontrada.
Mensagem exibida: “Não há cargas”
O que fazer: confirmar que existem entregas atribuídas à placa informada; sincronizar novamente e tentar de novo.
Retomada automática não avança e aparece “Nada para atualizar”
Cenário: havia uma carga pendente salva no aparelho, mas ela não trouxe dados de entrega válidos para continuar.
Mensagem exibida: “Nada para atualizar”
O que fazer: informar a placa manualmente e tocar em “Buscar”.
Busca por placa recusada com “Placa inválida.” em uma notificação
Cenário: a busca chegou a ser enviada fora do modo crossdock sem a placa do veículo, apesar da validação no campo.
Mensagem exibida: “Placa inválida.”
O que fazer: reabrir a tela de Nova Carga, informar a placa novamente e repetir a busca.
A tela de Nova Carga não avança sozinha e nenhuma mensagem aparece ao ser aberta
Cenário: havia uma carga pendente salva no aparelho, mas o aplicativo não conseguiu usá-la para retomar automaticamente.
Mensagem exibida: Nenhuma — a tela permanece exibindo apenas o campo de placa vazio, sem indicar que uma tentativa de retomada automática ocorreu.
O que fazer: informar a placa manualmente e tocar em “Buscar”; se o problema persistir em aberturas seguintes, acionar o suporte.
Casos de Uso
Caso 1 — Retomada automática de uma carga pendente
O motorista havia iniciado a carga da placa “ABC1D23” em uma sessão anterior, mas fechou o aplicativo antes de concluir. Ao reabrir o aplicativo e chegar à tela de Nova Carga, com a permissão de localização “sempre” e o GPS ativos, o aplicativo identifica os dados salvos no aparelho, dispara a retomada automaticamente e leva o motorista direto para a tela de Cargas, sem que ele precise informar a placa novamente.
Caso 2 — Busca manual de carga com placa nova
O motorista está usando o aplicativo pela primeira vez no dia, sem nenhuma carga pendente salva. Ele informa a placa “XYZ2E45” no campo, o texto é convertido automaticamente para maiúsculas, e toca em “Buscar”. Com as permissões de localização atendidas e a placa no formato correto, o aplicativo encontra as entregas atribuídas àquela placa e leva o motorista para a tela de Cargo.
Caso 3 — Permissão de localização insuficiente antes da primeira busca
O motorista abre a tela de Nova Carga com a permissão de localização configurada apenas para “durante o uso do app”. Ao tocar em “Buscar”, o alerta pedindo a permissão “sempre” é exibido antes de qualquer validação da placa. O motorista ajusta a permissão nas configurações do aplicativo; ao retornar, a tela de Nova Carga se fecha automaticamente. Ele a reabre, informa a placa novamente e toca em “Buscar” — desta vez a busca é enviada normalmente.
Caso 4 — Placa incompleta corrigida pelo motorista
O motorista digita apenas “ABC1D2” (6 caracteres) e toca em “Buscar”. O aplicativo bloqueia o envio e exibe “Placa inválida” abaixo do campo. O motorista completa o último caractere, digitando “ABC1D23”, e toca em “Buscar” novamente — desta vez a validação passa e a busca é enviada.
