Configuração App Teorema

---
title: Configuração App Teorema
slug: configuracao-app-teorema
sistema:
  - Teorema Service (App)
categoria: user_manual
tipo: how-to
autor: Andreia Burko Bley
setor: Qualidade
modulo: Orion
aprovado_em: 09/2023
release: Manuais 2023
versao_pipeline: 2.6.0
publico: "Técnicos de implantação e usuários responsáveis pela configuração dos aplicativos móveis Teorema"
keywords:
  - configuração
  - app
  - aplicativo
  - Orion
  - CNPJ
  - servidor primário
  - servidor secundário
  - ngrok
  - login
  - dispositivo
  - cadastro de conta
chamado: ""
ultima_revisao: "2026-06-12"
---

## Visão Geral

Os aplicativos móveis Teorema (Transformação, Autorizador 3, Inventário 2, Service 3 e Produção) seguem um padrão unificado de instalação, configuração de servidor e cadastro de conta. Este guia descreve o fluxo completo: instalação via Google Play, inserção do Cadastro Nacional da Pessoa Jurídica (CNPJ), configuração do endereço do servidor (primário e secundário), teste de conexão com o Orion e primeiro acesso ao aplicativo.

> **Pré-requisito:** O Orion deve estar instalado e em execução na máquina servidora antes de configurar qualquer aplicativo. Consulte os manuais de configuração do Orion disponíveis em https://teorema.assetway.com.br/search/3071 e https://teorema.assetway.com.br/search/3079.

## Instalar o Aplicativo pelo Google Play

1. Acesse o Google Play em https://play.google.com/store/ e localize o aplicativo desejado:
   - Teorema Transformação
   - Teorema Autorizador 3
   - Teorema Inventário 2
   - Teorema Service 3
   - Produção

   ![Tela inicial do dispositivo Android exibindo os ícones dos aplicativos Teorema: Transformação, Autorizador 3, Inventário 2, Service 3 e Produção na área de trabalho](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-01.png)

2. Toque no aplicativo desejado para abrir a página de instalação no Google Play.

   ![Tela do dispositivo Android com destaque em seta vermelha sobre o ícone do aplicativo Teorema Transformação na área de trabalho](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-02.png)

   ![Tela de abertura do aplicativo exibindo a mensagem "SOLUÇÕES para a sua empresa FAZER +"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-03.png)

> **Nota:** Na tela de CNPJ, verifique a versão exibida no rodapé do aplicativo e confirme se é a mais atual disponível no Google Play.

## Informar o CNPJ

3. Na tela de boas-vindas, informe o CNPJ da empresa no campo **Informe o CNPJ** e toque em **Continuar**.

   ![Tela "Seja bem vindo ao Teorema OT 2" com campo "Informe o CNPJ" vazio e botão Continuar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-04.png)

   ![Tela "Seja bem vindo ao Teorema OT 2" com CNPJ digitado no campo e teclado numérico exibido; seta indicando o botão OK do teclado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-05.png)

   ![Tela "Seja bem vindo ao Teorema OT 2" com CNPJ preenchido e botão Continuar destacado em amarelo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-06.png)

   ![Tela "Seja bem vindo ao Teorema OT 2" com mensagem "Buscando documento, aguarde..." exibida sobre o botão Continuar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-07.png)

## Identificar o IP do Servidor

Para configurar o servidor primário, é necessário conhecer o endereço IP (Protocolo de Internet) da máquina onde o Orion está instalado.

4. Na máquina servidora, abra o Prompt de Comando: pressione **Win**, digite `cmd` e pressione Enter.

   ![Barra de pesquisa do Windows com o termo "cmd" digitado; ao fundo, tela de Configurações do app no aplicativo Android](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-08.png)

5. No Prompt de Comando, digite `ipconfig` e pressione Enter.

   ![Janela do Prompt de Comando com o comando "ipconfig" digitado; ao fundo, tela de Configurações do app no Android](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-09.png)

6. Localize o valor exibido em **Endereço IPv4** do adaptador de rede ativo. Esse é o IP a ser usado no campo Endereço Servidor Primário.

   ![Resultado do comando ipconfig no Prompt de Comando exibindo vários adaptadores de rede; seta destacando o campo "Endereço IPv4" do adaptador Ethernet ativo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-10.png)

## Configurar o Servidor Primário

7. No aplicativo, acesse **Configurações do app** e toque em **Endereço servidor primário**.

   ![Tela "Configurações do app" com seção Acesso exibindo os campos: Documento (CNPJ preenchido), Endereço servidor primário (destacado em amarelo), Endereço servidor secundário e Banco de dados (Não Definido); botões Testar Conexão e Buscar Endereços](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-11.png)

