Integração Olist (Tiny)
Espelha clientes, fornecedores, peças e estoque entre o EOS e a sua conta Olist (Tiny), nos dois sentidos: o que você cadastra aqui aparece lá, e o que é cadastrado lá aparece aqui.
A integração está em Configurações › Integrações › Olist e faz parte do plano — não há custo adicional.
Requer a permissão "Editar dados da empresa e usuários".
O que é espelhado
| Aqui | No Olist | Observação |
|---|---|---|
| Clientes | Contatos do tipo Cliente | Nome, documento, telefone, e-mail e endereço |
| Fornecedores | Contatos do tipo Fornecedor | O mesmo contato pode ser cliente e fornecedor lá e aqui |
| Peças | Produtos | Código, descrição e dados do cadastro |
| Estoque | Saldo e depósitos | Os depósitos do Olist viram locais de estoque aqui |
| — | Produtos "de venda" | O EOS trabalha com peças; o catálogo de produtos do Olist chega como peça |
Sobre o estoque, vale entender a regra: cada lado informa a sua própria movimentação (entrada ou saída), em vez de empurrar o saldo cheio. Assim uma venda registrada no Olist não é apagada por uma edição feita aqui. Periodicamente o sistema também confere o saldo do Olist e o adota como correto, já que ele é o sistema fiscal da operação.
Ligando a integração
O recurso nasce desligado. Para colocá-lo no ar:
- Abra Configurações › Integrações e clique no cartão Olist (Tiny).
- Ligue a chave Recurso ativo e clique em Salvar.
- No Olist, em Aplicativos, crie um app e copie o Client ID e o Client Secret — eles são da sua conta.
- Volte ao EOS, preencha os dois campos e clique em Salvar.
- Clique em Conectar ao Olist e autorize o acesso na tela do Olist.
- Clique em Testar conexão — a resposta lista os depósitos da sua conta, o que confirma que está tudo certo.
A URL de redirecionamento mostrada na tela deve ser cadastrada, exatamente como aparece, no app criado no Olist. Qualquer diferença — inclusive uma barra a mais no fim — impede a conexão.
Credenciais e limite
| Campo | Para que serve |
|---|---|
| Client ID | Identifica o app da sua conta Olist. Trocá-lo encerra a autorização em vigor: será preciso conectar de novo |
| Client Secret | Guardado de forma cifrada e nunca exibido de volta. Deixe em branco ao salvar para manter o atual |
| Limite de requisições por minuto | O ritmo da sincronização, conforme o seu plano Olist: 30 (Construa/Crescer), 60 (Evoluir/Impulsione), 120 (Domine) ou 140 (Protagonize) |
| URL de redirecionamento | Só para consulta — é o endereço que deve estar cadastrado no app do Olist |
O limite é da sua conta Olist e é dividido com os outros aplicativos que você usa nela. Informar menos do que o plano permite só deixa a sincronização mais lenta; informar mais faz o Olist recusar as chamadas.
Conexão
O bloco Conexão mostra a situação atual (conectada, com erro, aguardando) e, quando houver, a última falha. Os botões disponíveis:
| Botão | O que faz |
|---|---|
| Testar conexão | Consulta os depósitos da conta e confirma que a autorização está válida |
| Reconectar | Refaz a autorização no Olist (necessário se as credenciais mudarem ou a autorização expirar) |
| Desconectar | Para a sincronização. Não apaga nada: credenciais e vínculos são mantidos |
Fila de sincronização
Não existe botão de "sincronizar agora": o sistema mantém uma fila e trabalha nela continuamente, no ritmo do limite informado. O quadro na página mostra:
| Indicador | O que mostra |
|---|---|
| Na fila | Quanto falta processar, com uma estimativa de tempo no limite atual |
| Concluídos | Itens já sincronizados |
| Com erro | Itens que não passaram — clique para abrir as Pendências |
| Divergências | Registros alterados nos dois lados — clique para abrir as Pendências |
Abaixo do quadro aparece a data da última sincronização.
A primeira carga demora
Na primeira vez, o sistema precisa ler todo o cadastro da sua conta Olist, um registro por vez — é uma exigência da API do Olist. Uma conta com poucos milhares de contatos e produtos pode levar algumas horas no limite de 30 requisições por minuto, e menos de uma hora no limite de 140.
Combine a primeira carga para a noite ou para um fim de semana, e conte que os cadastros vão aparecer aos poucos — não de uma vez.
Pendências
A tela Pendências da Integração Olist (pelo link nos contadores) reúne os casos que precisam de decisão sua. São dois blocos.
Não foram sincronizados
Itens que a sincronização tentou 5 vezes e desistiu. A tabela mostra o registro, o sentido (se ia daqui para lá ou de lá para cá) e o motivo da falha.
| Ação | O que faz |
|---|---|
| Tentar de novo | Devolve o item para a fila; a próxima sincronização tenta outra vez |
| Tentar todos de novo | O mesmo, para a lista inteira |
| Descartar | Remove o item da fila. A alteração não será enviada ao Olist |
Resolva primeiro a causa apontada no motivo (um campo obrigatório em branco, por exemplo) e só então mande tentar de novo.
Alterados nos dois lados
O mesmo registro mudou aqui e no Olist entre uma sincronização e outra. Nesse caso a alteração mais recente já prevaleceu — nada foi perdido sem critério —, e o caso fica listado para conferência.
| Ação | O que faz |
|---|---|
| A daqui | A versão do EOS passa a valer e é enviada ao Olist |
| A do Olist | A versão do Olist passa a valer e é trazida para cá |
Desligando
Desligar a chave para a sincronização na hora. Nada é apagado: credenciais, autorização e o vínculo dos registros com o Olist continuam guardados, e religar retoma de onde parou, sem duplicar cadastro.
Perguntas comuns
Preciso pagar algo a mais? Não. As integrações fazem parte do plano.
Os cadastros vão duplicar? Não. Cada registro fica vinculado ao seu par no Olist; religar ou reconectar não cria cópias.
Cadastrei uma peça aqui e ela não apareceu lá. Verifique a fila: com volume grande, o item pode estar aguardando a vez. Se ele estiver em Pendências › Não foram sincronizados, o motivo da falha está na própria linha.
A sincronização está lenta. O ritmo é o limite de requisições da sua conta Olist. Confira se o valor informado corresponde ao seu plano e lembre que ele é dividido com os outros aplicativos ligados na mesma conta.
Conceitos relacionados
- Integrações — a vitrine e as regras comuns a todas as integrações.
- Clientes, Financeiro/Fornecedores, Cadastros/Peças, Suprimentos/Controle Estoque e Suprimentos/Local de Estoque — os cadastros espelhados.
- Meu Plano — as integrações aparecem em Incluído no plano.