Como integrar a LojaVirtual ao Bling

A integração Bling V2 conecta a loja ao Bling para exportar pedidos elegíveis, vincular produtos e sincronizar estoque configurado. Use Loja > Aplicativos e integrações > Bling V2 para acompanhar a conexão.

Comece pela conta correta

Ao entrar diretamente no painel v2 como titular, selecione a loja desejada e abra Loja > Aplicativos e integrações > Bling V2. Não é necessário fazer login antes no painel V1. A integração deve manter a mesma loja e o mesmo usuário do login; confira o nome no cabeçalho e no menu lateral antes de configurar a conexão.

Ao selecionar outra loja no login, as sessões dos módulos passam a usar a loja escolhida. Abas antigas podem pedir que você entre novamente ou atualize a página. Se aparecer uma loja diferente da selecionada, saia do painel e faça login novamente, selecionando a loja correta. Se a diferença persistir, procure o suporte antes de alterar a integração. A mensagem Nenhuma conexão cadastrada se refere à loja aberta; ela não significa que a conexão de outra loja foi removida.

Para acessos da equipe, consulte usuários e permissões do painel.

1. Conecte e autorize a conta da empresa que deve receber os dados.
2. Confira o estado da conexão e as permissões necessárias.
3. Habilite a exportação de pedidos quando estiver pronto para utilizá-la.
4. Revise os vínculos de produtos e, se usar o saldo do ERP, configure o depósito de estoque.
5. Acompanhe os resultados e as pendências no painel.

Pedidos da operação atual, aprovados e elegíveis, podem ser exportados junto dos dados de contato necessários. A conexão não importa automaticamente todo o histórico da loja nem transforma qualquer pedido antigo em uma exportação nova.

A autorização do Bling não foi concluída

O estado Credenciais cadastradas confirma que os dados foram salvos. A exportação só pode ser ativada depois de concluir a autorização. Se voltar ao painel com uma falha, clique em Atualizar estado e leia o motivo na seção Conexão.

• Permissão não concedida: clique em Autorizar no Bling e conclua a permissão na conta desejada.
• Solicitação ou autenticação recusada: confira as credenciais do aplicativo e, quando indicado, a URL de retorno. Uma recusa genérica não comprova qual desses dados está incorreto.
• Acesso negado: confira as permissões do aplicativo, incluindo a consulta dos dados da empresa.
• Limite de tentativas ou falha de comunicação: aguarde alguns instantes e inicie uma nova autorização.
• Falha ao ler credenciais ou conta diferente da vinculada: procure o suporte antes de substituir os dados.
• Conta Bling já utilizada em outra conexão: uma nova autorização substitui a conexão anterior. A anterior fica desconectada, com sincronização pausada e histórico preservado. A nova conexão também começa pausada; confira suas opções antes de ativar a exportação.
• Operação em andamento: aguarde alguns instantes e autorize novamente. A substituição não interrompe uma operação que ainda esteja usando a conexão anterior.

Falhas antigas podem continuar sem motivo específico. Informe ao suporte o horário da tentativa e a mensagem exibida, sem enviar Client Secret, tokens ou a URL completa de autorização. A exportação permanece pausada até a conexão ser autorizada e ativada.

Se precisar trocar os dados, consulte como desconectar e substituir credenciais.

Como desconectar a conta Bling e substituir as credenciais

1. Abra Gerenciar conexão e localize a seção Autorização.
2. Marque Quero desconectar a conta Bling. Com o estado carregado e sem operação em andamento, o botão Desconectar conta fica habilitado, mesmo com alterações não salvas nas opções de exportação, pagamentos ou estoque.
3. Clique em Desconectar conta e aguarde a confirmação. A desconexão pausa os envios, revoga o acesso e preserva o histórico e as configurações já salvas. As alterações não salvas na tela são descartadas após a operação.
4. Para trocar as credenciais, use Substituir credenciais após a desconexão. Depois, autorize a conta correta no Bling e ative a exportação quando estiver pronto para retomar os envios.

Se o botão continuar desabilitado, aguarde a operação em andamento e confirme se a conta já está desconectada. Após uma falha, clique em Atualizar estado. Se aparecer Desconexão pendente, confirme a opção e tente desconectar novamente: a pausa dos envios não significa que a revogação foi concluída.

Antes de retomar, confira os vínculos de produtos e o depósito de estoque da conta autorizada.

Como o status do pedido é atualizado no Bling

Depois que um pedido é exportado e vinculado pela integração Bling V2, as alterações de situação na LojaVirtual são acompanhadas automaticamente, com a conexão ativa e a exportação de pedidos habilitada. A atualização acontece em segundo plano; salvar o pedido não significa que o Bling já recebeu a mudança.

Mudanças com a mesma correspondência, como de Aguardando envio para Enviado, não reenviam a situação. Em disputa não significa cancelamento. O acompanhamento considera o estado atual: mudanças rápidas podem ser agrupadas antes do próximo processamento.

Se a LojaVirtual mostrar Concluído e o Bling continuar Em aberto, confira a autorização da conta, a conexão ativa, a exportação habilitada e as permissões de consulta de situações e alteração de pedidos de venda no Bling. A conta precisa ter uma única situação com o nome correspondente. Falhas são tentadas novamente com intervalo; se a divergência persistir, informe ao suporte o número do pedido e o horário da alteração.

Esse fluxo não cria outro pedido, não importa situações do Bling para a LojaVirtual e não passa a acompanhar automaticamente pedidos enviados pela integração antiga. Alterações feitas somente no Bling não são monitoradas por este fluxo. As ações automáticas associadas às transições no Bling dependem da configuração do ERP; revise-as antes de utilizar a sincronização.

Veja também como acompanhar pedidos e atualizar o status da venda.

Uma exportação falhou?

Leia o motivo e confira autorização, dados do cliente e vínculos dos itens antes de repetir. Uma tentativa com resultado incerto precisa ser conferida para evitar duplicações.

Confirmei o pagamento no painel e o pedido não foi enviado

A aprovação do lojista pode autorizar a exportação mesmo quando o Pix está pendente ou expirou, desde que a aprovação esteja registrada, o pedido seja elegível e a forma de pagamento esteja associada no Bling. Essa ação não confirma nem cobra o pagamento no gateway: o pedido enviado identifica a confirmação feita pelo lojista. Cobranças de teste, estornos, disputas e dados financeiros conflitantes continuam sujeitos a revisão.

Se o documento da nova compra for diferente do usado em uma compra anterior do mesmo cadastro, a integração procura ou cria o contato correspondente ao documento do pedido. O contato e os pedidos anteriores são preservados. Contatos ambíguos ou sem correspondência segura precisam de revisão.

Após a correção da integração, pedidos que estavam bloqueados apenas por esses dois motivos são reavaliados em segundo plano, com a conexão ativa. Não é necessário cancelar o pedido, refazer a aprovação ou criar outra compra. Envios com resultado incerto permanecem protegidos contra duplicação. Confira o resultado em Atualizar estado; outras pendências podem exigir correção de dados ou configuração.

A conexão descrita neste guia é a Bling V2. Para vender em marketplaces pelo ERP, confira também as configurações e os serviços contratados no Bling; conectar sua loja não ativa esses canais automaticamente.

Atualizar produtos no Bling automaticamente

Ative o envio de nome, preço e estoque da LojaVirtual ao Bling e escolha o depósito de destino. A primeira passagem usa os valores atuais; as seguintes detectam mudanças locais. Essa opção é independente da exportação de pedidos e não traz alterações do ERP para a loja.