Tutorial ERP Bling - Nova Versão

Este tutorial vale para o app Bling ERP V2 (integração com a API v3 do Bling).

Vídeo tutorial nesse link

Importante: para utilizar o novo aplicativo do Bling, primeiro desinstale a versão anterior. Isso garante uma instalação correta e o melhor funcionamento da nova versão.

Tutorial de configuração

Antes de começar a configuração no Bling, instale o aplicativo Bling ERP V2 na plataforma da E-Com Plus pelo seguinte link.

1. Criar aplicativo no Bling

Clique no ícone da Central de Extensões do Bling

Em seguida, vá para a Área do Integrador

Clique em “Criar Novo Aplicativo”

Deixe as opções abaixo selecionadas e clique em “Próximo”

Preencha os campos obrigatórios

Configure o redirecionamento

Utilize o link abaixo e substitua SEU_STORE_ID_AQUI pelo número exibido no seu painel administrativo da E-Com Plus:

https://us-central1-ecom-bling-v2.cloudfunctions.net/app/bling/authentication?store_id=SEU_STORE_ID_AQUI

Onde encontrar meu Store ID?

  • Acesse seu painel administrativo.
  • Na página inicial, você verá o número do Store ID, conforme mostrado na imagem abaixo.

2. Selecionar escopos necessários

Como selecionar os escopos?

Na Lista de Escopos, selecione as opções abaixo:

Lista de escopos necessários

  1. Campos Customizados
    • Clientes e Fornecedores
    • Produtos
  2. Categoria de Produtos
    • Gerenciar Categorias de Produtos
  3. Clientes e Fornecedores
    • Gerenciar Contatos
  4. Controle de Estoque
    • Controle avançado de estoque: Inserção de Estoque
    • Controle avançado de estoque: Edição e exclusão de Estoque
  5. Gerenciador de Transições
  6. Integrações Logísticas
  7. Integrações e Lojas Virtuais
  8. Notas Fiscais
  9. Pedidos de Venda
    • Gerenciar Pedidos de Venda
    • Gerenciar situações dos Pedidos de Venda
  10. Produtos
    • Gerenciar Produtos
    • Salvar imagens dos Produtos
    • Salvar variações de Produtos

Preencha as informações de contato

Coloque suas próprias informações de contato e prossiga.

Após salvar, você verá a opção Informações do app no menu lateral

Nas informações do app, copie o client_id e o client_secret

  • No painel da E-Com Plus, abra Aplicativos > Bling ERP V2.
  • Cole o client_id no campo Client id e o client_secret no campo Client secret.
  • Salve as configurações (esse passo é essencial para o funcionamento do app).

Depois de salvar no app da E-Com Plus, copie o link de convite no Bling

  • Copie o Link de convite abaixo, cole em outra aba do seu navegador e autorize o aplicativo.

Você verá uma tela assim:

Autorize, faça login no seu painel normalmente e continue com as configurações do app.

3. Habilitar callback (webhook) do Bling

Para habilitar os callbacks do Bling, é necessário adicionar um aplicativo no painel do Bling pela Central de Extensões:

  1. Clique no ícone da Central de Extensões (o mesmo do passo 1).
  2. No campo de pesquisa, procure por API e clique sobre a integração para incluir.
  3. Coloque o Nome do Canal de Venda. Exemplo: e-com plus

  1. No canto esquerdo, clique em Callbacks.
  2. No campo Tipo de retorno no callback, selecione JSON (urlencoded).
  3. Ative callback de estoque e callback de pedidos de venda.

  1. Para as URLs de callback, coloque a mesma para estoque e pedidos:
  • URL para os callbacks: https://us-central1-ecom-bling-v2.cloudfunctions.net/app/bling/callback?store_id=SEU_STORE_ID_AQUI

Onde estiver SEU_STORE_ID_AQUI, utilize o mesmo Store ID usado no passo 1.

Depois é só salvar.

Depois de configurar

Problemas comuns

Persistindo, abra um ticket informando o Store ID, o SKU do produto ou o número do pedido e um print do registro no Logs do app.