# 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: 1. Abra **Configurações › Integrações** e clique no cartão **Olist (Tiny)**. 2. Ligue a chave **Recurso ativo** e clique em **Salvar**. 3. No Olist, em **Aplicativos**, crie um app e copie o **Client ID** e o **Client Secret** — eles são da **sua** conta. 4. Volte ao EOS, preencha os dois campos e clique em **Salvar**. 5. Clique em **Conectar ao Olist** e autorize o acesso na tela do Olist. 6. 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*.