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.

---

| 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.

---

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.

| 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 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 |

---

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**.

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.

---

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.

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 |

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á |

---

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**.

---

**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.

---

- [[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*.