Conectar o Bling (bonificação)

Crie o app privado no Bling, marque os escopos certos (com as subopções Gerenciar), conecte e escolha a natureza de bonificação.

Atualizado em 09/11/2026Só o dono da marca

Com o Bling conectado, os kits de Recebidos viram pedidos de venda no seu Bling com a natureza de bonificação que você escolher. Depois que você fatura e despacha por lá, o número da nota e o rastreio voltam sozinhos para o Hub.

A conexão usa um app privado da própria marca, criado na sua conta Bling. Só o dono da marca pode conectar.

Passo a passo#

  1. Vá em Configurações › Loja, desça até ERP para Recebidos e clique em Conectar Bling.
  2. Entre em developer.bling.com.br com a conta Bling da marca e crie um aplicativo (Área do integrador › Cadastro de aplicativos), do tipo privado.
  3. Em Link de redirecionamento, cole o endereço que aparece no card do Hub (termina em /api/bling/callback).
  4. Em Escopos, marque os itens da lista abaixo. Atenção às subopções Gerenciar.
  5. Salve o app no Bling e copie o Client Id e o Client Secret dele para o card do Hub. Clique em Salvar app.
  6. Clique em Conectar Bling, entre na conta Bling da marca e autorize o acesso.
  7. De volta ao Hub, em Natureza de bonificação, clique em Escolher, selecione a natureza (em geral "Remessa em bonificação") e clique em Salvar.

Os escopos do app#

EscopoO que marcar
Pedidos de VendaA caixa principal e a subopção "Gerenciar Pedidos de Venda"
Clientes e FornecedoresA caixa principal e a subopção "Gerenciar Contatos"
ProdutosSó a caixa principal
Notas Fiscais (NF-e)Só a caixa principal
Visualizar os dados básicos da empresaSó a caixa principal
Naturezas de OperaçãoSó a caixa principal, se aparecer na lista

A natureza de bonificação#

É a natureza de operação do seu Bling usada em todos os itens dos kits. Ela define o CFOP (em geral 5.910 no mesmo estado, 6.910 para outro estado) e os tributos da nota. Sem ela, aparece "Nenhuma escolhida: os kits não podem ser enviados."

Se o Bling não deixar o Hub listar as naturezas, aparece um campo para digitar o número dela. No Bling, abra Cadastros › Naturezas de operação, clique na natureza e copie o número que aparece no fim do endereço da página.

Como o pedido chega no Bling#

  • Os produtos são encontrados pelo SKU (código do produto no Bling igual ao SKU da loja).
  • A pessoa é cadastrada como contato pelo CPF (ou reaproveitada, se já existir).
  • O pedido leva a referência do kit (KIT-XXXXXX) e, nas observações, "Remessa em bonificação - envio de produtos para divulgação". Se um pedido com essa referência já existe, o Hub reaproveita e não cria outro.

Para conferir antes, selecione kits em Recebidos e clique em Simular. Veja rastreio e status.

Erros comuns e o que fazer#

MensagemPor quêO que fazer
"O app do Bling da marca não tem permissão para isso: marque “…” nos escopos do app."Falta um escopo (quase sempre uma subopção Gerenciar).Marque o escopo indicado no app do Bling, salve lá e clique em Reconectar Bling.
"Escolha a natureza de bonificação em Configurações › Loja."Nenhuma natureza escolhida.Clique em Escolher no card do Bling.
"A natureza de bonificação escolhida não existe mais (ou está inativa) no Bling. …"A natureza foi apagada ou desativada no Bling.Clique em Alterar e escolha outra.
"SKU … não encontrado no Bling"O produto não existe no Bling com esse código.Cadastre o produto no Bling com o mesmo SKU da loja (ou corrija o código) e tente de novo.
"O acesso ao Bling expirou ou foi revogado. Reconecte o Bling em Configurações › Loja."A autorização caiu.Clique em Reconectar Bling.
"A autorização foi recusada no Bling."Você clicou em recusar na tela do Bling.Clique em Conectar Bling e autorize.
"A autorização expirou. Tente conectar de novo." / "A autorização começou em outro navegador. Tente conectar de novo."A tela de autorização ficou aberta tempo demais ou foi aberta em outro navegador.Comece de novo pelo botão Conectar Bling, no mesmo navegador.
"Entre com a mesma conta que iniciou a conexão e tente de novo."Você trocou de login no Hub no meio da conexão.Entre com a conta do dono e conecte de novo.
"Informe o Client Id do app criado no seu Bling." / "Client Secret inválido."Campo vazio ou incompleto.Copie de novo os dados do app no Bling.
"Muitas requisições ao Bling. Tente de novo em instantes."O Bling limitou as chamadas.Espere alguns minutos e tente de novo.

Perguntas frequentes#

Mudei os escopos do app. Preciso fazer algo?

Sim. Clique em Reconectar Bling. A conexão atual continua com as permissões antigas até você autorizar de novo.

O que acontece se eu desconectar?

Os kits já enviados continuam no Bling, mas o Hub para de acompanhar a nota e o rastreio deles. Para revogar o acesso de vez, remova o app também nas integrações do Bling.

Posso ter Bling e outro ERP ao mesmo tempo?

Não. É um ERP por vez. Para trocar, desconecte o atual e use Escolher outro ERP.

Este artigo ajudou?

Não resolveu?

Fale com a gente. A mensagem já vai com a tela e o artigo, para agilizar o atendimento.

Leia também