A conexão com a Olist Commerce (plataforma de e-commerce da Olist, antiga Vnda) é feita por um token de API gerado no painel admin da loja, junto com o domínio da loja. Nenhuma senha de usuário é usada.
Antes de começar
- Tenha acesso de administrador ao painel admin da sua loja Olist Commerce.
- Gere (ou localize) o token de API no painel admin da loja. Para o caminho exato do menu onde o token fica, confirme na documentação oficial da Olist Commerce.
- Saiba o domínio da loja — o mesmo endereço que você usa para acessar a loja
(ex.:
www.sualoja.com.br). - Use as credenciais do ambiente de produção: o ambiente de staging da plataforma tem token e endereço próprios e não é consultado pela Toca.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Olist Commerce e clique no botão de conexão.
- Preencha os dois campos:
- token — o token de API gerado no painel admin da loja.
- shopHost — o domínio da loja (ex.:
www.sualoja.com.br). Colar a URL inteira do navegador também funciona.
- 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 Olist Commerce, além de produtos, estoque por variante e por depósito, clientes, carrinhos e cupons. A integração é somente de leitura: a Toca não altera nada na sua loja.
Manutenção da conexão
O token da Olist Commerce não expira: a conexão permanece ativa até você revogar o
token no painel da loja ou desconectar a integração na Toca. Se o token for revogado na
plataforma, 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 se o token foi colado inteiro, sem espaços extras, e se é o token do ambiente de produção (não o de staging).
- Loja não identificada nas consultas — o campo shopHost precisa ser o domínio
pelo qual a loja é acessada (ex.:
www.sualoja.com.br). É ele que identifica a sua loja na API da Olist. - Consultas retornam vazio — confirme se o domínio informado é o da loja certa; token e domínio precisam pertencer à mesma loja.