Olist no Konektor: conectar passo a passo

Guia feliz para conectar o Olist (ERP, também conhecido pelo histórico Tiny) à loja Interago pelo Konektor: onde gerar Client ID e Client Secret, como preencher o modal e o que fazer depois de autorizar. Foco no operador, sem tutorial de API.

Para quem é

Operador ou dono de loja que usa Olist ERP e quer alinhar catálogo, estoque e/ou pedidos com a Interago pelo Konektor.

Em uma frase

No Olist você cria um aplicativo (Configurações → Geral → Aplicativos), copia Client ID e Client Secret, cola na aba Acesso do Konektor, autoriza, escolhe o que sincronizar e Salva.

Antes de começar

1. Conta Olist ERP ativa, com permissão para Configurações / Aplicativos.
2. Extensão Gestão de Aplicativos disponível na conta (pré-requisito citado na ajuda Olist para API V3). Plano e liberação: confira no Olist; a partir do plano Construa, conforme a central de ajuda pública.
3. Konektor disponível na loja Interago e card Olist em Integrações.
4. Ritual de segurança lido: Konektor: pegar token e preencher Acesso com segurança.

Mapa: Konektor: mapa e quando usar (TagPlus, Olist, iTools Hub e API).

Fluxo Interago: Como conectar um sistema no Konektor.

Parte 1: onde pegar Client ID e Client Secret no Olist

A ajuda pública do Olist (Aplicativos API V3) descreve o caminho abaixo.

Passo a passo no ERP Olist

1. No Olist: menu → Configurações → aba Geral → Aplicativos.
2. Clique em + novo aplicativo (ou equivalente).
3. Preencha:
   * Nome do aplicativo: algo claro, por exemplo “Interago”.
   * URLs de Redirecionamento: a URL fornecida para a integração Interago / Konektor. fale com a equipe Interago o redirect URI exato do Interago.
4. Salve o aplicativo.
5. Abra de novo o aplicativo (editar / detalhes).
6. Na seção Chaves de acesso, copie Client ID e Client Secret.
7. Em Permissões do aplicativo, libere os módulos que a operação precisa (produtos, estoque, pedidos, contatos, etc.), com leitura e/ou incluir/editar conforme a regra. Depois de mudar permissões, a ajuda Olist recomenda gerar novas chaves e salvar de novo.

Atenção da própria Olist: Client ID/Secret dão acesso aos dados da conta. Não divulgue sem cuidado.

Fonte pública: central de ajuda Olist, artigo Aplicativos API V3 - Configurações e Utilização (ajuda.olist.com).

Limite útil para o operador

A ajuda pública cita no máximo 5 aplicativos por conta. Se a lista estiver cheia, exclua um app antigo não usado (com cuidado) ou fale com quem administra o ERP.

E o “Token API” (fluxo antigo / V2)?

Em alguns fluxos ainda existe a extensão Token API (menu Extensões / Configurações de e-commerce, conforme a documentação pública do ERP). Esse token é mais comum em integrações legadas.

No Konektor, prefira o que o modal pedir. Se a tela pedir Client ID e Client Secret + Autorizar, use o caminho de Aplicativos (V3). Só use Token API se o modal do seu site pedir chave/token nesse formato. fale com a equipe Interago se a tela misturar os dois.

Parte 2: preencher o modal no Interago

1. Extensões → Konektor → Integrações.
2. Localize Olist → Conectar ou Configurar.
3. Aba Acesso: cole Client ID e Client Secret.
4. Clique em Autorizar acesso (se aparecer).
5. Na tela do Olist / accounts, faça login se pedido e aprove o acesso do aplicativo.
6. Volte ao Konektor e confira se ficou autorizado.

Aba Configurações

Ajuste o que a tela oferecer (ex.: depósito, comportamentos). Em dúvida de campo, fale com a equipe Interago em vez de chutar.

Aba O que sincronizar

Opção	Ideia prática
Catálogo / produtos	Coletar do Olist e/ou enviar da loja
Estoque	Saldo alinhado (produtos vinculados)
Pedidos	Pedidos da vitrine indo ao ERP (e o que a tela descrever no sentido inverso)
Clientes	Fluxo de clientes conforme a opção

Estoque e pedidos não “adivinham” produto novo só cadastrado no Olist: precisa de vínculo / coleta / envio conforme o ritual do artigo 05.

Abas Webhook e Situação

• Webhook: só mude se a equipe pedir. fale com a equipe Interago se a tela exigir URL.
• Situação: use depois de salvar para ver saúde da conexão e eventos.

Parte 3: Salvar e primeiras ações

1. Salvar.
2. Sincronizar agora.
3. Coletar produtos do Olist se a origem do catálogo for o Olist.
4. Enviar produtos se a origem for a Interago.
5. Teste com um produto: vincule, confira estoque, faça um pedido de teste se possível. Se a loja vende produtos com variações, inclua um deles no teste (veja a Parte 4).

Salvar no Konektor não exige Atualizar páginas da loja. Atualize o catálogo quando a vitrine precisar refletir mudança de produto/estoque.

Validade do acesso (contexto público)

Documentação pública do Olist ERP (OAuth): access token cerca de 4 horas; refresh cerca de 1 dia. Se a Situação falhar por autenticação, reabra Acesso e Autorize de novo. Você não precisa “ficar renovando token na mão” a cada venda se a integração estiver saudável.

