Commit fcda32
2026-09-02 15:03:55 Felipe Madril: -/-| /dev/null .. integrações/olist.md | |
| @@ 0,0 1,133 @@ | |
| + | # 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*. |