Trocar de empresa no app

No app do Tromso ERP no celular, a opção Trocar empresa permite alternar, sem sair do sistema, entre as empresas do seu grupo que o seu usuário enxerga. Tudo o que você registra no app vale para a empresa atual, por isso é importante conferir em qual delas você está antes de lançar.

Trocar de empresa no app tem três particularidades em relação ao sistema no computador. A troca precisa de internet, porque o servidor valida o seu vínculo com a empresa de destino. O app bloqueia a troca quando há operações ainda não sincronizadas. E, ao confirmar a troca, o app apaga todo o conteúdo salvo no aparelho e recarrega os dados da nova empresa do zero, de modo que nada da empresa anterior fica acessível depois.

Quando a opção aparece

A opção Trocar empresa aparece no menu do usuário (o avatar, no canto superior) somente quando o seu usuário tem acesso a mais de uma empresa. Com uma só, o item não existe no menu e não há nada a trocar.

A lista de empresas é definida pelo administrador da sua organização em Configurações › Usuários e confirmada pelo servidor no momento do login. Não há autoatendimento: para operar em uma empresa que não está na lista, peça ao administrador para incluir o vínculo no seu acesso.

O item continua visível sem internet, porque a lista fica salva no aparelho. A troca, porém, exige conexão (veja Por que a troca precisa de internet).

Como trocar de empresa

Toque no avatar (canto superior) para abrir o menu do usuário.
Toque em Trocar empresa. O app abre a lista das empresas às quais o seu usuário tem acesso.
Toque na empresa de destino. A empresa atual aparece marcada com um Check e não é selecionável. A empresa padrão (aquela que abre quando você entra no app) aparece sinalizada com uma estrela.
Aguarde a confirmação. O app avisa Empresa trocada para seguido do nome da empresa e recarrega as telas com os dados da nova empresa.

Se a empresa de destino não estiver acessível no momento do toque, o app avisa Sem acesso a esta empresa e mantém você na empresa atual (veja Erros durante a troca).

Sincronize antes de trocar

O app funciona offline-first: tudo o que você registra no celular (um apontamento de produção, uma entrega, uma transferência de estoque) fica guardado no aparelho e é enviado ao servidor depois, em segundo plano. Esse envio é a sincronização.

Quando há operações ainda não sincronizadas, a troca de empresa é bloqueada. O app avisa Você tem N operações não sincronizadas. Sincronize antes de trocar de empresa (com a contagem real no lugar de N) e mantém você na empresa atual.

Para destravar a troca:

No menu do usuário, toque em Sincronizar.
Na tela de Sincronização, selecione o período de dados a carregar no aparelho: 30 dias, 60 dias ou 90 dias, ou toque em Começar do zero. O período define quanto histórico de operações (pedidos, retiradas, apontamentos, cargas e entregas) o app traz do servidor. Os cadastros, como clientes e produtos, vêm sempre por completo. O envio das operações pendentes acontece independentemente da opção escolhida.
Aguarde o envio. O app mostra o andamento na própria tela de sincronização.
Quando a tela voltar ao normal, abra o menu do usuário de novo e toque em Trocar empresa.

Por que a troca precisa de internet

A troca de empresa é uma operação online: ao tocar na empresa de destino, o app pede ao servidor que valide o seu vínculo com ela, emita um novo acesso para a nova empresa e invalide o acesso anterior. Sem internet, nada disso é possível.

Se você tentar trocar sem conexão, o app avisa Conecte-se à internet para trocar de empresa e mantém você na empresa atual. O ponto de conexão no canto do avatar fica verde quando o app está online. Confirme que ele está verde e tente de novo.

Como o app protege os dados ao trocar

Ao confirmar a troca, o app faz uma limpeza completa do conteúdo salvo no aparelho: cadastros, operações em andamento, marcas de sincronização e preferências locais são apagados e recriados do zero. Em seguida, recarrega os dados da nova empresa a partir do servidor.

A limpeza é completa, e não seletiva, porque o conteúdo guardado no aparelho não identifica, linha a linha, a que empresa pertence. Limpar só uma parte deixaria resíduo da empresa anterior misturado com os dados da nova. Como a troca só acontece com a fila de operações vazia, nenhum trabalho pendente se perde na limpeza.

Se o seu acesso à empresa foi removido enquanto o app estava fechado

Ao abrir, o app restaura a sessão guardada no aparelho sem falar com o servidor. Se o administrador revogou o seu vínculo com a empresa enquanto o app estava fechado, sem uma verificação você poderia entrar em uma empresa à qual já não tem direito.

