Registro de Evidências
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Registro de Evidências
A tela de Registro de Evidências é onde o motorista fotografa ou grava a comprovação física de uma entrega — foto do produto, do local, ou vídeo do momento da entrega.
Visão Geral
A tela de Registro de Evidências é onde o motorista fotografa ou grava a comprovação física de uma entrega — foto do produto, do local, ou vídeo do momento da entrega. Ela é aberta a partir da tela de Detalhe da Entrega, sempre associada a uma entrega específica, e mostra a grade de evidências já registradas para aquela entrega mais um botão para adicionar uma nova. Cada evidência adicionada é enviada ao servidor e passa a compor o histórico da entrega, servindo de comprovante junto com a assinatura do recebedor e o canhoto físico, quando aplicável.
Pré-requisitos
O acesso à tela de Registro de Evidências depende do botão correspondente estar habilitado na tela de Detalhe da Entrega, o que só acontece sob certas condições ligadas ao status da entrega (ver “Elegibilidade do botão de Registro de Evidências” em Regras de Negócio). Sem o botão habilitado, o motorista não consegue abrir esta tela a partir do Detalhe da Entrega.
Para o envio de uma evidência ter sucesso, a entrega precisa continuar localizável e vinculada no momento do envio — ver “Validações do envio de evidência” em Regras de Negócio para as condições e os cenários T-05 a T-08 em Troubleshooting para o que aparece quando alguma delas falha.
O envio de uma evidência com posição geográfica exige que o motorista tenha concedido permissão de localização ao aplicativo; sem ela, o aplicativo solicita a permissão no momento do envio.
Fluxo Operacional
- Na tela de Detalhe da Entrega, o motorista toca no botão de evidências, que leva à tela de Registro de Evidências daquela entrega.
- A tela mostra a data da evidência mais recente já registrada (ou a data atual, se ainda não há nenhuma) e a grade de evidências já capturadas.
- O motorista toca no quadrado de adicionar evidência e escolhe entre fotografar, gravar um vídeo pela câmera, ou selecionar um vídeo da galeria.
- Assim que a evidência é escolhida, o aplicativo salva uma cópia local no aparelho e tenta enviá-la ao servidor imediatamente.
- Com o envio concluído (com sucesso ou não), o motorista recebe uma mensagem de confirmação ou de erro e pode continuar adicionando outras evidências ou voltar para a tela de Detalhe da Entrega.
Interface e Comportamentos
Cabeçalho da Tela de Registro de Evidências
O topo da tela mostra uma data (ver “Data exibida no topo da tela” em Regras de Negócio para a condição exata), seguida do subtítulo fixo “Registre as evidências” e do cartão com os dados da entrega (número da nota fiscal ou do pedido, valor, destinatário e endereço).
Tanto o botão de voltar do topo da tela quanto o gesto de voltar do aparelho levam o motorista diretamente de volta à tela de Detalhe da Entrega, mesmo que existam outras telas empilhadas no caminho de navegação entre elas.
Grade de Evidências
As evidências já registradas para a entrega são exibidas em grade, uma ao lado da outra. Cada evidência aparece como miniatura da própria imagem, exceto quando o arquivo é um vídeo, caso em que a tela mostra um ícone de vídeo genérico no lugar da miniatura real. Um quadrado adicional com um ícone de mais (+) é sempre exibido por último, ao final da grade, para adicionar uma nova evidência.
Enquanto o envio de uma nova evidência está em andamento, toda a grade é substituída por um indicador de carregamento central.
Diálogo de Seleção de Evidência
Ao tocar no quadrado de adicionar evidência, o motorista vê um diálogo com o título “Selecione Sua Imagem” e três ícones lado a lado: câmera fotográfica, câmera de vídeo e galeria de vídeos. As opções de captura disponíveis estão descritas em “Opções de captura de evidência”, em Regras de Negócio; as características do arquivo gerado em cada opção estão em Evidências e Documentos Gerados.
Feedbacks ao Usuário
Feedbacks Gerais da Tela
| Situação | Feedback | Texto exato |
|---|---|---|
| Envio de evidência concluído com sucesso | Faixa verde na parte inferior da tela | “Evidencia enviada com Sucesso” |
| Aparelho sem conexão no momento do envio | Faixa vermelha na parte inferior da tela | “Sem conexão, evidência salva offline” |
| Envio falhou e o servidor não informou uma mensagem específica | Faixa vermelha na parte inferior da tela | “Não foi possível realizar a conexão!” |
| Envio da evidência em andamento | A grade de evidências é substituída por um indicador de carregamento | Nenhum texto — apenas o indicador visual |
| Diálogo de escolha de evidência aberto | Título do diálogo de seleção | “Selecione Sua Imagem” |
Feedbacks com Mensagem de Validação Devolvida pelo Servidor
| Situação | Feedback | Mensagem |
|---|---|---|
| Identificador da entrega não enviado | Faixa vermelha na parte inferior da tela | “Id da entrega inválido.” |
| Placa do veículo não enviada fora do modo crossdock | Faixa vermelha na parte inferior da tela | “Placa inválida.” |
| Nenhuma entrega correspondente localizada | Faixa vermelha na parte inferior da tela | “Entrega inválida.” |
| Entrega localizada está com status desvinculado | Faixa vermelha na parte inferior da tela | “Entrega desvinculada.” |
| Posição geográfica enviada em formato inválido | Faixa vermelha na parte inferior da tela | “Posição da evidência é inválida.” |
| Latitude fora do intervalo permitido | Faixa vermelha na parte inferior da tela | “Latitude da evidência é inválida.” |
| Longitude fora do intervalo permitido | Faixa vermelha na parte inferior da tela | “Longitude da evidência é inválida.” |
| Falha no recebimento ou na gravação do arquivo enviado | Faixa vermelha na parte inferior da tela | mensagem de falha de upload informada pelo servidor, identificando a etapa em que o envio do arquivo falhou |
| Evidência não pôde ser gravada no servidor | Faixa vermelha na parte inferior da tela | “Não foi possível salvar a evidência.” |
Regras de Negócio
Elegibilidade do botão de Registro de Evidências. Na tela de Detalhe da Entrega, o botão de evidências fica sempre habilitado quando a entrega não está mais com status “aguardando”. Enquanto a entrega está “aguardando”, ele só é habilitado depois que o motorista inicia a entrega na mesma sessão da tela de Detalhe da Entrega — reabrir a tela sem repetir essa ação mantém o botão desabilitado.
Data exibida no topo da tela. Se já existir ao menos uma evidência registrada para a entrega, a tela mostra a data da evidência mais recente (a última da lista). Se não houver nenhuma evidência registrada, mostra a data atual do aparelho. Existe um terceiro cenário sem tratamento definido: se já existir ao menos uma evidência registrada, mas a evidência mais recente não tiver uma data preenchida, a tela não calcula nenhuma data e o topo fica sem nenhuma data visível — ver T-14 em Troubleshooting.
Opções de captura de evidência. O motorista pode fotografar com a câmera, gravar um vídeo com a câmera, ou selecionar um vídeo já existente na galeria — não há opção de selecionar uma foto já existente na galeria, apenas fotos tiradas na hora. As características do arquivo gerado em cada opção estão descritas em Evidências e Documentos Gerados.
Validações do envio de evidência. O servidor recusa o envio com “Id da entrega inválido.” se o identificador não for enviado; com “Placa inválida.” se a placa não for enviada fora do modo crossdock; com “Entrega inválida.” se nenhuma entrega correspondente for localizada; com “Entrega desvinculada.” se a entrega localizada estiver com esse status. Quando uma posição é enviada, precisa vir no formato “latitude,longitude”: o servidor recusa com “Posição da evidência é inválida.” se não houver vírgula separando os dois valores, com “Latitude da evidência é inválida.” se o primeiro valor estiver fora do intervalo -90 a 90, e com “Longitude da evidência é inválida.” se o segundo estiver fora do intervalo -180 a 180. O envio da posição não é obrigatório.
Validações do arquivo enviado. Se o arquivo da evidência não chegar ao servidor, se o envio falhar durante a transferência, ou se o servidor não conseguir gravá-lo, o registro é recusado com uma mensagem de falha de upload — o texto exato varia conforme a etapa em que a falha ocorreu, mas sempre identifica que o problema foi no recebimento do arquivo, não nos dados da entrega.
Confirmação e falha ao salvar a evidência. Depois que o arquivo é recebido com sucesso, o servidor confirma o envio com a mensagem “Evidência salva.” Se o registro da evidência não puder ser salvo por qualquer motivo, o servidor recusa com “Não foi possível salvar a evidência.”
Modo de operação (crossdock). Ao enviar uma evidência informando se está operando em modo crossdock, esse também passa a ser o modo de operação usado pelas demais telas do aplicativo, até a próxima vez que essa informação for enviada por qualquer outra ação do motorista.
Comportamento Offline e Dados Locais
Assim que uma evidência é escolhida, o aplicativo já copia o arquivo para a pasta de documentos do próprio aparelho, adiciona a evidência à lista local de evidências da entrega e marca a carga como não integrada (pendente de sincronização) — isso acontece antes mesmo de tentar o envio ao servidor, e independentemente do resultado desse envio.
Se o aparelho está sem conexão no momento do envio, a evidência não é enviada ao servidor: ela fica guardada numa fila local de evidências pendentes, e o aplicativo informa “Sem conexão, evidência salva offline”. Se o envio for tentado com conexão mas falhar (erro de rede ou recusa do servidor), a evidência já copiada no aparelho também é adicionada a essa mesma fila local, para ser reenviada automaticamente mais tarde.
Evidências e Documentos Gerados
Evidência Fotográfica ou em Vídeo
Cada evidência registrada nesta tela é uma foto ou um vídeo do momento ou do resultado da entrega. Uma foto é sempre gerada na hora pela câmera do aparelho — nunca reaproveitada da galeria —, redimensionada para no máximo 1920 por 1080 pixels e comprimida para 25% da qualidade original antes do envio. Um vídeo pode ser gravado na hora pela câmera ou escolhido de uma gravação já existente na galeria do aparelho. Em qualquer um dos dois casos, o arquivo é enviado ao servidor, que o salva no diretório da entrega correspondente. Toda evidência enviada por esta tela é classificada com o tipo padrão (Evidência) — esta tela nunca envia o tipo Canhoto, usado apenas pela captura de canhoto físico em outra funcionalidade do aplicativo.
Miniatura da Evidência
Para cada evidência gravada com sucesso no servidor, uma miniatura de 200 por 200 pixels é gerada automaticamente a partir da imagem, no mesmo diretório da entrega. A miniatura é sempre gerada de novo a partir do arquivo enviado — o servidor não reaproveita uma miniatura de um envio anterior. A geração da miniatura não é condição para o sucesso do envio da evidência.
Troubleshooting
Evidência enviada com sucesso, mas não aparece na grade da tela
Cenário: o motorista envia uma nova evidência, recebe a confirmação de sucesso, mas a evidência recém-enviada não aparece na grade de evidências da tela.
Mensagem exibida: “Evidencia enviada com Sucesso” (a confirmação aparece normalmente; o problema é a grade não atualizar).
O que fazer: sair da tela de Registro de Evidências e abri-la novamente a partir da tela de Detalhe da Entrega — o envio já foi concluído com sucesso e a evidência aparecerá na grade atualizada.
Envio de evidência trava no indicador de carregamento, sem nenhuma mensagem
Cenário: o motorista escolhe uma evidência para enviar e a tela fica indefinidamente com o indicador de carregamento no lugar da grade, sem confirmação nem erro — normalmente associado a falha na obtenção da posição geográfica do motorista (permissão de localização negada ou localização desligada no aparelho).
Mensagem exibida: Nenhuma — a tela permanece com o indicador de carregamento, sem confirmação nem erro.
O que fazer: verificar se a permissão de localização e o serviço de localização do aparelho estão ativados para o aplicativo; sair da tela e tentar novamente. A evidência já fica salva localmente no aparelho mesmo quando isso acontece.
Evidência salva offline por falta de conexão
Cenário: o motorista envia uma evidência sem conexão de internet disponível no aparelho.
Mensagem exibida: “Sem conexão, evidência salva offline”
O que fazer: nenhuma ação necessária — a evidência foi salva no aparelho e será enviada automaticamente assim que a conexão for restabelecida e uma sincronização acontecer.
Falha no envio sem mensagem específica do servidor
Cenário: o envio da evidência falha (erro de rede ou recusa do servidor) e o servidor não informou um texto de erro específico.
Mensagem exibida: “Não foi possível realizar a conexão!”
O que fazer: verificar a conexão do aparelho e tentar novamente; a evidência permanece guardada no aparelho para nova tentativa.
Envio recusado por identificador de entrega inválido
Cenário: o envio da evidência chega ao servidor sem o identificador da entrega.
Mensagem exibida: “Id da entrega inválido.”
O que fazer: sair da tela e reabrir o Registro de Evidências a partir do Detalhe da Entrega, para garantir que a entrega correta está associada ao envio.
Envio recusado por placa do veículo inválida
Cenário: fora do modo crossdock, o envio da evidência chega ao servidor sem a placa do veículo.
Mensagem exibida: “Placa inválida.”
O que fazer: confirmar que o veículo está corretamente selecionado no aplicativo e tentar novamente.
Envio recusado por entrega não localizada
Cenário: o servidor não encontra nenhuma entrega correspondente ao identificador, à placa (ou ao modo crossdock) e às empresas ativas do motorista.
Mensagem exibida: “Entrega inválida.”
O que fazer: confirmar que a entrega pertence à placa (ou ao lote crossdock) atualmente selecionada e que está vinculada a uma das empresas ativas do motorista.
Envio recusado por entrega desvinculada
Cenário: a entrega localizada pelo servidor está com status desvinculado.
Mensagem exibida: “Entrega desvinculada.”
O que fazer: contatar o suporte para verificar a situação da entrega antes de tentar registrar novas evidências para ela.
Envio recusado por posição geográfica em formato inválido
Cenário: a posição geográfica enviada junto com a evidência não está no formato esperado (latitude e longitude separadas por vírgula).
Mensagem exibida: “Posição da evidência é inválida.”
O que fazer: tentar o envio novamente; se o problema persistir, reportar ao suporte técnico.
Envio recusado por latitude fora do intervalo permitido
Cenário: o valor de latitude obtido pelo aplicativo está fora do intervalo -90 a 90.
Mensagem exibida: “Latitude da evidência é inválida.”
O que fazer: verificar o funcionamento do GPS do aparelho e tentar novamente.
Envio recusado por longitude fora do intervalo permitido
Cenário: o valor de longitude obtido pelo aplicativo está fora do intervalo -180 a 180.
Mensagem exibida: “Longitude da evidência é inválida.”
O que fazer: verificar o funcionamento do GPS do aparelho e tentar novamente.
Falha no recebimento do arquivo pelo servidor
Cenário: o arquivo da evidência não chega ao servidor, falha durante a transferência, ou não pode ser gravado no diretório da entrega.
Mensagem exibida: mensagem de falha de upload informada pelo servidor.
O que fazer: verificar a conexão do aparelho e tentar reenviar a evidência; a evidência permanece guardada no aparelho para nova tentativa.
Evidência não pôde ser gravada no servidor
Cenário: o arquivo chega e é salvo no servidor, mas o registro da evidência não pode ser gravado.
Mensagem exibida: “Não foi possível salvar a evidência.”
O que fazer: tentar reenviar a evidência; se o problema persistir, reportar ao suporte técnico com o identificador da entrega.
Topo da tela exibido sem nenhuma data visível
Cenário: a entrega já tem evidência registrada, mas a evidência mais recente não tem uma data preenchida.
Mensagem exibida: Nenhuma — o topo da tela aparece sem nenhuma data, sem indicação de erro.
O que fazer: nenhuma ação necessária para continuar registrando evidências — a ausência de data no topo não impede o registro de novas evidências nem afeta o envio ao servidor.
Casos de Uso
Caso 1 — Registro de foto de evidência com sucesso, com conexão ativa
O motorista conclui a entrega, abre o Registro de Evidências a partir do Detalhe da Entrega, toca em adicionar evidência e fotografa o produto entregue. Com conexão disponível, o aplicativo obtém a posição atual, envia a foto ao servidor e recebe a confirmação “Evidencia enviada com Sucesso”. A evidência passa a constar na grade da tela (após reabri-la, conforme T-01) e no histórico da entrega.
Caso 2 — Registro de evidência em modo crossdock, sem placa exigida
Um motorista operando em modo crossdock registra uma evidência para uma carga já liberada no ponto de transbordo. Como o envio informa que o motorista está em modo crossdock, o servidor localiza a entrega apenas pelo identificador da carga e pelo indicador de carga liberada, sem exigir a placa do veículo, e grava a evidência normalmente.
Caso 3 — Captura de evidência sem conexão, sincronizada depois
Em uma área sem sinal, o motorista fotografa a evidência de uma entrega. O aplicativo salva a foto localmente e, ao tentar o envio, identifica a falta de conexão, devolvendo “Sem conexão, evidência salva offline”. A evidência permanece na fila local até uma sincronização automática posterior enviá-la ao servidor.
Caso 4 — Vídeo de evidência selecionado da galeria
Ao registrar a evidência de uma entrega com item avariado, o motorista escolhe gravar um vídeo mostrando a avaria, mas prefere usar uma gravação já feita anteriormente. No diálogo de seleção, escolhe a opção de vídeo da galeria em vez da câmera; o aplicativo aceita o vídeo já existente da mesma forma que aceitaria um recém-gravado, e a tela exibe um ícone de vídeo no lugar da miniatura, já que arquivos de vídeo não têm uma imagem estática para mostrar.