Parte 4: produtos com variações (voltagem, tamanho, cor)

Boa notícia para quem vende o mesmo produto em várias versões: o Konektor entende as variações do Olist e liga cada uma à opção de variação certa da loja. O segredo é o SKU: a variação no Olist e a opção final na loja precisam ter exatamente o mesmo código.

Antes de coletar

1. Cadastre na loja o produto com as opções (por exemplo 110V e 220V, ou P, M e G).
2. Dê a cada opção final o mesmo SKU da variação correspondente no Olist.
3. Confira se não existe na loja um produto simples com o SKU de uma variação. Se existir, ele tem prioridade e o vínculo vai para ele, não para a opção.

A coleta não monta a grade sozinha: ela liga o que já existe na loja. E uma variação do Olist nunca vira produto avulso. Se nenhuma opção tiver o mesmo SKU, nada é criado e os eventos da integração explicam o que ajustar.

Como a coleta vincula

• Abra Coletar produtos do Olist (bloco Ações manuais). Na coluna No Interago?, o item que bate com uma opção aparece como ✅ Opção de variação (sincronizar).
• Coletar o produto pai vincula todas as variações dele de uma vez. Também dá para coletar uma variação sozinha.
• Depois da coleta, a coluna Situação mostra o selo Vinculado à opção.

Estoque e pedidos por opção

• Estoque: o saldo vai e volta por opção. Vendeu a versão 220V, só ela muda de quantidade, nos dois lados. Grades grandes são enviadas em partes.
• Pedidos: o pedido chega ao Olist com a variação que o cliente escolheu. Opção sem SKU segue pelo produto pai.
• Se a opção comprada não existe mais na loja ou está incompleta, o envio daquele pedido falha em vez de seguir com o produto pai (assim o estoque da versão errada não é baixado). A falha aparece nos eventos da aba Situação. O passo a passo para resolver está em Konektor: checklist e problemas comuns.
• Se o catálogo da loja estiver indisponível por um instante, o envio volta para a fila e tenta de novo sozinho.
• No Enviar produtos, um produto com variações da loja não é criado no Olist como produto simples. Cadastre a grade no Olist com os mesmos SKUs e use a coleta para vincular.

Excluir produto vinculado e desvincular

Na lista do Coletar produtos do Olist existe o botão Desvincular selecionados. Use quando um vínculo estiver errado e você quiser refazer o par com calma.

Excluir na loja ficou mais tranquilo: no Olist, a exclusão de um produto vinculado só desfaz o vínculo. O cadastro no Olist continua como está, sem inativação automática. Se quiser inativar o item no ERP, faça isso direto no Olist. O mesmo vale para opções de variação que deixam de existir na loja: o Konektor remove esses vínculos sozinho.

E quando o produto vinculado some do Olist (foi excluído ou cadastrado de novo por lá), o Konektor procura o item pelo SKU e refaz o vínculo sem clique extra. Se não achar nenhum produto com aquele SKU no Olist, ou se o produto da loja estiver sem SKU, o vínculo antigo é removido e os eventos da aba Situação explicam o que fazer: cadastrar o item no Olist ou usar Enviar produtos.

1. Marque os produtos vinculados na lista.
2. Clique em Desvincular selecionados.
3. Confirme. O painel lembra que o cadastro no ERP não muda e que estoque e pedidos deixam de usar esse vínculo até uma nova coleta.

Desvincular o produto pai não solta as variações sozinho: marque também cada linha de variação que quiser desvincular.

Se nenhum produto vinculado estiver marcado, aparece o aviso “Selecione ao menos um produto vinculado.”.

Antes desta melhoria, a coleta podia criar produtos avulsos com o SKU de cada variação. Se isso aconteceu na sua loja, veja o item sobre variações que viraram produtos avulsos em Konektor: checklist e problemas comuns.

Checklist Olist (primeira conexão)

1. Gestão de Aplicativos liberada / plano adequado no Olist.
2. Novo aplicativo criado com nome claro.
3. URL de redirecionamento conferida. fale com a equipe Interago
4. Client ID e Client Secret copiados das Chaves de acesso.
5. Permissões de módulos alinhadas (produtos, estoque, pedidos…).
6. Konektor → Olist → Acesso preenchido e autorizado.
7. O que sincronizar marcado com a regra da loja.
8. Salvar → Sincronizar agora → Coletar ou Enviar.
9. Produto de teste vinculado e Situação ok.
10. Produtos com variações: cada opção da loja com o mesmo SKU da variação no Olist e selo Vinculado à opção depois da coleta.
11. Vai excluir na loja um produto vinculado? No Olist a exclusão só desfaz o vínculo e o cadastro no ERP fica como está. Para soltar um vínculo errado sem excluir, use Desvincular selecionados (marque o pai e cada variação).

O que este artigo não cobre

• Rate limit por plano, endpoints ou Postman.
• Integração Olist E-commerce ↔ Olist ERP (outro fluxo da própria Olist).
• iTools Hub / Bling.
• Detalhe Coletar × Enviar e a lista de coleta (artigo 05) e estoque/pedidos (artigo 06).

Artigos relacionados

• Como conectar um sistema no Konektor
• Konektor: pegar token e preencher Acesso com segurança
• TagPlus no Konektor: conectar passo a passo
• Konektor: sincronizar produtos (coletar do ERP e enviar da loja)
• Konektor: estoque e pedidos no dia a dia
• Konektor: checklist e problemas comuns