Seleção de Carga
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Seleção de Carga
A tela de Seleção de Carga mostra ao motorista a lista de cargas atribuídas a ele para o veículo em uso, já separadas em grupos, e é o ponto onde o motorista escolhe qual carga vai executar em seguida.
Visão Geral
A tela de Seleção de Carga mostra ao motorista a lista de cargas atribuídas a ele para o veículo em uso, já separadas em grupos, e é o ponto onde o motorista escolhe qual carga vai executar em seguida. Ela aparece depois que o aplicativo já buscou as cargas — vindo da Tela Inicial (quando o motorista opera em modo padrão), da tela de Nova Carga, da tela de Cargas ou de uma sincronização disparada pelo menu do motorista. Ao escolher uma carga na lista, o motorista é levado para a tela de Entregas da Carga, onde executa as entregas daquele grupo uma a uma.
Pré-requisitos
- Motorista autenticado: toda busca de cargas e todo início de carga exigem que o motorista esteja com uma sessão válida no aplicativo; sem isso a operação é recusada antes de qualquer outra verificação.
- Existência de cargas pendentes: é necessário existir ao menos uma entrega com status “aguardando” ou “em andamento” atribuída ao motorista (e, fora do modo crossdock, à placa do veículo informada). Sem isso, a tela mostra a mensagem de ausência de cargas.
- Vínculo ativo com uma empresa: fora do modo crossdock, o motorista precisa ter vínculo ativo com ao menos uma empresa para que suas cargas apareçam.
- Sincronização de pendências concluída: antes de qualquer busca de cargas, o aplicativo tenta enviar as entregas que ainda guarda sem sincronizar. Se essa sincronização falhar, a busca de cargas nem chega a ser feita e a tela mostra a mensagem de ausência de cargas, mesmo que existam cargas novas disponíveis.
- Carga liberada no ponto de transbordo (modo crossdock): no modo crossdock, só entram na lista as entregas já marcadas como carregadas no ponto de transbordo.
Fluxo Operacional
- O motorista chega à tela de Seleção de Carga depois que o aplicativo já buscou as cargas (automaticamente ou por toque em “sincronizar”).
- A tela exibe a lista de cargas atribuídas a ele: fora do modo crossdock, uma carga por rótulo (ou “Sem carga”, quando a entrega não tem rótulo); no modo crossdock, um único grupo chamado “Entregas”.
- O motorista toca no grupo de carga que deseja executar.
- O aplicativo registra o início daquela carga (horário e posição do motorista no momento do toque).
- Concluído o registro com sucesso, o aplicativo abre a tela de Entregas da Carga, já com a lista de entregas daquele grupo carregada.
Interface e Comportamentos
Lista de Cargas na Tela de Seleção de Carga
A tela de Seleção de Carga lista as cargas do motorista agrupadas por rótulo, cada grupo aparecendo como um item na lista com o nome da carga centralizado. Se, depois de concluída a busca, não houver nenhuma carga para mostrar, a lista é substituída pela mensagem “Nenhum produto encontrado!”.
Carregamento e Sincronização de Cargas em Segundo Plano
Enquanto a lista de cargas ainda está sendo carregada pela primeira vez, a tela mostra um indicador de carregamento em tela cheia no lugar do conteúdo. Quando a busca de cargas é uma sincronização em segundo plano (disparada, por exemplo, a partir do menu do motorista ou de outra tela), a tela de Seleção de Carga sobrepõe o conteúdo com uma camada escurecida, um indicador de carregamento e o texto “Sincronizando…”; enquanto essa sincronização ocorre, o botão de menu no topo da tela fica indisponível.
Atualização da Lista de Cargas a partir de Outras Telas
A lista de cargas exibida é sempre atualizada quando chega um novo resultado de busca de cargas, mesmo que a tela de Seleção de Carga não esteja em primeiro plano no momento (por exemplo, quando a sincronização foi disparada a partir da tela de Cargas ou de Nova Carga). Nesses casos a atualização acontece silenciosamente: as mensagens de sucesso ou de erro da sincronização só aparecem quando a tela de Seleção de Carga está realmente em primeiro plano no momento em que o resultado chega.
Feedbacks ao Usuário
Mensagens da Tela de Seleção de Carga
| Situação | Feedback | Texto exato |
|---|---|---|
| Nenhuma carga carregada na lista | Mensagem no lugar da lista | “Nenhum produto encontrado!” |
| Carregamento de cargas em segundo plano em andamento | Camada de carregamento sobre a tela | “Sincronizando…” |
| Sincronização de cargas em segundo plano concluída com sucesso (tela em primeiro plano) | Notificação de rodapé | “Sincronizado com sucesso!” |
| Sincronização de pendências falha antes da busca, ou não há resposta disponível | Mensagem de ausência de cargas | “Não há cargas” |
| Placa do veículo não informada (ou vazia) na busca de cargas | Mensagem de erro | “Placa inválida.” |
| Preparação da carga selecionada não retorna entregas válidas | Mensagem de erro | “Nada para atualizar” |
Mensagens Variáveis da Busca de Cargas
| Situação | Feedback | Mensagem |
|---|---|---|
| Sincronização de cargas em segundo plano falha (tela em primeiro plano) | Notificação de rodapé de erro | Texto do erro retornado no momento da falha, exibido como recebido |
Regras de Negócio
Cargas em Modo Crossdock
Quando o motorista opera em modo crossdock, a busca de cargas sempre retorna um único grupo, chamado “Entregas”, contendo as entregas do motorista com status “aguardando” ou “em andamento”, já carregadas no ponto de transbordo. As entregas desse grupo são ordenadas pela sequência de entrega definida pela roteirização e, em caso de empate, pela data.
Cargas Fora do Modo Crossdock
Fora do modo crossdock, a placa do veículo é obrigatória: se não for informada, a busca é recusada.
A busca considera apenas as empresas às quais o motorista está vinculado no momento. Algumas empresas configuram quais tipos de entrega aparecem no aplicativo para o motorista; quando isso acontece, só esse tipo de entrega aparece na lista de cargas daquela empresa.
As cargas são identificadas pelo rótulo gravado em cada entrega; entregas sem rótulo são agrupadas sob o rótulo “Sem carga”, e os rótulos aparecem em ordem alfabética. Dentro de cada carga, somente entregas com status “aguardando” ou “em andamento” aparecem — entregas já concluídas ou com falha não entram —, ordenadas pela sequência de entrega definida pela roteirização e, em caso de empate, pela ordem de cadastro.
Para cada entrega, o aplicativo tenta identificar o cliente a partir do CNPJ ou, na ausência dele, do CPF informado na nota fiscal da entrega; se nenhum dos dois estiver presente na nota, ou não houver cliente cadastrado com esse documento, a entrega aparece sem os dados desse cliente. Quando o cliente é identificado, o aplicativo também mostra os horários de entrega combinados com ele, organizados por dia da semana, podendo haver mais de uma janela no mesmo dia.
Para cada entrega, o aplicativo também indica, conforme a configuração da empresa dona da entrega, quais formas de comprovação estão disponíveis: coleta de selfie, coleta de dados do recebedor, coleta de assinatura digital, coleta e validação de canhoto físico, permissão de reagendamento e de cancelamento pelo motorista, e check-in por proximidade (com o raio de distância considerado válido).
Validações para Iniciar uma Carga
No modo crossdock, iniciar a carga exige que a data/hora e a posição geográfica capturadas no momento sejam válidas; qualquer uma ausente ou inválida faz o início ser recusado, com mensagem indicando qual dado está inválido.
Fora do modo crossdock, iniciar a carga exige adicionalmente: uma empresa válida, com o motorista tendo vínculo ativo com ela; a placa do veículo; e que a carga escolhida corresponda a uma carga realmente existente para aquele motorista, veículo e empresa.
Comportamento Offline e Dados Locais
Antes de qualquer busca de cargas, o aplicativo primeiro reúne as entregas que ainda guarda sem confirmação de sincronização e tenta reenviá-las uma a uma; cada envio que não for concluído mantém a entrega pendente para nova tentativa na próxima sincronização, sem interromper o envio das demais. A busca de cargas só é realizada se essa etapa de sincronização terminar com sucesso — se falhar, a tela mostra a mensagem de ausência de cargas.
Ao abrir a carga escolhida, o aplicativo substitui os dados de entregas que estavam guardados pelos dados do grupo selecionado: as entregas do grupo anterior deixam de ficar guardadas ali, e as da carga escolhida passam a ocupar esse lugar, marcadas como ainda não sincronizadas. Essa marcação como já sincronizada só é mantida quando a troca de carga acontece por uma sincronização automática em segundo plano, não quando o motorista toca diretamente para abrir a carga.
Evidências e Documentos Gerados
Para cada entrega retornada em uma busca de cargas, o aplicativo mostra os dados da nota fiscal (DANFE) vinculada a ela. Se a nota fiscal dessa entrega não estiver disponível ou não puder ser lida corretamente, a entrega aparece na lista sem os detalhes de produtos, pagamento e destinatário, sem nenhum aviso de erro.
Quando a entrega é de um tipo específico de operação e ainda está com status “aguardando”, o sistema atualiza os dados de cliente e endereço da nota fiscal antes de exibi-la, mantendo-a alinhada ao cadastro mais recente do cliente.
Para cada entrega, o aplicativo também lista as evidências (fotos, assinatura, canhoto) já capturadas para ela, da mais recente para a mais antiga; se ainda não houver nenhuma evidência capturada, a lista aparece vazia.
Troubleshooting
A tela de Seleção de Carga não mostra nenhuma carga e exibe “Nenhum produto encontrado!”
Cenário: a busca de cargas foi concluída, mas nenhum grupo de carga veio na resposta (ou a tela ainda não recebeu nenhum resultado de busca).
Mensagem exibida: “Nenhum produto encontrado!”
O que fazer: confirmar que o motorista tem entregas “aguardando” ou “em andamento” atribuídas à placa em uso; sincronizar novamente pelo menu.
A tela de Seleção de Carga mostra “Não há cargas” ao ser aberta
Cenário: a sincronização de pendências falhou antes da busca de cargas, ou não havia resposta disponível.
Mensagem exibida: “Não há cargas”
O que fazer: verificar a conexão do dispositivo e tentar sincronizar novamente; se persistir, verificar se realmente existem cargas atribuídas ao motorista para o veículo em uso.
Busca de cargas recusada com “Placa inválida.”
Cenário: o motorista tentou buscar cargas fora do modo crossdock sem uma placa de veículo informada.
Mensagem exibida: “Placa inválida.”
O que fazer: informar a placa do veículo antes de repetir a busca.
Toque em uma carga não avança para a tela de entregas
Cenário: o motorista tocou em um grupo de carga, mas a preparação da carga não retornou entregas válidas para continuar.
Mensagem exibida: “Nada para atualizar”
O que fazer: voltar à lista de cargas, sincronizar novamente e tentar abrir a carga outra vez.
Início de carga recusado por empresa inválida, não encontrada ou sem vínculo
Cenário: o motorista tentou iniciar uma carga (fora do modo crossdock) sem uma empresa identificada, ou identificando uma empresa que não existe no cadastro, ou à qual ele não tem mais vínculo ativo.
Mensagem exibida: “Empresa inválida.” (nenhuma empresa identificada), “Empresa não encontrada.” (empresa identificada não existe) ou “Motorista não tem vínculo com empresa.” (vínculo não está mais ativo)
O que fazer: sincronizar o cadastro do motorista e confirmar com o suporte o vínculo com a empresa da carga.
Início de carga recusado com “Carga {nome} não encontrada.” ou “Carga inválida.”
Cenário: o motorista tentou iniciar uma carga (fora do modo crossdock) cuja identificação não corresponde a nenhuma carga existente para ele, aquele veículo e aquela empresa.
Mensagem exibida: “Carga {nome} não encontrada.” (ou “Carga inválida.”, quando a identificação da carga nem chega a ser enviada)
O que fazer: sincronizar a lista de cargas novamente antes de tentar iniciar; se persistir, contatar o suporte.
Início de carga recusado por data/hora inválida
Cenário: a data e hora de início capturadas automaticamente pelo aplicativo no momento do toque não puderam ser validadas.
Mensagem exibida: mensagem indicando que a data ou a hora de início da carga é inválida
O que fazer: verificar se a data e a hora do aparelho estão corretas e repetir a operação.
Início de carga recusado por posição geográfica inválida
Cenário: a posição geográfica capturada automaticamente pelo aplicativo no momento do toque não pôde ser validada.
Mensagem exibida: mensagem indicando que a posição de início da carga é inválida
O que fazer: verificar se o GPS do aparelho está ativado e com sinal, e repetir a operação.
Sessão expira durante a busca de cargas ou o início de carga
Cenário: o aplicativo identifica que a sessão do motorista expirou no meio de uma busca de cargas ou de um início de carga.
Mensagem exibida: Nenhuma imediatamente — o aplicativo tenta renovar a sessão e refazer a operação automaticamente; se a renovação falhar, é exibida a mensagem de erro correspondente e o motorista pode precisar entrar novamente no aplicativo.
O que fazer: se o erro persistir, sair e entrar novamente no aplicativo.
A carga aparece na lista, mas sem os detalhes da nota fiscal
Cenário: a nota fiscal daquela entrega não foi localizada ou não pôde ser lida.
Mensagem exibida: Nenhuma — a entrega aparece na lista normalmente, mas sem os detalhes de produtos, pagamento e destinatário.
O que fazer: repetir a sincronização mais tarde; se persistir, acionar o suporte para verificar a nota fiscal vinculada àquela entrega.
O cabeçalho da tela de Seleção de Carga aparece sem a placa e sem a data
Cenário: o motorista abre a tela de Seleção de Carga e observa que o espaço reservado para a placa do veículo e para a data no topo da tela está sempre em branco.
Mensagem exibida: Nenhuma — o cabeçalho permanece vazio, mas a lista de cargas abaixo dele é exibida e funciona normalmente.
O que fazer: nenhuma ação necessária; a informação de placa e data pode ser conferida em outras telas do aplicativo.
Casos de Uso
Caso 1 — Motorista inicia uma carga comum, fora do modo crossdock
O motorista, com a placa ABC1D23 selecionada, abre a tela de Seleção de Carga e vê duas cargas: “Rota Centro” e “Sem carga”. Ele toca em “Rota Centro”; o aplicativo registra o início dessa carga com a posição atual do motorista e navega para a tela de Entregas da Carga, já com as entregas de “Rota Centro” carregadas.
Caso 2 — Motorista em modo crossdock inicia a carga “Entregas”
O motorista está com o modo crossdock ativo. Ao abrir a tela de Seleção de Carga, vê um único grupo chamado “Entregas”, com as entregas já carregadas no ponto de transbordo. Ele toca no grupo; o aplicativo registra o início da carga (sem exigir empresa nem identificação de carga, apenas data/hora e posição válidas) e avança para a tela de Entregas da Carga.
Caso 3 — Sincronização de pendências falha antes da busca
O motorista tem entregas concluídas no dia anterior ainda não sincronizadas e está sem conexão estável. Ao abrir a tela de Seleção de Carga, o aplicativo tenta sincronizar essas pendências primeiro; a sincronização falha por falta de conexão, e a tela mostra “Não há cargas”, mesmo havendo cargas novas disponíveis. O motorista sai da área sem sinal e a lista é atualizada na próxima tentativa.
Caso 4 — Sincronização de cargas a partir do menu, com a tela de Cargas em primeiro plano
O motorista está na tela de Cargas (não na tela de Seleção de Carga) e aciona a opção de sincronizar pelo menu. A busca de cargas ocorre em segundo plano; como a tela de Seleção de Carga não está em primeiro plano, a lista interna de cargas é atualizada silenciosamente, sem nenhuma notificação visível, e passa a refletir os dados mais recentes na próxima vez que o motorista abrir a tela de Seleção de Carga.
