For the complete documentation index, see llms.txt. This page is also available as Markdown.

Importação de Dados (Bling)

Conecte a sua conta do ERP Bling ao SprintHub e traga produtos, contatos, empresas e pedidos de venda sem exportar planilhas. Os pedidos viram oportunidades no CRM, já ligadas ao contato e com a situação que têm no Bling.



A conexão usa um aplicativo seu no Bling: você cria um aplicativo privado na sua conta do Bling, cola as credenciais dele no SprintHub e autoriza o acesso. É feito uma vez só.


1. Copie a URL de redirecionamento no SprintHub

  1. Acesse Configurações do Sistema > Integrações.

  2. Digite "Bling" em Pesquisar integração e clique em Configurações no card Bling.

Aba Integrações com o card Bling
  1. Um painel abre na lateral direita. No card Credenciais do aplicativo, copie a URL do aviso URL de redirecionamento ("Cadastre esta URL no aplicativo do Bling:"). Você vai colá-la no Bling no próximo passo.

Painel do Bling com o card Credenciais do aplicativo e a URL de redirecionamento

Deixe esta aba aberta: você volta para ela no passo 3.

2. Crie o aplicativo no Bling

  1. Em outra aba, entre na sua conta do Bling.

  2. Abra a Central de Extensões e clique em Área do Integrador. A tela Cadastro de aplicativos abre.

  3. Clique em Criar aplicativo.

Cadastro de aplicativos do Bling com o botão Criar aplicativo
  1. Em Tipo do aplicativo, deixe API selecionado e, em Selecione o uso do aplicativo, escolha Privado — o aplicativo vai operar só na sua conta. Clique em Próximo.

Tipo do aplicativo: API e uso Privado
  1. Em Dados básicos, preencha os campos obrigatórios:

  • Nome — só para você reconhecer; sugestão: "SprintHub";

  • Categoria — escolha CRM;

  • Descrição — o campo já vem com um texto de instruções do Bling: clique nele, selecione todo o texto, apague e só então escreva uma frase sobre o uso, como "Integração com o SprintHub". Se escrever sem apagar, as instruções ficam junto da sua frase;

  • Descrição curta.

Dados básicos do aplicativo
  1. No campo Link de redirecionamento, cole a URL que você copiou no SprintHub.

  2. Em Lista de escopos, clique em Adicionar e marque os escopos abaixo. Basta o escopo principal de cada um (o de visualizar): as opções de gerenciar e excluir que aparecem abaixo deles não são necessárias. Clique em Adicionar para confirmar.

    • Clientes e Fornecedores — para contatos e empresas;

    • Produtos — para o catálogo;

    • Pedidos de Venda — para os pedidos que viram oportunidades.

Link de redirecionamento preenchido e os três escopos na lista
  1. Preencha as Informações para contato (nome, e-mail e celular de quem cuida do aplicativo) e clique em Salvar dados básicos.

  2. Abra a aba Informações do app e copie o Client ID e o Client Secret (use o ícone de copiar ao lado de cada campo).

Informações do app com Client ID e Client Secret (valores mascarados)

Observação: o Client Secret funciona como uma senha do seu aplicativo. Não compartilhe nem mande por mensagem; cole direto no SprintHub.

Observação: se você não é o administrador da conta do Bling, peça a ele a permissão Cadastro de aplicativos (em Preferências > Sistema > Usuários) para ver a Área do Integrador.

3. Salve as credenciais no SprintHub

  1. Volte para a aba do SprintHub, no painel do Bling.

  2. Cole o Client ID e o Client Secret nos campos do card Credenciais do aplicativo.

  3. Clique em Salvar credenciais.

Lembrando: enquanto as credenciais não estiverem salvas, aparece a mensagem "Salve as credenciais do aplicativo para liberar a conexão." e o botão Adicionar conta fica desabilitado. Se você salvou só o Client ID, aparece "Falta o Client Secret do aplicativo. Cole o secret acima e salve para liberar a conexão."

4. Conecte a conta

  1. No card Conta conectada, clique em Adicionar conta.

  2. Você é levado para o Bling. Confira os acessos pedidos e autorize.

  3. O Bling devolve você para o SprintHub, já na Central de Importações, com a conta conectada. No painel do Bling aparece o selo Conectado e a faixa "Conta conectada." (veja o segundo print do passo 1).