Por isso, sempre que o app abre com internet, ele faz uma verificação em segundo plano do seu vínculo com a empresa atual. Se o vínculo foi revogado, o app mostra Seu acesso a esta empresa foi revogado. Faça login novamente., limpa a sessão, apaga o conteúdo local e volta para a tela de entrada. Se tudo estiver em dia, nada aparece e você segue normalmente.

Se isso acontecer com você, confira com o administrador qual empresa você deve usar agora.

Sessão expirada e falta de sinal

Nem toda queda de acesso encerra a sessão:

Sessão expirada. Quando o servidor recusa a renovação do seu acesso, o app mostra Sessão expirou. Faça login novamente. e faz o mesmo que no caso de acesso revogado, descrito em Se o seu acesso à empresa foi removido enquanto o app estava fechado.
Sem sinal. Quando a conexão cai, o app não encerra a sessão nem apaga nada. Ele mostra o banner Sem sinal, com a descrição “Pedidos na fila até a conexão voltar.”, e você continua na empresa atual. A troca de empresa, porém, continua exigindo internet (veja Por que a troca precisa de internet).

Erros durante a troca

Sem acesso a esta empresa

O aviso Sem acesso a esta empresa aparece quando o servidor recusa a troca para a empresa de destino. Em geral, o seu vínculo com aquela empresa foi revogado pelo administrador depois que o app carregou a lista, e a lista do aparelho ficou desatualizada.

A empresa atual continua intacta: o sistema não troca. Para atualizar a lista, feche e abra o app com internet. Se o vínculo foi mesmo removido, a empresa de destino deixa de aparecer. Se você precisa operar nela, peça ao administrador para reincluir o vínculo em Configurações › Usuários.

Outras falhas (rede ou servidor)

Se a troca falhar por um problema de conexão ou do servidor, o app mostra uma mensagem de erro e mantém você na empresa atual. Verifique se o app está online, aguarde alguns instantes e tente de novo. Nada é alterado até o servidor confirmar a troca.

Conferir a empresa atual

Antes de lançar, abra o menu do usuário, toque em Trocar empresa e confira qual empresa está com o Check. Todo lançamento feito agora pertence a essa empresa.

Para a troca de empresa no sistema no computador, com os atalhos de teclado e o menu lateral, veja Acesso e primeiro login.

Dúvidas frequentes

Não vejo Trocar empresa no meu menu.

A opção só aparece quando o seu usuário tem acesso a mais de uma empresa. Peça ao administrador para liberar as demais em Configurações › Usuários. Na primeira vez que você entrar no app depois da liberação, a lista é atualizada e a opção passa a aparecer.

O app diz que tenho operações não sincronizadas.

Há trabalho da empresa atual ainda não enviado ao servidor. Toque em Sincronizar no menu do usuário e aguarde o envio concluir. Se alguma operação não for enviada, resolva o problema apontado antes de tentar a troca de novo: o bloqueio evita que o trabalho da empresa atual se perca no caminho.

Tentei trocar e apareceu “Conecte-se à internet para trocar de empresa”.

A troca exige conexão. Conecte-se e toque de novo em Trocar empresa. A lista de empresas continua visível offline.

Troquei de empresa e a tela ficou vazia.

É o esperado. Como o app recarrega os dados da nova empresa do zero, as listas podem aparecer vazias por alguns instantes, enquanto a sincronização inicial da nova empresa termina. Assim que ela conclui, os dados da empresa atual aparecem. Nada foi perdido: a troca só acontece com a fila vazia, então o conteúdo da empresa anterior já estava sincronizado.

Toquei em uma empresa e apareceu “Sem acesso a esta empresa”.

O servidor recusou a troca, geralmente porque o administrador revogou o seu vínculo com aquela empresa. A empresa atual continua intacta. Veja Sem acesso a esta empresa, em Erros durante a troca.

Abri o app e ele voltou para a tela de entrada sozinho.

O aviso que aparece indica o motivo:

Se apareceu Seu acesso a esta empresa foi revogado. Faça login novamente., o acesso àquela empresa foi revogado enquanto o app estava fechado. Veja Se o seu acesso à empresa foi removido enquanto o app estava fechado.
Se apareceu Sessão expirou. Faça login novamente., o servidor recusou a renovação do seu acesso. Veja Sessão expirada e falta de sinal.

Lancei algo na empresa errada no app. O que fazer?

Não há “transferir entre empresas”: o registro pertence à empresa onde foi criado. Exclua o registro na empresa errada: se ainda não foi sincronizado, ele sai direto do app, e, se já foi enviado, exclua-o pela lista. Depois, refaça o lançamento na empresa correta. Para evitar a repetição, confira a empresa atual antes de começar, como indicado em Conferir a empresa atual.