> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/integracoes/importacao-de-dados-bling.md).

# 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.

***

{% hint style="danger" %}
**Atenção:** conectar e importar são ações administrativas. Só quem tem permissão de administração do sistema enxerga a integração do Bling e a **Central de Importações**.
{% endhint %}

***

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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Fy8QUpC9oseAw8t2dbvFf%2Fimage.png?alt=media&amp;token=f9f89527-2a63-4e5d-92c8-3c6902f5de9d" alt=""><figcaption><p>Aba Integrações com o card Bling</p></figcaption></figure>

3. 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.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FqRReq4gVCC0rOjOesmUw%2Fimage.png?alt=media&amp;token=04bc79ce-b647-432b-b492-f45f2ff903bd" alt=""><figcaption><p>Painel do Bling com o card Credenciais do aplicativo e a URL de redirecionamento</p></figcaption></figure>

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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FJPKCeZlrTUNznQORZW9u%2Fimage.png?alt=media&amp;token=42bd6819-9d20-402f-8539-a3711de51ba2" alt=""><figcaption><p>Cadastro de aplicativos do Bling com o botão Criar aplicativo</p></figcaption></figure>

4. 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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FjecZU0MKgorVZhoRn56N%2Fimage.png?alt=media&amp;token=9aa8cf75-3c84-4ae1-a99b-06b612eddb72" alt=""><figcaption><p>Tipo do aplicativo: API e uso Privado</p></figcaption></figure>

5. 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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FfdhOf63AAyx9sM87RAQx%2Fimage.png?alt=media&amp;token=bd4209e8-8c2f-4271-beb1-1e7047061a3b" alt=""><figcaption><p>Dados básicos do aplicativo</p></figcaption></figure>

6. No campo **Link de redirecionamento**, cole a URL que você copiou no SprintHub.
7. 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.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FFUmn9dZ7hlfoowClYucT%2Fimage.png?alt=media&amp;token=eedc0437-0bc5-468d-b8c8-f6038eb2b422" alt=""><figcaption><p>Link de redirecionamento preenchido e os três escopos na lista</p></figcaption></figure>

8. Preencha as **Informações para contato** (nome, e-mail e celular de quem cuida do aplicativo) e clique em **Salvar dados básicos**.
9. 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).

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FjFizOhSz1PZvUlI86R0X%2Fimage.png?alt=media&amp;token=57dbba6a-e26e-43ac-99a6-97fd75e27d99" alt=""><figcaption><p>Informações do app com Client ID e Client Secret (valores mascarados)</p></figcaption></figure>

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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2F0j3KQdKta46eUEBvxBdT%2Fimage.png?alt=media&amp;token=6d1b79a8-37ce-415f-a21f-b9cd996b73ae" alt=""><figcaption><p>Central de Importações com o card Bling conectado</p></figcaption></figure>

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

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FODG0KOoL7DvoSVu6QCjp%2Fimage.png?alt=media&amp;token=015f102a-e25b-4420-8f04-f7fb3ea2b0f3" alt=""><figcaption><p>Etapa O que será importado? com os quatro tipos</p></figcaption></figure>

**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).

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FXPmwVECMbwiacQArdd96%2Fimage.png?alt=media&amp;token=e50d7f7a-6b68-4eab-8e60-21c23d9cf485" alt=""><figcaption><p>Etapa Destino com responsável e acesso</p></figcaption></figure>

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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Fss5MLiRoySTLE9CzfUnD%2Fimage.png?alt=media&amp;token=86af3093-2483-4ca0-b444-48c0e657d501" alt=""><figcaption><p>Funil de destino e Registros que já existem</p></figcaption></figure>

**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**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FLdRsm6VGVwEcIHYYsMAq%2Fimage.png?alt=media&amp;token=2dbfdbd5-80e6-46c0-9fbd-01e30737230f" alt=""><figcaption><p>Pré-visualização da importação</p></figcaption></figure>

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

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FfSFI0fa9rFWHdjD204e3%2Fimage.png?alt=media&amp;token=9f732cf6-a977-4fd1-9a25-02f3fe858e36" alt=""><figcaption><p>Amostra de pedidos com a situação de cada oportunidade</p></figcaption></figure>

**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.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FzYQaj3z7ISREp35yxCjM%2Fimage.png?alt=media&amp;token=3eb2a353-d0d1-4724-a838-1945a319d0bb" alt=""><figcaption><p>Resultado da importação concluída</p></figcaption></figure>

***

### 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.
