Autenticação e credenciais

Cadastro inicial: criar a conta no Koncili, criar o aplicativo no Bling (na Central de Extensões) e conectar as duas pontas via OAuth. Feito uma vez por cliente.

Passo 1

Criar a conta do Bling ERP no Koncili

No Koncili, acesse Integrações no menu lateral e escolha o card Bling.

Tela de Integrações do Koncili com o card Bling ERP

Clique em Criar nova conta.

Tela Bling ERP no Koncili com o botão Criar nova conta

Na tela de criação, copie a URL de redirecionamento exibida (somente leitura, botão Copiar) — esse link será colado no cadastro do aplicativo no Bling (Passo 6).

Tela Bling ERP no Koncili com a URL de redirecionamento e o botão Copiar — Tela de criação da conta Bling ERP no Koncili — copie a **URL de redirecionamento** (botão Copiar).

Passo 2

Abrir a Central de Extensões do Bling

No Bling, clique no ícone de grade (⊞) no canto superior direito do cabeçalho, ao lado do sino de notificações — ele abre a Central de Extensões.

Dashboard do Bling com o ícone de grade destacado no canto superior direito — No cabeçalho do Bling, clique no ícone de grade (⊞) — abre a Central de Extensões.

Passo 3

Acessar a Área do Integrador

Na Central de Extensões, na aba Descubra, clique em Área do integrador, no canto superior direito da tela.

Central de Extensões do Bling na aba Descubra com o botão Área do integrador destacado — Central de Extensões > Descubra > **Área do integrador** (canto superior direito).

Passo 4

Criar o aplicativo

Na Área do Integrador, seção Cadastro de aplicativos, clique em + Criar aplicativo.

Tela Cadastro de aplicativos do Bling com o botão Criar aplicativo destacado — Cadastro de aplicativos — clique em **+ Criar aplicativo**.

Passo 5

Escolher o tipo do aplicativo

Selecione o tipo API ("Tenha acesso à API v3 do Bling!") e, em Selecione o uso do aplicativo, escolha Privado — para usar a API só na própria conta do cliente.

O tipo Público (operar em contas de terceiros e publicar na Central de Extensões) não se aplica a esta integração.

Seleção do tipo do aplicativo no Bling: API e uso Privado marcados — Tipo do aplicativo: **API** + uso **Privado**.

Passo 6

Preencher dados básicos, redirecionamento e escopos

Em Dados básicos, preencha nome, categoria (ERP), descrição e descrição curta. No campo Link de redirecionamento, cole a URL copiada no Passo 1.

Formulário Dados básicos do aplicativo no Bling com nome, categoria ERP e link de redirecionamento — Dados básicos — nome, categoria **ERP** e o **Link de redirecionamento** copiado no Passo 1.

Em Lista de escopos, adicione as permissões que a integração usa:

Categorias — Receitas e Despesas
Contas a Receber
Contas a Receber: Baixar contas a receber
Notas Fiscais
Pedidos de Venda

Lista de escopos do aplicativo Bling com as cinco permissões marcadas — Lista de escopos — as cinco permissões da integração marcadas.

Passo 7

Copiar o Client ID e o Client Secret

Ao salvar, o Bling gera o Client ID e o Client Secret na aba Informações do app. Copie os dois valores (ícone de copiar ao lado de cada campo) — serão colados no Koncili no próximo passo.

Aba Informações do app do Bling com Client ID e Client Secret — Informações do app — copie o **Client ID** e o **Client Secret** (valores ocultados nesta imagem).

Passo 8

Conectar a conta no Koncili

Volte para a tela de criação da conta no Koncili. Cole o Client ID e o Client Secret nos campos correspondentes (ambos obrigatórios na criação; o secret é opcional de reenviar numa edição futura) e dê um nome à conta.

Preencha também a Data de início da sincronização das contas a receber — data a partir da qual o Koncili passa a buscar os títulos no Bling (no máximo 1 ano atrás e não editável depois; ver Limitações importantes).

Clique em Conectar com Bling para abrir a autorização OAuth e, após concluir a autenticação, clique em Salvar.

Exclusão do aplicativo: o Bling avisa, na tela de Informações do app, que excluir o aplicativo revoga automaticamente os tokens de acesso — os usuários conectados perdem acesso e a integração para de funcionar até recriar o app e reconectar.

Conexão inválida: se o acesso ficar cerca de 30 dias sem uso, a autorização é rejeitada e a conexão fica inválida — reconecte a conta pelo botão Reconectar (ver Limitações importantes).