Plugin para WooCommerce · Grátis · GPL

CPF e CNPJ alfanumérico no checkout do WooCommerce, em blocos e no clássico.

Um campo só, que entende CPF ou CNPJ pelo tamanho e aceita o CNPJ com letras que a Receita emite desde julho de 2026. Número e bairro no endereço, tudo gravado nas mesmas chaves do Brazilian Market: a nota fiscal, o frete e os pedidos antigos continuam funcionando.

BR.S2 — O que o grátis faz

Sai do Brazilian Market sem perder nada.

Um campo para CPF ou CNPJ

O comprador digita o documento e o plugin descobre pelo tamanho se é CPF ou CNPJ, com máscara enquanto digita e validação no servidor.

CNPJ alfanumérico

Aceita o CNPJ com letras, como 12.ABC.345/01DE-35, com os dígitos verificadores calculados pela regra oficial. Teste um CNPJ no validador.

Número e bairro

Campos de número e bairro logo depois da rua, na cobrança e na entrega, com o número obrigatório para endereço no Brasil.

As mesmas chaves do pedido

Grava _billing_cpf, _billing_cnpj, _billing_persontype, _billing_number e _billing_neighborhood, que os plugins de nota e de frete já leem. Pedido antigo aparece sem migrar nada.

Cliente que volta

Quem já comprou encontra o documento, o número e o bairro preenchidos, inclusive os que o Brazilian Market salvou.

BR.S3 — Pro · R$ 197 por ano

O Pro preenche o que o comprador não quer digitar.

CNPJ preenche empresa e endereço

Ao digitar um CNPJ, a razão social, o CEP e o número da empresa vêm dos dados públicos da Receita, e o CEP completa rua, bairro, cidade e estado. O campo Empresa, que o checkout em blocos esconde, aparece. Endereço já digitado não muda.

CEP preenche o endereço

Ao digitar o CEP, rua, bairro, cidade e estado são preenchidos. Se o comprador corrigir o CEP, o endereço acompanha; o que ele digitou à mão fica.

CPF ou CNPJ no cadastro

O cadastro de Minha conta pede o CPF ou CNPJ e o valida, inclusive o alfanumérico, e o endereço de cobrança também. Na próxima compra, o checkout já vem com o documento. Manda cupom de boas-vindas a quem se cadastra? Ligue um cadastro por CPF ou CNPJ em WooCommerce, Configurações, Contas e privacidade: a mesma pessoa não abre outra conta com o mesmo documento para ganhar outro cupom, e a compra sem conta segue liberada. Quem esqueceu qual e-mail usou? Ligue Entrar com CPF ou CNPJ no mesmo lugar e o login aceita o documento do cadastro, com ou sem pontos e traço, na Minha conta e na tela de login do WordPress. Senha errada e documento sem conta recebem a mesma mensagem, para a tela não contar quem é cliente da loja. O cupom também pode valer só para compras com CNPJ ou só com CPF: escolha em Vale para, na Restrição de uso do cupom, e o checkout recusa o cupom para o outro tipo de comprador, dizendo qual documento ele exige. O que o cupom do WooCommerce deixa passar.

CPF ou CNPJ no ERP e no app

O documento, a inscrição estadual da empresa, o número e o bairro saem na REST API e nos webhooks de pedido, nos mesmos campos do Brazilian Market, e o app do WooCommerce mostra o CPF/CNPJ e a inscrição estadual no pedido, em Campos personalizados, também com o Brazilian Market ativo. Usa Bling? Veja o que medimos com ele. Emite nota pelo WooCommerce? Veja as chaves que cada plugin de nota fiscal lê.

CPF ou CNPJ sem abrir o pedido

