O app funciona inteiro sem internet: seus dados moram em um banco local no aparelho. A sincronização é o que faz esses dados também existirem no servidor — para você abrir o app em outro aparelho, para não perder tudo se o celular sumir e para que uma categoria compartilhada chegue à outra pessoa.
O que é preciso para sincronizar
| Requisito | O que acontece se faltar |
|---|---|
| Estar logado | Sem conta não há para onde enviar. O app avisa que o token da conta está ausente. |
| Token válido | Se ele expirou, a sincronização para e oferece o botão Atualizar sessão, que renova o token sem pedir a senha. Só quando o servidor recusa o token é preciso fazer login de novo. |
| Consentimento de sincronização | O envio de dados ao servidor exige um aceite explícito. Sem ele, a sincronização é recusada mesmo com login válido — e a tela oferece o botão Ativar sincronização, que resolve isso sem sair do app. |
| Não estar em Modo de Testes | A sincronização é desabilitada no modo sandbox de propósito: dados de teste não devem subir para a sua conta. |
Quando falta alguma dessas coisas, a tela de sincronização não deixa o "Iniciar" falhar: ela diz o que está faltando e mostra só o botão que resolve aquele caso — entrar na conta, ativar a sincronização, atualizar a sessão ou abrir a área do cliente no site.
Ativando a sincronização
O consentimento é o aceite de que os seus dados saiam deste aparelho. Ligá-lo é um caminho de dois passos dentro do próprio app, na tela Ativar sincronização:
- Você lê e aceita duas afirmações — que os dados vão subir para o servidor, e que desligar isso depois não é simétrico.
- O app avisa o servidor e renova a sessão. Os dois passos aparecem na tela conforme acontecem; se algum falhar, a mensagem diz o que houve e oferece a saída — tentar de novo, ou entrar de novo quando o problema for a sessão.
Repetir o processo é seguro: o servidor responde da mesma forma para uma conta que já está com o consentimento ligado.
Ligar acontece no app; desligar acontece no site, na área do cliente. Não é burocracia: desligar apaga tudo o que já foi sincronizado, e essa confirmação mora na página que explica o que vai ser apagado.
Se você acabou de mexer no consentimento pelo site e o app ainda não percebeu, toque em Atualizar sessão — a preferência viaja dentro do token, e o token precisa ser reemitido. O app também faz isso sozinho de tempos em tempos.
Antes de começar: o que há para sincronizar
Antes de você tocar em Iniciar, a tela mostra o que a sincronização faria:
- Para enviar — o que ainda existe só neste aparelho, separado por tipo: lançamentos, anotações, categorias, importações, ajustes e exclusões.
- Para receber — o que já existe no servidor e ainda não chegou aqui, contado do mesmo jeito.
- Conexão — se o servidor respondeu, e em quanto tempo. É uma consulta de verdade, feita com a sua conta: se ela passou, a sincronização também passa.
- Tempo estimado — uma faixa aproximada, calculada a partir da quantidade acima e das suas próprias sincronizações anteriores. É uma frase arredondada de propósito ("menos de 5 segundos", "cerca de 2 minutos"), porque a conta não é exata.
Essa consulta não envia nem grava nada — é só uma pergunta. Se o servidor não responder, o painel continua mostrando o lado deste aparelho, que é um número local, e não mostra o outro lado: sem resposta, um "0" ali seria um palpite. Atualizar refaz a pergunta.
O que a barra de progresso está fazendo
- Coleta. O app lê o banco local e separa tudo o que mudou desde a última sincronização bem-sucedida.
- Marcação. Os itens selecionados são marcados para envio — a mensagem mostra quantos são.
- Comunicação. O lote sobe e o app aguarda a resposta. É a etapa mais longa e a que depende da sua conexão.
- Conclusão. O que veio do servidor é gravado localmente e o resumo mostra quantos itens foram sincronizados e quantos falharam.
O log na tela agrupa as mensagens por segundo, então uma sincronização grande não vira uma cascata ilegível. Você pode cancelar a qualquer momento: o cancelamento é pedido ao processo em andamento e registrado no log. E ao terminar, o app aguarda alguns segundos antes de liberar um novo envio — evita disparos repetidos por impaciência.
A sincronização automática
Na maior parte do tempo você não precisa abrir a tela de sincronização. O app dispara sozinho em quatro situações:
- Primeira sincronização — logo depois que a conta é vinculada ao aparelho.
- Alteração manual — quando você cria ou responde um compartilhamento, por exemplo.
- Alteração em lote — depois de uma importação ou de uma classificação em massa.
- Rotina — de tempos em tempos, e só quando já faz um bom tempo desde a última sincronização válida — não a cada abertura do app.
Trocando de aparelho
- Sincronize no aparelho antigo. Rode uma sincronização manual e confirme que ela terminou com sucesso, sem itens falhados.
- Instale e faça login no novo. Com a mesma conta. O app detecta que não há dados locais e parte para a sincronização inicial.
- Confira antes de apagar o antigo. Compare a quantidade de categorias e um mês qualquer de lançamentos nos dois aparelhos. Só então desinstale.
Em Configuração › Logout, entre as outras opções, existe Baixar meus dados: uma exportação em arquivo, que abre a caixa de salvar do próprio sistema. Ela é independente do servidor e funciona mesmo sem conta — vale guardar uma cópia antes de qualquer operação grande, como uma importação enorme ou uma reorganização da árvore de categorias. Estar naquela tela não obriga a sair de nada.