A conexão com a Linx Commerce é feita com o domínio da loja e as credenciais do usuário de integração fornecidas pela Linx — não é a sua senha de acesso ao painel.
Antes de começar
- Tenha em mãos o domínio da sua loja na Layer: pode ser só o subdomínio
(ex.:
minhaloja) ou a URL completa do ambiente (ex.:https://minhaloja.layer.core.dcg.com.br/) — os dois formatos são aceitos. - Tenha o usuário e a senha de integração fornecidos pela Linx para a sua loja. Se você não os recebeu, solicite ao suporte da Linx.
- Não confunda com outros produtos "Linx" (como o Microvix, que é ERP): a integração da Toca é com a plataforma de loja virtual Linx Commerce (Layer/CORE).
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Linx Commerce e clique no botão de conexão.
- Preencha os três campos:
- domain — o domínio da loja (ex.:
minhaloja) ou a URL completa da Layer. - user — o usuário de integração fornecido pela Linx.
- password — a senha desse usuário de integração.
- domain — o domínio da loja (ex.:
- Salve. O card fica marcado como conectado e a Toca já consegue consultar a loja.
O que a Toca acessa
Com a conexão ativa, a Toca lê vendas, pedidos e faturamento da loja Linx Commerce (Layer/CORE), o catálogo de produtos e categorias, e os clientes. A integração é somente de leitura: a Toca não altera nada na sua loja Linx.
Manutenção da conexão
As credenciais do usuário de integração não expiram sozinhas: a conexão permanece ativa
até a senha ser alterada ou o usuário ser desativado do lado da Linx, ou até você
desconectar a integração na Toca. Se a credencial deixar de valer, o card em
Configurações → Integrações passa a indicar que a conexão precisa ser refeita.
Problemas comuns
- Erro de autenticação logo após conectar — confira usuário e senha (são as credenciais de integração fornecidas pela Linx, não o seu login do painel) e se foram colados sem espaços extras.
- Domínio não encontrado — o campo domain aceita o subdomínio puro
(ex.:
minhaloja) ou a URL completa da Layer. Confira a grafia; a URL da vitrine da loja (o site que o cliente acessa) não é necessariamente o domínio da Layer. - Consultas retornam vazio com dados existentes na loja — alguns métodos da API podem estar desativados para o usuário de integração. Confirme com a Linx quais permissões de leitura o usuário possui.