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

# Bling

> Como conectar o ERP Bling à Velan via OAuth 2.0 para emissão de NF-e e sincronização de pedidos.

A integração Bling usa **OAuth 2.0 Authorization Code**. As credenciais (`client_id` e `client_secret`) são configuradas no painel da Velan antes de iniciar o fluxo.

***

## Passo a passo

```
1. Crie um app no portal do Bling e copie client_id e client_secret
2. No painel da Velan, acesse Integrações e clique em INTEGRAR no card do Bling
3. Informe o client_id e client_secret no modal de configuração
4. Clique em Autorizar — você é redirecionado para o Bling
5. Autorize o acesso no Bling
6. O Bling retorna para a Velan, que salva os tokens e ativa a integração
```

***

## 1. Criar app no Bling

Acesse o portal de desenvolvedores do Bling, crie um aplicativo e configure o **Redirect URI** para:

```
https://api.velan.app/v1/integrations/bling/callback
```

Copie o `client_id` e `client_secret` gerados.

***

## 2. Fluxo OAuth (referência técnica)

A Velan redireciona o usuário para:

```
https://www.bling.com.br/Api/v3/oauth/authorize?
  response_type=code&
  client_id={client_id}&
  state={company_code}&
  redirect_uri=https://api.velan.app/v1/integrations/bling/callback
```

Após autorização, o Bling redireciona para o callback da Velan, que troca o `code` pelos tokens e os salva na integração.

Em caso de **sucesso**, o usuário é redirecionado para o painel em:

```
/dashboard/integrations/bling-success
```

Em caso de **falha**:

```
/dashboard/integrations/bling-fail
```

***

## Reautorização

Se o `access_token` expirar, acesse o painel, remova a integração Bling existente e refaça o fluxo a partir do passo 2.