> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/integracoes/bling.md).

# Integração com o Bling

Integração Bling ERP com a Uplaces: conecte com um botão, importe catálogo e clientes e envie os pedidos da loja B2B ao Bling.

A integração com o Bling liga a sua loja B2B da Uplaces ao ERP que você já usa. Você cria um aplicativo privado no Bling, salva as credenciais na Uplaces e clica em **Conectar com o Bling**. Depois, **Importar do Bling** traz catálogo, clientes, categorias e formas de pagamento, e cada pedido da loja segue para o Bling no status que você escolher. A integração usa a API v3, a versão atual do Bling.

{% hint style="warning" %}
**No Bling aparece "Webhook inativo por erros na operação"?** Preço, estoque ou situação do pedido pararam de chegar à loja. Veja como reativar em [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md).
{% endhint %}

## Para que serve

* Montar a loja com o que já está no Bling: produtos, variações, preços, fotos, categorias e estoque chegam sem cadastrar um a um.
* Pedido sem redigitação: o pedido feito pelo cliente ou pelo vendedor vai para o Bling com cliente, itens, preços, forma de pagamento e vendedor.
* Estoque e preço em dia: com o webhook cadastrado, mudança de estoque, de preço, de nome ou de foto dos produtos que já estão na loja chega sozinha. Produto novo entra pelo **Importar do Bling**.
* Faturamento acompanhado: a situação do pedido no Bling volta para a Uplaces, para o cliente ver em que pé está.

## Como funciona

