Skip to main content
Categoria: Sistemas de estoque e ERP Integre o sistema de gestão vhsys ao Linqui para manter categorias, produtos, variações e estoque sincronizados automaticamente, e enviar os pedidos feitos no catálogo de volta para o vhsys.
Esta página cobre o que é feito do lado do Linqui. Para os passos de instalação do app na Loja de Integrações do vhsys e geração do token, veja a documentação oficial da vhsys.

​
Do lado do vhsys

Resumidamente, antes de configurar aqui no Linqui você precisa, dentro do painel do vhsys:
1

Instalar o app Linqui

Na Loja de Integrações do vhsys, busque por “Linqui” e instale o aplicativo.
2

Gerar o token de segurança

Na tela do app, dentro do vhsys, gere um novo token. Isso gera um Access-Token e um Secret-Access-Token.
3

Ativar o envio automático de informações

Depois de conectar a conta aqui no Linqui, volte ao vhsys e saia/entre novamente no painel. É isso que ativa o envio automático de atualizações de produtos e estoque para o Linqui.
Sem repetir o login no vhsys após conectar, as mudanças de produtos e estoque só ficam disponíveis via sincronização manual, não automática.

​
Do lado do Linqui

Acesse Integrações → vhsys e clique em Conectar (ou Gerenciar, se já estiver conectado).

​
1. Tokens de acesso

Cole o Token de acesso e o Token secreto gerados no vhsys e clique em Atualizar tokens. Tela de configuração da integração vhsys no Linqui: tokens, ativação e envio de pedidos

​
2. Ativar integração

O toggle Ativar integração controla tudo: quando desativado, as atualizações vindas do vhsys são ignoradas e nenhum dado é alterado no Linqui.

​
3. Envio de pedidos

Define como os pedidos feitos no Linqui voltam para o vhsys:
Sem a exigência de CPF/CNPJ ativada (em Configurações → Cadastro de clientes), os pedidos enviados não ficam vinculados ao cadastro do cliente no vhsys.

​
4. Atualização de produtos pelo vhsys

Escolha o que acontece quando um produto é atualizado no vhsys (produtos novos são sempre criados por completo):
Nome, descrição, preço, estoque, categoria, dimensões, imagens, atributos e variações são sobrescritos com os dados do vhsys a cada sincronização.
Qualquer edição feita diretamente em um produto pelo Linqui será resetada na próxima atualização vinda do vhsys, que sempre prevalece.

​
5. Sincronização manual e zona de perigo

Sincronização manual, o que é sincronizado e zona de perigo da integração vhsys Use Sincronizar categorias, Sincronizar produtos ou Sincronizar tudo para importar sob demanda, sem esperar o próximo webhook automático. A opção Importar produtos inativos também traz produtos com status inativo no vhsys (criados como desabilitados no Linqui).
  • Categorias e subcategorias: criação e atualização, mantendo a hierarquia (subcategoria como filha da categoria).
  • Produtos: cadastro, preço de venda, preço promocional, estoque, dimensões e categoria. A chave de mapeamento é o ID do produto no vhsys (e SKU como fallback).
  • Variações: grades de produto (cor, tamanho etc.) com preço e estoque próprios.
  • Estoque: alterações chegam via webhook de produto/variação e atualizam o saldo.
Clientes e vendas do vhsys não são importados. Apenas dados relacionados a produtos.
Em Zona de perigo, o botão Excluir dados sincronizados remove todos os dados que vieram do vhsys. Use com cuidado, essa ação não pode ser desfeita.