A lista de pedidos ganha a coluna CPF/CNPJ, para ver de quais pedidos de empresa emitir a nota, e a busca da lista acha o pedido pelo documento digitado com ou sem pontos e traço. Um filtro acima da lista deixa só os pedidos de Pessoa Jurídica (CNPJ) ou só os de Pessoa Física (CPF), para emitir as notas de um tipo em sequência. Exportar CSV dos filtrados, ao lado dos filtros, baixa todos os pedidos do filtro e da busca atuais, de todas as páginas; para só alguns, marque os pedidos e escolha Exportar CSV com CPF/CNPJ em Ações em massa. A planilha traz pedido, data, nome, empresa, documento, inscrição estadual, e-mail, telefone e total, e abre direto em colunas no Excel, pronta para o contador. O documento e a inscrição estadual também aparecem na prévia do pedido, o ícone de olho na lista, e na fatura e na guia de remessa do PDF Invoices & Packing Slips, junto do número do pedido.

R$ 197 por ano por loja, no Pix, boleto ou cartão, com as atualizações e o suporte do ano. Os dois arquivos, Pro e grátis, são liberados na sua área do cliente assim que o pagamento é confirmado, e o link chega por e-mail.

BR.S4 — Como o comprador vê

O checkout em blocos, na tela do comprador.

Campo CPF ou CNPJ do checkout em blocos com o CNPJ alfanumérico 12.ABC.345/01DE-35 já formatado
Grátis: o CNPJ alfanumérico ganha a máscara enquanto o comprador digita e é validado pelo dígito verificador.
Checkout em blocos com o CNPJ 19.131.243/0001-97 digitado: Empresa OPEN KNOWLEDGE BRASIL, Avenida Paulista, número 37, Bela Vista, São Paulo, SP e CEP 01311-902 preenchidos sozinhos
Pro: com um CNPJ válido, a razão social, o CEP e o número da empresa entram sozinhos, e o CEP completa o endereço.
Endereço de cobrança com rua, bairro, cidade e estado preenchidos a partir do CEP 01310-100, com o campo Número
Pro: o CEP completa rua, bairro, cidade e estado; o comprador só digita o número.

Telas reais do grátis 0.2.1 e do Pro numa loja de teste com WooCommerce 11 em português e checkout em blocos: o CNPJ alfanumérico e o CEP num iPad mini com o Pro 0.6.0, a empresa e o endereço pelo CNPJ no Chrome com o Pro 0.6.6, em 4 de novembro de 2026.

BR.S5 — Como instalar

Três passos no painel do WordPress.

1. Envie o arquivo

Em Plugins, Adicionar novo, Enviar plugin, escolha o brasa-checkout-brasil.zip e clique em Instalar agora.

2. Ative

Ative o plugin. O campo CPF ou CNPJ, o número e o bairro aparecem no checkout na hora, sem configuração.

3. Desligue o antigo

Desative o Brazilian Market para o checkout não pedir o documento duas vezes. Os pedidos antigos continuam com o documento.

BR.S6 — Perguntas frequentes

O que perguntam antes de instalar.

O plugin aceita o CNPJ alfanumérico?

Aceita. Letras entram nas 12 primeiras posições, como no exemplo oficial 12.ABC.345/01DE-35, e os dígitos verificadores são calculados pela regra da Receita Federal.

O checkout pede a inscrição estadual para a NF-e?

No Pro, sim: quando o comprador digita um CNPJ aparece o campo inscrição estadual, opcional, que aceita só números ou ISENTO e fica no pedido na mesma chave do Brazilian Market (_billing_ie), que os plugins de NF-e leem. Com CPF o campo não aparece.

Funciona no checkout em blocos do WooCommerce?

Funciona. O campo entra pela API de campos adicionais do checkout em blocos e também no checkout clássico por shortcode, com a mesma validação no servidor.

Posso trocar o Brazilian Market por ele sem perder os pedidos antigos?

Pode. O plugin grava e lê as mesmas chaves (_billing_cpf, _billing_cnpj, _billing_persontype, _billing_number e _billing_neighborhood), então os pedidos antigos continuam mostrando o documento, inclusive os da loja que usava o Brazilian Market só para Pessoa Jurídica, que grava o CNPJ sem o tipo de pessoa (versão 0.2.8). O cliente que volta encontra os campos preenchidos. Desative o Brazilian Market para o checkout não pedir o documento duas vezes.

