# Bling

#### Como funciona a integração

Conecte a Waid ao Bling para emitir notas fiscais automaticamente a partir das vendas realizadas na Waid Pay.

### 1. Como funciona a integração?

Para que a Waid consiga enviar os dados para o seu Bling, precisamos criar uma "chave de acesso" segura. Siga os passos abaixo dentro da sua conta do Bling.

A integração conecta a Waid ao Bling para automatizar o fluxo de vendas. Quando um aluno compra um conteúdo pelo Waid Pay:

1. A Waid verifica se o aluno já existe no seu Bling. Se não existir, cria um novo contato.
2. A Waid registra um novo Pedido de Venda no Bling com os dados do produto comprado.
3. A partir daí, você pode emitir a nota fiscal diretamente pelo Bling.

{% hint style="warning" %}
**Atenção:** Esta integração funciona exclusivamente para vendas processadas via Waid Pay. Vendas realizadas por checkouts externos (como Hotmart, Kiwify, Eduzz, etc.) não são enviadas ao Bling por esta integração.
{% endhint %}

### 2. Configurando o Bling (Criando o Aplicativo)

Para que a Waid consiga enviar os dados para o seu Bling, precisamos criar uma "chave de acesso" segura. Siga os passos abaixo dentro da sua conta do Bling.

#### Passo 2.1 — Acessar a Área do Integrador

1. Faça login na sua conta do Bling.
2. No canto superior direito, clique no ícone de Central de Extensões (ícone de grade).

<figure><img src="/files/hTYuuZlLvd78RSBFEZgO" alt=""><figcaption></figcaption></figure>

3. Dentro da central, clique no botão Área do integrador, também no canto superior direito.

<figure><img src="/files/1UYIQ4xG0YwIWI2v9bXB" alt=""><figcaption></figcaption></figure>

4. Escolha o tipo Privado e clique em Próximo (no canto inferior direito).

<figure><img src="/files/984kW2gy3p1aG0dRUVcR" alt=""><figcaption></figcaption></figure>

#### Passo 2.2 — Preencher os dados do aplicativo

O Bling pedirá algumas informações para identificar a integração. Esses dados são apenas para organização interna e não afetam o funcionamento.

* Nome: Escolha um nome fácil de lembrar (ex.: "Integração Waid").
* Categoria: Selecione a que melhor descreve o seu negócio.
* Descrição e Descrição curta: Explique o que o app faz (ex.: "Integra Waid ao Bling para emissão de NF em vendas").
* Informações para contato: Preencha com seu nome, e-mail e celular.
* Link de redirecionamento: Este campo é muito importante. Insira o seu domínio da Waid seguido de `/integrations/bling`.

{% hint style="info" %}
Exemplo: `https://seudominio.curseduca.pro/integrations/bling`
{% endhint %}

<figure><img src="/files/WrcuTp12ZjCVpD9suC90" alt=""><figcaption></figcaption></figure>

#### Passo 2.3 — Configurar os Escopos (Permissões)

Os escopos são as permissões que a Waid precisa para criar contatos e pedidos no seu Bling. Vá até a seção Lista de escopos e clique em Adicionar.

{% hint style="warning" %}
***Se faltar algum escopo, a integração falhará.***
{% endhint %}

<figure><img src="/files/giyJ2OGE8NqBB3rVmTAt" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/r8ICuVTeowMnZpbh8mAu" alt=""><figcaption></figcaption></figure>

Selecione exatamente estas duas opções:

1. Clientes e Fornecedores → Gerenciar contatos (Sem isso, a Waid não consegue registrar o comprador).

<figure><img src="/files/LQBvYqgOlRIWCorTBqQl" alt=""><figcaption></figcaption></figure>

2. Pedidos de Venda → Gerenciar Pedidos de Venda (Sem isso, a Waid não consegue registrar a venda).

<figure><img src="/files/zOWN9V7R7yyOtYytMrDw" alt=""><figcaption></figcaption></figure>

3. Após selecionar as duas opções, clique em Adicionar.

<figure><img src="/files/2kaTXAMKhlF48fjrQDEt" alt=""><figcaption></figcaption></figure>

