> 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/conectar.md).

# Conectar o Bling

Como conectar o Bling à Uplaces: crie o aplicativo no Bling, salve o Client ID e o Client Secret e clique em Conectar com o Bling.

Para ligar a sua loja B2B ao Bling, você cria um aplicativo privado no Bling, salva as credenciais dele na Uplaces e autoriza a conexão com o botão **Conectar com o Bling**. Leva poucos minutos, e a renovação do acesso depois é automática.

## Antes de começar

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

{% stepper %}
{% step %}

## Abrir a integração

1. No menu da Uplaces, abra **Integração ERP › Nativa**.
2. No card **Bling**, clique em **Conectar**. Se a integração já existe, o botão é **Gerenciar**.
3. A tela mostra o aviso **Falta conectar sua conta do Bling.** com os passos abaixo.
   {% endstep %}

{% step %}

## Criar o aplicativo no Bling

1. Na tela da Uplaces, clique em **abrir cadastro**. Abre o cadastro de aplicativos do Bling. O guia do próprio Bling está em **como fazer** ([developer.bling.com.br/aplicativos](https://developer.bling.com.br/aplicativos#como-cadastrar)).
2. Crie um aplicativo **privado** com o nome que preferir.
3. No campo **Link de redirecionamento**, cole o endereço que a Uplaces mostra no passo **Cole este endereço**. Use o botão **Copiar** ao lado dele.
4. Marque as permissões do aplicativo. No Bling, cada permissão tem itens que se marcam um a um:

| Permissão no Bling                                                                                  | Para que a Uplaces usa                                                   |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Produtos**                                                                                        | importar catálogo e variações                                            |
| **Categoria de Produtos**                                                                           | importar a árvore de categorias                                          |
| **Controle de Estoque**                                                                             | importar o saldo                                                         |
| **Depósitos de Estoque**                                                                            | listar os depósitos na aba **Configurações**. Sem ela, a lista vem vazia |
| **Clientes e Fornecedores** e **Gerenciar Contatos**                                                | importar clientes e cadastrar no Bling o cliente do pedido               |
| **Pedidos de Venda**, **Gerenciar Pedidos de Venda** e **Gerenciar situações dos Pedidos de Venda** | enviar o pedido e mudar a situação                                       |
| **Integrações e Lojas Virtuais**                                                                    | ligar o pedido ao canal de venda no Bling                                |
| **Visualizar os dados básicos da empresa**                                                          | o **Testar integração**, que mostra a razão social e o CNPJ              |

5. Para a loja receber sozinha as mudanças de preço, de estoque e da situação do pedido, cadastre o webhook na aba **Webhooks** do aplicativo: um servidor com o endereço que a Uplaces mostra em **Ainda no aplicativo, aba Webhooks**, e **Webhook ativo** em **Produtos**, **Estoques** e **Pedidos de Vendas**. O passo a passo, tela por tela, está em [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md). Sem o webhook, as mudanças feitas no Bling só chegam à loja quando você clica em **Importar do Bling**.
6. Salve o aplicativo e copie o **Client ID** e o **Client Secret**.
   {% endstep %}

{% step %}

## Salvar as credenciais na Uplaces

1. De volta à tela do Bling na Uplaces, clique em **Ver credenciais do aplicativo**.
2. Preencha **Client Id** e **Client Secret** e clique em **Salvar**.

Trate o **Client Secret** como uma senha: não envie por e-mail nem por mensagem.
{% endstep %}

{% step %}

## Conectar

1. Clique em **Conectar com o Bling**. O botão fica ativo depois que as credenciais são salvas.
2. Autorize o aplicativo no Bling. Você volta para a Uplaces.
3. A tela mostra **Conectado ao Bling.** Só é preciso reconectar se você revogar o aplicativo no Bling.
4. Clique em **Testar integração** para conferir. A mensagem mostra o que o Bling respondeu: em caso de sucesso, a razão social e o CNPJ da conta, para você conferir se são os da sua empresa.

Se o Bling recusar a autorização, a Uplaces mostra a mensagem que ele devolveu e o que fazer. Um motivo comum é a conta do Bling não ter acesso à API.
{% endstep %}
{% endstepper %}

## Ajustes depois de conectar

Depois de conectar, a tela do Bling na Uplaces mostra os campos do topo e as abas **Configurações** e **Webhooks**. Clique em **Salvar** depois de mudar qualquer um deles.

| Onde                  | Campo                                                        | Para que serve                                                                                                                                                             |
| --------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| alto da tela          | **Integração ativa**                                         | liga e desliga o envio de pedidos ao Bling                                                                                                                                 |
| alto da tela          | **Usuário de integração**                                    | o usuário da Uplaces em nome de quem a integração registra as mudanças nos pedidos                                                                                         |
| alto da tela          | **Enviar para integração quando o status for**               | o momento em que o pedido segue para o Bling. Veja [Pedidos da Uplaces no Bling](https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md)                                |
| aba **Webhooks**      | **Ativar recebimento via webhooks**                          | deixe marcado. Desmarcado, a Uplaces ignora os avisos do Bling, mesmo com o webhook ligado no aplicativo                                                                   |
| aba **Configurações** | **Incluir vendedor no envio do pedido**                      | manda o vendedor junto com o pedido                                                                                                                                        |
| aba **Configurações** | **Estoque de produtos (depósito)**                           | o depósito do Bling que alimenta o estoque da loja. **Todos os depósitos (saldo total)** soma todos. Lista vazia: falta a permissão **Depósitos de Estoque** no aplicativo |
| aba **Configurações** | **Mapeamento dos status**                                    | relaciona cada status do pedido na Uplaces a uma situação do Bling                                                                                                         |
| aba **Configurações** | **Critérios para atualização de CLIENTES** e **de PRODUTOS** | o que a importação e o webhook não trazem ou não sobrescrevem (tabela abaixo)                                                                                              |

### Critérios para atualização

Sem nenhum critério marcado, a integração cria o que é novo e atualiza tudo o que veio do Bling.

| Critério                                                                                  | O que faz                                                                                    |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Apenas atualizar (não insere novos produtos)**                                          | atualiza os produtos que já estão na loja e não cria produto novo                            |
| **Ignorar categorias**                                                                    | não importa categorias nem muda a categoria dos produtos                                     |
| **Não atualizar nome**, **Não atualizar nome das variações**, **Não atualizar descrição** | o texto vem do Bling só quando o produto é criado; depois, vale o que você editou na Uplaces |
| **Não atualizar preço de tabela**                                                         | o preço editado na Uplaces não é sobrescrito pelo do Bling                                   |
| **Não atualizar estoque**                                                                 | o saldo da loja deixa de seguir o do Bling                                                   |
| **Não atualizar status (Ativo/Inativo)**                                                  | ativar ou inativar o produto no Bling não muda a loja                                        |
| **Não atualizar Fabricante**, **Não atualizar Marca**, **Não atualizar informações**      | mantêm esses dados como estão na Uplaces                                                     |
| **Não atualizar url de fotos e vídeos**                                                   | mantém as fotos e os vídeos que estão na loja                                                |
| **Apenas atualizar (não insere novos clientes)**                                          | atualiza os clientes que já estão na loja e não cria cliente novo                            |
| **Com e-mail válido**, junto de **Pessoa Jurídica** e **Pessoa Física**                   | só traz clientes com e-mail válido, dos tipos marcados                                       |

Cliente com e-mail em formato inválido fica de fora em qualquer caso, e o relatório da importação mostra o motivo.

## Resultado

A tela mostra **Conectado ao Bling.**, e o botão **Importar do Bling** aparece para o administrador. O próximo passo é [importar produtos e clientes do Bling](https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md).

## Problemas comuns

<details>

<summary>O botão Conectar com o Bling está cinza</summary>

Aparece **Disponível depois que o Client ID e o Client Secret forem salvos.** Volte ao passo de salvar as credenciais e clique em **Salvar**.

</details>

<details>

<summary>Ainda não dá para conectar</summary>

A Uplaces não achou as credenciais salvas. Salve o **Client ID** e o **Client Secret** antes de autorizar.

</details>

<details>

<summary>Mudei as permissões do aplicativo e a integração parou</summary>

Ao salvar o aplicativo com permissões alteradas, o Bling revoga o acesso. Clique em **Reconectar** na Uplaces e autorize de novo.

</details>

<details>

<summary>O Bling respondeu que o usuário não possui autorização</summary>

Conta do Bling com fatura em aberto fica com recursos reduzidos, e o Bling recusa a autorização. Regularize a conta no Bling e conecte de novo.

</details>

<details>

<summary>As mudanças do Bling pararam de chegar (Webhook inativo por erros na operação)</summary>

O Bling desliga o webhook de um recurso quando os avisos falham por algum tempo, e marca o recurso com **Webhook inativo por erros na operação**. Siga [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md): lá está onde fica o aplicativo no Bling, como religar cada recurso e como trazer o que mudou enquanto ele estava desligado.

</details>

<details>

<summary>Deu erro depois de conectar</summary>

Abra **Deu erro na integração?**, clique em **Testar integração**, depois em **Reconectar** e autorize de novo. Por fim, confira se o **Link de redirecionamento** do aplicativo no Bling é o mesmo que a Uplaces mostra.

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

</details>

## Perguntas frequentes

<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, ou estiver com fatura em aberto, o Bling recusa a autorização. Consulte a ajuda do Bling.

</details>

<details>

<summary>Preciso reconectar de tempos em tempos?</summary>

Não. A renovação do acesso é automática. Só é preciso reconectar se o aplicativo for revogado no Bling.

</details>

## Veja também

* [Integração com o Bling](https://ajuda.uplaces.com.br/integracoes/bling.md)
* [Importar produtos e clientes do Bling](https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md)
* [Pedidos da Uplaces no Bling](https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md)
* [Webhook do Bling: configurar e reativar](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md)
* [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md)
