Brazilian Market on WooCommerce parou de funcionar? O que fazer com o plugin de CPF/CNPJ

Os campos de CPF e CNPJ sumiram do checkout. O cliente jurídico digita um CNPJ válido e o formulário responde “CNPJ inválido”. Ou a loja atualizou o WordPress e a finalização quebrou logo depois. Se a sua loja usa o Brazilian Market on WooCommerce — um dos plugins de CPF/CNPJ mais instalados, com mais de 70 mil instalações ativas — a causa provável é que ele não acompanhou duas mudanças grandes do ecossistema.

A versão 4.0.2, publicada em 17 de fevereiro de 2024, foi a última. Desde então, nada: sem atualizações, sem correções, sem adaptações. Enquanto isso, o WooCommerce tornou o checkout em blocos a experiência padrão para lojas novas e a Receita Federal começou a emitir o CNPJ alfanumérico — duas mudanças que a versão atual do plugin não suporta.

A resposta curta para “o que eu faço agora”: identifique qual dos dois problemas afeta a sua loja — campos sumindo apontam para o checkout em blocos; CNPJ com letras recusado aponta para o novo formato da Receita — e escolha entre três rotas: manter o checkout clássico (solução de transição), migrar para um plugin mantido ou adaptar com código próprio. Ao final, você também tem um checklist para fazer a troca sem perder pedidos antigos nem quebrar NF-e, ERP e gateways.

Sinais de que o Brazilian Market on WooCommerce parou de funcionar na sua loja

Os sintomas abaixo aparecem com frequência no fórum oficial do plugin. Tópicos recentes como “CNPJ Alfanuméricos”, “Erro com a Versão 10.3.0 do Woo” e “Campos não aparecendo” mostram que o problema é coletivo — não é só a sua loja.

• Campos de CPF/CNPJ não aparecem no checkout. O seletor de pessoa física/jurídica, o campo de número e o bairro somem da finalização. O pedido é concluído sem o documento do cliente — e sem CPF ou CNPJ, a nota fiscal sai bloqueada ou com dados errados.
• Erros depois de atualizar o WordPress ou o WooCommerce. O plugin não é testado com as versões novas: a própria página oficial avisa que ele “não foi testado com as últimas 3 versões principais do WordPress”. Cada atualização do núcleo pode trazer o erro de volta.
• CNPJ novo (alfanumérico) é recusado na finalização. Desde 31 de julho de 2026 a Receita Federal emite CNPJs com letras no número. A máscara e a validação do plugin só aceitam dígitos: o cliente digita um CNPJ novo e recebe “CNPJ inválido” na hora.

Dois cuidados antes de apontar o dedo para o plugin:

• Se o problema começou logo depois de instalar, atualizar ou remover outro plugin, descarte primeiro a hipótese de conflitos entre plugins — é o gatilho mais comum desse tipo de quebra.
• Se o erro vai além dos campos (checkout em branco, pagamento recusado, botão que não responde), o guia de problemas no checkout do WooCommerce cobre o diagnóstico camada por camada.

Por que isso está acontecendo agora: dois problemas separados

O plugin não recebe atualizações desde fevereiro de 2024

O Brazilian Market on WooCommerce, de Claudio Sanches, está hospedado no WordPress.org como woocommerce-extra-checkout-fields-for-brazil. A versão atual, 4.0.2, foi publicada em 17 de fevereiro de 2024 — o changelog da versão 4.0.1, do mesmo dia, declara suporte para WooCommerce 8.6+ e WordPress 6.4+, e o plugin é compatível desde o WooCommerce 5.0.x. Depois disso, nenhuma atualização.

Os sinais de manutenção parada estão todos visíveis:

• A página oficial do plugin informa que ele não foi testado com as últimas 3 versões principais do WordPress (testado até o WP 6.4.9).
• O repositório no GitHub tem 72 issues abertas (contagem de 09/08/2026) e o último commit é de julho de 2024.
• O PR #259, que propõe suporte a CNPJ alfanumérico, está aberto desde 18 de junho de 2026, sem merge e sem nenhuma revisão — evidência direta de que essa funcionalidade não existe na versão publicada.
• No fórum de suporte, lojistas relatam problemas atuais com as versões novas do WooCommerce.

Para ser preciso: não há declaração oficial do autor confirmando o abandono do projeto. Os fatos, porém, são esses — há mais de dois anos sem atualização, sem manutenção ativa recente. Para a sua loja, o efeito prático é o mesmo: ninguém está do outro lado para corrigir o que quebrar.

Problema 1: o checkout em blocos virou padrão e o plugin não foi adaptado

