Passar para o conteúdo principal

Brazilian Market no WooCommerce: CPF/CNPJ no checkout

Instale e ative o plugin Brazilian Market on WooCommerce para adicionar CPF/CNPJ e outros campos obrigatórios ao checkout de lojas brasileiras. Veja como configurar rapidamente e garantir compatibilidade com frete e gateways de pagamento.

🧭 Quando usar

  • Ao lançar uma loja WooCommerce para o mercado brasileiro

  • Ao integrar gateways de pagamento e frete que exigem CPF/CNPJ

  • Ao ajustar o checkout para conformidade com dados do comprador

✅ Pré-requisitos

  • Acesso de administrador ao WordPress

  • WooCommerce instalado e ativo

  • Loja com moeda/país configurados para Brasil

🛠️ Passo a passo

Passo 1 – Instalar o plugin

  1. No WordPress, acesse Plugins » Adicionar novo.

  2. Busque por Brazilian Market on WooCommerce (autor: Claudio Sanches).

  3. Clique em Instalar agora e depois Ativar.

Passo 2 – Validar campos no checkout

  1. Após ativar, os campos CPF/CNPJ são adicionados automaticamente ao checkout.

  2. Acesse WooCommerce » Configurações » Brasil (aba do plugin) para revisar as validações padrão.

  3. (Opcional) Habilite RG, Data de nascimento e outros campos conforme a sua política.

Passo 3 – Garantir compatibilidade com frete e pagamentos

  1. Configure seu método de frete (ex.: Melhor Envio) e gateways (ex.: Mercado Pago, Getnet).

  2. Confirme se os dados do comprador (CPF/CNPJ) aparecem na ordem/pedido.

  3. Faça um pedido de teste para validar a transmissão dos campos.

🧩 Exemplos práticos

  • Exemplo 1: Loja ativa apenas CPF (PF); checkout exige CPF válido antes de prosseguir.

  • Exemplo 2: Loja B2B ativa CNPJ (PJ) e IE; notas fiscais são emitidas com os dados corretos.

🧪 Solução de problemas

  • Erro/Sintoma: Campo CPF/CNPJ não aparece no checkout.
    ​Causa provável: Plugin não ativado ou cache.
    ​Como resolver: Verifique Plugins » Instalados e limpe o cache do site/ CDN.

  • Erro/Sintoma: Gateway reclama de “documento ausente”.
    ​Causa provável: Campo não mapeado no pedido ou checkout customizado conflitando.
    ​Como resolver: Desative customizações do checkout temporariamente, confira as opções do plugin e refaça o pedido de teste.

  • Erro/Sintoma: Validação bloqueia avanço com documento válido.
    ​Causa provável: Formatação/ máscara diferente.
    ​Como resolver: Remova caracteres especiais ao digitar (somente números) e revise as regras de validação na aba do plugin.

🔎 Referências e links úteis

🗂️ Metadados

  • Categoria: Checkout e Pagamentos

  • Subcategoria: Localização Brasil (WooCommerce)

  • Tags: WooCommerce, checkout, CPF, CNPJ, Brasil, Claudio Sanches, validação

  • Nível: básico

  • Atualizado em: 2025-11-09

Artigos relacionados
Respondeu à sua pergunta?