#### Passo 2.4 — Salvar e gerar as credenciais

Clique no botão Salvar dados básicos.

<figure><img src="/files/L9gTKxNuUfgNYqcpiwEC" alt=""><figcaption></figcaption></figure>

Uma mensagem de sucesso aparecerá. Vá até a aba Informações do app e copie o Client ID e o Client Secret — você precisará deles no próximo passo.

<figure><img src="/files/Mehc6YJAF2nu9rMsVEwf" alt=""><figcaption></figcaption></figure>

### 3. Configurando a Waid (Conectando as contas)

Agora que o Bling está pronto, vamos inserir as credenciais na Waid.

1. Acesse a plataforma Waid como administrador. No menu lateral, vá em Configurações → Geral.

<figure><img src="/files/k6l75WA9pjnetAFSHE9J" alt=""><figcaption></figcaption></figure>

2. Clique no botão Configurar integrações.

<figure><img src="/files/zMZvkbNGemUJzcf54S1q" alt=""><figcaption></figcaption></figure>

3. Selecione a opção Bling.

<figure><img src="/files/vWHDLpY9KrDpAUQ5uWRY" alt=""><figcaption></figcaption></figure>

4. Cole o Client ID e o Client Secret que você copiou do Bling. O campo "Loja" é opcional.

<figure><img src="/files/x6Eir93aLJwnI0JxFUOu" alt=""><figcaption></figcaption></figure>

5. Clique em Salvar. Você será redirecionado para uma página do Bling pedindo autorização. Confira se as permissões estão corretas e clique em Autorizar.

<figure><img src="/files/zXb3PwyNE3xpiUpZiAUb" alt=""><figcaption></figcaption></figure>

6. Após alguns instantes, a tela mostrará "Concluindo conexão com o Bling" e você voltará para a Waid com a integração ativa.

<figure><img src="/files/m4qDZ3mu2m4MwTqW702t" alt=""><figcaption></figcaption></figure>

### 4. Vinculando os Produtos (Passo Final)

Para que o Bling saiba exatamente qual produto foi vendido, precisamos vincular o ID do produto do Bling ao produto correspondente na Waid.

#### Passo 4.1 — Pegar o ID no Bling

1. No Bling, acesse o menu de Produtos.

<figure><img src="/files/JnqlrddHZkFkKN76Qc5Z" alt=""><figcaption></figcaption></figure>

2. Clique no produto que você deseja vincular.

<figure><img src="/files/1PGgsjuKnuHTyNfhKxsN" alt=""><figcaption></figcaption></figure>

3. Na página de edição, olhe para a URL do navegador e copie o número que aparece no final. Esse é o ID do produto.

<figure><img src="/files/n2DdZ76iPLDdf9bJbwTq" alt=""><figcaption></figcaption></figure>

#### Passo 4.2 — Inserir o ID na Waid

1. Na plataforma Waid, vá em Produtos e clique em Editar no produto correspondente.

<figure><img src="/files/vRnEu6ea8UCWRyxncEeN" alt=""><figcaption></figcaption></figure>

2. Acesse a aba Integrações. (Esta aba só aparece se o Waid Pay estiver ativo).

<figure><img src="/files/ctynp23kjhviTVw92WQW" alt=""><figcaption></figcaption></figure>

3. No campo ID do produto no Bling, cole o número copiado anteriormente e clique em Vincular.

<figure><img src="/files/4BdpL22t88VqfeZv5yM2" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
***Pronto! A partir de agora, toda venda confirmada deste produto na Waid gerará automaticamente um pedido no seu Bling.***
{% endhint %}

{% hint style="warning" %}

### Pontos de Atenção (Limitações)

1. **Apenas Waid Pay:** *Vendas por checkouts externos (Hotmart, Eduzz, etc.) não são enviadas ao Bling por esta integração.*
2. **Formas de Pagamento:** *Os pedidos criados no Bling utilizarão a forma de pagamento padrão configurada na sua conta. A forma exata usada pelo cliente (PIX, boleto ou cartão) não é enviada automaticamente — se necessário, ajuste manualmente dentro do pedido no Bling antes de emitir a nota.*
   {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.curseduca.com/integracoes/bling.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.