Guia grátis para lojas WooCommerce

Integração do Bling com o WooCommerce: como conectar e fazer o CPF chegar.

A integração atual não usa plugin: o Bling entra pela API do WooCommerce e cria os webhooks na loja. Ligamos uma conta de verdade numa loja de teste e olhamos o que ele pede, o que grava e por que o cadastro do cliente pode nascer sem CPF, número e bairro.

BW.S1 — Conectar

Três passos para integrar.

1. A chave no WooCommerce

Em WooCommerce, Configurações, Avançado, API REST, clique em Adicionar chave e escolha permissão de leitura e escrita. O segredo só aparece nessa hora: deixe a tela aberta até terminar.

2. A loja no Bling

Na Central de Extensões, em Plataforma de e-commerce, abra WooCommerce Webhook e clique em Conectar. Preencha o endereço da loja, a chave e o segredo. O método de autenticação vem em SSL, e também há OAuth (HTTP), Basic Auth e SSL + User-Agent.

3. As regras

Dê um nome à loja e escolha as regras: importar estoque e imagens dos produtos e como cada situação do pedido no WooCommerce entra no Bling. Por padrão, todas entram como Em aberto, inclusive Cancelado e Falhado: vale revisar.

Passos feitos numa conta real do Bling em 4 de novembro de 2026, com WooCommerce 11.2.1. Os nomes das telas podem mudar: a ajuda do Bling é a referência dele.

BW.S2 — Na loja

O que ele faz no seu site.

Lê a API com a sua chave

O log da loja mostrou o Bling chamando /wp-json/wc/v3/ com a chave e o segredo na própria URL, e sem User-Agent. É por isso que firewall de WordPress costuma barrar: a ajuda do Bling cita o Wordfence, o iThemes Security e o Mod_security da Hostgator.

Cria três webhooks

Produto criado, Pedido criado e Pedido atualizado, todos apontando para o Bling. Cada vez que salvamos a configuração, ele criou mais três iguais: terminamos com nove, e cada pedido novo gerou seis entregas. Ficam em WooCommerce, Configurações, Avançado, Webhooks.

Importa pedidos antigos à parte

Webhook só vale para venda nova. Para as anteriores, o Bling manda usar Importar pedidos manualmente, no menu de Vendas: na tela Pedidos de lojas virtuais, escolha a loja e clique em Visualizar. Foi por ela que os nossos pedidos entraram.

A loja de teste estava num endereço temporário, com WooCommerce 11.2.1 e sem nenhum plugin do Bling.

BW.S3 — O cadastro

Por que o CPF some, e como chega.

O que a ajuda do Bling exige

Ela diz que o Brazilian Market é obrigatório, porque é por ele que o Bling captura contato e endereço de entrega. E diz que o plugin do próprio Bling foi descontinuado. Se a sua loja usa o checkout clássico com o Brazilian Market, siga por aí.

Com o Checkout Brasil grátis

CPF, número e bairro ficam no pedido, mas não saem na API do WooCommerce, então o Bling não os recebe. No nosso teste, o cliente entrou no Bling só com nome, rua, CEP, cidade e telefone: CPF, número e bairro em branco.

Com o Checkout Brasil Pro

Sem o Brazilian Market instalado, a API passou a levar os campos, e o cliente de teste entrou no Bling como Pessoa Física, com CPF 111.444.777-35, bairro Santa Helena, número 777 e complemento Apto 402, cada um no seu campo.

Ver o Pro, R$ 197 por ano
"billing": { "persontype": "F", "cpf": "111.444.777-35", "number": "777", "neighborhood": "Santa Helena" }

É o trecho do pedido de teste na API do WooCommerce com o Pro ativo. Para conferir a sua loja, abra /wp-json/wc/v3/orders/ID com a chave e procure esses campos dentro de billing. O checkout em blocos com o Brazilian Market 4.0.2 é outro caso: o pedido nem grava o CPF.

