Atualizar as listas no app do celular

No app do Tromso ERP no celular, as listagens são atualizadas puxando a tela para baixo com o dedo — o gesto conhecido como pull-to-refresh. Ele força uma sincronização imediata com o servidor: envia na hora o que você registrou no aparelho e baixa as novidades, sem esperar a sincronização automática, que roda a cada 5 minutos. O gesto funciona em todas as listagens do app.

Para que serve o gesto

O app é feito para funcionar offline: tudo o que você registra — um apontamento, um pedido, uma entrega — fica salvo no aparelho na hora e é enviado ao servidor depois, em segundo plano. Esse envio é a sincronização.

A sincronização acontece sozinha em alguns momentos (ver Atualização manual e automática), mas nem sempre é imediata. O gesto de puxar a lista para baixo é o jeito de forçar a sincronização agora, quando você quer:

• ver na lista um registro que acabou de ser criado em outra tela ou por outra pessoa;
• conferir se o que você lançou no aparelho já foi enviado ao servidor;
• trazer para o app uma alteração feita no sistema no computador.

Ao puxar e soltar, o app recoloca na fila as operações que travaram no envio, envia o que está pendente no aparelho e baixa do servidor os dados mais recentes. Por isso, depois do gesto, a lista reflete tanto o que saiu do aparelho quanto o que chegou do servidor.

Como atualizar

1. Abra a lista que você quer atualizar — por exemplo, Apontamentos ou Pedidos de venda.

2. Coloque o dedo no topo da lista e puxe para baixo, como se fosse rolar a lista além do começo. Um indicador de carregamento (um girador) aparece no topo da tela.

3. Solte. O indicador continua girando enquanto a sincronização acontece.

4. Quando o indicador some, a lista está atualizada — com os dados mais recentes do servidor e o que você tinha pendente já enviado.

Não há mensagem de “atualização concluída”: o sinal de que terminou é o indicador parar e sumir. Se a lista não mudou, é porque não havia nada novo no servidor nem nada pendente para enviar.

Onde o gesto funciona

O gesto funciona em todas as listagens do app:

• Apontamentos (produção) — ver Apontamentos.
• Pedidos de venda — tanto o painel de início quanto a lista de pedidos. Ver Pedidos de venda.
• Pedidos de retirada — ver Pedidos de retirada.
• Estoque — o painel de início e a lista de Transferências de estoque. Ver Transferências de estoque.
• Entregas, no app do motorista.

Em qualquer uma dessas telas, o gesto tem o mesmo efeito: forçar a sincronização imediata.

Atualização manual e automática

O app sincroniza em quatro situações, para manter o aparelho sempre atualizado sem depender só de você:

• Quando você puxa a lista (este gesto) — sincronização forçada, imediata.
• Quando você volta ao app — ao trazer o app de volta para a tela, ele sincroniza.
• Quando a internet volta — se o aparelho estava sem conexão, o app sincroniza assim que ela retorna.
• A cada 5 minutos, automaticamente — o app sincroniza em segundo plano nesse intervalo, sem você precisar fazer nada.

O gesto de puxar é o único em que você decide o momento: ele dispara a sincronização na hora e ignora a espera dos 5 minutos. Os demais são automáticos.

Há também o botão Sincronizar, no menu do usuário (o avatar, no canto superior), que dispara uma sincronização completa pelo menu — útil quando você quer sincronizar sem estar numa lista. O gesto de puxar e esse botão fazem o mesmo trabalho por baixo dos panos.

Quando vale puxar a lista

Puxe a lista quando quiser o dado mais recente na hora — por exemplo, antes de conferir um saldo, depois que a retaguarda confirma um pedido, ou ao voltar ao app depois de um tempo. Nos demais momentos, a sincronização automática de 5 em 5 minutos já mantém o aparelho atualizado.

Sem internet

O gesto funciona mesmo offline: você pode puxar a lista a qualquer momento, com ou sem conexão.

Sem internet, porém, a sincronização não consegue nem enviar o que está pendente nem baixar novidades — mas nada se perde. O que você registrou segue salvo no aparelho aguardando envio; assim que a conexão volta, o app tenta enviar automaticamente. A lista continua mostrando os dados que já estão no aparelho, e o indicador de carregamento gira e para normalmente, sem mensagem de erro.

Em resumo: offline, puxar a lista não traz nada novo (porque não há comunicação com o servidor), mas também não estraga nada — é só tentar de novo quando houver sinal. O ponto de conexão no canto do avatar fica verde quando o app está online.

Dúvidas frequentes

Puxei a lista e ela não mudou.

Significa que não havia nada novo no servidor e nada pendente no aparelho para enviar — a lista já estava atualizada. O indicador de carregamento girou e parou porque o gesto foi executado; o conteúdo não mudou porque não havia o que mudar. Se você esperava ver um registro, confirme se ele foi realmente criado no servidor e se você está na empresa certa.

O gesto funciona sem internet?

Sim. Você pode puxar a lista a qualquer momento, mesmo offline. Sem conexão, o gesto não consegue enviar nem baixar nada, mas nada se perde — seus registros ficam no aparelho e são enviados assim que a internet volta. O indicador de carregamento gira e para normalmente, sem mensagem de erro.

Qual a diferença entre puxar a lista e o botão Sincronizar?

Os dois forçam a sincronização imediata, da mesma forma. A diferença é o lugar: o gesto de puxar age na lista que você está vendo; o botão Sincronizar fica no menu do usuário (avatar, no canto superior) e serve para sincronizar de qualquer tela, sem precisar estar numa lista.

Preciso puxar a lista para o app atualizar?

Não. O app sincroniza sozinho a cada 5 minutos, e também quando você volta ao app e quando a internet volta. Puxar a lista é para quando você quer o dado mais recente agora, sem esperar os 5 minutos.

Como sei se o que lancei já foi enviado?

Puxe a lista: o gesto envia as pendências antes de baixar as novidades. Em Apontamentos, cada registro mostra um indicador de sincronização; no painel de pedidos de venda, um contador mostra as alterações aguardando envio e diminui conforme o envio acontece. Se o indicador ou o contador não zera, pode ser que o app esteja sem conexão — confira o ponto no avatar.

Criei um pedido no computador e não vejo no app.

O app só mostra os dados que já foram sincronizados para o aparelho. Puxe a lista da tela correspondente para forçar a sincronização imediata; se o app estiver online, o pedido aparece. Confira também se você está na mesma empresa em que o pedido foi criado — os dados são separados por empresa.