Os plugins de nota fiscal e de frete continuam funcionando?

Os que leem as chaves do Brazilian Market, sim: o documento, o número e o bairro ficam no pedido com os mesmos nomes.

Dá para pôr o CPF ou o CNPJ num pedido criado no painel?

Dá, desde a versão 0.2.9 do grátis. O WooCommerce só mostra os campos do checkout em blocos nos pedidos feitos pelo checkout, então o pedido criado à mão no painel (venda por telefone ou WhatsApp) ficava sem lugar para o documento. Agora a tela do pedido tem CPF ou CNPJ, Número e Bairro, gravados nas mesmas chaves do checkout, que os plugins de nota fiscal e os ERPs leem; com o Pro, esse pedido entra na coluna CPF/CNPJ, no filtro de Pessoa Jurídica e na exportação. Corrigir o CPF de um pedido feito no checkout atualiza as mesmas chaves. Documento inválido não é salvo, e a tela avisa. No Pro, desde a 0.8.0, o mesmo pedido ganha a inscrição estadual (ou ISENTO), na chave que os emissores de nota e a API REST leem; inscrição inválida não apaga a que estava.

O plugin manda dados do comprador para fora da loja?

O grátis não manda nada: o documento fica só no pedido e no cadastro do cliente, na sua própria loja. O Pro consulta o CNPJ na BrasilAPI e o CEP no ViaCEP, direto do navegador do comprador, e nada fica guardado por nós.

O que preciso para instalar?

WordPress 6.5 ou mais novo, WooCommerce 8.9 ou mais novo e PHP 7.4 ou mais novo. É compatível com o armazenamento de pedidos de alto desempenho (HPOS).

Funciona com o meu frete e o meu gateway?

Instalamos 16 plugins brasileiros ao lado do Checkout Brasil e medimos o checkout. Com o Melhor Envio e o PagBank para WooCommerce ativos, fechamos pedidos nos dois checkouts: um campo de documento só, gravado nas chaves que eles leem. Mercado Pago, Correios, Asaas, PagBank Connect, Rede, PagHiper, PayPal Brasil, Cielo e Virtuaria não acrescentam campo ao formulário do checkout. Há ressalvas: o SuperFrete sempre acrescenta o próprio documento, número e bairro, e o comprador vê em dobro; PagHiper, Cielo Pix e Rede Maxipago podem pedir o documento de novo na etapa de pagamento; o Getnet exige o Brazilian Market instalado; no plugin de NF-e da WebmaniaBR, deixe desligada a opção de tipo de pessoa. Não rodamos pagamento real, que depende da conta de cada loja: faça um pedido de teste antes de vender.

E o comprador de fora do Brasil?

Quando o país do endereço não é o Brasil, os campos de CPF ou CNPJ, número e bairro somem e o pedido fecha sem eles. No checkout em blocos isso exige o WooCommerce 9.9 ou mais novo; antes dele, os campos continuam obrigatórios para todos.

Dá para exportar os pedidos do WooCommerce para o Excel com CPF e CNPJ?

Dá, no Pro. A exportação das Análises do WooCommerce não leva o CPF nem o CNPJ. Na lista de pedidos, escolha a situação, o mês, Pessoa Jurídica ou Pessoa Física, ou faça uma busca, e clique em Exportar CSV dos filtrados: vem a planilha com todos os pedidos do filtro, de todas as páginas, com pedido, data, situação, nome, empresa, tipo, CPF/CNPJ, inscrição estadual, e-mail, telefone e total. Ela abre direto em colunas no Excel, com os acentos e a vírgula decimal. Para só alguns pedidos, marque-os e use Exportar CSV com CPF/CNPJ em Ações em massa.

E se eu não renovar a licença do Pro?

O Pro continua funcionando na sua loja como está, porque ele não consulta licença nem desliga recurso, e o grátis não tem licença. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas do Pro e o suporte. Pagou depois, ela volta a ficar ativa sozinha.

BR.S7 — Suporte

Instalou e travou em algum ponto?

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