8. No diálogo **Endereço do servidor primário**, digite o endereço no formato `http://<IP>:<porta>` e toque em **Continuar**.

   - Exemplo: `http://192.168.0.8:9035`
   - A porta padrão do Orion é **9035**. Se a porta não foi alterada durante a instalação, utilize este valor.

   ![Diálogo "Endereço do servidor primário" com campo de texto vazio e botão Continuar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-12.png)

   ![Diálogo "Endereço do servidor primário" com o endereço "http://192.168.0.8:9035" digitado e teclado exibido; seta apontando para o botão Continuar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-13.png)

## Configurar o Servidor Secundário (Acesso Externo)

O servidor secundário permite acesso ao sistema de fora do ambiente da empresa, por exemplo via rede 4G. Quando o aplicativo não conseguir conectar ao servidor primário, tentará automaticamente o endereço secundário.

8. Na tela **Configurações do app**, toque em **Endereço servidor secundário** e informe o endereço externo.

   ![Tela "Configurações do app" com campo "Endereço servidor primário" preenchido com "http://192.168.0.8:9035" e campo "Endereço servidor secundário" destacado em azul](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-14.png)

   ![Tela "Configurações do app" com ambos os endereços preenchidos: servidor primário "http://192.168.0.8:9035" e servidor secundário com URL ngrok](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-15.png)

> **Nota:** Uma opção para disponibilizar o servidor local na internet é a ferramenta **ngrok**, que cria um túnel e fornece uma URL pública (DNS) apontando para o IP local. O exemplo abaixo mostra o terminal do ngrok em execução, exibindo a URL de encaminhamento gerada.

   ![Terminal do ngrok em execução mostrando sessão ativa com URL de encaminhamento público e histórico de requisições HTTP](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-16.png)

   ![Terminal do ngrok exibindo detalhes da sessão: Account, Version, Region, Web Interface e Forwarding com URL pública mapeada para localhost; abaixo, log de requisições POST com status 200](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-17.png)

## Testar a Conexão com o Orion

9. Na tela **Configurações do app**, toque em **Testar Conexão**.

   ![Tela "Configurações do app" com ambos os endereços de servidor preenchidos e seta apontando para o botão "Testar Conexão"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-18.png)

   ![Tela "Configurações do app" com mensagem "Tentando realizar conexão" exibida e botão Testar Conexão em estado desabilitado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-19.png)

   ![Tela "Configurações do app" com botão "Conectado !" destacado em amarelo, indicando conexão bem-sucedida com o servidor](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-20.png)

Se a conexão falhar, verifique se as informações foram cadastradas corretamente e se há algum firewall bloqueando a porta do Orion.

## Selecionar o Banco de Dados

10. Após a conexão ser estabelecida, toque em **Banco de dados** para listar as bases disponíveis para o usuário.

    ![Tela "Configurações do app" com campo "Banco de dados" destacado em amarelo exibindo "Não Definido" e botão "Conectado !" visível](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-21.png)

11. Na tela **Base de Dados**, selecione a base desejada tocando sobre ela.

    ![Tela "Base de Dados" listando múltiplas bases disponíveis para o usuário, cada uma com identificador e nome da empresa](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-22.png)

    ![Tela "Configurações do app" com campo "Banco de dados" preenchido com o identificador da base selecionada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-23.png)

## Revisar as Configurações de Usuário e FAQ

Na parte inferior da tela **Configurações do app** estão as seções **Usuário** e **FAQ**.

- **Usuário login automático** — campo informativo que exibe o último usuário que acessou o aplicativo neste dispositivo.
- **Empresa login automático** — empresa selecionada no último acesso.
- **Login Automático** — alternância para habilitar ou desabilitar o login automático.

![Tela "Configurações do app" com seção Usuário (campos: Usuário login automático "Não informado", Empresa login automático "Não Informado", Login Automático desativado) e seção FAQ com as perguntas: "Como faço para ter acesso ao app?", "Não tenho mais licenças disponíveis em minha conta, oque fazer?", "Como funciona o cadastro de licenças na linha mobile teorema?" e "Não estou conseguindo realizar o login em meu aplicativo"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-24.png)

O **FAQ** funciona como canal de ajuda integrado ao aplicativo, com tutoriais para as dúvidas mais comuns dos usuários.

![Tela de Configurações do app exibindo a seção FAQ com as quatro perguntas listadas em destaque amarelo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-25.png)

## Conceder Permissões ao Aplicativo

