> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Bling

> Conecte sua conta do Bling para receber pedidos, contatos, produtos e estoque e disparar comunicações a cada situação do pedido, rastreio e nota fiscal autorizada

A integração com o **Bling** conecta o seu ERP à OctaSend. Com ela você:

* **Dispara comunicações** a partir dos pedidos de venda: pedido criado, cada situação do pedido (com os nomes que você usa no Bling), rastreio disponível e nota fiscal autorizada.
* **Sincroniza pedidos, contatos, produtos e estoque** com o menu [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md).
* **Alimenta as [automações](https://docs.octasend.com.br/plataforma/automacoes.md)** de pedido.

O funcionamento geral (mapeamento, variáveis, histórico e rotinas) segue o mesmo modelo das outras integrações. Esta página descreve o que é próprio do Bling.

## Conectar

**1. Abra o card do Bling**

Em **Configurações → Desenvolvedores → Integrações**, clique em **Conectar** no card do Bling e, na tela seguinte, clique em **Conectar** de novo.

**2. Autorize no Bling**

Você autoriza o acesso no Bling e volta para a OctaSend, na tela **Confirmar conexão**.

**3. Confirme**

Confira o nome da empresa e da conta e clique em **Conectar**. Depois você vai para a tela de mapeamento de eventos.

> [!NOTE]
>
> O link da tela **Confirmar conexão** vale 30 minutos e só pode ser usado uma vez. Se expirar, clique em **Conectar** de novo.

Uma empresa do Bling fica conectada a uma conta OctaSend só, e cada conta OctaSend conecta uma empresa do Bling. Se a empresa já estiver conectada em outra conta, ou se a sua conta já tiver outra empresa conectada, desconecte antes de conectar.

## O que chega do Bling

* **Pedidos de venda**, com itens: cada pedido novo ou alterado chega pelos avisos (webhooks) do Bling.
* **Contatos**, **produtos** e **estoque**.
* **Notas fiscais**, usadas para o aviso de nota autorizada.

### Importação inicial

Ao conectar, a OctaSend traz os pedidos dos últimos 364 dias e todos os contatos e produtos. Ela usa a listagem do Bling, que é resumida, então tem limites:

* pedidos antigos chegam **sem itens**;
* contatos antigos chegam **sem e-mail**;
* se a conta for grande e o tempo da importação acabar, parte do que não coube pode ficar de fora; use as [rotinas](#rotinas-e-executar-agora) para completar.

Pedidos novos, depois da conexão, chegam completos. Um pedido que já chegou completo não perde os itens quando a importação roda.

## Mapear os eventos

Na tela de mapeamento, cada evento recebe uma comunicação da OctaSend. Evento sem comunicação escolhida não dispara nada. Se você ainda não tem comunicação cadastrada, crie uma primeiro em **Comunicações**.

| Evento | Quando acontece |
| - | - |
| **Pedido criado** | Um pedido novo chega do Bling |
| **Pedido na situação X** | Uma linha para cada situação do módulo de vendas da sua conta, com o nome que você deu no Bling (por exemplo, "Em andamento", "Atendido") |
| **Rastreio disponível** | O pedido ganha um código de rastreio |
| **Nota fiscal autorizada** | A NF-e fica autorizada |

Pedido alterado, pedido excluído, produto e estoque só atualizam os dados na OctaSend; não enviam mensagem.

> [!NOTE]
>
> **Uma mensagem por pedido e situação.** Se o pedido sai de uma situação e volta para ela, ou se o Bling repete o aviso, a mensagem não é enviada de novo. O mesmo vale para o rastreio e para a nota autorizada: uma vez por pedido e por nota.

### Quem recebe a mensagem

Para chegar ao consumidor, a comunicação precisa de um canal ativo compatível com o contato. Nos eventos de pedido, o telefone é o celular do contato e, se não houver, o fixo; na nota fiscal autorizada, é o telefone do destinatário da nota. Se o contato não tem e-mail nem telefone, o evento fica como **Ignorado**.

## Variáveis

O painel lateral da tela de mapeamento mostra as variáveis do evento, com botão para copiar.

**Pedido criado e Pedido na situação X**

| Variável | Conteúdo |
| - | - |
| `{{cliente_nome}}` | Nome do cliente do pedido |
| `{{cliente_email}}` | E-mail do cliente |
| `{{cliente_telefone}}` | Telefone do cliente |
| `{{pedido_numero}}` | Número do pedido no Bling |
| `{{pedido_total}}` | Valor total do pedido |
| `{{pedido_itens}}` | Lista dos itens, um por linha, como `2x Camiseta Preta` |
| `{{pedido_data}}` | Data do pedido |
| `{{pedido_situacao}}` | Nome da situação atual do pedido |
| `{{loja_nome}}` | Nome da empresa no Bling |

**Rastreio disponível** tem as variáveis acima e mais:

| Variável | Conteúdo |
| - | - |
| `{{codigo_rastreio}}` | Código de rastreio do envio |
| `{{link_rastreio}}` | Link de rastreio informado pelo Bling |

> [!TIP]
>
> O Bling nem sempre informa o link. Nesse caso `{{link_rastreio}}` chega vazio: monte o texto para que ele faça sentido só com o código.

**Nota fiscal autorizada**

| Variável | Conteúdo |
| - | - |
| `{{cliente_nome}}` | Nome do destinatário da nota |
| `{{cliente_email}}` | E-mail do destinatário |
| `{{cliente_telefone}}` | Telefone do destinatário |
| `{{nota_numero}}` | Número da nota fiscal |
| `{{nota_chave}}` | Chave de acesso da NF-e |
| `{{link_danfe}}` | Link da DANFE |
| `{{loja_nome}}` | Nome da empresa no Bling |

Variável que não existe no evento não é substituída: a mensagem chega com o texto `{{nome_da_variavel}}`. Variável que existe, mas o Bling não preencheu, chega vazia.

## Rotinas e Executar agora

Na aba **Rotinas** há um botão **Executar agora** para **Clientes**, **Produtos** e **Pedidos**. Use quando desconfiar que algo não chegou, ou para completar o que a importação inicial deixou resumido.

| Rotina | O que faz |
| - | - |
| **Clientes** | Busca os contatos alterados desde a última execução (no máximo 30 dias para trás) e regrava cada um completo, com e-mail |
| **Produtos** | Busca todos os produtos e regrava |
| **Pedidos** | Busca os pedidos alterados desde a última execução, no máximo 30 dias para trás por execução (na primeira, os últimos 30 dias), e regrava cada um completo, com itens |

Em clientes e pedidos, cada execução cobre até 30 dias; o histórico anterior vem da importação inicial. Se a execução parar no limite de tempo, a aba avisa quantos registros entraram e a próxima execução continua a mesma janela: execute de novo até ela terminar sem aviso.

**Executar agora** atualiza os dados guardados; ele não reenvia mensagens. Cada execução aparece na aba **Logs**.

## Pedido que chega por duas vias

Se você também conectou uma loja virtual, o mesmo pedido pode chegar por ela e pelo Bling. Quando a [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md) e o Bling estão conectados, a tela de mapeamento do Bling mostra o aviso **Pedidos da loja virtual também chegam pelo Bling**.

* Configure cada mensagem em **uma** integração só, para o cliente não receber a mesma mensagem duas vezes.
* Nas [automações](https://docs.octasend.com.br/plataforma/automacoes.md) com o gatilho **Chegou um pedido**, use o campo **Origem do pedido** para escolher a integração (por exemplo, "Bling — nome da empresa"). O padrão, **Qualquer origem**, dispara para pedidos de qualquer integração.

## Limites

* O Bling permite **3 requisições por segundo por conta**. A importação e as rotinas respeitam esse limite, por isso uma conta grande leva mais de uma execução.
* As mensagens de situação do pedido, rastreio e nota fiscal são processadas em fila, que roda a cada minuto. Em geral saem em poucos minutos depois do aviso do Bling.
* Se um aviso do Bling não chegar, use **Executar agora** em **Pedidos**.

## Acompanhar

A aba **Eventos recebidos** mostra cada evento e o resultado:

| Resultado | Quando |
| - | - |
| **Recebido** | O aviso chegou e ainda está sendo processado |
| **Enviado** | A mensagem foi aceita para envio |
| **Ignorado** | Sem comunicação mapeada, comunicação inativa, contato sem e-mail e telefone, ou sem canal compatível |
| **Falhou** | Houve erro; o motivo aparece junto |

## Desconectar

Ao desconectar, a OctaSend revoga o acesso no Bling e para de receber os avisos. Os pedidos, contatos e produtos já importados **continuam** na OctaSend. Para voltar, conecte de novo.

## Veja também

> [card] [Integrações](https://docs.octasend.com.br/integracoes/visao-geral.md)
>
> As plataformas disponíveis e o que muda entre elas

> [card] [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md)
>
> Detalhes do mapeamento, do histórico e das rotinas

> [card] [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md)
>
> Clientes, pedidos e produtos sincronizados

> [card] [Automações](https://docs.octasend.com.br/plataforma/automacoes.md)
>
> Sequências de mensagens a partir dos pedidos


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.