Conectar o Bling

Com o Bling conectado, cada pedido pago no Vipter vira um pedido de venda no Bling, com o contato, os itens, o frete, o desconto e as parcelas. O Bling pode gerar a NF-e e baixar o estoque, e a nota e o rastreio voltam para o pedido no Vipter.

Antes de começar, vale ler como funciona a integração com o ERP: o que vai no pedido de venda, como os produtos são encontrados e o que acontece no reembolso.

Duas formas de conectarCopiar link da seção

• Pelo aplicativo do Vipter: quando o card Conexão mostra a chave Usar meu próprio aplicativo do Bling, deixe a chave desligada. Clique em Conectar e autorize o Vipter na sua conta do Bling. Você não precisa criar nenhum aplicativo. Os avisos de nota e rastreio também chegam sozinhos. Pule para o passo 2.
• Por um aplicativo seu: quando o card não mostra a chave, ou quando a sua empresa exige um aplicativo próprio e você liga a chave. Siga todos os passos.

Trocar de uma forma para a outra desfaz a conexão. Depois de salvar, o painel avisa o aplicativo mudou, conecte de novo: clique em Reconectar.

Passo 1: criar o aplicativo no BlingCopiar link da seção

1. No painel do Vipter, abra Geral›Integrações›ERP›Bling e copie a URL de retorno (redirecionamento) do card Conexão, pelo botão de copiar.
2. No Bling, abra Central de Extensões›Área do Integrador e clique em Criar aplicativo.
3. Escolha o aplicativo para uso privado e preencha os dados que o Bling pede, como o nome.
4. Em Link de redirecionamento, cole a URL que você copiou do Vipter, sem mudar nada.
5. Em Lista de escopos, clique em Adicionar e inclua: Contatos, Produtos, Pedidos de venda, Notas fiscais eletrônicas, Formas de pagamento, Situações, Logísticas e Dados básicos da empresa.
6. Salve o aplicativo. Na aba Informações do app, copie o Client ID e o Client Secret e guarde para o passo 2.

Passo 2: conectar no VipterCopiar link da seção

1. Abra Geral›Integrações›ERP›Bling.
2. Com aplicativo seu, preencha os campos do card Conexão:

3. Clique em Conectar ao Bling. O Vipter salva a página e abre o Bling.
4. Entre na conta do Bling da sua empresa e autorize o acesso.

O acesso ao Bling dura algumas horas e o Vipter renova sozinho, antes de vencer. A linha embaixo do estado mostra até quando vale o acesso atual.

Passo 3: cadastrar os avisos no BlingCopiar link da seção

Este passo é só para quem conecta com aplicativo próprio. Com o aplicativo do Vipter, o card diz O aplicativo do Vipter recebe os avisos do Bling sozinho. Você não precisa cadastrar nada.

Os avisos levam a NF-e e o rastreio do Bling para o Vipter assim que mudam.

1. Depois de salvar, o card Conexão mostra a URL de avisos, em Avisos do ERP (webhooks). Copie a URL.
2. No Bling, abra o seu aplicativo na Área do Integrador e entre na aba Webhooks.
3. Cadastre a URL do Vipter como servidor.
4. Ative os recursos Pedido de venda e Nota fiscal, com as ações de criação e de alteração, na versão 1 do conteúdo.
5. Salve.

O Bling assina cada aviso com o Client Secret do aplicativo, e o Vipter recusa os avisos com outra assinatura. Se você gerar um Client Secret novo no Bling, cole o novo no Vipter e salve.

Quando o primeiro aviso chega, o card mostra Último aviso recebido em 04/10/2026 15:42. Sem avisos, o Vipter consulta o Bling a cada 3 horas, então a nota e o rastreio chegam mesmo assim, só que mais tarde.

Passo 4: escolher o que enviarCopiar link da seção

O card O que enviar diz quais pedidos vão e o que o Bling faz com eles.

• Pedidos enviados (1): Só pedidos com entrega, o padrão, ou Todos os pedidos pagos.
• Gerar a NF-e no ERP (2): o Bling gera a NF-e do pedido de venda. Ligado, aparecem Transmitir a NF-e à SEFAZ, para transmitir na hora em vez de deixar como rascunho, e ERP envia a NF-e por e-mail ao cliente.
• Lançar o estoque do pedido (3): o Vipter lança a saída do estoque no Bling. Ligue só se o Bling não baixa o estoque sozinho ao emitir a nota.
• Cancelar no ERP quando o pedido for estornado (4): vem ligado. No estorno total ou no chargeback, o pedido de venda vai para a situação Cancelado e o estoque lançado pelo Vipter volta.
• Criar no ERP os produtos que faltarem (5): Desligado, o pedido fica com erro até você informar o código do produto no Bling em Produtos. Ligado, o Vipter cria no Bling o produto que falta.
• Integração ativa: desligado, nada vai para o Bling e as novas tentativas param.

Cada opção está explicada em como funciona a integração com o ERP.

Passo 5: preencher os dados do BlingCopiar link da seção

