Funcionamento APP TEOREMA Consulta PREÇO

---
title: Funcionamento APP TEOREMA Consulta PREÇO
slug: funcionamento-app-teorema
sistema:
  - Teorema Counter
chamado: "0000529899"
categoria: user_manual
tipo: how-to
autor: Gabriel Faria
setor: QUalidade
modulo: APP Consulta Preços
publico: "Usuários do aplicativo Teorema Consulta Preços"
keywords:
  - consulta de preços
  - app
  - Teorema Counter
  - código de barras
  - código reduzido
  - registro de dispositivo
versao_doc: "01"
revisao: Paulo Bley
aprovado_em: Julho de 2025
versao_pipeline: 2.5.2
ultima_revisao: "2026-06-11"
---

## Visão Geral

O aplicativo Teorema Consulta Preços permite consultar preços e informações de produtos do sistema ERP (Enterprise Resource Planning) Teorema diretamente em dispositivos móveis. Este documento orienta o usuário desde a instalação e configuração inicial até a pesquisa de produtos no dia a dia, cobrindo: autenticação via CPF ou CNPJ, configuração de conexão com o servidor, registro de dispositivo, cadastro de informações pessoais e uso das funcionalidades de busca.

> **Pré-requisito:** O servidor Orion Horse deve estar instalado e configurado antes do primeiro acesso. Consulte o manual de instalação do servidor em: <https://teorema.assetway.com.br/p/teorema/search/m/asset/5493>

## Modo de Utilização

### Tela Inicial — Identificação com CPF ou CNPJ

Ao abrir o aplicativo Teorema Consulta Preços, é exibida a tela de autenticação, que solicita o documento de cadastro da empresa.

**Passo a passo:**

- Informe o CNPJ (Cadastro Nacional de Pessoa Jurídica) ou CPF (Cadastro de Pessoa Física) da empresa cadastrada no sistema.
- Toque no botão **Continuar**.

O sistema identifica a base vinculada ao documento e redireciona automaticamente para a tela de configuração de conexão.

![Tela inicial do aplicativo Teorema Consulta Preços com o título "Seja Bem Vindo ao Teorema Consulta Preços", campo de texto "CPF OU CNPJ" em destaque e botão "Continuar"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-06.png)

### Configuração de Acesso — Conexão com Servidor

Após a validação do documento, o sistema redireciona para a tela de configurações de acesso, padrão nos aplicativos desenvolvidos em Delphi.

A tela exibe os campos:

