Sincronizar Dados
Criado por Igor Ribeiro em 06 de outubro de 2026
Atualizado por Igor Ribeiro em 06 de outubro de 2026
Sincronizar Dados
A tela de Sincronizar Dados baixa do servidor tudo que o coletor precisa para operar o dia: propriedades, motivos de ocorrência, dados do veículo, coletas já enviadas e o percurso do dia.
Visão Geral
A tela de Sincronizar Dados baixa do servidor tudo que o coletor precisa para operar o dia: propriedades, motivos de ocorrência, dados do veículo, coletas já enviadas e o percurso do dia. É acionada automaticamente pelo login (quando o coletor ainda não tem uma base completa salva no aparelho, ou quando a atualização do percurso falha) e também pode ser alcançada de outros pontos do aplicativo quando os dados salvos precisam ser refeitos do zero.
Pré-requisitos
- O aparelho precisa ter uma conexão de rede ativa (wi-fi, dados móveis ou ethernet) no momento da sincronização — sem isso, o processo é interrompido antes de qualquer contato com o servidor.
- O coletor precisa estar autenticado (a sincronização usa a sessão aberta no login).
Fluxo Operacional
- Ao abrir esta tela, o aplicativo inicia a sincronização automaticamente, sem exigir toque do coletor.
- Primeiro, o aplicativo confirma que o aparelho tem uma conexão de rede ativa.
- Em seguida, baixa do servidor os dados do coletor: propriedades da rota, motivos de ocorrência, coletas já enviadas e dados do veículo vinculado.
- Por último, atualiza o percurso do dia.
- Se tudo for concluído com sucesso, o aplicativo decide a tela seguinte pela origem de onde o coletor chegou: vindo do login, segue para Atualizar Rota e Placa; vindo de qualquer outro ponto do aplicativo, segue para a tela de Propriedades.
- Se qualquer etapa falhar, a tela exibe uma mensagem de erro e um botão para tentar novamente, permanecendo na mesma tela.
Interface e Comportamentos
Tela de Progresso da Sincronização
Enquanto a sincronização roda, a tela mostra um indicador de progresso e um texto de status, que muda conforme a etapa (verificando conexão, sincronizando dados). Se a sincronização falhar, aparece um botão “Tentar novamente” com um ícone de alerta, que reinicia o processo do zero ao ser tocado.
Botão de Fechar e Botão Voltar Bloqueados
O botão de fechar (X) no topo da tela e o botão/gesto de voltar do aparelho ficam desabilitados por padrão nesta tela: tocar ou acionar voltar não faz nada enquanto a sincronização não for concluída com sucesso. Na prática, não há como sair manualmente desta tela antes que a sincronização termine — com sucesso (o aplicativo navega automaticamente adiante) ou com falha (fica a opção de tentar novamente, sem conseguir voltar).
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Verificando a conexão do aparelho | Texto de status na tela | “Aguarde, estamos verificando o seu status de conexão” |
| Sem wi-fi nem dados móveis ativos | Texto de status + botão de tentar novamente | “Ative a conexão Wi-Fi ou Dados móveis do dispositivo” |
| Baixando os dados | Texto de status na tela | “Sincronizando dados, aguarde” |
| Falha ao sincronizar (erro genérico) | Texto de status + botão de tentar novamente | “Não foi possível sincronizar os dados. Verifique sua conexão de rede e tente novamente” |
| Botão de tentar novamente | Rótulo do botão | “Tentar novamente” |
| Nome ou código de cadastro do coletor ausente | Texto de status + botão de tentar novamente | “As informações do motorista estão incompletas, contate os administradores do sistema” |
| Lista de propriedades vazia | Texto de status + botão de tentar novamente | “A lista de propriedades esta vazia, o sistema precisa de propriedades válidas. Contate os administradores do sistema” |
| Lista de motivos de ocorrência vazia | Texto de status + botão de tentar novamente | “A lista de motivos da coleta esta vazia, o sistema precisa de motivos válidos. Contate os administradores do sistema” |
| Veículo não encontrado ou sem capacidade cadastrada | Texto de status + botão de tentar novamente | “Veículo não encontrado ou sem capacidade. \nContate os administradores do sistema” |
| Veículo sem nenhum tanque com capacidade em litros | Texto de status + botão de tentar novamente | “Veículo não possui tanque com capacidade em litros. Contate os administradores do sistema” |
| Falha ao atualizar o percurso do dia | Texto de status + botão de tentar novamente | “Erro ao tentar sincronizar os percursos. Contate os administradores do sistema.” |
Regras de Negócio
Dados obrigatórios do coletor
O servidor precisa devolver nome e código de cadastro válidos para o coletor; faltando qualquer um dos dois, a sincronização é recusada.
Listas obrigatórias
As listas de propriedades e de motivos de ocorrência recebidas precisam ter ao menos um item cada; lista ausente, vazia ou em formato inesperado interrompe a sincronização.
Atualização dos dados salvos
Sincronizar dados substitui, pelos valores recebidos do servidor, as propriedades, os motivos de ocorrência e o histórico de coletas já enviadas que estavam salvos no aparelho. Coletas que o coletor já registrou e ainda não enviou não são apagadas por esse processo.
Raio de localização para bloqueio de coleta
Se o servidor enviar um raio de localização maior que zero, o aplicativo passa a bloquear o registro de coleta por localização, usando esse raio como limite. Se o servidor não enviar nenhum raio ou enviar zero, esse bloqueio por localização fica desativado.
Casas decimais
O número de casas decimais para valor e para quantidade, recebido do servidor, só é aceito se estiver entre 0 e 4; fora dessa faixa, o aplicativo usa 2 casas decimais como padrão.
Validação do veículo
A confirmação do veículo do coletor só é feita quando ele já tem uma placa associada ao seu cadastro; sem placa associada, essa etapa é pulada sem bloquear a sincronização. Quando há placa associada, o veículo só é aceito se tiver capacidade maior que zero somada entre todos os seus tanques; sem nenhuma capacidade configurada, a sincronização é recusada.
Sincronização parcial ao falhar na validação do veículo
Se a confirmação do veículo falhar depois que propriedades e motivos já foram salvos, a sincronização inteira ainda é mostrada como falha, mesmo com propriedades e motivos já atualizados naquela tentativa. Tentar novamente refaz o download inteiro sem prejuízo.
Comportamento Offline e Dados Locais
A verificação de conexão feita antes de iniciar a sincronização confirma apenas que o aparelho tem uma interface de rede ativa (wi-fi, dados móveis ou ethernet) — não confirma que essa rede realmente alcança a internet. Uma rede sem acesso real à internet passa nessa verificação inicial e só falha depois, ao tentar efetivamente baixar os dados.
Geolocalização e Rastreamento
Esta tela não rastreia localização diretamente, mas configura o raio de localização usado por outras telas para bloquear o registro de coleta fora da área esperada — ver “Raio de localização para bloqueio de coleta” em “Regras de Negócio”.
Troubleshooting
Sincronização falha com aviso para ativar a conexão
Mensagem exibida: “Ative a conexão Wi-Fi ou Dados móveis do dispositivo”
O que fazer: ativar wi-fi ou dados móveis no aparelho e tocar em “Tentar novamente”.
Sincronização falha com aviso genérico de conexão
Mensagem exibida: “Não foi possível sincronizar os dados. Verifique sua conexão de rede e tente novamente”
Cenário: o aparelho tem uma interface de rede ativa, mas a comunicação com o servidor não teve sucesso (sem internet de fato, servidor fora do ar, ou qualquer outra falha não coberta por um aviso mais específico).
O que fazer: confirmar se o aparelho realmente tem acesso à internet (não só uma rede conectada); tentar novamente; se persistir, avisar o suporte.
Sincronização recusada com aviso sobre dados do motorista incompletos
Mensagem exibida: “As informações do motorista estão incompletas, contate os administradores do sistema”
O que fazer: confirmar com o suporte se o cadastro deste coletor tem nome e código de cadastro preenchidos.
Sincronização recusada com aviso de lista de propriedades vazia
Mensagem exibida: “A lista de propriedades esta vazia, o sistema precisa de propriedades válidas. Contate os administradores do sistema”
O que fazer: confirmar com o suporte se há propriedades atribuídas a este coletor.
Sincronização recusada com aviso de lista de motivos vazia
Mensagem exibida: “A lista de motivos da coleta esta vazia, o sistema precisa de motivos válidos. Contate os administradores do sistema”
O que fazer: confirmar com o suporte se há motivos de ocorrência cadastrados para coletas.
Sincronização recusada com aviso de veículo não encontrado
Mensagem exibida: “Veículo não encontrado ou sem capacidade. \nContate os administradores do sistema”
Cenário: o coletor tem uma placa associada ao cadastro, mas o servidor não encontrou o veículo correspondente.
O que fazer: confirmar com o suporte se a placa cadastrada para este coletor existe e está correta.
Sincronização recusada com aviso de veículo sem tanque
Mensagem exibida: “Veículo não possui tanque com capacidade em litros. Contate os administradores do sistema”
O que fazer: confirmar com o suporte se o veículo tem capacidade de tanque configurada.
Sincronização recusada com aviso sobre o percurso
Mensagem exibida: “Erro ao tentar sincronizar os percursos. Contate os administradores do sistema.”
O que fazer: confirmar com o suporte se há percurso atribuído a este coletor para o dia.
Sincronização parece concluída, mas a tela avança mesmo com erro de percurso
Mensagem exibida: “Nenhuma — a tela chega a mostrar brevemente um aviso de erro, mas o aplicativo avança para a tela seguinte mesmo assim”
Cenário: o download de propriedades, motivos, veículo e coletas enviadas funcionou, mas a atualização do percurso do dia falhou.
O que fazer: se a tela seguinte não mostrar o percurso esperado, avisar o suporte e tentar sincronizar novamente por outro ponto do aplicativo, se disponível.
Não consigo sair da tela de Sincronizar Dados
Mensagem exibida: “Nenhuma — o botão de fechar e o botão voltar simplesmente não respondem”
Cenário: tentar fechar ou voltar enquanto a sincronização está em andamento ou travada em erro.
O que fazer: tocar em “Tentar novamente” (se visível) até concluir, ou fechar o aplicativo e reabri-lo caso a tentativa continue falhando; não há atalho para sair desta tela sem concluir a sincronização.
Casos de Uso
Caso 1 — Primeiro acesso, sincronização completa com sucesso
O coletor chega a esta tela vindo do login, sem dados salvos anteriormente. O aplicativo confirma a conexão, baixa propriedades, motivos, veículo e coletas enviadas, atualiza o percurso do dia, e segue automaticamente para a tela de Atualizar Rota e Placa.
Caso 2 — Sincronização sem conexão de rede
O coletor abre esta tela sem wi-fi nem dados móveis ativos. O aplicativo exibe o aviso para ativar a conexão e o botão de tentar novamente, sem chegar a contatar o servidor.
Caso 3 — Veículo sem capacidade cadastrada
O coletor tem placa associada ao cadastro, mas o veículo correspondente não tem nenhuma capacidade de tanque configurada. Propriedades, motivos e coletas enviadas chegam a ser baixados e salvos, mas a sincronização é mostrada como falha por causa do veículo; tentar novamente refaz todo o processo.
Caso 4 — Dados completos, mas percurso do dia não disponível
O coletor já tem cadastro completo e sincroniza novamente (por exemplo, depois de uma falha anterior). Propriedades, motivos, veículo e coletas enviadas são atualizados normalmente, mas não há percurso atribuído para o dia; mesmo assim, o aplicativo segue para a próxima tela (ver T-09), sem um aviso explícito e definitivo de que o percurso não foi atualizado.