BW.S4 — Limites

O que ficou de fora do teste.

Estoque, rastreio e nota fiscal

Não testamos. Medimos o caminho do pedido e do cadastro do cliente. Atualizar estoque, devolver o rastreio à loja e emitir nota fiscal dependem de produto vinculado e de plano ativo no Bling.

Conta sem plano

A conta usada estava com o período de testes vencido. Os webhooks responderam com sucesso, mas os pedidos novos não apareceram sozinhos nas vendas em mais de 5 minutos: entraram pela importação. Não sabemos se é o plano vencido. Confira na sua conta.

Sua loja

Não medimos o Bling com tema, firewall ou hospedagem de terceiros. Antes de vender, faça um pedido de teste e abra o cadastro do cliente no Bling.

BW.S5 — Perguntas

O que perguntam sobre o Bling no WooCommerce.

Como integrar o Bling com o WooCommerce?

No WooCommerce, gere uma chave em Configurações, Avançado, API REST, com permissão de leitura e escrita. No Bling, abra a Central de Extensões, procure WooCommerce Webhook em Plataforma de e-commerce, clique em Conectar e preencha o endereço da loja, a chave e o segredo. Depois é dar um nome à loja e escolher as regras de produtos e pedidos.

Existe plugin do Bling para WooCommerce?

Não mais. A ajuda do Bling diz que o plugin dele foi descontinuado e manda desativar quem ainda tem. A integração atual não instala nada: ela usa a chave da API REST do WooCommerce e os webhooks que o próprio Bling cria na loja.

O Bling precisa do Brazilian Market?

A ajuda do Bling diz que ele é obrigatório, porque é por ele que o Bling captura contato e endereço de entrega. Na nossa loja de teste, sem o Brazilian Market instalado, o que fez o cadastro chegar completo foi o WooCommerce entregar os campos na API: com o Brasa Checkout Brasil Pro, o cliente entrou com CPF, número e bairro.

Por que o CPF não chega no Bling?

Porque o WooCommerce sozinho não tem CPF, número nem bairro, e o Bling lê a API dele. Se o campo não sai na API, o cadastro nasce sem ele. Abra um pedido em /wp-json/wc/v3/orders/ID com a sua chave e procure cpf, number e neighborhood dentro de billing: se não estiverem lá, o Bling também não recebe.

O Checkout Brasil grátis manda o CPF para o Bling?

Não. Medimos: ele grava CPF, número e bairro no pedido, mas esses campos não saem na API do WooCommerce, e o Bling lê a API. Quem manda para a API é o Pro, por R$ 197 por ano, ou o Brazilian Market, se a sua loja usa o checkout clássico.

Por que os pedidos antigos não aparecem no Bling?

Os webhooks só valem para vendas feitas depois de conectar. Para as anteriores, o Bling manda usar Importar pedidos manualmente, no menu de Vendas. A tela se chama Pedidos de lojas virtuais: escolha a loja, clique em Visualizar e importe as que quiser.

O Bling não consegue conectar na minha loja. O que olhar?

A ajuda do Bling cita o Wordfence, que barra POST sem User-Agent, o módulo Banned Users do iThemes Security e o Mod_security da Hostgator. O log da nossa loja mostrou que o Bling chama mesmo sem User-Agent. Confira também se a chave tem permissão de leitura e escrita e se o site responde em HTTPS.

Vale apagar os webhooks repetidos?

Vale olhar. Na nossa loja, cada vez que salvamos a configuração o Bling criou mais três webhooks iguais, e terminamos com nove. Cada pedido novo gerou seis entregas, todas respondidas com sucesso. Eles ficam em WooCommerce, Configurações, Avançado, Webhooks. Não apagamos os repetidos na loja de teste, então não medimos o efeito.

BW.S6 — Suporte

O cadastro ainda chega incompleto?

Chame no WhatsApp com o link da loja e o que apareceu no Bling. Você fala com quem escreveu o plugin.