CEP Autocomplete for Address

CEP Autocomplete adiciona autocompletar de endereço por CEP (ViaCEP) aos formulários que usam o campo Address padrão (CommerceGuys Addressing).

Funciona nos Perfis “customer” do Drupal Commerce e em formulários de usuário — inclusive quando o bloco “Add Billing Information” é carregado via AJAX no checkout.

✅ Usa o Address nativo (sem campos alternativos)
✅ Compatível com Drupal 10/11 e Commerce 3.x
✅ Sem API key: ViaCEP público + cache server-side

Recursos

• Busca CEP (ViaCEP) + preenchimento automático:
• UF (Estado) → administrative_area
• Cidade → locality
• Logradouro → address_line1
• Bairro (se o campo existir) → dependent_locality
• Complemento: não é preenchido automaticamente; fica para o usuário.
• CEP em primeiro lugar + foco automático (melhor UX).
• Label/placeholder “Complemento” para address_line2 (em vez de “Street address line 2”).
• Pronto para AJAX (IEF/checkout): behaviors do Drupal reanexam no conteúdo injetado.
• Base path inteligente: funciona em sites em subdiretórios (ex.: /web/) e com prefixo de idioma.

Configuração recomendada

• Commerce → Store → Billing countries: marque apenas Brasil (BR) (opcional, remove o seletor de país).
• Confirme que o Profile “customer” tem o campo Address padrão (default do Commerce).
• Abra o formulário (edição do profile ou “Add Billing Information” no checkout).
• Digite um CEP de 8 dígitos (ex.: 01311000) — os campos serão preenchidos.
• Dica: no DevTools → Network, você verá a chamada ao endpoint interno do módulo com resposta 200.

Contribua!

Se você se sentir a vontade e quiser contribuir como gratidão, a chave pix é a seguinte: [email protected]