Conectando o Linx Microvix

A conexão com o Linx Microvix é feita por credenciais: a chave do WebService de Saída, que a Linx entrega ao cliente na contratação do serviço, e opcionalmente o número do Portal.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• A chave do WebService de Saída é entregue pela Linx quando a empresa contrata o serviço com o gerente de relacionamento — ela não fica no painel do Microvix.
• Se a empresa ainda não contratou o WebService de Saída, fale com o gerente de relacionamento da Linx. As condições e prazos de ativação, confirme na documentação oficial da Linx.
• Tenha em mãos o número do Portal, se a Linx o informou — o campo é opcional.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Linx Microvix e clique no botão de conexão.
3. Preencha os campos:
   • Chave do WebService — a chave do WebService de Saída entregue pela Linx.
   • Número do Portal — opcional, apenas dígitos, se a Linx o informou.
4. Salve. O card fica marcado como conectado e a Toca já consegue consultar o ERP.

O que a Toca acessa

Com a conexão ativa, a Toca lê vendas e movimento das lojas físicas, notas, produtos com saldo e preço, clientes e faturas a receber e a pagar do Microvix. O WebService de Saída apenas exporta dados, então o acesso é somente de leitura: a Toca não altera nada no seu ERP. Conectar o Linx Microvix não desativa a integração da sua loja virtual ou marketplace — as conexões convivem, e a Toca cruza os dados do ERP com os da loja.

Manutenção da conexão

A chave não expira sozinha, mas a Linx pode desativá-la sem aviso prévio se considerar o consumo indevido — por isso a Toca consulta em janelas curtas e faz uma chamada por vez. Se a chave for desativada ou trocada, fale com o gerente de relacionamento da Linx e atualize o campo pelo mesmo card em Configurações → Integrações.

Problemas comuns

• Não encontro a chave no painel do Microvix — ela não fica lá: é entregue pela Linx na contratação do WebService de Saída. Peça ao gerente de relacionamento.
• A chave parou de funcionar — a Linx pode desativar a chave por consumo considerado indevido. Fale com o gerente de relacionamento da Linx.
• Os números parecem de uma loja só — cada consulta é feita loja a loja, pelo CNPJ. Para a rede inteira, a Toca soma loja por loja, o que leva mais tempo.
• Consultas voltam vazias — no Microvix GO, versão reduzida do ERP, alguns métodos retornam vazios. Confirme na documentação oficial da Linx o que a sua versão expõe.