Manual de Implantação – Integração AlterVision + Ilimitar

Visão Geral

A integração entre a AlterVision e o sistema Ilimitar (via iSnapp) foi desenvolvida para automatizar o monitoramento de fluxo de clientes em lojas físicas, relacionar essas informações com as vendas e calcular, em tempo real, a taxa de conversão por loja.

Essa integração permite decisões mais rápidas e inteligentes, com foco em desempenho comercial, comportamento de consumo e efetividade das lojas físicas.

Objetivo do Produto

Desenvolver uma solução de integração que centralize o fluxo de dados de entrada e saída de clientes, combinando com os dados de vendas do sistema Ilimitar para oferecer análises completas via painel da AlterVision.

Público-Alvo

• Gerentes de loja que desejam entender o comportamento de fluxo e conversão.

• Analistas de BI que utilizam dados operacionais para embasar decisões estratégicas.

• Equipes de implantação ou TI responsáveis por ativar e configurar a integração.

Pré-Requisitos

1. Instalação da Biblioteca supademo

   • Utilizada pela AlterVision para acessar a API da Ilimitar.

   • Deve ser instalada no ambiente do cliente (já em uso em clientes como Oscar).

2. Criação de usuário com permissão de “Gestor” no Ilimitar

   • Necessário para autenticação nas chamadas da API de vendas.

3. Envio de credenciais à AlterVision

   • Usuário e senha de acesso Ilimitar (ou token) para consumo seguro da API.

4. Acesso à internet liberado para chamadas HTTPS entre AlterVision ↔ Ilimitar]

 Estrutura da Integração

[Câmeras AlterVision] ---> [API iSnapp/Ilimitar] ---> [Painel AlterVision]
      (conta entradas/saídas)         (consulta vendas)       (taxa de conversão)

• A AlterVision coleta dados das câmeras e envia para seu servidor.

• A AlterVision consome os dados de vendas do Ilimitar via API para cruzar com o fluxo.

• A taxa de conversão é calculada e exibida no painel do cliente AlterVision.

Etapas de Instalação

• Solicitar a biblioteca supademo ao responsável técnico (Maurício Francelino)

• Instalar a biblioteca no ambiente do cliente

• Criar um usuário gestor no Ilimitar

  • Atribuir permissões mínimas necessárias para leitura das vendas

• Compartilhar o login com a equipe da AlterVision

• Testar conexão API ↔ Ilimitar

  • Validar autenticação e retorno de dados

• Validar dados no painel da AlterVision

  • Verificar se as taxas de conversão estão sendo exibidas corretamente

Boas Práticas

• Crie um usuário técnico dedicado à integração

• Evite reutilizar usuários administrativos

• Valide com o cliente final o período de histórico desejado (ex: 7, 30 ou 90 dias)

• Garanta a atualização da biblioteca, quando aplicável

• Verifique se as câmeras estão corretamente posicionadas e calibradas

Fluxo de Operação

• A cada intervalo definido (ex: 5 minutos):

  • A AlterVision consulta a API da Ilimitar

  • Recebe os dados de vendas por loja e horário

  • Relaciona com o número de entradas e saídas coletadas

  • Atualiza o painel com a taxa de conversão da loja