Coletas Enviadas
Criado por Igor Ribeiro em 09 de outubro de 2026
Atualizado por Igor Ribeiro em 09 de outubro de 2026
Coletas Enviadas
A tela de Coletas Enviadas mostra, agrupadas por carga, as coletas que o motorista já enviou ao servidor.
Visão Geral
A tela de Coletas Enviadas mostra, agrupadas por carga, as coletas que o motorista já enviou ao servidor. Ela vem depois, no fluxo do dia a dia, do envio da carga (tela de Enviar Coleta) — é a forma de consultar o que já foi entregue, sem poder mais editar nada ali. A partir dela, o motorista também pode emitir um comprovante impresso em impressora bluetooth portátil, com o resumo de uma carga ou de várias.
Pré-requisitos
Para usar a tela de Coletas Enviadas, o motorista precisa atender a estas condições:
- Estar autenticado no aplicativo; sem isso, a tela não consegue atualizar a lista com o servidor e mostra apenas o que já estava salvo no aparelho (ver “Comportamento Offline e Dados Locais”).
- Ter pelo menos uma coleta já enviada para o seletor de carga aparecer; sem nenhuma coleta enviada, a tela mostra diretamente o aviso de lista vazia.
- Para emitir o comprovante impresso, o aparelho precisa ter bluetooth ativado e estar pareado com uma impressora térmica compatível; sem isso, a impressão fica bloqueada nas etapas de conexão (ver “Troubleshooting”).
Fluxo Operacional
- O motorista abre a tela de Coletas Enviadas a partir do menu do aplicativo.
- O aplicativo carrega automaticamente a lista de cargas já enviadas e pré-seleciona, no seletor no topo da tela, a carga mais antiga entre as enviadas.
- O motorista confere a lista de coletas daquela carga: propriedade, percurso, data, tanque e litros de cada uma.
- Se quiser consultar outra carga, o motorista escolhe outra opção no seletor; a lista é recarregada para a carga escolhida.
- Se quiser um comprovante impresso, o motorista toca no ícone de impressão (disponível apenas quando há coletas carregadas), escolhe o conteúdo e a ordenação desejados, conecta a impressora bluetooth e imprime.
- O motorista volta para a tela anterior a qualquer momento, pelo botão de voltar do cabeçalho ou pelo botão/gesto físico do aparelho — a volta é sempre imediata, sem confirmação.
Interface e Comportamentos
Tela de Coletas Enviadas
A tela tem um seletor de carga no topo e, abaixo, a lista de coletas da carga escolhida. O seletor só aparece quando existe pelo menos uma carga enviada carregada; cada opção do seletor é rotulada como “Número da carga: {número}”, sem repetir o mesmo número mais de uma vez mesmo que a carga tenha várias coletas enviadas. Enquanto a lista de uma carga está sendo carregada, a tela mostra um indicador de carregamento centralizado. Quando não há nenhuma coleta a exibir — nem carga nenhuma enviada, nem coleta na carga escolhida — a tela mostra um aviso no lugar da lista, com um ícone de alerta.
Item da Lista de Coletas Enviadas
Cada linha da lista mostra o nome da propriedade e do percurso, e a data da coleta no padrão brasileiro. Do lado direito: se a coleta tiver tanque e litros diferentes de zero, mostra o número do tanque e a quantidade coletada; se qualquer um dos dois for zero (coleta registrada como não-coleta, tipicamente), mostra apenas um ícone de alerta no lugar, sem nenhum valor numérico.
Tela de Impressão de Comprovante
A tela de impressão de comprovante é aberta a partir do ícone de impressão da tela de Coletas Enviadas, sempre no modo “resumo de carga”. O motorista escolhe:
- O que imprimir: “Carga Selecionada” (pré-marcada por padrão — resumo só da carga que estava sendo visualizada), “Todas as cargas” (resumo de várias cargas de uma vez) ou “Página de teste” (conteúdo fixo, sem dado de coleta, para testar a impressora).
- Como ordenar o resumo: “Tanque” (pré-marcado por padrão — agrupa as propriedades dentro de cada número de tanque) ou “Propriedade” (agrupa por percurso, com o tanque ao lado de cada propriedade).
A tela também mostra um seletor dos dispositivos bluetooth pareados no aparelho e os botões de conectar/desconectar. O botão de imprimir só fica habilitado depois de uma conexão bluetooth bem-sucedida.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Nenhuma coleta a exibir na lista (carga sem coleta, ou nenhuma carga enviada) | Aviso no corpo da tela, com ícone de alerta | “Não há coletas para a carga informada” |
| Bluetooth do aparelho desativado ao tentar conectar a impressora | Notificação temporária | “Bluetooth desativado” |
| Falha ao conectar ou dispositivo desconectado durante a tentativa | Notificação temporária | “Não foi possível conectar com o dispositivo, certifique-se que está ativo” |
| Conexão com a impressora bluetooth bem-sucedida | Notificação temporária | “Bluetooth conectado com sucesso” |
| Impressão do resumo por Tanque bloqueada por não haver coleta válida entre as cargas consideradas | Notificação temporária | “Não é possível imprimir o resumo da carga com tanque vazio” |
Regras de Negócio
Coletas enviadas mostradas: janela de 7 dias e apenas do motorista logado
O aplicativo só mostra coletas enviadas dentro dos últimos 7 dias corridos, e apenas as enviadas pelo próprio motorista logado; coletas mais antigas ou de outro motorista não aparecem nesta lista, mesmo continuando a existir no sistema.
Carga pré-selecionada é a mais antiga entre as enviadas
Ao abrir a tela, a carga mostrada por padrão no seletor é a mais antiga entre as enviadas, não a mais recente.
Resolução do nome de propriedade e percurso
O nome da propriedade e do percurso de cada coleta é resolvido a partir dos dados já salvos no aplicativo; se a propriedade não for encontrada, a coleta continua na lista, só que sem nome de propriedade nem de percurso preenchidos.
Atualização com o servidor é silenciosa
O aplicativo só tenta buscar coletas novas do servidor se houver alguma conexão de rede no aparelho. Se essa tentativa falhar — por qualquer motivo — a tela segue mostrando apenas o que já estava salvo, sem nenhum aviso ao motorista.
Validação do resumo impresso por Tanque
A impressão com ordenação “Tanque” só é permitida se existir, entre as cargas consideradas, pelo menos uma coleta que não seja um registro de não-coleta; a ordenação “Propriedade” não tem essa validação — imprime mesmo sem nenhuma coleta válida, produzindo um comprovante só com cabeçalho e rodapé.
Cálculo dos totais do comprovante
Cada grupo (percurso ou tanque) soma a quantidade coletada das linhas que o compõem; ao final de cada carga, soma-se o total de todos os tanques dela, no formato “TOTAL {valor}L”.
“Todas as Cargas” imprime cargas pendentes, não as já enviadas
A opção de imprimir o resumo de “Todas as cargas” busca as cargas ainda NÃO enviadas ao servidor — não as cargas já enviadas que esta própria tela exibe.
“Carga Selecionada” busca coletas pendentes dentro da carga
Ao imprimir o resumo da carga que estava sendo visualizada, o aplicativo busca as coletas daquela carga apenas entre as AINDA NÃO enviadas — como, nesta tela, a carga em questão já foi enviada por inteiro, essa busca não encontra nenhuma coleta.
Reconexão automática da impressora bluetooth
O aplicativo guarda o endereço do último dispositivo bluetooth usado e reconecta a ele automaticamente da próxima vez que a tela de impressão for aberta — exceto na primeira vez, quando ainda não há nenhum endereço salvo. Se o dispositivo salvo não estiver mais pareado, o aplicativo seleciona o primeiro disponível no lugar dele, sem reconectar sozinho.
Comportamento Offline e Dados Locais
A lista exibida na tela de Coletas Enviadas vem sempre do que já está salvo no aplicativo — com ou sem conexão, a tela sempre consegue mostrar os dados existentes. Com conexão disponível, o aplicativo tenta, em segundo plano, atualizar a lista com as coletas enviadas mais recentes; sem conexão, essa tentativa é pulada e a tela mostra diretamente os dados que já existiam. Em qualquer caso de falha nessa atualização, o motorista não recebe nenhum aviso distinguindo “sem coletas novas” de “falha ao atualizar”: a tela se comporta da mesma forma nos dois casos.
Evidências e Documentos Gerados
A tela de Coletas Enviadas gera um documento próprio: o comprovante impresso do resumo de carga.
Comprovante impresso do resumo de carga
- Tipo: comprovante de resumo de carga, impresso pelo aplicativo numa impressora térmica bluetooth portátil.
- Direção: gerado pelo aplicativo — não é enviado nem registrado no servidor, existe só como papel impresso.
- Condição de criação: sempre sob demanda, a cada toque no botão de imprimir; nunca é gerado automaticamente nem reaproveitado de uma impressão anterior.
- Conteúdo: cabeçalho com a placa do veículo e o nome do motorista logado; corpo com as propriedades/tanques e litros coletados, agrupados conforme a ordenação escolhida (ver “Regras de Negócio”); rodapé com a data/hora em que o comprovante foi gerado. O texto impresso sai sem acentuação e em letras maiúsculas, alinhado em colunas.
- Observação: quando aberto a partir desta tela, o comprovante normalmente sai sem nenhum dado de coleta (só cabeçalho e rodapé) — o processo de impressão foi pensado para cargas ainda não enviadas, não para cargas já enviadas como as que aparecem aqui (ver “Troubleshooting”).
Troubleshooting
A tela de Coletas Enviadas abre sem nenhuma carga no seletor
Cenário: o motorista abre a tela e nenhuma carga aparece para escolher; o corpo mostra o aviso de lista vazia.
Mensagem exibida: “Não há coletas para a carga informada”
O que fazer: confirmar que o motorista realmente já enviou alguma coleta nos últimos 7 dias; se sim e a mensagem persistir mesmo com conexão de internet confirmada no aparelho, pode ser uma falha silenciosa na atualização com o servidor — acionar o suporte para verificar diretamente no sistema se as coletas enviadas estão registradas para este motorista.
Uma coleta aparece na lista sem o nome da propriedade ou do percurso
Cenário: a coleta aparece normalmente na lista, mas os campos de propriedade e percurso ficam em branco.
Mensagem exibida: Nenhuma — os campos de texto simplesmente ficam vazios, sem nenhum aviso.
O que fazer: orientar o motorista a sincronizar os dados na tela de Sincronizar Dados; o cadastro daquela propriedade pode não estar mais salvo no aparelho.
O ícone de impressão aparece desabilitado
Cenário: o motorista toca no ícone de impressão no topo da tela e nada acontece.
Mensagem exibida: Nenhuma — o ícone simplesmente não responde ao toque.
O que fazer: aguardar o carregamento da lista terminar; se o ícone continuar desabilitado, confirmar que a carga selecionada no seletor realmente tem coletas associadas.
Falha ao conectar a impressora bluetooth: bluetooth desativado
Cenário: o motorista tenta conectar a impressora com o bluetooth do aparelho desligado.
Mensagem exibida: “Bluetooth desativado”
O que fazer: orientar o motorista a ativar o bluetooth do aparelho e tentar conectar novamente.
Falha ao conectar a uma impressora bluetooth específica
Cenário: o bluetooth do aparelho está ativo, mas a conexão com o dispositivo selecionado não se completa.
Mensagem exibida: “Não foi possível conectar com o dispositivo, certifique-se que está ativo”
O que fazer: orientar o motorista a confirmar que a impressora está ligada e dentro do alcance, e tentar conectar novamente; se persistir, selecionar outro dispositivo pareado, se houver.
Mensagem de “tanque vazio” ao tentar imprimir mesmo com a carga cheia
Cenário: o motorista tenta imprimir o resumo (ordenação “Tanque”) da carga que está consultando nesta tela — uma carga que já foi integralmente coletada e enviada — e recebe a mensagem de tanque vazio.
Mensagem exibida: “Não é possível imprimir o resumo da carga com tanque vazio”
O que fazer: isso acontece porque, ao abrir a impressão a partir desta tela, o aplicativo busca os dados da carga pensando em uma carga ainda não enviada — e a desta tela já foi. Não há como contornar isso pelo aplicativo no momento; avisar o suporte técnico.
Resumo impresso de uma carga desta tela sai sem nenhuma propriedade ou tanque
Cenário: com a ordenação “Propriedade” (que não tem a validação de tanque vazio), o motorista consegue concluir a impressão, mas o papel sai só com cabeçalho (veículo, motorista) e rodapé, sem nenhuma linha de propriedade ou tanque.
Mensagem exibida: Nenhuma — a impressão é concluída normalmente, só que sem conteúdo de coleta.
O que fazer: mesma causa de T-06. Orientar o motorista a não usar a impressão desta tela para conferência de conteúdo; avisar o suporte técnico.
Resumo de “Todas as cargas” não corresponde ao que o motorista está consultando
Cenário: o motorista está em Coletas Enviadas, escolhe imprimir “Todas as cargas” e o resultado não bate com as cargas enviadas que a tela mostra (vem vazio, ou traz uma carga diferente).
Mensagem exibida: “Não é possível imprimir o resumo da carga com tanque vazio” (quando não há nenhuma carga pendente) — ou nenhuma mensagem, se houver alguma carga pendente de envio, caso em que o comprovante impresso é dela, não da enviada.
O que fazer: explicar ao motorista que, nesta tela, a opção “Todas as cargas” imprime cargas AINDA NÃO enviadas, não as já enviadas que ele está consultando; para o resumo da carga enviada, a opção é “Carga Selecionada” (sujeita ao comportamento de T-06/T-07). Avisar o suporte técnico.
Casos de Uso
Caso 1 — Motorista confere o histórico de uma carga enviada na véspera
O motorista abre Coletas Enviadas, o aplicativo seleciona automaticamente a carga mais antiga entre as enviadas nos últimos 7 dias e lista as propriedades coletadas nela, com tanque e litros de cada uma. O motorista troca, no seletor, para a carga mais recente e confere os mesmos dados.
Caso 2 — Motorista encontra uma coleta sem nome de propriedade na lista
Ao consultar uma carga mais antiga, uma das coletas aparece na lista com os campos de propriedade e percurso em branco, porque o cadastro daquela propriedade não está mais salvo no aparelho. O motorista reconhece a coleta pela data e pelo tanque/litros exibidos.
Caso 3 — Motorista tenta emitir o comprovante de uma carga já enviada
O motorista toca no ícone de impressão, mantém “Carga Selecionada” e “Tanque” (opções padrão) e tenta imprimir: recebe a mensagem de tanque vazio, mesmo a carga tendo sido totalmente coletada. Muda a ordenação para “Propriedade” e consegue concluir a impressão, mas o papel sai sem nenhuma linha de coleta — só cabeçalho e rodapé.
Caso 4 — Motorista testa a impressora antes de iniciar o trabalho
Antes de sair para a rota, o motorista abre a impressão a partir de uma carga qualquer em Coletas Enviadas, conecta a impressora bluetooth pareada (reconectada automaticamente, por já ter sido usada antes) e escolhe “Página de teste” para confirmar que a impressora está funcionando, sem se preocupar com nenhum dado de coleta.
