Gerenciador de Campos para Lojas Brasileiras RaCar

Sempre aplicar o checkout brasileiro no frontend

Com esta opção ligada, campos brasileiros, layout, máscaras e validações se aplicam independentemente do país escolhido no checkout (clássico e blocos). Desligue para seguir as regras de locale do WooCommerce por país e exibir os campos brasileiros apenas quando o Brasil estiver selecionado.

Sub-abas: Checkout clássico e Checkout em blocos

• O plugin detecta o tipo de página de checkout da loja e marca a sub-aba correspondente com o badge Ativo.
• Há links rápidos para Editar página de checkout e Configurações avançadas do WooCommerce.
• Dica na interface: Clique na engrenagem para ver as opções do campo.

Layout do checkout clássico

• Recuperar colunas de checkout flutuantes — use se o tema ainda organiza o checkout com CSS float e as colunas quebram ao mostrar/ocultar PF/PJ.
• Preservar o layout de linha de duas colunas em telas pequenas — mantém o pareamento esquerda/direita no mobile, quando desejado.

Checkout em blocos

• Ativar suporte a campos no checkout em blocos — habilita a integração dos campos brasileiros no Checkout Block.
• Título editável da seção Documentos (demais títulos de seção costumam ser editados no editor do bloco; há link para abrir o editor).
• Seções na grade de blocos: Documentos, Informações de contato, Endereço de Entrega, Endereço de Faturamento e Campos de observações.

Grade de campos: ligar, arrastar e configurar

Nos cartões de campo, cartões com visual distinto separam campos nativos do WooCommerce dos campos adicionados pelo plugin. Em cada cartão você pode:

• Arrastar para reordenar (define a prioridade/ordem vertical).
• Ligar ou desligar o campo com o toggle do cabeçalho.
• Abrir a engrenagem para editar opções.

Opções típicas dentro da engrenagem:

• Rótulo — texto acima do campo.
• Texto de exemplo (placeholder) — disponível no checkout clássico para campos que não são select.
• Layout da linha — Linha completa, Coluna esquerda ou Coluna direita (substitui a edição manual de classes CSS como fluxo principal).
• Obrigatório? — Sim ou Não.

Tipo de pessoa (PF e PJ)

O campo Tipo de pessoa inclui o controle de Modo:

• PF e PJ (ambos) — o seletor aparece no checkout.
• Somente PF ou Somente PJ — o seletor some e o fluxo assume o modo escolhido.
• Nenhum — desativa a lógica de tipo de pessoa.

Ao mudar o modo, campos relacionados podem ser desligados automaticamente (por exemplo, empresa em loja só PF). Você ainda pode religar um campo manualmente pelo toggle, se a loja exigir.

Seções no checkout clássico

• Campos de Faturamento
• Campos de Entrega
• Campos de observações

Exceções importantes

• Nome de usuário e senha da conta no checkout são controlados pelo WooCommerce em Contas e Privacidade (não pelo toggle do plugin). Há atalho para essa tela.
• Essas opções da Aba 1 valem para o checkout; o registro em Minha Conta segue o template do WooCommerce (e a Aba 4 para campos extras).
• Observações do pedido tem particularidades de layout (campo amplo por natureza).

Empresa como nome

Quando o cliente é PJ (ou o modo é Somente PJ), esta opção faz o nome da empresa ser salvo no first_name do WordPress/WooCommerce — útil quando o representante de compras muda com frequência e o “nome” exibido em Minha Conta deve ser o da empresa.

Dimensões do campo de checkout

Ajuste altura e line-height de selects e inputs do checkout para alinhar visualmente com o tema da loja.

Melhoria das caixas de seleção (Select2)

Ativa Select2 nos campos Tipo de pessoa e Gênero: busca digitável e aparência mais compacta. O custo é carregar assets extras e transformar o campo após o carregamento da página — teste o que funciona melhor na sua loja.

Máscara de campo

