Bling — Integração de Pedidos

Conecte sua loja ao Bling para exportar pedidos, compartilhar informações de clientes e produtos e facilitar a gestão das vendas realizadas pela Nortgraf.

Para que serve a integração?

A integração permite conectar sua loja à plataforma de gestão Bling, facilitando o envio de informações comerciais sem precisar cadastrar manualmente os mesmos pedidos nos dois sistemas.

Após configurar e autorizar a conexão, você poderá utilizar os recursos de exportação disponíveis, incluindo o envio de pedidos e produtos.

Durante a exportação de pedidos, a Nortgraf prepara as informações do cliente, dos itens e dos valores para encaminhá-las à API do Bling.

A integração também permite acompanhar o resultado das operações e identificar situações que exigem atenção.

1 - Atenção e Regras

Antes de iniciar a configuração, observe algumas informações importantes:

Conta no Bling: É necessário possuir uma conta ativa no Bling para autorizar a integração.
Aplicativo: A conexão utiliza um aplicativo cadastrado no Bling, com Client ID e Client Secret.
Autorização OAuth: Informar as credenciais não conclui a conexão. É necessário autorizar o acesso à conta do Bling.
URL de retorno: O endereço de redirecionamento deve ser exatamente igual ao disponibilizado pela Nortgraf.
Permissões: O aplicativo precisa possuir as autorizações necessárias para consultar e enviar informações.
Pedidos: A exportação depende das informações cadastradas no pedido, incluindo cliente e itens.
Produtos: Os produtos e suas informações comerciais devem estar corretamente cadastrados para facilitar o processamento.
Segurança: O Client Secret é uma credencial privada e não deve ser compartilhado.
Reconexão: Caso a autorização seja revogada ou deixe de funcionar, poderá ser necessário conectar novamente a conta.

Importante: A integração com o Bling utiliza a API v3 e autenticação OAuth 2.0. Não é necessário informar manualmente um token de acesso obtido por métodos antigos.

2 - Criando ou Acessando sua Conta no Bling

Caso ainda não possua uma conta, realize o cadastro antes de configurar a integração.

Acesse www.bling.com.br.
Crie uma conta ou entre com seus dados de acesso.
Complete as informações solicitadas pelo Bling.
Verifique se a conta está habilitada para utilizar as funcionalidades necessárias.
Acesse o painel da plataforma.

Se você já possui uma conta ativa, poderá avançar para o cadastro do aplicativo.

3 - Cadastrando um Aplicativo no Bling

A conexão com a Nortgraf exige credenciais de um aplicativo cadastrado no Bling.

Passo 1 - Acessar a área de desenvolvedores

Entre na sua conta do Bling.
Acesse a área de aplicativos e integrações.
Localize a opção destinada ao cadastro ou gerenciamento de aplicativos.
Inicie o cadastro de um novo aplicativo.

Você também pode consultar o Portal de Desenvolvedores do Bling para obter informações sobre o cadastro e a utilização da API.

Passo 2 - Preencher os dados do aplicativo

Informe os dados solicitados para identificar sua integração.

Utilize um nome que facilite reconhecer o aplicativo, como Integração Nortgraf.

Durante o cadastro, será necessário informar o endereço de redirecionamento utilizado após a autorização.

URL de retorno

A Nortgraf disponibiliza esse endereço diretamente nas configurações da integração.

Para consultá-lo:

Abra o painel administrativo da sua loja na Nortgraf.
Acesse Configurações > Integrações.
Selecione Bling.
Localize o campo URL de retorno — cadastre no Bling.
Clique em Copiar.
Volte ao cadastro do aplicativo no Bling.
Cole o endereço no campo Link de redirecionamento.

Importante: Utilize exatamente o endereço fornecido pela Nortgraf, mesmo que sua loja possua domínio próprio.

Não substitua a URL pelo endereço da loja. Um redirecionamento incorreto impedirá a conclusão da autorização.

Passo 3 - Obter as credenciais

Após cadastrar o aplicativo, localize as credenciais disponibilizadas pelo Bling:

Client ID

Identifica o aplicativo que solicitará a autorização.

Client Secret

É a credencial secreta utilizada para autenticar o aplicativo durante a conexão.

Copie essas informações para utilizá-las na configuração da Nortgraf.

Atenção: Não envie seu Client Secret por mensagens, e-mails ou outros canais públicos. Informe essa credencial somente no campo apropriado da integração.

4 - Conectando o Bling à Nortgraf

Depois de criar o aplicativo e obter suas credenciais, retorne ao painel da Nortgraf.

Passo 1 - Informar as credenciais

