Integração com Tiny / Olist

Este documento orienta como habilitar a conexão entre o Binno WMS e o Tiny ERP (plataforma Olist) utilizando autenticação OAuth.

A integração permite sincronizar pedidos e produtos automaticamente entre os dois sistemas.

Pré-requisitos

Antes de iniciar, certifique-se de que você possui:

1. Uma conta ativa no Binno WMS com perfil de Administrador ou Configuração.
2. Acesso ao painel de desenvolvedor do Olist em erp.olist.com/aplicativos_api.
3. Um aplicativo criado (ou a ser criado) no painel do Olist com as credenciais Client ID e Client Secret.

---

Parte 1 — Configurar o Aplicativo no Olist

Esta etapa é feita uma única vez no painel do Olist para registrar o Binno como aplicativo autorizado.

1. Acesse o painel de aplicativos

No Olist, vá em Configurações → API → Meus Aplicativos ou acesse diretamente:

https://erp.olist.com/aplicativos_api

2. Crie ou edite seu aplicativo

Clique em Novo Aplicativo ou edite um existente.

3. Configure a URL de Redirecionamento

Este é o passo mais importante. No campo URL de Redirecionamento (ou Redirect URL), insira exatamente o seguinte valor:

https://binno.app.br/api/integrations/tiny/callback

Atenção

A URL de redirecionamento deve ser inserida exatamente como mostrado acima — incluindo o caminho completo /api/integrations/tiny/callback. Inserir apenas https://binno.app.br/ causará o erro “Invalid Parameter: redirect_url” ao tentar autorizar.

4. Configure as Permissões do Aplicativo

O Binno precisa de acesso a determinados módulos do Olist para funcionar corretamente. Na seção de Permissões (ou Escopos) do seu aplicativo, habilite os seguintes módulos:

Módulo	Por que é necessário
Produtos	Importar catálogo de produtos e sincronizar estoque
Pedidos	Importar e atualizar pedidos de venda
Estoque / Depósitos	Mapear locais de armazenamento e atualizar saldos
Notas Fiscais	Gerar NF-e a partir de pedidos expedidos
Contatos	Buscar endereço de entrega dos clientes
Separação	Consultar separações vinculadas a pedidos
Expedição	Obter etiquetas de envio

Permissão de Depósitos obrigatória

Sem a permissão de Estoque / Depósitos habilitada, a tela de mapeamento de locais de estoque no Binno não conseguirá listar os depósitos cadastrados no Olist. O Binno tentará um método alternativo de descoberta, mas o resultado pode ser incompleto.

Onde configurar

As permissões são definidas no painel do Olist em Meus Aplicativos → [seu app] → Permissões. Não são parâmetros enviados durante o OAuth — precisam estar configuradas previamente no aplicativo.

5. Salve as credenciais

Após salvar o aplicativo, copie o Client ID e o Client Secret gerados — você vai precisar deles na próxima etapa.

---

Parte 2 — Conectar no Binno

1. Acesse a Área de Integrações

No painel do Binno (binno.app.br), navegue pelo menu lateral:

1. Localize a seção Sistema.
2. Clique em Integrações.

2. Selecione o Módulo Tiny / Olist

Na tela de integrações, localize o card Tiny / Olist e clique em Gerenciar.

3. Insira as Credenciais

Preencha os campos com os dados obtidos no painel do Olist:

• Client ID — identificador do seu aplicativo
• Client Secret — chave secreta do seu aplicativo

Clique em Salvar antes de prosseguir.

4. Autorize a Conexão

Com as credenciais salvas, clique em Conectar agora. Você será redirecionado para a tela de login do Olist.

1. Informe suas credenciais do Tiny/Olist caso não esteja logado.
2. Autorize o acesso solicitado pelo Binno.
3. Você será redirecionado de volta ao Binno automaticamente com a integração ativa.

---

Importando seus Produtos

Com a conexão estabelecida, importe seu catálogo de produtos:

1. No card do Tiny / Olist, localize a área Sincronização de Produtos.
2. Marque Sobrescrever apenas se quiser que os dados do Tiny substituam os já cadastrados no Binno.
3. Clique em Sincronizar Produtos e aguarde a conclusão.

Ao final, seus produtos estarão disponíveis na tela de Lista de Produtos.

---

Solução de Problemas

Erro	Causa provável	Solução
Invalid Parameter: redirect_url	URL de redirecionamento incorreta no painel do Olist	Confirme que o campo está preenchido com https://binno.app.br/api/integrations/tiny/callback
Client ID inválido	Credenciais não salvas antes de clicar em Conectar	Salve o Client ID e o Client Secret antes de iniciar o OAuth
Redirecionado mas sem conexão ativa	Client Secret incorreto ou expirado	Revise o Client Secret no painel do Olist e atualize no Binno
Locais de estoque não aparecem	Permissão de Depósitos não habilitada no app Olist	Acesse o painel do app no Olist, habilite o módulo “Estoque / Depósitos” e reconecte
Erro 403 ao buscar depósitos	App sem permissão para o endpoint /depositos	Igual ao item acima — habilite a permissão de Depósitos no painel do Olist
Produtos não importam	Permissão de Produtos não habilitada no app Olist	Habilite o módulo “Produtos” nas permissões do aplicativo
Pedidos não sincronizam	Permissão de Pedidos não habilitada no app Olist	Habilite o módulo “Pedidos” nas permissões do aplicativo

---

Dúvidas

Em caso de dúvidas, entre em contato com nosso time pelo e-mail suporte@binno.app.br.