- **Documento** — CNPJ/CPF informado na etapa anterior (ex.: 00.980.499/0001-40)
- **Endereço servidor primário** — endereço de conexão principal (ex.: https://orion2.teorema.inf.br)
- **Endereço servidor secundário** — endereço alternativo, se houver
- **Endereço servidor impressão** — endereço do servidor de impressão, se configurado
- **Banco de dados** — base vinculada ao documento

Os dados podem ser preenchidos manualmente ou localizados pelo botão **Buscar Endereços**. Use **Testar Conexão** para verificar se a comunicação está ativa antes de prosseguir.

![Tela "Configurações / Acesso" com campos Documento (00.980.499/0001-40), Endereço servidor primário (https://orion2.teorema.inf.br), Endereço servidor secundário (Não Informado), Endereço servidor impressão (Não Informado) e Banco de dados (Não Informado); botões "Testar Conexão" e "Buscar Endereços"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-07.png)

### Login com Usuário e Senha

Após a conexão ser validada, o aplicativo exibe a tela de login.

**Campos obrigatórios:**

- **Usuário** — nome de usuário previamente cadastrado no ERP Teorema ou painel administrativo.
- **Senha** — senha vinculada ao usuário informado.

Toque em **Login** para prosseguir.

![Tela de login "Teorema Consulta Preços" com campos "Usuário" e "Senha" sinalizados por setas e botão "Login"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-08.png)

### Registro de Dispositivo — Licenciamento do App

Após o login, o sistema exibe a tela **"Estamos quase lá!"**, onde é necessário vincular o dispositivo à licença de uso do aplicativo.

**Campos da tela:**

- **Identificação do dispositivo** — preenchido automaticamente pelo sistema com o modelo do aparelho (ex.: Android SM-G998B). Este campo não pode ser alterado manualmente.
- **Escolha um apelido para esse dispositivo** — defina um nome que identifique o uso dentro da empresa, como: Diretoria, Vendas, Compras, Estoque, Financeiro.

Toque em **Avançar** para confirmar o registro.

![Tela "Estamos quase lá!" com campo "Identificação do dispositivo" preenchido com "Android SM-G998B", campo "Escolha um apelido para esse dispositivo" com placeholder "Ex: Diretoria, Vendas, Compras" e botão "Avançar"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-09.png)

### Informações Pessoais — Finalização do Cadastro

O sistema solicita as informações de contato do usuário para viabilizar suporte quando necessário.

**Campos obrigatórios:**

- **Nome completo** — informe o nome completo conforme desejado no cadastro.
- **Telefone de contato** — preencha com o número de WhatsApp válido, incluindo o DDD.

Toque em **Concluir** para finalizar. O aplicativo estará pronto para uso.

![Tela "Informações pessoais" com instrução "Informe seu nome e seu WhatsApp de contato para que possamos entrar em contato com você caso precise", campos "Nome completo" e "Telefone de contato (Informe seu WhatsApp)" e botão "Concluir"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-10.png)

### Cadastro Realizado — Configuração Final

Após clicar em **Concluir**, o sistema confirma o cadastro e inicia automaticamente a configuração do aplicativo no dispositivo.

![Tela com mensagem "Cadastro realizado com Sucesso!" e instrução "Aguarde enquanto estamos configurando seu APP"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-11.png)

### Menu Lateral — Configurações do App

Após o carregamento, o usuário é direcionado à interface principal do Teorema Consulta Preços. Toque no ícone de três barras (≡) para abrir o menu lateral, que oferece duas seções: **Consulta** e **Configurar**.

Ao selecionar **Configurar**, são exibidas as seguintes opções:

- **Sincronizar Itens** — força a sincronização completa de todos os itens do sistema com o dispositivo.
- **Sincronizar Imagens** — realiza a sincronização das imagens vinculadas aos produtos.
- **Ocultar Foto** — quando ativado, as imagens dos produtos não são exibidas na tela de consulta.
- **Ocultar Oferta** — oculta os destaques de preços promocionais na visualização de consulta.
- **Ocultar Estoque** — impede que o campo de estoque disponível seja exibido durante a navegação.

Informações adicionais exibidas no menu:

- **Usuário logado** — exibido no canto superior direito (ex.: adm).
- **Empresa** — código da empresa conectada (ex.: 0040330).
- **Sair da Aplicação** — encerra a sessão e retorna à tela de login.

![Menu lateral do aplicativo aberto na seção "Configurar", exibindo as opções Sincronizar Itens, Sincronizar Imagens, Ocultar Foto (com checkbox), Ocultar Oferta (com checkbox) e Ocultar Estoque (com checkbox); no painel esquerdo: itens "Consulta" e "Configurar"; na barra inferior: "Sair da Aplicação" e "Empresa: 0040330"; usuário "adm" no canto superior direito](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-12.png)

## Consulta de Produtos

### Tela Principal — Consulta Rápida de Produtos

A tela inicial após o login é dedicada à consulta de preços e informações de produtos. Digite ou escaneie no campo de busca o código de barras, código interno ou descrição do produto, depois toque no ícone de lupa para iniciar a pesquisa.

**Formas de busca disponíveis:**

- Código de barras (via digitação ou leitor Bluetooth)
- Código interno
- Nome do item (total ou parcial)
- Código reduzido

**Informações exibidas no resultado:**

- Item Reduzido
- Código de Barras
- Imagem do Produto (caso sincronizada)
- Preço de Venda
- Quantidade em Estoque

> **Nota:** Os campos Foto, Oferta e Estoque podem ser ocultados em **Configurar**, conforme preferências do usuário ou políticas da empresa.

![Tela principal "CONSULTA RÁPIDA DE PRODUTOS" com campo de busca em destaque contendo instrução "Digite ou escaneie o código de barras, código interno ou a descrição...", ícone de lupa, e área de resultado com campos Item Reduzido, Código de Barras, espaço para imagem do produto, Preço de venda e Quantidade em estoque (0.0)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-13.png)

### Busca por Nome — Exemplo "balde"

Ao pesquisar por nome, o sistema exibe o item mais relevante em destaque e uma lista de produtos relacionados à palavra digitada.

**Resultado para "balde":**

- Produto principal: **BALDE VAZIO**
- Item Reduzido: 000005
- Preço de Venda: R$ 2,11
- Quantidade em estoque: -12,0
- Lista de produtos relacionados exibida abaixo (ex.: 000005 BALDE VAZIO, 000006 PAO DE QUEIJO - BALDE 4 KG)

![Tela de resultado da busca por "balde" exibindo o produto principal "BALDE VAZIO" com Item Reduzido 000005, Preço Venda R$2,11, Quantidade em estoque -12,0 e imagem do produto; lista inferior com colunas CÓDIGO, DESCRIÇÃO, COD. BARRAS e RS VE mostrando as linhas 000005 BALDE VAZIO e 000006 PAO DE QUEIJO - BALDE 4 KG](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-14.png)

### Busca por Nome — Exemplo "agua"

**Resultado para "Agua":**

- Produto principal: **AGUA MINALBA 510 ML SEM GÁS**
- Item Reduzido: 000001
- Código de Barras: 0000987952057
- Preço de Oferta: R$ 2,59
- Quantidade em estoque: -710,0
- Lista de produtos relacionados: AGUA MINALBA 510 ML SEM GÁS (000001), AGUA MINERAL AGUAVITA 300 ML SEM GÁS (000004), AGUA MINERAL BOREAL 510 ML SEM GÁS (000003), AGUA MINERAL CRISTAL 500 ML SEM GÁS (000007)

> **Dica:** Se a opção "Ocultar Estoque" ou "Ocultar Oferta" estiver ativada nas configurações, esses campos não serão exibidos no resultado.

![Tela de resultado da busca por "Agua" exibindo o produto principal "AGUA MINALBA 510 ML SEM GÁS" com Item Reduzido 000001, Código de Barras 0000987952057, Preço Oferta R$2,59, Quantidade em estoque -710,0 e imagem do produto; lista inferior com produtos 000001 AGUA MINALBA, 000004 AGUA MINERAL AGUAVITA, 000003 AGUA MINERAL BOREAL e 000007 AGUA MINERAL CRISTAL](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-15.png)

### Busca por Código Reduzido

O código reduzido é um identificador numérico simplificado usado no cadastro de itens. A busca por esse código retorna o produto de forma direta e precisa.

**Resultado para "000017":**

- Produto localizado: **CALÇO**
- Item Reduzido: 000017
- Preço de Venda: R$ 1,50
- Quantidade em estoque: 28.905,0
- Lista de produtos relacionados exibida abaixo (ex.: 000017 CALÇO, 000037 PRODUTO INTERMEDIARIO NIVEL 3 (COM LOTE) — COD. BARRAS 000000000178)

> **Dica:** A busca por código reduzido é especialmente útil quando utilizada em conjunto com catálogos impressos, listas técnicas ou orçamentos com referência cruzada.

![Tela de resultado da busca por código reduzido "000017" exibindo o produto "CALÇO" com Item Reduzido 000017, Preço Venda R$1,50, Quantidade em estoque 28905,0 e imagem do produto; lista inferior com 000017 CALÇO e 000037 PRODUTO INTERMEDIARIO NIVEL 3 (COM LOTE) com código de barras 000000000178](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/funcionamento-app-teorema/funcionamento-app-teorema-16.png)

## Informações do documento

> Autor: Gabriel Faria
> Setor: QUalidade
> Módulo: APP Consulta Preços
> Chamado: 0000529899
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Paulo Bley
> Aprovado em: Julho de 2025

---

> 📎 **Arquivos originais:** [MANUAL FUNCIONAMENTO APP TEOREMA CONSULTA PREÇO.docx](https://drive.google.com/uc?export=download&id=1TbnJPAnb5S_AKTXv-Dt5z39KcQdJ2D3S) · [MANUAL FUNCIONAMENTO APP TEOREMA CONSULTA PREÇO.pdf](https://drive.google.com/uc?export=download&id=1bJseicNm3Nd69uV1zfgWJSoQNgGHhpWw)