Desde o WooCommerce 8.3 (lançado em 16 de novembro de 2023), o checkout em blocos passou a ser a experiência padrão para novas instalações. Lojas existentes continuaram com o checkout clássico — aquele renderizado por um shortcode, um código curto inserido na página ([woocommerce_checkout]).

A questão não é simplesmente “os hooks antigos pararam de funcionar”. É uma mudança de arquitetura: o checkout em blocos usa outro mecanismo de extensibilidade, e os campos adicionados pelo mecanismo clássico não passam automaticamente a funcionar nele. O problema concreto é que o Brazilian Market foi construído para o checkout clássico e não foi adaptado para a nova experiência em blocos (anúncio do WooCommerce 8.3).

O checkout clássico continua existindo e é suportado. Mas o WooCommerce deixou claro que sua direção de desenvolvimento é o checkout em blocos.

Problema 2: o CNPJ alfanumérico chegou e a versão atual não o valida

Em 31 de julho de 2026, a Receita Federal emitiu o primeiro CNPJ alfanumérico do país — uma filial do Banco do Brasil, registrada como 00.000.000/E08G-12 (nota oficial da Receita Federal).

Como funciona o novo formato:

• O CNPJ mantém 14 posições; as 12 primeiras podem conter letras (A–Z) e números; os 2 últimos dígitos verificadores continuam numéricos (cálculo módulo 11).
• A máscara continua XX.XXX.XXX/XXXX-DD — só que agora com letras possíveis.
• Vale apenas para novas inscrições. CNPJs existentes não mudam, e os dois formatos coexistem. A emissão é gradual: nem todo CNPJ novo terá letras de imediato.

O Brazilian Market 4.0.2 usa máscara e validação que só aceitam dígitos numéricos. Ou seja: um CNPJ alfanumérico válido não consegue nem ser digitado direito no campo, ou é recusado na finalização. O PR #259 aberto sem merge é a confirmação de que o suporte ainda não foi implementado.

Dois problemas diferentes — e uma consequência importante

Resumo para não confundir:

1. Checkout em blocos — os campos podem não aparecer porque o plugin foi construído para o checkout clássico.
2. CNPJ alfanumérico — mesmo no checkout clássico, a versão atual do plugin não está preparada para o novo formato.

A consequência é decisiva: voltar ao checkout clássico pode resolver o primeiro problema, mas não é solução completa ou definitiva para o segundo. No checkout clássico, com o plugin 4.0.2, o CNPJ alfanumérico continua sendo recusado. Por isso “voltar ao clássico” é uma medida de transição, não a resposta final.

O que fazer agora: as três rotas

A escolha depende do perfil da sua loja. Responda primeiro:

• O plugin ainda funciona no checkout clássico da sua loja?
• Você atende clientes com CNPJ novo — emitido a partir de julho de 2026?
• Você pretende migrar para o checkout em blocos em algum momento?
• Quem mantém a loja hoje: você, uma agência ou um desenvolvedor interno?

Com as respostas, veja qual rota faz sentido.

Rota 1: manter o checkout clássico e continuar com o plugin

Quando faz sentido: o checkout clássico está ativo na loja, o plugin funciona, você não planeja migrar para blocos e ainda não atende clientes com CNPJ alfanumérico.

Se a sua loja já usa o checkout em blocos e os campos sumiram, dá para voltar ao clássico: na página de checkout, substitua o bloco Checkout pelo shortcode [woocommerce_checkout]. Faça isso com backup e teste em staging antes — e trate como solução de continuidade e transição, não como a melhor solução de longo prazo.

O que essa rota resolve: o problema dos campos sumidos (problema 1). O que ela não resolve:

• O CNPJ alfanumérico continua recusado (problema 2).
• O risco de quebrar a cada atualização do WordPress ou do WooCommerce permanece — sem atualizações, ninguém corrige incompatibilidades nem bugs.
• O WooCommerce continua oferecendo os shortcodes, mas sua direção de desenvolvimento é claramente o checkout em blocos. Você estará segurando uma posição que encolhe com o tempo.

Rota 2: migrar para uma alternativa mantida

É a rota mais direta para endereçar os dois problemas de uma vez. O ponto crítico da troca são os dados: o WooCommerce grava cada campo do pedido em uma “meta key” — um nome de campo no banco. O CPF do cliente, por exemplo, fica na chave _billing_cpf; o CNPJ, em _billing_cnpj. Gateways, ERPs, emissores de NF-e e transportadoras leem essas chaves. Se o plugin novo gravar com nomes diferentes, as integrações param de receber os dados — silenciosamente.

