Como configurar o WooCommerce para o Brasil: CPF, CNPJ, CEP e checkout
Você instalou o WooCommerce, escolheu o Brasil no assistente e a moeda já sai em reais. Aí abre o checkout como se fosse um cliente — e o formulário pede nome, endereço e e-mail… mas não pede CPF, não separa o número do endereço e não tem bairro. É o retrato de um pedido incompleto: o tipo de pedido que pode travar nota fiscal, ERP e transportadora.
O WooCommerce padrão nasce americano. Ele entrega CEP com validação de formato e a lista de estados brasileiros, mas não coleta documento fiscal, não separa número e bairro, e só pergunta telefone na cobrança — nunca na entrega. Sem ajuste, sua loja recebe pedidos que podem não conseguir ser faturados nem entregues.
Este artigo é a Etapa 3 do nosso guia completo de como criar uma loja WooCommerce no Brasil e o passo seguinte ao guia de como instalar e configurar o WooCommerce. Aqui você vai deixar os campos brasileiros prontos — CPF, CNPJ, CEP, número, bairro e telefone —, escolher um plugin de CPF/CNPJ mantido com critérios verificáveis e testar o checkout antes de seguir para as etapas de pagamentos e frete da série.
Neste guia
- O que o WooCommerce padrão já entrega para o Brasil (e o que falta)
- Por que configurar o WooCommerce para o Brasil antes de pagamentos e frete
- CPF e CNPJ no cadastro e no checkout
- Endereço brasileiro: CEP, número, bairro e complemento
- Telefone: o campo que o WooCommerce esquece na entrega
- Checkout em blocos vs. checkout clássico: o que muda na prática
- Como avaliar um plugin de CPF/CNPJ antes de instalar (critérios)
- Situação atual das alternativas (verificada em agosto de 2026)
- CNPJ alfanumérico: o que mudou de verdade
- LGPD: menos dados, menos problema
- Teste prático do checkout depois da configuração
- Checklist final da adaptação
- Erros comuns
- Quando chamar um especialista
- Perguntas frequentes
O que o WooCommerce padrão já entrega para o Brasil (e o que falta)
Antes de instalar qualquer coisa, vale saber exatamente onde o WooCommerce já fala português — e onde ele não fala. Isso evita dois erros opostos: comprar plugin para resolver o que o core já resolve, e assumir que o core cobre o que ele nunca cobriu.
O que já vem pronto:
- CEP com validação de formato. O campo de CEP é obrigatório e aceita só o formato brasileiro: oito dígitos, com ou sem hífen (00000-000). Isso valida o formato digitado — não confirma se o CEP existe nem consulta o endereço correspondente.
- Lista de estados. O Brasil não tem formato de endereço próprio no código do WooCommerce: ele usa os campos padrão com os rótulos traduzidos — CEP, Estado, Cidade — e transforma a lista oficial de UFs em um seletor. O cliente escolhe o estado em vez de digitar.
- Moeda e medidas. Real brasileiro, quilos e centímetros já foram configurados na etapa de instalação.
E o que falta:
- CPF e CNPJ. Não existe campo de documento no núcleo do WooCommerce. Ele não coleta, não valida e não salva CPF ou CNPJ em lugar nenhum.
- Número e bairro separados. O formulário padrão tem “Endereço” e um segundo campo “Apartamento, suíte, etc.” — que serve de complemento, não de bairro. O cliente deixa número e bairro tudo misturado na primeira linha, quando lembra.
- Telefone na entrega. O telefone existe só no endereço de cobrança. O endereço de entrega nem pergunta.
A consequência é direta: sem adaptação, o primeiro pedido real da loja chega sem CPF, sem número e sem bairro. Para um e-commerce brasileiro, isso pode se tornar um pedido inválido na prática — não importa quão bonito seja o checkout.
Por que configurar o WooCommerce para o Brasil antes de pagamentos e frete
Os pedidos incompletos não ficam “quase certos” — sem ajuste, eles podem causar falhas em vários pontos da operação:
- Emissão fiscal e integrações: o CPF/CNPJ do cliente é frequentemente necessário no e-commerce brasileiro para emissão de documentos fiscais, integrações, identificação do cliente e outros fluxos. A obrigatoriedade concreta depende do documento fiscal, da operação e das regras fiscais aplicáveis — não existe uma regra única para todas as lojas.
- ERP e planilhas: integrações leem os dados do pedido. Pedido sem CPF ou sem bairro pode causar falhas de sincronização, conciliação e relatórios — ou exigir correção manual.
- Transportadora: sem número, bairro e telefone de contato, a coleta pode ser impedida ou a entrega pode voltar. O custo do retorno sai do seu bolso.
- Cliente: ele pagou e o pedido não anda. A reclamação vai para você, não para o WooCommerce.
Fazer essa adaptação agora — com a loja ainda em modo “Em breve” e sem pedidos reais — é configuração. Fazer depois, com pedidos no sistema, é correção de dados e migração. O mesmo trabalho, na ordem certa, custa uma fração.
As próximas etapas da série — pagamentos e frete — também dependem deste passo: gateways e métodos de entrega leem o endereço e os dados fiscais do pedido. Checkout brasileiro configurado primeiro, tudo encaixa em cima; checkout americano padrão, cada integração nova vira remendo.
CPF e CNPJ no cadastro e no checkout
O núcleo do WooCommerce não coleta CPF nem CNPJ. Isso não é omissão: é o formato padrão internacional do plugin, desenhado para países sem documento fiscal no checkout. O WooCommerce não oferece configuração nativa para esses campos — mas o plugin não é tecnicamente a única possibilidade. Existem duas abordagens:
- Para o lojista, o caminho normal e mais simples é um plugin compatível com o seu checkout.
- Desenvolvimento personalizado também pode adicionar os campos usando a Additional Checkout Fields API oficial do WooCommerce — a mesma API usada pelos plugins.
Este artigo segue o caminho do plugin, que é o indicado para a maioria das lojas; não vamos entrar em código aqui. O importante é a distinção correta: não existe configuração nativa, existem essas duas vias.
O que um plugin de CPF/CNPJ faz na prática:
- Adiciona um seletor Pessoa Física / Pessoa Jurídica no checkout, para o cliente indicar o tipo de documento.
- Cria os campos de CPF e CNPJ com máscara — o hífen e as barras entram sozinhos enquanto o cliente digita.
- Valida o documento: dígitos verificadores conferidos na hora, antes de o pedido ser fechado. CPF inventado não passa (em plugins com validação ativa).
- Salva o documento no pedido e no cadastro do cliente, em posições de dados padronizadas que as integrações leem.
Esse último ponto merece atenção. Todo pedido no WooCommerce guarda os dados em posições próprias — chamadas de meta keys. As mais usadas pelos plugins brasileiros seguem o padrão criado pelo Brazilian Market: _billing_cpf, _billing_cnpj, _billing_persontype (PF ou PJ), _billing_number e _billing_neighborhood. Plugins de nota fiscal, ERP e antifraude leem essas posições para puxar os dados do pedido.
Na prática, isso significa duas coisas. Primeiro: se você trocar de plugin no futuro, os pedidos antigos continuam legíveis por quem respeita o mesmo padrão. Segundo: na hora de avaliar uma opção, vale conferir se ela salva nos mesmos lugares — principalmente se você já sabe qual emissor de NF-e pretende usar. O espelhamento dessas posições varia de plugin para plugin, e a informação está na página oficial de cada um.
E um aviso que poupa dor de cabeça: documento fiscal é o necessário — CPF/CNPJ quando a operação exige. RG, data de nascimento e gênero entram só se a sua operação tiver uma necessidade real, e a seção de LGPD deste artigo mostra o critério.
Endereço brasileiro: CEP, número, bairro e complemento
O WooCommerce já valida o formato do CEP e já mostra a lista de estados. O que falta no endereço são os dois campos que a logística brasileira não vive sem: número e bairro.
No formulário padrão, o cliente tem “Endereço” e “Apartamento, suíte, etc.”. Sem campo de número, o endereço vira uma linha de texto livre — “Rua das Flores 123” ou “Rua das Flores, 123, casa 2”, cada cliente do seu jeito. Sem campo de bairro, a transportadora recebe um pedido sem a informação que ela usa para roteirizar a entrega. O plugin de campos resolve os dois, adicionando:
- Número, separado da rua.
- Bairro, como campo próprio (alguns plugins permitem configurar o rótulo ou desligá-lo).
Sobre o complemento: o campo “Apartamento, suíte, etc.” do core continua servindo para isso — apartamento, casa 2, bloco B. Número e bairro próprios + complemento no campo certo é o endereço completo que qualquer transportadora aceita.
Um recurso que muitos plugins brasileiros oferecem é o preenchimento automático a partir do CEP: o cliente digita o CEP e o sistema busca rua, bairro, cidade e estado. Muitos usam o serviço gratuito ViaCEP para essa consulta — funciona bem, mas o endereço preenchido deve ser conferido, e vale lembrar isso no teste da seção correspondente.
Telefone: o campo que o WooCommerce esquece na entrega
O formulário padrão pergunta o telefone apenas no endereço de cobrança. No endereço de entrega, não existe campo de telefone. Para uma loja com entrega física, isso é um problema silencioso: a transportadora precisa de um número para avisar sobre a entrega, e sem ele a tentativa pode falhar e o pedido pode voltar.
No checkout em blocos — o padrão das lojas novas — o telefone da cobrança nasce visível e opcional, e a configuração permite três estados: oculto, opcional ou obrigatório. O caminho de configuração depende do formato do seu checkout e está detalhado na seção seguinte.
Os plugins brasileiros tratam o assunto de forma mais completa: alguns adicionam um campo de celular ao lado do telefone fixo, com opções de obrigatório ou opcional, máscara de DDD e a possibilidade de substituir o telefone padrão. Se a sua operação entrega em domicílio, inclua “telefone/celular no checkout” na sua lista de critérios — é um campo que parece detalhe e decide entrega.
Checkout em blocos vs. checkout clássico: o que muda na prática
Desde o WooCommerce 8.3 (novembro de 2023), lojas novas nascem com o checkout em blocos — o formato editável e a direção oficial do plugin, como vimos no guia de instalação e configuração. O checkout clássico é o formato antigo, que ainda roda em lojas existentes.
A regra prática é uma frase: plugins feitos só para o checkout clássico não aparecem no checkout em blocos. É o erro número um de quem instala um plugin de campos em loja nova: “instalei e não aparece nada”. Não é bug — é incompatibilidade de formato.
A extensão oficial para personalizar o checkout em blocos é a API de campos adicionais do checkout (Additional Checkout Fields API), que permite adicionar campos nas três áreas do formulário: contato, endereço e pedido. Campos de endereço aparecem tanto na cobrança quanto na entrega e ficam salvos no pedido e no cadastro do cliente. É em cima dessa API que os plugins compatíveis com blocos são construídos.
Na hora de escolher seu plugin de CPF/CNPJ, a pergunta certa não é “funciona com WooCommerce?”, e sim “é compatível com o checkout em blocos?”. A resposta deve estar declarada na página do plugin — junto com a versão mínima do WooCommerce exigida. A documentação de personalização de carrinho e checkout detalha a diferença entre os dois formatos.
Um detalhe a mais sobre o comportamento padrão dos blocos: o campo Empresa nasce oculto e pode ser ativado ou tornado obrigatório no editor da página de checkout — útil para lojas com vendas PJ, que combinam o campo Empresa com o seletor de CNPJ do plugin.
Como avaliar um plugin de CPF/CNPJ antes de instalar (critérios)
Não existe “melhor plugin brasileiro” — existe plugin que atende os critérios da sua loja e plugin que não atende. O histórico mostra por quê: um dos plugins de CPF/CNPJ mais instalados está sem manutenção desde 2024, e lojas novas que o instalam nem veem os campos no checkout. Por isso, avalie com estes critérios na mão:
- Manutenção. Na página do plugin, confira a data da última atualização e a versão do WordPress em que ele foi testado. Plugin sem atualização há mais de um ano é risco: não acompanha o WooCommerce e fica para trás a cada release. Um aviso “não testado com as últimas versões” na página é um sinal de alerta literal.
- Compatibilidade com checkout em blocos. O plugin deve declarar suporte ao checkout em blocos e informar a versão mínima do WooCommerce. Plugin de checkout clássico não resolve loja nova.
- CNPJ alfanumérico. O plugin aceita e valida CNPJ com letras? Com o novo formato do CNPJ em implantação, essa resposta entra no critério de escolha — a seção sobre o assunto mostra o porquê.
- Preço e modelo. Gratuito, pago ou freemium — e o que cada plano cobre. Para o freemium, confira o que fica de fora na versão gratuita (preenchimento de CEP, por exemplo, costuma ser recurso pago).
- Campos que a sua operação usa. Seletor PF/PJ, número, bairro, telefone/celular na entrega. RG e Inscrição Estadual só se a sua operação exigir.
- Dados que salva no pedido. O plugin respeita as meta keys do padrão brasileiro (
_billing_cpf,_billing_cnpjetc.)? Essa informação aparece na página oficial e importa para NF-e e ERP. - Campos desligáveis. Dá para desativar campos que você não usa (RG, nascimento, gênero)? Isso é critério de LGPD, não de estética.
- E o tamanho da base? Muitas instalações ativas não provam manutenção — um dos plugins de CPF/CNPJ mais instalados está sem manutenção desde 2024. Use o número como informação, nunca como decisão.
A regra de ouro continua a mesma da instalação: instale um plugin por função. Dois plugins de campos de checkout ao mesmo tempo é receita de conflito — o guia de como identificar conflitos entre plugins mostra o diagnóstico caso isso aconteça.
Situação atual das alternativas (verificada em agosto de 2026)
Os dados abaixo foram conferidos nas páginas oficiais de cada plugin em 11 de agosto de 2026. A manutenção muda com o tempo — esta tabela é um retrato com data, não uma garantia. Antes de instalar, confira novamente a data da última atualização na página oficial.
| Plugin | Última atualização | Checkout em blocos | CNPJ alfanumérico | Preço | Observações |
|---|---|---|---|---|---|
| Brazilian Market on WooCommerce (Claudio Sanches) | 17/02/2024 | Não — apenas checkout clássico | Não (proposta aberta sem conclusão) | Gratuito | Mais de 70 mil instalações ativas; aviso “não testado com as últimas 3 versões principais do WordPress” na página. Sem manutenção desde fevereiro de 2024. |
| Brazilian Checkout Toolkit for WooCommerce (Riaan K.) | v1.2.0 — atualizado há cerca de 1 mês (consulta em 11/08/2026) | Sim — checkout clássico + Checkout Blocks (compatibilidade declarada até WooCommerce 10.9) | Sem declaração pública na página | Gratuito | 100+ instalações ativas; seletor PF/PJ; CPF/CNPJ com validação opcional; número e bairro; celular (opcional/obrigatório/substituir telefone); máscaras; campos de RG/IE/nascimento/gênero desligáveis; espelha as meta keys legadas _billing_*; suporta HPOS. Baseado no trabalho original do Brazilian Market. |
| BuildsByLuke Checkout Brasil for WooCommerce (XeroWP) | 31/07/2026 | Sim (WooCommerce 8.9+) | Sim — aceita letras nas 12 primeiras posições e valida os dois dígitos verificadores numéricos | Freemium (Pro pago: autofill de CEP, varredura de CNPJ, relatórios) | Usa as mesmas meta keys do Brazilian Market, também no checkout em blocos; RG/IE opcionais; campo de razão social. Aviso do fabricante: não é software fiscal e não emite NF-e. |
| Simple Checkout Fields Manager for WooCommerce (Naked Cat Plugins) + add-on Validate CPF/CNPJ | Em atualização contínua (v7.3, 05/03/2026) | Sim — foco no checkout em blocos | Sim — validação de CPF/CNPJ incluindo alfanumérico | Pago (assinatura anual do plugin principal; add-on Validate CPF/CNPJ gratuito) | Gerenciamento de campos sem código; importação de campos por JSON com pacote pronto de CPF/CNPJ/IE; máscaras no add-on; requer WooCommerce 8.9+, WordPress 6.3+ e PHP 7.4+. |
Três leituras rápidas dessa tabela:
- O nome mais famoso não é o mais seguro. O Brazilian Market é um dos plugins de CPF/CNPJ mais instalados e está sem manutenção desde fevereiro de 2024 — incompatível com o checkout em blocos e sem suporte ao CNPJ alfanumérico. Se você já usa ele em outra loja, o guia de migração do Brazilian Market mostra o caminho para trocar sem perder dados.
- Compatibilidade com blocos é o divisor de águas. As opções com manutenção em dia trabalham com o checkout em blocos; as que não trabalham ficam para trás.
- Validação de CNPJ alfanumérico é o critério novo. Duas das opções declararam suporte; das outras duas, uma é incompatível (checkout clássico) e a outra simplesmente não declara — e isso muda com o tempo, então vale a pergunta direta ao autor do plugin antes de decidir.
CNPJ alfanumérico: o que mudou de verdade
O CNPJ ganhou letras. Em 31 de julho de 2026, a Receita Federal emitiu o primeiro CNPJ alfanumérico do país — uma filial do Banco do Brasil, com o número 00.000.000/E08G-12. Para o seu checkout, o que importa é entender o que isso significa de verdade.
Os fatos, segundo a Receita Federal:
- Implantação gradual. Novos CNPJs passam a sair no formato alfanumérico de forma progressiva durante 2026. Um CNPJ novo ainda pode sair exclusivamente numérico — os dois formatos coexistem.
- Só para novas inscrições. Os CNPJs existentes permanecem válidos e não precisam de substituição. Nenhum cliente atual da sua loja vai “virar alfanumérico” da noite para o dia.
- Formato: 14 posições, como antes. As 12 primeiras podem conter letras de A a Z e números; os 2 últimos são dígitos verificadores, sempre numéricos.
- Base legal: a Instrução Normativa RFB nº 2.119/2022, alterada pela IN RFB nº 2.229/2024, definiu o cronograma. A Receita recomenda que sistemas concluam ajustes e testes — desde 27 de julho de 2026, aplicações não adaptadas que consomem os serviços da Receita podem falhar. Os detalhes estão na página oficial do CNPJ alfanumérico.
E o que isso significa para a sua loja? Preparação, não pânico. Hoje, a maioria dos seus clientes PJ tem CNPJ numérico e seguirá com ele. Mas o primeiro cliente novo com CNPJ alfanumérico que passar pelo seu checkout vai digitar letras — e se o campo ou a validação rejeitarem, a venda morre ali.
Na prática, duas atitudes resolvem:
- No critério de escolha do plugin, pergunte se a validação de CNPJ inclui o formato alfanumérico com o dígito verificador oficial. As respostas atuais estão na tabela da seção anterior — e mudam com o tempo.
- No teste do checkout, use um CNPJ fictício válido gerado pelo Simulador de Inscrição Alfanumérica da Receita Federal e confirme que o campo aceita. O simulador oficial gera inscrições fictícias para testes, sem usar dados reais de empresas.
LGPD: menos dados, menos problema
Todo campo extra no checkout é um dado pessoal coletado — e a Lei Geral de Proteção de Dados (Lei nº 13.709/2018) estabelece o princípio da necessidade: o tratamento deve se limitar ao mínimo necessário, com dados pertinentes, proporcionais e não excessivos para a finalidade. Em português claro: não colete o que você não precisa.
A orientação da ANPD reforça o mesmo ponto: não coletar dados sem finalidade identificada. A aplicação prática no checkout brasileiro:
- CPF/CNPJ: sim, quando a operação exige — emissão de NF-e a pedido do cliente, devoluções e identificação fiscal. É o padrão do e-commerce brasileiro.
- RG, data de nascimento e gênero: só se a sua operação tiver necessidade real e documentada. Para a grande maioria das lojas, não tem — e coletar dados sem finalidade clara ou além do necessário pode contrariar o princípio da necessidade da LGPD.
- Campos opcionais do plugin: desative os que você não usa. Os plugins mantidos permitem desligar campos — use essa função.
- Proteção: cada dado coletado precisa de proteção adequada. Dado que você não coleta não precisa ser protegido, não vaza e não aparece em relatório.
A regra vale para o formulário inteiro: o checkout deve pedir o necessário para vender, faturar e entregar — e nada além disso. Menos campos também é checkout mais rápido, menos desistência e menos superfície para erro.
Teste prático do checkout depois da configuração
Configuração sem teste é teoria. O teste abaixo leva cerca de dez minutos e deve ser feito agora — a loja continua em modo “Em breve” para visitantes, então ninguém vê nada além de você.
- Cadastre um produto de teste com preço em reais (R$ 10,00 serve) e um CEP de origem válido nas configurações gerais.
- Adicione ao carrinho e abra o checkout. Navegue como cliente, não como administrador — idealmente em uma janela anônima do navegador.
- Preencha como Pessoa Física: CPF com máscara entrando sozinha? Validação aceitando e rejeitando os números certos? Campos de número e bairro aparecendo? CEP preenchendo o endereço automaticamente, se o plugin oferecer?
- Mude para Pessoa Jurídica: o seletor PF/PJ alterna os campos? CNPJ válido é aceito? Gere um CNPJ alfanumérico fictício no Simulador de Inscrição Alfanumérica da Receita Federal e veja se o campo aceita letras.
- Confira o seletor de estados e o telefone na entrega, se você ativou esse campo.
- Conclua o pedido de teste. Como pagamentos ainda não foram configurados (é a próxima etapa da série), ative temporariamente o método nativo “Pagamento na entrega” (Cash on delivery) em WooCommerce > Configurações > Pagamentos — é um método que já vem no core, sem depender de gateway brasileiro — só para completar o teste. Remova depois.
- Confira o pedido em WooCommerce > Pedidos: CPF/CNPJ, número, bairro e telefone salvos e completos? É aqui que pedido “quase certo” aparece.
- Apague o pedido de teste e desative o método de pagamento temporário.
Se o checkout apresentar erro durante o teste — tela em branco, campo que não aparece, pedido que não conclui —, o guia de diagnóstico de checkout do WooCommerce mostra o caminho para achar a causa sem derrubar a loja.
Checklist final da adaptação
Antes de partir para a etapa de pagamentos, confira esta lista. Cada item levou algum tempo nas seções anteriores — o teste final garante que nenhum ficou para trás:
- Plugin escolhido por critérios (manutenção, blocos, alfanumérico, preço) — não por fama
- Compatibilidade com checkout em blocos confirmada na página oficial do plugin
- Seletor Pessoa Física / Pessoa Jurídica aparecendo no checkout
- CPF e CNPJ com máscara e validação funcionando
- CNPJ alfanumérico fictício (gerado no Simulador da Receita Federal) aceito no teste
- Número e bairro separados no endereço
- CEP validando e preenchendo o endereço (se o plugin oferecer autofill)
- Telefone/celular na entrega, se a sua operação precisar
- Campos desnecessários desativados (RG, nascimento, gênero)
- Pedido de teste concluído e conferido em WooCommerce > Pedidos
- Pedido de teste apagado e método “Pagamento na entrega” desativado
Erros comuns
- Escolher o plugin pelo nome. Um dos plugins de CPF/CNPJ mais instalados está sem manutenção desde fevereiro de 2024. Manutenção se confere na página oficial, não na fama.
- Instalar plugin de checkout clássico em loja nova. O checkout em blocos não exibe esses campos — “instalei e não aparece nada” é incompatibilidade, não bug.
- Lançar sem testar o checkout. O primeiro pedido real nasce incompleto — sem CPF, sem número, sem bairro — e o problema tende a aparecer na primeira tentativa de emissão fiscal ou integração.
- Coletar dados que a operação não usa. RG, data de nascimento e gênero sem finalidade são excesso de coleta à luz da LGPD. Desligue o que não usa.
- Esquecer o telefone na entrega. A transportadora não tem como avisar, a entrega pode voltar e o custo do retorno é seu.
- Confiar no autofill do CEP sem conferir. O ViaCEP é um serviço de consulta e preenchimento de CEP usado por plugins — o endereço preenchido pode estar desatualizado. Conferência é do cliente e do teste.
- Ignorar o CNPJ alfanumérico na escolha do plugin. A venda que morre por um campo que rejeita letras é a venda mais cara de todas — e a mais fácil de evitar.
- Instalar dois plugins de campos ao mesmo tempo. Um plugin por função — se um conflito aparecer, o diagnóstico está na seção de critérios deste artigo.
Quando chamar um especialista
Esta etapa é feita para você resolver sozinho — com os critérios deste artigo, a escolha do plugin é uma decisão informada, e o teste é um passeio pelo checkout. Uma avaliação técnica vale a pena em três situações:
- Sua loja já está lançada e recebendo pedidos incompletos. Corrigir dados de pedidos antigos, migrar de plugin sem perder histórico e alinhar meta keys com emissor de NF-e e ERP é trabalho de migração — o guia de migração do Brazilian Market cobre o caso mais comum, e o que escapa dele pede mão técnica.
- Você tem integrações exigentes. Emissor de NF-e, ERP ou antifraude com requisitos específicos de dados: vale uma conferência de compatibilidade antes de escolher o plugin, não depois.
- O checkout quebrou durante a configuração. Tela branca, pedido que não conclui, campo que some após a instalação — sintomas que indicam conflito ou configuração errada.
A Panacea é especialista em WooCommerce, com foco em manutenção, checkout e integrações. Se a adaptação travou — ou você prefere garantir que o checkout está certo antes de ativar pagamentos —, uma análise técnica aponta o problema e o caminho.
Solicitar análise inicial da minha loja
Perguntas frequentes
Preciso de um plugin para CPF/CNPJ no WooCommerce?
Sim. O núcleo do WooCommerce não tem campo de documento — não coleta, não valida e não salva CPF ou CNPJ. Sem um plugin de campos, o checkout brasileiro fica sem o dado que emissão fiscal, integrações e devoluções frequentemente exigem.
Qual é o melhor plugin de CPF/CNPJ para WooCommerce?
Não existe um “melhor” universal — existe o plugin que atende os critérios da sua loja: manutenção recente, compatibilidade com checkout em blocos, suporte a CNPJ alfanumérico, preço e os campos que a sua operação usa. A tabela deste artigo mostra a situação verificada em agosto de 2026; antes de instalar, confira a data da última atualização na página oficial.
O checkout em blocos aceita campos de CPF/CNPJ?
Aceita, desde que o plugin seja compatível com o formato em blocos — via API de campos adicionais do checkout. Plugins feitos apenas para o checkout clássico não aparecem no checkout em blocos.
Instalei o plugin e nada aparece no checkout. O que houve?
A causa mais comum é incompatibilidade de formato: plugin de checkout clássico não funciona no checkout em blocos. Confirme que o plugin declara suporte ao formato em blocos e a versão mínima do WooCommerce exigida.
Preciso me preocupar com o CNPJ alfanumérico agora?
É preparação, não urgência. A implantação é gradual e vale só para novas inscrições — CNPJs existentes permanecem válidos. Mas o checkout que rejeitar letras vai barrar o primeiro cliente PJ novo com CNPJ alfanumérico. Inclua o formato na avaliação do plugin e no teste do checkout.
Posso pedir RG, data de nascimento e gênero no checkout?
Só se a sua operação tiver necessidade real e identificada — a LGPD limita a coleta ao mínimo necessário. Para a maioria das lojas, CPF/CNPJ resolve. Campos opcionais que não são usados devem ficar desativados.
O CEP preenche o endereço automaticamente?
Depende do plugin: vários oferecem autofill usando o serviço gratuito ViaCEP para consultar e preencher o endereço. O preenchimento facilita a vida do cliente, mas o endereço deve ser conferido — no teste e na loja.
Já recebo pedidos sem número e sem bairro. Como corrijo?
Configure os campos com um plugin compatível com o seu checkout e passe a conferir os pedidos a partir de agora. Para pedidos antigos e migração de loja que já usa plugin sem manutenção, a correção envolve dados já salvos — nesse caso, uma avaliação técnica evita retrabalho.
Próxima etapa
Etapa 4 de 9
Pagamentos
Como escolher e configurar o gateway de pagamento da sua loja WooCommerce: Pix, cartão, boleto, taxas, prazos de recebimento e testes antes do lançamento.
Continuar para a Etapa 4 →Artigos relacionados
Checklist para lançar uma loja WooCommerce: o que conferir antes de publicar
A última inspeção antes de publicar: backup, checkout, pagamentos, frete, e-mails, segurança e SEO. Confira o checklist de lançamento de loja WooCommerce.
Pagamentos no WooCommerce no Brasil: Pix, cartão, boleto e gateways
Como escolher e configurar o gateway de pagamento da sua loja WooCommerce: Pix, cartão, boleto, taxas, prazos de recebimento e testes antes do lançamento.
Como deixar o WooCommerce rápido desde o início: performance antes do lançamento
Prepare uma loja WooCommerce rápida antes do lançamento: meça a velocidade, configure cache sem quebrar o checkout e valide em desktop e mobile.