Pular para o conteúdo principal

Instalação e configuração — SuperApp Linear

Guia operacional para implantar e validar a integração SuperApp + SGApi no ambiente do cliente. Baseado no POP da Central de Ajuda Linear (atualizado em 26/05/2026).

Para desenvolvimento local da API, veja Setup local.

Visão geral​

O SuperApp integra operações de loja ao SG Linear em tempo real: consulta de preços, recebimento, cotações, pedidos, dashboards e demais rotinas expostas pela SGApi.

Pré-requisitos​

ComponenteVersão mínima
SG Linear26.01.04
Linear Monitor / WSLinear26.02.01 (inclui SGApi)
SuperApp (Android)Android 7.0+
Usuário SG LinearCadastrado com e-mail vinculado
LicençaLicença de Uso do SuperApp Linear

A licença define o limite de usuários com acesso ao app. O setor comercial deve informar a quantidade correta à Central de Serviços no momento da geração.

Fluxo comercial (antes da configuração técnica)​

  1. Cliente novo → encaminhar ao setor comercial (custos e escopo).
  2. Cliente que já usava Site Mercado pode seguir integração direta (Ifood Mercado substitui Site Mercado) — solicitar pedido ilustrativo à Central de Serviços.
  3. Após aprovação → Pedido de Venda → Serviços (Matriz) ou Suporte (ES/DF).
  4. Ticket aberto → execução do passo a passo abaixo.

1. Licença de uso​

Solicitar à Central de Serviços a Licença de Uso do SuperApp, informando a quantidade de usuários.

2. Configuração no SG Linear​

Menu: Utilitários → Integrações → SuperApp

  1. Inserir a licença do SuperApp Linear
  2. Verificar limite de usuários × usuários já configurados
  3. Selecionar o usuário
  4. Vincular o e-mail (buscado do Cadastro de Usuários)
  5. Definir filiais com permissão de acesso
  6. Configurar permissões do aplicativo (string de permissões — ver Sistema de permissões)
  7. Incluir o usuário

3. Linear Monitor e SGApi​

Atualize o Linear Monitor para 26.02.01 ou superior, que já inclui a SGApi integrada.

Validar que a SGApi está em execução​

Após ativar o serviço no Monitor:

  1. Abra o Gerenciador de Tarefas do Windows
  2. Confirme o processo SGApi em execução

Porta de comunicação​

A SGApi seleciona automaticamente a porta com base na porta do WSLinear: duas numerações acima.

WSLinearSGApi
80818083
80808082

Informe essa porta no SuperApp quando configurar o Servidor Local.

4. Instalação do app (Android)​

Buscar SuperApp Linear na loja de aplicativos do smartphone e instalar.

5. Configuração inicial do SuperApp​

Na primeira abertura, acesse Configurações.

5.1 CNPJ​

Informe o CNPJ da Matriz e o CNPJ da Empresa. Se forem iguais, repita o mesmo valor.

5.2 Servidor local (obrigatório — rede interna)​

Use quando o app acessa o servidor na mesma rede local:

CampoExemplo
Hosthttp://192.168.1.10
Porta8083 (conforme regra acima)

5.3 Servidor remoto (opcional — acesso externo)​

Para acesso fora da rede do supermercado, configure endereço e porta pública com apoio da TI do cliente (firewall, NAT, VPN).

5.4 LinearCloud (ambiente nuvem)​

CampoValor
Hosthttps://superapp.linearcloud.com.br
Porta(deixar em branco)

5.5 Testar e salvar​

Pressione Testar Conexão → Salvar.

6. Login e sincronização inicial​

Credenciais:

  • E-mail vinculado ao usuário no SG Linear
  • Senha do usuário no SG Linear

No primeiro acesso, o app executa sincronização inicial com o servidor. Após concluir, o app está pronto para uso.

Comportamento de sessão (login em outro dispositivo): Sessão única SuperApp.

7. Validar comunicação com a API​

Endpoints de saúde​

Teste no navegador ou via curl:

Ambiente local (substitua host e porta):

http://192.168.1.10:8083/health

LinearCloud:

https://superapp.linearcloud.com.br/health
https://superapp.linearcloud.com.br/ping

Resposta esperada em /health: status Healthy (ASP.NET Core Health Checks).

/ping pode estar exposto no gateway LinearCloud; localmente a SGApi expõe /health.

Desenvolvimento local​

cd "SGApi Solution"
dotnet run --project src/SGApi.csproj
# http://localhost:5031/health  (porta padrão local sem --urls)

8. Logs e diagnóstico​

A SGApi envia logs estruturados para o Seq da Linear Cloud:

  • URL: https://debug.linearcloud.com.br
  • Credenciais: solicitar à Central de Serviços ou equipe interna (não versionar senhas no repositório)

Rota de teste de log (somente ambientes autorizados):

GET /test/log

Referências​