CEP automático, CPF e CNPJ: campos brasileiros no checkout
Como adaptar o formulário do WooCommerce ao comprador brasileiro, com CEP que preenche o endereço, validação de documentos e telefone com DDD.

Neste artigo
O WooCommerce nasceu para vender no mundo todo, então seus campos de endereço seguem um padrão genérico. Para quem vende no Brasil, isso significa formulários que pedem informações na ordem errada, não validam documentos e deixam o comprador digitar o que um CEP já resolveria.
Ajustar os campos ao formato brasileiro é uma das melhorias mais baratas e com mais impacto que uma loja pode fazer no checkout.
Comece pelo CEP
O CEP deveria ser o primeiro campo do bloco de endereço. Com ele, é possível preencher automaticamente rua, bairro, cidade e estado. O comprador só precisa digitar o número e, se houver, o complemento.
Alguns cuidados ao implementar:
- Aplique máscara (00000-000) e aceite o CEP colado com ou sem hífen.
- Mantenha os campos editáveis depois do preenchimento. Bases de CEP nem sempre estão atualizadas, e o comprador precisa conseguir corrigir.
- Trate CEPs genéricos: em muitas cidades pequenas, o CEP é único para o município inteiro e não traz rua nem bairro. Nesses casos, os campos devem ficar vazios e liberados.
- Não trave o checkout se a consulta falhar. Se o serviço de CEP estiver fora do ar, o comprador deve conseguir preencher tudo à mão.
Calcule o frete assim que o CEP for informado
Com o CEP em mãos, a loja já consegue calcular o frete. Mostrar as opções de entrega logo depois do CEP evita a surpresa no final e deixa o comprador decidir antes de investir tempo no restante do formulário.
CPF e CNPJ como campos nativos
Praticamente todo gateway brasileiro exige CPF ou CNPJ para gerar Pix, boleto ou aprovar cartão. Também é necessário para a nota fiscal. Por isso, o documento deve fazer parte do formulário desde o início, e não ser adicionado por um plugin isolado.
Boas práticas:
- Um campo só para CPF ou CNPJ, que identifica o tipo pelo número de dígitos, ou uma escolha simples entre pessoa física e jurídica.
- Máscara automática e validação dos dígitos verificadores enquanto o comprador digita.
- Mensagem de erro específica: "Confira o CPF, os números não batem" é mais útil que "Campo inválido".
- Teclado numérico no celular usando o atributo
inputmode="numeric".
Quando o comprador é pessoa jurídica, campos como razão social e inscrição estadual podem aparecer só depois que o CNPJ é identificado. Assim, quem compra como pessoa física não vê campos que não fazem sentido para ele.
Telefone com DDD e WhatsApp
O telefone brasileiro tem DDD e, no caso de celulares, nove dígitos. Uma máscara como (00) 00000-0000 evita erros e deixa claro o formato esperado. Se a loja usa WhatsApp para confirmação de pedido ou recuperação de carrinho, vale indicar isso no rótulo: "WhatsApp" é mais claro que "Telefone".
Número e complemento separados
O campo "Endereço linha 2" do WooCommerce não deixa claro o que deve ser preenchido. Separar número e complemento evita que o comprador escreva tudo junto na rua ou esqueça o número, o que gera problemas na entrega.
Remova o que não é usado
Depois de adaptar os campos brasileiros, revise o que sobrou:
- Nome da empresa, quando a loja vende para pessoa física.
- País, quando a loja só entrega no Brasil.
- Observações do pedido, se ninguém lê.
Cada campo removido é um pequeno esforço a menos para o comprador.
Resumo
Um formulário brasileiro bem feito pede o CEP primeiro, preenche o endereço sozinho, valida CPF e CNPJ na hora e mostra o frete cedo. O Checkout Rishi já traz esses campos configurados de forma nativa, sem depender de vários plugins separados.