Critérios para comparar as alternativas:

• Manutenção recente (data da última atualização).
• Compatibilidade com o checkout em blocos.
• Suporte ao CNPJ alfanumérico.
• Campos de CPF/CNPJ, número e bairro.
• Compatibilidade com as meta keys históricas do Brazilian Market.
• Impacto sobre gateways, ERP, NF-e e integrações.
• Gratuito ou pago.

Plugin	Preço	Checkout clássico	Checkout em blocos	CNPJ alfanumérico	Dados no padrão do Brazilian Market
Brazilian Checkout Toolkit for WooCommerce	Gratuito	Sim	Sim (via Additional Checkout Fields API; recomenda WooCommerce 9.0+)	Não informado	Sim — declara espelhamento nas meta keys legadas _billing_*
BuildsByLuke Checkout Brasil for WooCommerce	Freemium (Pro pago opcional)	Sim	Sim	Sim (máscara e validação com dígito verificador, incluindo o formato alfanumérico)	Sim — mesmas meta keys (ex.: _billing_cpf, _billing_cnpj, _billing_persontype, _billing_number, _billing_neighborhood)
Simple Checkout Fields Manager for WooCommerce + add-on Validate CPF/CNPJ	Pago	Não é o foco (feito para o checkout em blocos)	Sim (Additional Checkout Fields API)	Sim (no add-on Validate CPF/CNPJ)	Não informado — campos importados via JSON
Woo Better Shipping Calculator for Brazil	Gratuito¹	Sim	Sim (declarado pelo desenvolvedor)	Sim (declarado no changelog)	Sim — declara compatibilidade com o padrão de meta keys do Brazilian Market
RaCar Checkout Manager for Brazilian Stores	Gratuito	Sim	Não informado	Não informado	Não declarado

¹ A página oficial não detalha se há recursos pagos — confirme antes de decidir.

Leitura da tabela: “Não informado” significa que o dado não está declarado nas páginas públicas consultadas em 09/08/2026; “declarado” significa que a informação vem do próprio desenvolvedor (página ou changelog oficial). Confirme os detalhes na página de cada plugin antes de decidir — recursos e preços mudam. A data da última atualização de cada plugin e o impacto sobre gateways, ERP e NF-e também devem ser conferidos na fonte oficial: dependem da sua pilha de integrações e mudam com frequência.

Três observações honestas para a decisão:

• Nenhum destes plugins é “o melhor” no vácuo. A tabela existe para você comparar com os critérios da sua loja — o objetivo aqui é mostrar opções reais, não vender uma delas.
• A compatibilidade de dados (última coluna) costuma ser o fator mais importante: é ela que preserva pedidos antigos e mantém NF-e, ERP e gateways funcionando.
• Se você precisa simultaneamente de suporte declarado ao CNPJ alfanumérico e preservação explícita do padrão de dados do Brazilian Market, entre as opções verificadas neste artigo isso é declarado pelo BuildsByLuke Checkout Brasil e pelo Woo Better Shipping Calculator for Brazil. O Simple Checkout Fields Manager com o add-on Validate CPF/CNPJ suporta o CNPJ alfanumérico no Checkout Blocks, mas a compatibilidade com as meta keys legadas do Brazilian Market não foi confirmada nas fontes consultadas.
• Quem ainda não precisa do formato novo tem mais margem de escolha — e mais tempo para decidir com calma.

Rota 3: adaptar com código próprio

Faz sentido quando há desenvolvedor no time, requisitos muito específicos (integração proprietária, campos customizados além do padrão) ou preferência por não depender de terceiros.

Se você seguir esse caminho, três regras:

• Não edite os arquivos do Brazilian Market diretamente. Qualquer adaptação deve ficar em um plugin próprio, um MU-plugin ou solução equivalente — com manutenção e testes próprios. Alterar o código do plugin original é uma mudança que se perde na primeira atualização e foge das boas práticas de manutenção.
• Não coloque o PR #259 em produção sem revisão técnica. O PR que adiciona suporte ao CNPJ alfanumérico está aberto, sem merge e sem nenhuma revisão desde junho de 2026. Código não revisado pode conter erros de validação ou de segurança. Se quiser aproveitar essa base, contrate um desenvolvedor para revisar, testar em staging e assumir a manutenção.
• Entenda o custo de manutenção. A partir daí, você é o mantenedor: cada atualização do WooCommerce ou do WordPress exige teste, e cada bug encontrado é seu.

Como migrar sem perder dados e integrações

A troca de plugin só é arriscada quando os dados param de conversar. Pedido gravado com meta keys diferentes das que gateways e ERPs leem é falha que ninguém percebe — até a nota fiscal dar erro. Siga este checklist na ordem:

