PB Autocomplete CEP for WooCommerce

PB Autocomplete preenche automaticamente os campos de endereço (rua, bairro, cidade, estado) no Checkout em Blocos do WooCommerce quando o cliente informa o CEP. Utiliza as APIs públicas OpenCEP e ViaCEP e só é carregado quando o PagBank Connect está instalado e há ao menos um método de pagamento disponível no checkout.

Recursos

• Autocomplete de endereço por CEP no Checkout em Blocos do WooCommerce
• Integração com OpenCEP (principal) e ViaCEP (alternativa) para dados de CEP no Brasil
• Opção para exibir o CEP como primeiro campo na cobrança ou na entrega (configurável no editor de blocos ao editar a página de checkout)
• Dependência explícita de WooCommerce e PagBank Connect

Requisitos

• WooCommerce instalado e ativo
• PagBank Connect instalado e ativo, com ao menos um método de pagamento (PIX, cartão, boleto etc.) habilitado
• Uso do Checkout em Blocos do WooCommerce (não se aplica ao checkout legado/shortcode)

Configuration

1. O autocomplete funciona automaticamente no Checkout em Blocos quando o cliente informar um CEP válido (8 dígitos). Os campos de endereço são preenchidos após a consulta ao OpenCEP (ou ViaCEP, se necessário).
2. Para exibir o CEP como primeiro campo: edite a página de checkout no editor de blocos, selecione o bloco “Endereço de entrega” ou “Endereço de cobrança” e, no painel à direita, abra a secção PB Autocomplete. Marque as opções desejadas e clique em Salvar no topo.

External services

Este plugin envia pedidos HTTPS GET a partir do navegador do cliente (Checkout em Blocos do WooCommerce) para APIs de terceiros, com o objetivo de obter dados de endereço brasileiro a partir do CEP. O plugin não envia nome, e-mail, telefone ou endereço completo para essas APIs — apenas os dígitos do CEP vão no caminho do URL, quando o cliente informa um CEP válido com 8 dígitos.

OpenCEP (principal)

• O que é / para que serve: API pública de consulta de CEP em opencep.com, usada para devolver logradouro, bairro, cidade e UF.
• Quais dados são enviados e quando: Quando o autocomplete é acionado, o navegador solicita https://opencep.com/v1/{CEP} (apenas 8 dígitos). Como em qualquer pedido HTTP, metadados típicos do navegador (por exemplo IP, user-agent, referrer) podem ser tratados pelo serviço ou pela infraestrutura.
• Termos: Licença do projeto OpenCEP (MIT): https://github.com/SeuAliado/OpenCEP/blob/main/LICENSE
  Informações do serviço: https://opencep.com/
• Privacidade: O domínio opencep.com é entregue via Cloudflare (CDN). Política de privacidade da Cloudflare: https://www.cloudflare.com/privacypolicy/

ViaCEP (alternativa)

• O que é / para que serve: Webservice público em viacep.com.br, usado só se o OpenCEP não devolver dados utilizáveis para o mesmo CEP.
• Quais dados são enviados e quando: O navegador solicita https://viacep.com.br/ws/{CEP}/json/. Só o CEP vai no caminho. Aplica-se a mesma observação sobre metadados de pedido HTTP.
• Termos / condições de uso: Documentação oficial e avisos de uso (incluindo limites a uso massivo abusivo) estão no site do ViaCEP: https://viacep.com.br/
• Privacidade: O ViaCEP não disponibiliza uma página dedicada de política de privacidade. Contato do operador: https://viacep.com.br/faleconosco/

PagBank Connect (dependência obrigatória)

O PB Autocomplete exige o plugin PagBank Connect. Pagamentos, credenciais e outros serviços de terceiros ligados ao PagBank são tratados pelo PagBank Connect e pelo PagBank — não pelo PB Autocomplete. Documentação no WordPress.org: https://wordpress.org/plugins/pagbank-connect/ e Termos e Privacidade do PagBank Integrações em https://pbintegracoes.com/terms.

1. Certifique-se de ter o WooCommerce e o PagBank Connect instalados e ativos
2. Instale e ative o PB Autocomplete (Plugins > Adicionar novo, pesquise por “PB Autocomplete” ou envie o zip)
3. Se estiver compilando a partir do código-fonte: na pasta do plugin, execute npm install e depois npm run build