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.
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#
- Vá em Configurações › Loja, desça até ERP para Recebidos e clique em Conectar Bling.
- 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.
- Em Link de redirecionamento, cole o endereço que aparece no card do Hub (termina em
/api/bling/callback). - Em Escopos, marque os itens da lista abaixo. Atenção às subopções Gerenciar.
- Salve o app no Bling e copie o Client Id e o Client Secret dele para o card do Hub. Clique em Salvar app.
- Clique em Conectar Bling, entre na conta Bling da marca e autorize o acesso.
- 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#
| Escopo | O que marcar |
|---|---|
| Pedidos de Venda | A caixa principal e a subopção "Gerenciar Pedidos de Venda" |
| Clientes e Fornecedores | A caixa principal e a subopção "Gerenciar Contatos" |
| Produtos | Só a caixa principal |
| Notas Fiscais (NF-e) | Só a caixa principal |
| Visualizar os dados básicos da empresa | Só a caixa principal |
| Naturezas de Operação | Só 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#
| Mensagem | Por 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.

