Bigbot + Bling Integração

Conexão OAuth segura

Primeira etapa: somente leitura.

Este app prepara a autorização OAuth do Bling e testa uma consulta GET de contas a pagar limitada a um registro. Nenhum lançamento é criado, alterado ou excluído.

Conectar com o Bling Testar conexão

As duas ações pedem usuário e senha administrativos. Use somente depois de confirmar que o HTTPS está válido.

Teste de conexão 
GET /Api/v3/contas/pagar?pagina=1&limite=1

A resposta é descartada.
Somente o resultado da conexão é exibido.

Nenhum registro do ERP é mostrado nesta página.

Antes de autorizar

Confirme o certificado HTTPS e a URL de callback cadastrada no app do Bling.

  1. 1. Verifique o HTTPS

    Abra /bling/health. O resultado esperado é {"ok":true}, sem alerta de certificado no navegador.

  2. 2. Inicie a autorização

    Abra /bling/connect. O servidor gera um state aleatório novo e valida o retorno do Bling.

  3. 3. Faça o teste

    Depois do retorno OAuth, abra /bling/test. O app mostra apenas se a conexão funcionou.

Segurança

O Client Secret fica somente nas variáveis de ambiente da Hostinger. Os tokens são cifrados antes de serem guardados no MySQL. O navegador nunca recebe tokens.

Callback configurado: https://integracoes.bigbot.com.br/bling/callback.

Se o HTTPS ou a rota ainda não estiverem prontos, não inicie a autorização.

Dúvidas comuns

O app altera dados do Bling?

Não. Nesta etapa há apenas uma chamada GET de leitura. Não foram implementadas rotas para criar, alterar ou excluir lançamentos.

O que devo fazer se o HTTPS falhar?

Não autorize ainda. Resolva o domínio e o certificado SSL na Hostinger e confirme novamente em /bling/health.

O que acontece se o token expirar?

O servidor tenta renová-lo com o refresh token e atualiza a cópia cifrada. Se a renovação não for mais válida, será necessário autorizar novamente.