A conexão com o Bling é feita pelo login da sua própria conta (OAuth): você é direcionado ao Bling, autoriza o acesso e volta à Toca. Nenhuma chave é digitada à mão.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- Tenha acesso a uma conta Bling com permissão para autorizar aplicativos — em geral, o administrador da conta.
- Deixe o acesso ao Bling à mão: a autorização acontece na tela do próprio Bling.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Bling e clique no botão de conexão.
- Você será direcionado ao Bling: entre com a sua conta e autorize o acesso solicitado.
- De volta à Toca, o card fica marcado como conectado e a Toca já consegue consultar o ERP.
O que a Toca acessa
Com a conexão ativa, a Toca lê pedidos de venda, notas fiscais, contas a pagar e a receber, produtos, estoque e depósitos, e contatos do Bling. O acesso é somente de leitura: a Toca não altera dados na sua conta. Conectar o Bling não desativa a integração da sua loja virtual ou marketplace — as conexões convivem, e a Toca cruza os dados do ERP com os da loja.
Manutenção da conexão
A Toca renova a autorização automaticamente. Se o acesso for revogado no Bling — por
exemplo, ao remover o aplicativo da conta —, refaça a conexão pelo mesmo card em
Configurações → Integrações. Para os prazos de validade da autorização, confirme na
documentação oficial do Bling.
Problemas comuns
- A autorização não conclui — o Bling exige homologação de aplicativos públicos; enquanto ela não é concluída, apenas contas liberadas no aplicativo conseguem autorizar. Se a autorização não concluir para a sua conta, fale com o suporte da Toca.
- Consultas parecem lentas ou esbarram em limite — o limite do Bling vale para a conta inteira (3 requisições por segundo e 120.000 por dia), somando todos os aplicativos instalados nela. Por isso a Toca faz uma chamada por vez.
- Períodos longos retornam erro — o Bling recusa filtros de período acima de 1 ano. Peça a consulta em janelas de até 12 meses.