Manual de integração
Para realizar a integração entre sistemas, VendaAqui®App e o(s) ponto(s) de venda que você gerencia,
precisamos de informações sobre o ponto de venda, os produtos que serão vendidos por este e também sobre a
forma de recebimento. Nossas integrações são flexíveis para acomodar melhor todos os níveis de tecnologia,
mas consideramos isso em nossos algoritmos de ranqueamento, uma vez que integrações de alto
nível com maior tecnologia são melhores para a experiência de compra dos usuários.
Todos os dados de acesso assim como tipo de integração serão definidos entre a equipe do VendaAqui®App e o
ponto de venda, para viabilizar a melhor solução para cada caso.
Os scripts a serem utilizados nas integrações e também configurações de TI básicas para o funcionamento da
ferramenta podem ficar a cargo de nossa equipe. Por isso, não exite em nos perguntar:
suporte@vendaaquiapp.com.br
Definição dos modelos de dados
Dados do ponto de venda
- CNPJ
- Nome Fantasia
- Email
- Telefone
- Email responsável
- Telefone responsável
- Endereço
- Rua
- Número
- Cep
- Bairro
- Cidade
- País
- Latitude (opcional)
- Longitude (opcional)
- Opção de meio de pagamento
- Outros (para outros é necessário informar o meio de pagamento desejado, por
email, para integração com o mesmo)
- Cielo
- Merchant Key (dados de integração de pagamento CIELO)
- Merchant Id (dados de integração de pagamento CIELO)
Dados do produto
- Código de Barras
- Código Interno (Código de referência do produto no sistema interno, para produtos que não possuem
código de barras)
- Imagem (Imagem do produto, opcional)
- Imagens (Imagens do produto separadas por vírgula, opcional)
- Descrição (Nome do produto, opcional)
- Quantidade (Número de produtos em estoque, caso queira fazer o controle de estoque)
- Preço Atual (Preço do valor na gôndola)
- Preço Mínimo (Preço mínimo do produto que será utilizado caso o V.A.®Sold esteja habilitado)
- Produto Consignado (Caso ativo, serão desconsiderados os campos preço atual e preço mínimo)
- Valores aceitos (1 ou 0, TRUE ou FALSE, Sim ou Não)
- Margem Atual (Margem atual aplicada sobre o produto consignado)
- Margem Mínima (Margem mínima aplicada sobre o produto consignado caso o V.A.®Sold esteja
habilitado)
- V.A.®Sold (Ativa o preço mínimo/margem mínima)
- Valores aceitos (1 ou 0, TRUE ou FALSE, Sim ou Não)
- Restrição de idade (Caso ativo, apenas usuários com conta acima de 18 anos poderão visualizar seu
produto)
- Valores aceitos (1 ou 0, TRUE ou FALSE, Sim ou Não)
Manual planilha
Nesta forma, o ponto de venda utilizando seu usuário e senha no ambiente vendaaquiapp.com.br poderá acessar
a página de produtos e realizar upload da planilha que deve ser montada, de forma manual ou exportada de
outro sistema, no padrão definido.
Acesse a planilha aqui
Upload planilha
Nesta forma, o ponto de venda pode subir de forma automática sua planilha sem precisar abrir o painel. Sendo
assim, o ponto de venda junto com sua equipe de TI pode realizar a exportação dos dados para uma planilha e
após realizar o upload para nossos servidores utilizando uma API-KEY que é fornecida pela equipe do
VendaAqui®App.
ERP com banco de dados local
Para ERP's com banco de dados local, disponibilizamos um cliente que é instalado no seu servidor e este se
responsabilizará por acessar os dados de forma local e após isso, enviar os dados para o VendaAqui®App. Para
mais informações sobre este método, entre em contato com a equipe do VendaAqui®App.
ERP com banco de dados com conexão externa
Para ERP com banco de dados com conexão externa, realizamos a integração através de um service
online que realizará a conexão e execução de um script sql retorno os dados no modelo de dado do produto
pré-definido.
- Normal
- O script será executado algumas vezes ao dia, inserindo todos os produtos na base de uma só vez.
- Sob-demanda
- O script será executado todas as vezes que existir um pedido para determinado produto, sendo
passado ao script por forma de parâmetros o código de barras e/ou
código interno.
API para integração
Para API's, a integração se dá utilizando um script de tradução onde é realizado o mapeamento dos campos do
produto, do ponto de venda para o modelo de dado do produto pré-definido. Todas as credenciais necessárias
para acesso a está API devem ser informadas à VendaAqui®App.
- Normal
- A API será executada algumas vezes ao dia retornando todos os produtos da base e/ou apenas os
atualizados e esses serão inseridos na base.
- Sob-demanda
- A API será executada todas as vezes que existir um pedido para determinado produto, sendo
passada a API por forma de parâmetros o código de barras e/ou código
interno.
Todos os dados de acesso assim como tipo de integração serão definidos entre a equipe do VendaAqui®App e o
ponto de venda, para viabilizar a melhor solução para cada caso.
Os scripts a serem utilizados nas integrações e também configurações de TI básicas para o funcionamento da
ferramenta podem ficar a cargo de nossa equipe. Por isso, não exite em nos perguntar:
suporte@vendaaquiapp.com.br
Manual de integração indústria
Para integração entre a marca e CompreAqui®App disponibilizamos dois modelos de planilhas, sendo uma para
pré-cadastro dos seus pontos de venda e outra para cadastro dos produtos. Essa integração pode ser automatizada
usando as formas de integração, utilizadas também para pontos de venda.
Definição dos modelos de dados
Dados do pré-cadastro ponto de venda
- CNPJ
- Nome Fantasia
- E-mail
- Telefone
- E-mail responsável
- Telefone responsável
- Endereço
- Rua
- Número
- Cep
- Bairro
- Cidade
- País
- Latitude (opcional)
- Longitude (opcional)
Ao pré-cadastrar um ponto de venda, o mesmo receberá um e-mail para finalização de cadastro. Todos os pontos
pré-cadastrados podem receber pedidos, mesmo não estando com cadastro finalizado, concluindo o cadastro após o
recebimento do pedido.
Dados do produto
- Código produto (Código do produto, utilizado internamente que auxilia na junção de produtos idênticos, mas
com múltiplos códigos de barras)
- Código de barra (Código de referência do produto no sistema interno, para produtos que não possuem código de
barras)
- Nome (Nome do produto)
- Descrição (Descrição do produto)
- Características (Tags que definem o produto)
- Receitas (Receitas que podem ser feitas com este produto, separadas por vírgula)
- Ingredientes (Ingredientes que compõe este produto)
- Alergênicas (Avisos sobre componentes do produto que podem gerar reação alérgica)
- Nutricional (Informações nutricionais do produto)
- Unidade (Tipo de unidade de medida do produto)
- Dimensões (Dimensões do produto L x A x P)
- Modo de usar (Instrução de como utilizar o produto)
- Rendimento (Rendimento do produto)
- Benefícios (Benefícios do produto em relação a outros produtos, separados por vírgula)
- Validade (Prazo de validade do produto em dias)
- Armazenamento (Instruções de armazenamento do produto)
- Concorrentes (Código de barras dos produtos concorrentes, separados por vírgula)
- Relacionados (Código de barras dos produtos relacionados, separados por vírgula)
- Landing Page (Link para a página do produto)
- Conteúdo (Página em Markdown este conteúdo será
disponibilizado em diversas plataformas)