Acesse Configurações > Integrações.
Abra a integração Bling.
Localize a seção de conexão.
Informe o Client ID.
Informe o Client Secret correspondente.
Salve as configurações.

Após salvar as credenciais, a Nortgraf poderá iniciar automaticamente o processo de autorização com o Bling.

Passo 2 - Autorizar a conta

Durante o processo de conexão:

Você será direcionado ao Bling.
Entre na sua conta, caso seja solicitado.
Confira as informações do aplicativo.
Analise as permissões solicitadas.
Autorize a conexão.
Aguarde o retorno ao painel da Nortgraf.

Quando a autorização for concluída corretamente, a integração apresentará a confirmação de conexão.

Importante: Não feche a página antes de concluir a autorização e retornar à Nortgraf.

5 - Validando a Conexão

Após conectar sua conta, confira se a integração está funcionando.

Como verificar?

Retorne às configurações do Bling na Nortgraf.
Confira o status da integração.
Utilize a opção de teste de conexão disponível no painel.
Aguarde o resultado da verificação.

O teste utiliza a autorização obtida durante a conexão para realizar uma consulta à API do Bling.

Se a conta ainda não tiver sido autorizada, o sistema solicitará que você conclua a conexão antes de executar o teste.

Resultado esperado

Uma conexão válida permite que a Nortgraf se comunique com os serviços autorizados do Bling.

Se ocorrer algum erro, confira as credenciais, o status da autorização e as permissões concedidas ao aplicativo.

6 - Configurando a Exportação de Pedidos

A Nortgraf permite configurar o comportamento de exportação dos pedidos para a integração.

Exportação automática

Na configuração do Bling, localize a opção Exportação automática de pedidos.

Selecione uma das opções disponíveis:

Ativada — Sincronizar automaticamente: permite utilizar o processamento automático de exportação.
Desativada: mantém a exportação automática desligada.

Após alterar a configuração, salve as informações.

Importante: O envio automático depende das condições e regras de processamento da integração. Um pedido precisa estar elegível e possuir os dados necessários para ser exportado.

7 - Exportando um Pedido para o Bling

Além da exportação automática, a integração possui recursos para o envio individual de pedidos.

Antes de exportar

Confira se o pedido possui:

Cliente identificado;
Informações cadastrais necessárias;
Pelo menos um item;
Quantidades e valores corretamente registrados;
Dados comerciais compatíveis com o envio ao Bling.

A ausência de informações essenciais pode impedir a exportação.

Como funciona?

Quando um pedido é encaminhado para exportação, a Nortgraf prepara seus dados e verifica as informações necessárias.

O processamento considera o vínculo do pedido com a integração.

Se o pedido ainda não possuir um identificador correspondente no Bling, o sistema poderá realizar a inclusão.

Quando já existe um vínculo válido, o sistema poderá encaminhar a atualização do pedido correspondente.

O resultado da operação é registrado para permitir o acompanhamento.

8 - Informações Enviadas ao Bling

Durante a exportação, a Nortgraf organiza os dados do pedido para utilização pela API do Bling.

Dados do cliente

O processamento considera informações como:

Nome do cliente;
Tipo de pessoa;
CPF ou CNPJ;
Telefone;
E-mail;
Endereço, quando disponível e aplicável.

Tratamento do telefone

O telefone é preparado para o formato utilizado pelo Bling.

Para números brasileiros, a Nortgraf remove caracteres de formatação e trata o código internacional quando ele estiver presente no formato esperado.

Por exemplo, um número armazenado com +55 poderá ser enviado utilizando DDD e número.

Esse tratamento ocorre durante a preparação dos dados e não exige que você modifique manualmente o telefone cadastrado.

Dados dos produtos e itens

O envio dos itens considera informações como:

Identificação do produto, quando disponível;
Código do produto ou SKU, quando aplicável;
Descrição do item;
Quantidade;
Valor unitário;
Informações comerciais necessárias ao pedido.

A descrição pode incluir características e especificações registradas durante a compra, conforme as informações disponíveis no item.

Itens avulsos

Pedidos com itens avulsos também podem ser tratados durante a exportação.

Quando um item não possui vínculo com um produto cadastrado, a Nortgraf utiliza as informações salvas no próprio pedido para preparar sua descrição, quantidade e valor.

Isso permite preservar dados comerciais registrados no momento da venda.

Importante: A exportação utiliza os dados disponíveis no pedido. Por isso, confira as descrições e os valores antes de realizar o envio.

9 - Exportação e Reexportação de Pedidos

O painel da integração pode disponibilizar operações de sincronização e reexportação.

Exportação