14. Ao retornar à tela principal do aplicativo pela primeira vez, será solicitada a **Permissão de Arquivos**. Toque em **Entendi, Continuar**.

    ![Tela "Nova Permissão Necessária — Permissão de Arquivos" com texto explicativo e botão "Entendi, Continuar"; seta apontando para o botão](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-26.png)

    ![Tela "Nova Permissão Necessária — Permissão de Arquivos" com diálogo do sistema Android perguntando "Permitir que Teorema Transformação 2 acesse fotos, vídeos, músicas e áudios neste dispositivo?" com botões Permitir e Não permitir](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-27.png)

15. No diálogo do sistema, toque em **Permitir** para conceder o acesso necessário ao cadastro completo da conta.

    ![Tela "Configurações do app" exibida ao fundo após concessão de permissão, com campos de acesso e usuário visíveis](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-28.png)

## Realizar o Login

16. Na tela de login do aplicativo, informe o **Login / E-mail** e a **Senha** e toque em **Login**.

    ![Tela "Teorema OT 2" com campos Login / E-mail e Senha vazios, checkbox Lembrar-me e botão Login; rodapé exibe "Teorema Sistemas 2.0.2"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-29.png)

    ![Tela "Teorema OT 2" com campo Login preenchido com "teorema", campo Senha com caracteres mascarados, checkbox Lembrar-me marcado e seta apontando para o botão Login](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-30.png)

    ![Tela "Teorema OT 2" com mensagem "Realizando Login Online..." exibida durante o processo de autenticação](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-31.png)

    ![Tela "Teorema OT 2" com mensagem "Registrando Dispositivo..." exibida após a autenticação bem-sucedida](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-32.png)

## Cadastrar o Dispositivo no Primeiro Acesso

No primeiro acesso de um dispositivo, o aplicativo solicita o cadastro do aparelho na Teorema.

17. Na tela **Cadastro de conta**, preencha os campos e toque em **Continuar**:
    - **Token do aparelho** — gerado automaticamente; identifica unicamente o dispositivo.
    - **Escolha um alias** — nome de identificação de quem vai utilizar o aparelho.
    - **Nome completo** — nome do usuário que utilizará o dispositivo.
    - **E-mail para contato** — endereço de e-mail para contato.
    - **Marca / Modelo** — marca e modelo do aparelho.

    ![Tela "Cadastro de conta — Dados de seu registro" com campo "Token do aparelho" preenchido automaticamente e demais campos (Escolha um alias, Nome completo, E-mail para contato, Marca / Modelo) vazios; botão Continuar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-33.png)

    ![Tela "Cadastro de conta" com campo "Token do aparelho" preenchido e destacado em amarelo; demais campos ainda vazios](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-34.png)

    ![Tela "Cadastro de conta" com todos os campos preenchidos: Token do aparelho, Escolha um alias (Financeiro), Nome completo (exemplo), E-mail para contato (exemplo), Marca / Modelo (Samsung); botão Continuar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-35.png)

18. Após o envio, o sistema carrega a lista de empresas que o usuário tem acesso.

    ![Tela "Selecione a Empresa" listando múltiplas empresas disponíveis para o usuário, com código, Cadastro Nacional da Pessoa Jurídica (CNPJ) e nome parcialmente visíveis](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-36.png)

## Acessar a Empresa e Carregar o Aplicativo

19. Toque na empresa desejada para carregá-la no aplicativo.

    ![Tela "Selecione a Empresa" com seta apontando para uma das empresas da lista](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-37.png)

    ![Tela de carregamento do aplicativo com mensagem "Buscando processos..." exibida ao centro](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-38.png)

    ![Tela inicial do aplicativo carregada exibindo o logotipo da empresa selecionada e indicador de conexão ativa no topo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-39.png)

## Sair do Aplicativo

20. Para encerrar a sessão, abra o menu lateral e toque em **Sair da Aplicação**.

    ![Menu lateral do aplicativo Teorema exibindo lista de módulos (01 - LAMINACAO, 02 - SECAGEM, 03 - CLASSIFICACAO POS SECAGEM, 04 - MONTAGEM, 05 - PRENSA, 06 - ACABAMENTO / SERRA, 07 - EMBALAGEM) e opção "Sair da Aplicação" destacada com seta na parte inferior](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/configuracao-app-teorema/configuracao-app-teorema-40.png)

## Informações do documento

> Autor: Andreia Burko Bley
> Setor: Qualidade
> Módulo: Orion
> Chamado: 
> Versão do Sistema: 
> Versão do documento: 01
> Revisão: Marcelo Schemmer
> Aprovado em: 09/2023

---

> 📎 **Arquivos originais:** [Manual Configuração App Teorema.docx](https://drive.google.com/uc?export=download&id=12tS8aE5HoysfV5ZJKi5FXx9V8ao2xNzm) · [Manual Configuração App Teorema.pdf](https://drive.google.com/uc?export=download&id=15y1m6DO9gqI8zoL9920HgW8AgtTQuBKK)