# 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. 1. Acesse [www.bling.com.br](http://www.bling.com.br). 2. Crie uma conta ou entre com seus dados de acesso. 3. Complete as informações solicitadas pelo Bling. 4. Verifique se a conta está habilitada para utilizar as funcionalidades necessárias. 5. 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 1. Entre na sua conta do Bling. 2. Acesse a área de aplicativos e integrações. 3. Localize a opção destinada ao cadastro ou gerenciamento de aplicativos. 4. Inicie o cadastro de um novo aplicativo. Você também pode consultar o [Portal de Desenvolvedores do Bling](https://developer.bling.com.br/) 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: 1. Abra o painel administrativo da sua loja na Nortgraf. 2. Acesse **Configurações > Integrações**. 3. Selecione **Bling**. 4. Localize o campo **URL de retorno — cadastre no Bling**. 5. Clique em **Copiar**. 6. Volte ao cadastro do aplicativo no Bling. 7. 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 1. Acesse **Configurações > Integrações**. 2. Abra a integração **Bling**. 3. Localize a seção de conexão. 4. Informe o **Client ID**. 5. Informe o **Client Secret** correspondente. 6. 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: 1. Você será direcionado ao Bling. 2. Entre na sua conta, caso seja solicitado. 3. Confira as informações do aplicativo. 4. Analise as permissões solicitadas. 5. Autorize a conexão. 6. 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? 1. Retorne às configurações do Bling na Nortgraf. 2. Confira o status da integração. 3. Utilize a opção de teste de conexão disponível no painel. 4. 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? 1. Acesse **Configurações > Integrações**. 2. Abra **Bling**. 3. Confira o Client ID e o Client Secret cadastrados. 4. Corrija as credenciais, caso necessário. 5. Inicie novamente a conexão com o Bling. 6. Autorize o acesso à conta. 7. Retorne à Nortgraf. 8. 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.