Manual de Integração de Vendas 🛍️
A integração entre o sistema da AlterVision e o sistema de PDV / ERP das lojas tem como objetivo importar os dados de venda de cada loja para a plataforma. Este documento apresenta, de forma clara, os meios pelos quais os sistemas das lojas podem se integrar ao nosso sistema.
Visão geral das formas de integração
Apresentamos quatro formas para realizar a integração, que se diferenciam principalmente pela forma como os dados circulam entre os sistemas. No modelo Push, o cliente envia as informações diretamente para nossa plataforma, favorecendo um maior controle. No modelo Pull, nossa plataforma realiza consultas periódicas a uma API disponibilizada pelo cliente. Já no modelo de API de terceiros, os dados são obtidos a partir de um provedor externo que já possua integração com o sistema da AlterVision. Por fim, a importação manual permite inserir os dados através de planilhas CSV através do PainelAlter.
Método 1: PUSH - O cliente envia os dados para a AlterVision
Como é
O cliente implementa uma rotina (job, webhook ou serviço) que envia os dados de vendas para um endpoint seguro da nossa plataforma. Assim que recebidos, esses registros são validados, deduplicados e apresentados no painel para relatórios e análise.
Mais informações
Acesse a documentação completa em Documentação da API AlterVision
Quando escolher
Indicado quando o cliente quer baixa latência (dados quase em tempo real), total controle sobre quais registros saem do seu ambiente e prefere gerenciar o fluxo de envio internamente.
Benefícios
Não é necessário IP fixo nem redirecionamento de portas - utiliza apenas conexões de saída. Maior controle das informações compartilhadas.
Desafios
O cliente fica responsável por desenvolver a rotina de envio de vendas e garantir que os dados sejam enviados de forma confiável (reenvio automático em caso de erro, por exemplo).
Método 2: PULL - Os dados são obtidos via API do cliente
Como é
O cliente desenvolve e expõe uma API capaz de retornar os dados de vendas. Nossa plataforma consulta periodicamente o endpoint informado para coletar as vendas.
Mais informações
Quando escolher
Quando o cliente já possui integrações semelhantes com outros sistemas ou quando políticas internas impossibilitam a criação ou manutenção de rotinas automatizadas de envio.
Benefícios
Não é necessário manter rotinas ou servidores, necessitando apenas a manutenção da API.
Desafios
Dependência da disponibilidade e desempenho da API do cliente, necessidade de lidar com autenticação, rate limits e paginação.
Método 3: API de Terceiro - Os dados são obtidos com terceiro
Como é
A nossa plataforma obtém as vendas diretamente da API do fornecedor do PDV (o sistema de frente de caixa) que o cliente usa. Em vez do cliente construir uma rotina nova, consumimos os dados já disponibilizados pelo provedor do PDV.
Quando escolher
Quando o cliente já usa um PDV com API disponível e prefere aproveitar essa fonte pronta para reduzir trabalho interno ou quando o fornecedor do PDV é o dono da única fonte confiável dos registros de venda.
Benefícios
Reduz o esforço do cliente ao aproveitar a API do PDV, acelerando a integração e facilitando a padronização.
Desafios
Depende da disponibilidade e mudanças na API do fornecedor, o que pode afetar atualização e consistência dos dados e exigir coordenação para suporte e credenciais.
Método 4: Importação Manual
A importação manual permite a inserção de dados de venda no sistema por meio do upload de uma planilhas no formato CSV. Esse método é ideal para cenários onde os dados já estão organizados externamente ou quando não há integração automatizada disponível.
Para utilizar essa funcionalidade, acesse o PainelAlter e navegue até Atalhos Rápidos > Importar Vendas > Carregar Planilha. Nessa seção, é possível baixar os modelos de planilhas CSV padrões, que devem ser utilizados como base para garantir que os dados estejam no formato correto.
Após preencher a planilha com as informações necessárias, basta realizar o upload do arquivo na mesma área. O sistema processará os dados e realizará a importação automaticamente.
Recomendamos seguir rigorosamente o modelo disponibilizado, respeitando os nomes das colunas e o formato dos dados, para evitar erros durante o processamento.