Com máscaras ativas, CPF, CNPJ, CEP, telefone/celular e data recebem formatação automática na digitação (por exemplo, CPF como 123.456.789-09), melhorando a experiência e reduzindo erros.

O botão Salvar alterações permanece desativado até haver mudanças. Sempre salve antes de sair da tela.

Lista de campos brasileiros e do WooCommerce gerenciáveis

Documentos e campos brasileiros (plugin)

• Tipo de pessoa · CPF · RG · CNPJ · Inscrição Estadual
• Data de nascimento · Gênero
• Número · Bairro · Telefone celular

Faturamento (WooCommerce + plugin)

• Nome · Sobrenome · Nome da empresa · E-mail
• País · CEP · Logradouro · Complemento · Cidade · Estado · Telefone
• Nome de usuário / Senha da conta (sincronizados com Contas e Privacidade)

Entrega

• Nome e sobrenome do destinatário · Empresa · Contato do destinatário
• País · CEP · Logradouro · Número · Complemento · Bairro · Cidade · Estado

Pedido

• Observações do pedido

Além das opções da interface, o plugin valida CPF e CNPJ com dígitos verificadores no frontend (comportamento automático quando os campos estão ativos e obrigatórios no fluxo).

Aba 2 — Preenchimento automático de endereços por CEP

Quando o cliente informa um CEP válido, o plugin consulta primeiro a BrasilAPI e, se necessário, a ViaCEP como fallback. Apenas o CEP é enviado às APIs — sem nome, e-mail ou dados do pedido.

Ativação

• Ativar para endereço de cobrança
• Habilitar para endereço de entrega

Bloquear campos após preenchimento automático

Você escolhe quais campos ficam bloqueados depois de uma busca bem-sucedida:

• Logradouro (linha de endereço 1)
• Bairro
• Cidade
• Estado

Se a API não retornar endereço válido, os campos não são bloqueados, para o cliente poder digitar manualmente. Para editar um campo bloqueado, o cliente precisa informar um novo CEP.

Não esqueça de clicar em Salvar alterações.

Aba 3 — Uma conta por CPF/CNPJ

Habilitar validação de uma conta por CPF/CNPJ

Impede que um novo cadastro (checkout ou Minha Conta) use um CPF ou CNPJ já existente na loja. É especialmente útil em promoções de primeira compra para novos clientes.

Pré-requisito: pelo menos um dos campos CPF ou CNPJ precisa estar habilitado na Aba 1.

Use CPF ou CNPJ como nome de usuário para login

Semelhante ao que grandes marketplaces fazem: o documento vira o username. O cliente continua podendo entrar com e-mail. Esta opção exige que o WooCommerce esteja configurado para gerar o nome de usuário automaticamente (Contas e Privacidade). Ao ativá-la, a validação de uma conta por documento é ligada e travada — não é possível ter dois logins com o mesmo CPF/CNPJ.

Salve com Salvar alterações.

Aba 4 — Formulário de Registro de Usuário (Minha Conta)

Por padrão, o registro em Minha Conta pede pouco (e-mail e, conforme o WooCommerce, usuário/senha). Nesta aba você escolhe quais campos deseja no formulário de registro — em geral herdando rótulo, ordem e obrigatoriedade definidos na Aba 1.

• Alguns campos ficam bloqueados ou sincronizados (e-mail obrigatório; username/senha conforme Contas e Privacidade; regras especiais para tipo de pessoa, CPF e CNPJ).
• Tornar todos os campos amplos no formulário de registro — força largura total (um campo por linha), útil porque a coluna de registro em Minha Conta costuma ser estreita.

Conclua com Salvar alterações.

Aviso, reconhecimento e apoio ao desenvolvimento

No rodapé da tela de configurações você encontra o card Aviso e Reconhecimento, com a menção ao Brazilian Market for WooCommerce e a Claudio Sanches, além do lembrete de que o plugin é gratuito e aceita doação (“me pagar um café”) para continuar o desenvolvimento.