[PRINT: tela de autorização do Bling com os escopos pedidos — só aparece na primeira autorização do aplicativo; a conta de teste já estava autorizada e o Bling devolveu direto]

Para desfazer a conexão, clique em Desconectar conta e confirme. As credenciais do aplicativo continuam salvas: para voltar, basta clicar em Reconectar conta.


Como usar

1. Abra a Central de Importações — no menu, acesse Central de Importações. Em Fontes de importação, o card Bling mostra o selo Conectado. Clique em Importar.

Central de Importações com o card Bling conectado

2. O que será importado? — marque Contatos, Empresas, Produtos e/ou Oportunidades (os pedidos de venda), ou clique em Selecionar todos. Clique em Continuar.

Etapa O que será importado? com os quatro tipos

3. Destino — defina para onde vão os registros:

  • Quem cuida e quem vê — responsável e acesso dos contatos criados;

  • Como organizar — tags e segmentos aplicados aos contatos;

  • Funil de destino — funil e etapa em que os pedidos entram (aparece quando Oportunidades está marcado).

Etapa Destino com responsável e acesso

Em Registros que já existem, escolha o que fazer com quem já está no SprintHub:

  • Atualizar tudo — o Bling é a fonte da verdade: o campo que ele preenche substitui o que está aqui;

  • Só completar vazios — o que já está preenchido não é tocado;

  • Não alterar — o registro que já existe fica intacto; a importação só traz o que falta.

Clique em Pré-visualização.

Funil de destino e Registros que já existem

4. Pré-visualização — nada é gravado até aqui. O SprintHub lê uma amostra de cada tipo e mostra quantos registros serão importados, o que fazer com quem já existe, o Tempo estimado e quantas consultas serão feitas ao Bling. Na amostra, a coluna Situação marca o que é Novo e o que Já importado. Quando estiver certo, clique em Iniciar importação.

Pré-visualização da importação

Nos pedidos, a amostra mostra também a situação com que cada oportunidade vai entrar (Aberta, Ganha ou Perdida).

Amostra de pedidos com a situação de cada oportunidade

5. Resultado da importação — a tela acompanha o progresso e, no fim, mostra quantos registros foram Criados, Atualizados, Ignorados e Falharam, por tipo, além do consumo de consultas ao Bling. Se algo falhar, o motivo de cada falha aparece na tela.

Resultado da importação concluída

O que entra e como

  • Pedidos de venda → oportunidades: pedido Atendido, Atendido parcialmente, Faturado parcialmente, Em andamento, Verificado ou Venda Agenciada entra como ganho; Cancelado entra como perdido; Em aberto e Em digitação entram abertos na etapa escolhida.

  • Situação personalizada (criada por você no Bling): a pré-visualização mostra "Situação não reconhecida". Pedido novo entra aberto; se a oportunidade já existe, o SprintHub mantém a situação que está no CRM.

  • Produto com variação: entram as variações (cor, tamanho…), cada uma como um produto. O produto "pai", que só agrupa as variações, não entra — por isso a pré-visualização pode mostrar registros "descartados".

  • Contatos repetidos no Bling (mesmo e-mail, telefone ou documento): viram um contato só no SprintHub, e os pedidos de todos eles vão para esse contato.

  • Importar de novo não duplica: registros que já vieram são reconhecidos, mesmo que o contato tenha ganhado e-mail ou o produto tenha ganhado código no Bling.

Limites e erros comuns

  • Tempo: o Bling permite 3 consultas por segundo. Contatos e pedidos novos precisam de uma consulta cada para trazer e-mail, endereço e itens; por isso uma base grande pode levar horas. A pré-visualização mostra a estimativa antes de começar.

  • Limite diário do Bling: cada conta do Bling tem um limite de consultas por dia. Se ele for atingido, a importação para com o aviso na tela; rode de novo no dia seguinte e ela continua de onde parou, sem duplicar.

  • "A conexão expirou. Reconecte a origem para continuar.": a autorização foi revogada ou venceu no Bling. Abra o painel do Bling em Integrações e clique em Reconectar conta.

  • Erro ao autorizar no Bling: confira se o Link de redirecionamento do aplicativo no Bling é exatamente a URL mostrada no painel do SprintHub.

  • Faltam dados de algum tipo: confira se o escopo daquele tipo está na Lista de escopos do aplicativo no Bling. Depois de mudar escopos, clique em Reconectar conta no SprintHub.

Atualizado