1. [Conecte o Bling](https://ajuda.uplaces.com.br/integracoes/bling/conectar.md): crie o aplicativo no Bling, salve o Client ID e o Client Secret e autorize.
2. Ligue o [webhook do Bling](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md), para preço, estoque e situação do pedido chegarem sozinhos.
3. [Importe produtos e clientes](https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md) com o botão **Importar do Bling**, na quantidade que você escolher.
4. Escolha quando o [pedido segue para o Bling](https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md) e mapeie os status.
5. Acompanhe o que foi enviado e a resposta do Bling no [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md).

Cada campo da tela do Bling na Uplaces, e o que ele faz, está em [Ajustes depois de conectar](https://ajuda.uplaces.com.br/integracoes/bling/conectar.md#ajustes-depois-de-conectar).

## Onde configurar cada coisa

| Quero                                               | Onde                                                                                                                                       |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| ligar ou desligar o envio de pedidos                | **Integração ativa**, no alto da tela do Bling                                                                                             |
| escolher quando o pedido vai para o Bling           | **Enviar para integração quando o status for**                                                                                             |
| receber preço, estoque e situação sozinhos          | [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md)                                       |
| escolher o depósito do estoque                      | **Estoque de produtos (depósito)**, aba **Configurações**                                                                                  |
| impedir que o Bling sobrescreva nome, preço ou foto | **Critérios para atualização de PRODUTOS**, aba **Configurações**                                                                          |
| relacionar as situações do pedido                   | **Mapeamento dos status**, aba **Configurações**                                                                                           |
| relacionar formas de pagamento e vendedores         | **Mapeamento (ERP)** no cadastro de cada um. Veja [Pedidos da Uplaces no Bling](https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md) |
| ligar categorias que já existem na loja às do Bling | **Produtos › Categorias › Mapear categorias com ERP**                                                                                      |

## O que você precisa

* Conta no Bling com acesso à API e a aplicativos. O Bling define quais planos liberam esse recurso; consulte a ajuda do Bling.
* Usuário administrador da loja na Uplaces. O menu **Integração ERP** aparece para administrador e diretor.

## O que sincroniza

| Dado                               | Direção                                  | Quando                                                                                                                                                                    |
| ---------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Produtos, variações, preços, fotos | Bling para Uplaces                       | ao importar e, com webhook, a cada alteração de produto que já está na loja                                                                                               |
| Estoque                            | Bling para Uplaces                       | ao importar e, com webhook, a cada movimento de estoque                                                                                                                   |
| Clientes                           | Bling para Uplaces, e Uplaces para Bling | ao importar; o cliente é enviado ao Bling com o pedido                                                                                                                    |
| Pedido                             | Uplaces para Bling                       | no status escolhido em **Enviar para integração quando o status for**                                                                                                     |
| Situação do pedido                 | Uplaces para Bling                       | a cada mudança de status na Uplaces                                                                                                                                       |
| Situação do pedido                 | Bling para Uplaces                       | com webhook, conforme o **Mapeamento dos status**. As situações padrão do Bling voltam mesmo sem mapeamento; situação criada por você só muda o pedido se estiver mapeada |

Cotações não seguem para o Bling.

## O que (não) faz

* Excluir um produto no Bling não apaga o produto da loja.
* Pedido criado direto no Bling, fora da Uplaces, não muda o status de pedidos da loja.
* Produtos, preços e estoque não voltam da Uplaces para o Bling: o Bling continua sendo o cadastro principal.

## Páginas desta seção

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Conectar o Bling</strong></td><td>aplicativo, credenciais e autorização</td><td><a href="https://ajuda.uplaces.com.br/integracoes/bling/conectar.md">Conectar o Bling</a></td></tr><tr><td><strong>Webhook do Bling</strong></td><td>configurar e reativar quando o Bling desliga</td><td><a href="https://ajuda.uplaces.com.br/integracoes/bling/webhook.md">Webhook do Bling: configurar e reativar</a></td></tr><tr><td><strong>Importar produtos e clientes</strong></td><td>catálogo, estoque, categorias e carteira</td><td><a href="https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md">Importar produtos e clientes do Bling</a></td></tr><tr><td><strong>Pedidos no Bling</strong></td><td>quando o pedido sai e como volta a situação</td><td><a href="https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md">Pedidos da Uplaces no Bling</a></td></tr></tbody></table>

## Problemas comuns

<details>

<summary>Apareceu o alerta "Seus pedidos pararam de ir para o Bling"</summary>

A autorização da Uplaces no Bling expirou ou foi revogada, e os pedidos novos não chegam ao Bling até você reconectar. Clique em **Reconectar o Bling** e autorize de novo. O alerta some sozinho quando a conexão volta. Veja [Alertas da conta](https://ajuda.uplaces.com.br/primeiros-passos.md#alertas-da-conta).

</details>

<details>

<summary>Não consigo conectar</summary>

Siga o diagnóstico de [Conectar o Bling](https://ajuda.uplaces.com.br/integracoes/bling/conectar.md): credenciais salvas, link de redirecionamento igual ao da Uplaces e conta do Bling com acesso à API.

</details>

<details>

<summary>O estoque da loja não bate com o Bling</summary>

Confira o depósito em **Estoque de produtos (depósito)**, na aba **Configurações**.

</details>

<details>

<summary>Mudei o preço no Bling e não mudou na loja</summary>

Não é preciso importar a cada alteração: com o webhook de **Produtos** ligado no aplicativo do Bling, a mudança chega sozinha. Confira nesta ordem:

1. No [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md), aba **Recebidos**, busque `product.updated`. Se chegam avisos de estoque e de pedido, mas nenhum de produto, o webhook de **Produtos** está desligado no aplicativo do Bling. Se não chega aviso nenhum, confira também, na aba **Webhooks** da tela do Bling na Uplaces, se **Ativar recebimento via webhooks** está marcado.
2. Reative **Produtos** no aplicativo do Bling, como em [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md). No Bling, o recurso desligado aparece com **Webhook inativo por erros na operação**.
3. Clique em **Importar do Bling** uma vez, para trazer o que mudou enquanto o webhook estava desligado.
4. Se o aviso chegou e o preço continua o mesmo, veja na aba **Configurações** se **Não atualizar preço de tabela** está marcado.

O webhook atualiza os produtos que já estão na loja. Produto novo entra pelo **Importar do Bling**.

</details>

<details>

<summary>O estoque atualiza, mas o preço não</summary>

O Bling liga e desliga o webhook de cada recurso em separado: **Estoques** pode continuar ativo com **Produtos** desligado. Religue **Produtos** como em [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md) e importe uma vez.

</details>

<details>

<summary>O pedido não chegou ao Bling</summary>

Veja [Pedidos da Uplaces no Bling](https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md) e o [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md).

Se o erro continuar, fale com o suporte da Uplaces.

</details>

## Perguntas frequentes

<details>

<summary>Qual versão da API do Bling a Uplaces usa?</summary>

A API v3, a versão atual do Bling.

</details>

<details>

<summary>Preciso de um plano específico do Bling?</summary>

O Bling define quais planos liberam API e aplicativos. Se a conta não tiver o recurso, o Bling recusa a autorização. Consulte a ajuda do Bling.

</details>

<details>

<summary>Posso importar só parte do catálogo?</summary>

Sim. Use **Quantos trazer** para limitar a quantidade, ou **Produtos por código** para trazer só uma lista. Veja [Importar produtos e clientes do Bling](https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md).

</details>

<details>

<summary>Se eu mudar o preço no Bling, ele muda na loja?</summary>

Sim, sem importar de novo, desde que o webhook de **Produtos** esteja ligado no aplicativo do Bling. Sem ele, a mudança só chega quando você clica em **Importar do Bling**. Se o preço não mudou, veja **Mudei o preço no Bling e não mudou na loja**, em Problemas comuns.

</details>

<details>

<summary>O webhook do Bling fica em Gatilhos (webhooks)?</summary>

Não. O webhook do Bling se configura dentro do Bling, na aba **Webhooks** do aplicativo, como em [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md). O menu **Integração ERP › Gatilhos (webhooks)** da Uplaces faz o caminho contrário: avisa um sistema seu quando um pedido, um produto ou um cliente muda na loja. Para o Bling funcionar, não é preciso mexer nele.

</details>

<details>

<summary>Como sei se o pedido chegou ao Bling?</summary>

Na lista de pedidos, a coluna **Integração** mostra que o pedido chegou ao Bling, com a identificação dele lá. O [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md) guarda o que foi enviado e a resposta do Bling.

</details>

## Veja também

* [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md)
* [Integração com ERP](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md)
* [Integração com o Tiny ERP](https://ajuda.uplaces.com.br/integracoes/tiny.md)
* [Integração com a Omie](https://ajuda.uplaces.com.br/integracoes/omie.md)
* [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md)
* [Cadastro de produtos](https://ajuda.uplaces.com.br/ecommerce-b2b/produtos/cadastro.md)
* [Políticas comerciais](https://ajuda.uplaces.com.br/ecommerce-b2b/politicas-comerciais.md)
* No site: [integração com o Bling](https://uplaces.com.br/integracao-bling/)

{% hint style="success" %}
**Ainda não usa a Uplaces?** Teste grátis por 10 dias, sem cartão de crédito: crie a conta e configure a integração com o Bling com os seus produtos. [Começar o teste grátis](https://b2b.admin.uplaces.com.br/login?cadastro\&utm_source=ajuda\&utm_medium=cta\&utm_campaign=central-de-ajuda)
{% endhint %}