Utilizada para encaminhar pedidos elegíveis à integração.

Quando a operação é concluída, a Nortgraf registra o vínculo com o identificador retornado pelo Bling, quando disponível.

Reexportação

Utilizada quando é necessário reenviar informações de um pedido que já passou pelo processo de exportação.

Essa operação pode ser útil quando determinados dados foram atualizados ou quando é necessário repetir o envio.

Atenção: A reexportação deve ser utilizada com cuidado. Confira o pedido e o resultado anterior para evitar operações desnecessárias ou inconsistências no sistema de destino.

10 - Acompanhando as Sincronizações

Após utilizar os recursos de exportação, acompanhe os resultados apresentados pela Nortgraf.

As operações podem indicar:

Exportação concluída;
Atualização realizada;
Pedido sem dados mínimos;
Falha de autenticação;
Erro de validação retornado pelo Bling;
Falha de comunicação.

Quando uma operação apresentar erro, consulte as informações disponibilizadas no painel antes de tentar novamente.

Dica: Nas primeiras exportações, confira também o pedido diretamente no Bling para validar os dados recebidos.

11 - Reconectando a Conta do Bling

Em determinadas situações, a autorização da integração pode deixar de funcionar.

Isso pode ocorrer, por exemplo, quando o acesso do aplicativo é revogado ou quando as credenciais são alteradas.

Como reconectar?

Acesse Configurações > Integrações.
Abra Bling.
Confira o Client ID e o Client Secret cadastrados.
Corrija as credenciais, caso necessário.
Inicie novamente a conexão com o Bling.
Autorize o acesso à conta.
Retorne à Nortgraf.
Execute o teste de conexão.

Após a reconexão, verifique se os recursos de exportação estão disponíveis.

12 - Seções de Referência

Credenciais

Permite configurar o Client ID e o Client Secret utilizados na autenticação.

URL de Retorno

Exibe o endereço que deve ser cadastrado como Link de redirecionamento no aplicativo do Bling.

Autorização OAuth

Permite conectar a conta e conceder acesso à integração.

Exportação Automática de Pedidos

Define se a integração utilizará o processamento automático para envio de pedidos elegíveis.

Teste de Conexão

Verifica se a autorização permite a comunicação com a API do Bling.

Exportação e Reexportação

Disponibiliza operações para envio ou reenvio de informações, conforme as opções habilitadas no painel.

Status da Integração

Permite acompanhar o estado da conexão e identificar situações que exigem uma nova autorização.

13 - Problemas Comuns

Não consigo conectar minha conta ao Bling.

Confira se o Client ID e o Client Secret pertencem ao mesmo aplicativo e se os dados foram informados corretamente na Nortgraf.

Apareceu o erro "redirect_uri_mismatch".

O endereço de redirecionamento cadastrado no Bling não corresponde ao utilizado pela Nortgraf.

Copie novamente o campo URL de retorno — cadastre no Bling, atualize o Link de redirecionamento do aplicativo e tente conectar novamente.

O teste informa que preciso conectar a conta.

As credenciais podem estar salvas, mas a autorização OAuth ainda não foi concluída. Inicie a conexão, autorize o aplicativo no Bling e repita o teste.

A autorização expirou ou não foi concluída.

Retorne à configuração do Bling na Nortgraf e inicie novamente o processo de conexão.

Meu pedido não foi exportado.

Confira se o pedido possui cliente e itens cadastrados, se a integração está autorizada e se a exportação está habilitada ou foi iniciada corretamente.

O telefone do cliente não aparece como esperado.

Confira o telefone cadastrado. A Nortgraf prepara o formato do número brasileiro durante a exportação, mas informações ausentes ou incorretas devem ser ajustadas no cadastro do cliente.

A descrição de um item está diferente.

Verifique as informações registradas no pedido, incluindo características e especificações selecionadas durante a compra.

Um item avulso não possui SKU.

Itens avulsos podem ser encaminhados utilizando os dados registrados no pedido, sem depender obrigatoriamente de um produto cadastrado no catálogo.

Não consigo reexportar um pedido.

Verifique a conexão com o Bling, a situação do pedido e as mensagens retornadas durante a tentativa de reexportação.

O Bling retornou um erro durante o envio.

Confira os dados do cliente, do pedido e dos produtos envolvidos. Algumas validações são realizadas diretamente pela API do Bling e precisam ser atendidas para concluir a operação.

Dica: Após conectar o Bling, realize a exportação de um pedido de teste e confira o resultado diretamente na plataforma de destino. Verifique o cliente, telefone, descrições dos itens, quantidades e valores antes de utilizar a integração em sua rotina de vendas.