O card Dados do ERP recebe os números de cadastros do próprio Bling. Deixe em branco o que você não usa: o Vipter descobre sozinho a situação Cancelado e as formas de pagamento.

Abaixo, em Formas de pagamento, há um campo por método de pagamento do Vipter: Cartão de crédito, Cartão de débito, PIX, Boleto e Carteira digital. Em branco, o Vipter usa a forma de pagamento ativa do tipo certo, a padrão primeiro. Sem nenhuma forma, o Bling aplica a condição de pagamento dele e o pedido vai sem parcelas.

Todos os IDs aceitam só números. Clique em Salvar.

Passo 6: informar os códigos dos produtosCopiar link da seção

O card Produtos lista os produtos do Vipter, os com entrega primeiro. O Vipter encontra cada produto no Bling pelo código (SKU). Em branco, o código é o ID do produto no Vipter.

1. Ao lado de cada produto, digite o código que ele tem no Bling. Deixe em branco os produtos cujo código no Bling já é o ID do Vipter.
2. Clique em Salvar códigos.

Depois da primeira venda de cada produto, a linha mostra vinculado ao ID 16123456789 no ERP.

Passo 7: testarCopiar link da seção

1. Clique em Testar conexão. Aparece Conexão funcionando, com o nome e o CNPJ da empresa.
2. Faça uma compra de teste de um produto com entrega, ou abra um pedido pago e clique em Enviar ao Bling no card ERP.
3. Veja o pedido em Pedidos enviados, no fim da página da integração.

O pedido de teste é um pedido de venda de verdade no Bling. Depois de conferir, cancele no Bling. Com tudo certo, ligue a NF-e e o estoque, se for usar, e salve.

Ligar, desligar e removerCopiar link da seção

• Integração ativa: desligado, nada vai para o Bling, as novas tentativas param e os avisos são ignorados. Os pedidos pagos nesse período não vão depois sozinhos: religue e envie cada um pelo card do pedido.
• Remover integração: Remover a integração com o Bling? A conexão e o histórico de pedidos enviados são apagados. Os pedidos que já estão no ERP continuam lá.

Problemas comunsCopiar link da seção

• A conexão não foi concluída: o ERP não aceitou o código de autorização

  O painel mostra A conexão não foi concluída: … com o motivo. Esse motivo quer dizer que o Client ID ou o Client Secret estão errados: copie os dois de novo da aba Informações do app, salve e clique em Conectar ao Bling.

• Depois de autorizar, o Bling levou para outro endereço

  O Link de redirecionamento do aplicativo é diferente da URL de retorno (redirecionamento). Cole a URL do Vipter no aplicativo, salve no Bling e conecte de novo.

• A conexão não foi concluída: o link de autorização expirou

  O link vale por 20 minutos. Clique em Conectar ao Bling de novo e autorize logo em seguida.

• Informe o Client ID e o Client Secret do seu aplicativo e salve.

  Falta o Client ID ou o Client Secret do aplicativo. Preencha os dois e salve antes de conectar.

• O card mostra Expirada

  A autorização do Bling expirou. Clique em Reconectar e autorize de novo. Os pedidos que falharem nesse meio-tempo são reenviados depois. Isso acontece quando o aplicativo foi apagado ou teve o Client Secret trocado no Bling, ou quando o acesso foi revogado. Os pedidos que esgotarem as novas tentativas nesse meio-tempo precisam do Reenviar.

• Produto sem cadastro no ERP com este código. Informe o código em Produtos ou ligue a criação de produtos

  O Bling não tem um produto ativo com o código que aparece no erro. Cadastre o produto no Bling ou informe o código certo no passo 6. Depois, clique em Reenviar.

• O pedido ficou como Falhou com uma mensagem do Bling

  O Bling recusou um dado, e a mensagem diz qual, como um ID de loja ou de natureza que não existe na sua conta. Corrija o campo no passo 5, salve e clique em Reenviar.

• Erros 429, de limite de chamadas

  O Bling aceita até 3 chamadas por segundo em cada conta. O Vipter espera a vez entre uma chamada e outra e tenta de novo quando o Bling pede para esperar. Se outro sistema usa muito a mesma conta, um pedido pode falhar assim: as novas tentativas resolvem sozinhas.

• O estorno ficou como Falha ao cancelar

  O Bling recusou a mudança de situação. Confira o ID da situação Cancelado, ou deixe em branco para usar a situação Cancelado, salve e clique em Reenviar.

• Nenhum aviso recebido ainda. Sem avisos, o Vipter consulta o ERP a cada poucas horas.

  Confira se a URL está na aba Webhooks do aplicativo, com Pedido de venda e Nota fiscal ativos. O Bling desativa um webhook que falha por dias seguidos: nesse caso, ative de novo por lá. Se você trocou o Client Secret, atualize no Vipter.

O que fazer a seguirCopiar link da seção

• Entenda o pedido de venda, a NF-e, o reembolso e as novas tentativas em como funciona a integração com o ERP.
• Confira o card ERP na página de um pedido em Detalhe do pedido.