1. Mapeie as meta keys usadas hoje. As principais do Brazilian Market são _billing_cpf, _billing_cnpj, _billing_persontype, _billing_number e _billing_neighborhood — além de outras (data de nascimento, gênero, celular etc.). Descubra quais existem na sua base abrindo um pedido antigo no admin ou consultando o banco.
2. Liste quem consome esses dados. Gateway de pagamento, ERP, emissor de NF-e, transportadora, plugins de e-mail e relatórios. Para cada um, confirme de onde ele lê CPF/CNPJ e endereço.
3. Prefira alternativa que preserve as chaves — ou planeje a migração de dados. Se o plugin novo gravar em chaves diferentes, um script de conversão precisa mapear as antigas para as novas, e os pedidos históricos precisam continuar legíveis.
4. Monte um staging. Uma cópia da loja em ambiente separado, fora do ar para o público. É onde a troca deve ser testada, sem risco para as vendas.
5. Faça pedidos teste no staging. Como pessoa física e como pessoa jurídica, com CNPJ numérico e — se você tiver um à mão — alfanumérico.
6. Confira pedidos históricos. Abra pedidos antigos no admin e confirme que CPF, CNPJ, número e bairro continuam lá.
7. Migre os dados se necessário. Se houver pedidos com campos vazios ou em chaves antigas, execute a conversão antes de ativar o plugin novo.
8. Troque em produção em horário de baixo movimento. Desative o Brazilian Market só depois que o novo estiver validado no staging.

Checklist de validação pós-mudança

Depois de ativar o novo plugin, valide tudo antes de considerar o assunto encerrado:

• Checkout testado como pessoa física e como pessoa jurídica.
• CNPJ numérico aceito e salvo corretamente.
• CNPJ alfanumérico (se houver um disponível para teste) aceito e salvo corretamente.
• Pedido conferido no admin: CPF/CNPJ, tipo de pessoa, número e bairro preenchidos.
• NF-e ou ERP recebendo os dados do pedido sem erro.
• E-mails de confirmação com os dados do cliente.
• Monitoramento por algumas semanas: pedidos, reclamações de clientes e erros de integração.

Anote a data da mudança. Se algo quebrar depois, WooCommerce → Status → Logs ajuda a achar a causa com rapidez.

Perguntas frequentes

O plugin ainda é seguro de usar?

O ponto de atenção não é um alerta específico de segurança, e sim a ausência de manutenção: há mais de dois anos sem atualização, sem correção de bugs e sem testes com as versões novas do WordPress e do WooCommerce. Lojas que seguem no checkout clássico geralmente continuam funcionando — mas cada atualização do núcleo é um risco, e se um dia for encontrada uma vulnerabilidade no plugin, não há previsão de correção. Trate-o como solução de transição, com backup antes de qualquer atualização.

Preciso trocar de plugin por causa do CNPJ alfanumérico?

Depende do seu público. O novo formato vale apenas para novas inscrições, emitidas de forma gradual a partir de julho de 2026 — CNPJs antigos continuam numéricos, válidos e sem necessidade de substituição. Se a sua loja atende poucos clientes jurídicos novos, dá para adiar com planejamento. Mas a versão 4.0.2 não valida o novo formato em nenhum cenário: na primeira vez que um cliente com CNPJ alfanumérico tentar comprar, será recusado. Se esse cliente faz parte do seu público, a migração é questão de quando, não de se.

O checkout clássico vai deixar de existir?

Não há anúncio de descontinuação. O WooCommerce afirma que os shortcodes continuam disponíveis e suportados e que não há planos de remover o checkout clássico neste momento (FAQ oficial sobre os blocos de checkout) — mas a direção de desenvolvimento é claramente o checkout em blocos. Trate o clássico como solução viável hoje, não como aposta de longo prazo.

Posso testar o PR #259 na minha loja?

Não é recomendável em produção. O PR que adiciona suporte ao CNPJ alfanumérico está aberto desde 18 de junho de 2026, sem merge e sem nenhuma revisão — código não revisado pode conter erros de validação ou de segurança. Se quiser seguir esse caminho, o mínimo é um desenvolvedor revisar o código, testar em staging e assumir a manutenção da adaptação.

---

Se a sua loja depende do Brazilian Market e você não sabe se deve manter o checkout clássico, migrar os campos ou adaptar as integrações, a Panacea pode analisar o seu checkout e conduzir a migração preservando dados de pedidos e integrações (NF-e, ERP, gateways). Solicite uma análise do checkout com a Panacea.