Manual de Integração Bling ERP

1. Introdução

O conector oficial da PAIRUS para o Bling ERP v3 foi desenvolvido para automatizar completamente a higienização de nomes e descrições de produtos, bem como auditar a tributação fiscal (NCM, CEST, alíquotas da Reforma Tributária IBS/CBS e Imposto Seletivo) diretamente no seu estoque do Bling.

Para sua conveniência e flexibilidade, a PAIRUS oferece dois métodos distintos de conexão. Escolha o que melhor se adapta às suas necessidades operacionais.

2. Métodos de Integração Disponíveis

Característica	Método 1: Automático (Recomendado)	Método 2: Manual (Configuração Customizada)
Instalação	Zero-Code. Feita através do fluxo de login (OAuth 2.0)	Manual. Exige criação de chaves e configuração de webhook
Webhook / Sincronismo	Vinculado e ativado automaticamente	Exige copiar e colar o link de webhook no Bling
Credenciais	Armazenadas via Token de acesso seguro no servidor	Chave de API do próprio usuário configurada na PAIRUS
Recomendado para	Todos os usuários que desejam automação em tempo real rápida	Desenvolvedores ou cenários de integração privada restrita

3. Passo a Passo: Método 1 (Conexão Automática)

Este é o método recomendado e mais seguro, pois utiliza a autenticação OAuth 2.0 padrão da Bling Store.

1. Acesse o seu painel de cliente da PAIRUS e navegue até a aba Conectores ERP.
2. No card correspondente ao Bling ERP v3, localize e clique no botão laranja 🔗 Conectar Conta.
3. Você será redirecionado para a tela oficial de login e consentimento do Bling. Caso não esteja logado, informe as credenciais de sua conta Bling.
4. Na tela de concessão de acessos, confira as permissões solicitadas e clique no botão verde Autorizar.
5. Após autorizar, você será redirecionado de volta para a Dashboard da PAIRUS.
6. O status do Bling no card mudará para ● Conectado. Pronto! Toda a sincronização de webhooks já foi configurada de forma totalmente invisível.

4. Passo a Passo: Método 2 (Conexão Manual)

Use este método apenas se preferir realizar a integração por meio de chaves de API privadas criadas diretamente no seu painel do Bling.

1. No painel do Bling, navegue até Preferências > Sistema > Usuários e Perfis de Acesso e crie um usuário do tipo API.
2. Gere e copie a Chave de API (API Key) com permissão nos escopos de "Produtos" e "Estoque".
3. Cole a Chave de API gerada no formulário de conexões na Área do Cliente da PAIRUS.
4. Para ativar a sincronização em tempo real das atualizações de produtos, você precisará configurar o Webhook no Bling:
   • Copie a URL de Webhook para cadastrar no Bling exibida no card do Bling no painel da PAIRUS.
   • No Bling, vá em Cadastro de Aplicativos (ou Central de Extensões) > Webhooks.
   • Insira a URL que você copiou no campo de servidores e marque a opção de notificação para Produtos (Criação e Alteração).
   • Salve as configurações no Bling.

5. Como Testar se Tudo Funcionou

Após concluir a conexão utilizando qualquer um dos métodos acima, você pode verificar o funcionamento em tempo real da seguinte forma:

1. Acesse a sua conta do Bling e vá ao cadastro de produtos (Cadastros > Produtos).
2. Crie ou edite um produto de teste. Insira um nome com abreviações ou marcas sem formatação e um NCM genérico (ex: `refri coca 350ml lata`, NCM `00000000`).
3. Salve o produto no Bling.
4. Aguarde cerca de 5 a 10 segundos para que a PAIRUS execute a IA em segundo plano.
5. Atualize a página do produto no Bling. Você notará que o nome foi limpo (ex: `Refrigerante Coca-Cola 350ml Lata`), o NCM foi corrigido para o código oficial e as alíquotas da Reforma Tributária foram saneadas automaticamente!

6. Suporte Avançado

Se você encontrar qualquer dificuldade no processo de autenticação ou tiver dúvidas sobre as alíquotas fiscais aplicadas aos seus produtos, a nossa equipe de suporte está à sua inteira disposição:

• E-mail de Suporte Técnico: suporte@pairus.com.br
• WhatsApp Comercial: (11) 99999-9999