About this plugin
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
- 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).
- 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
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. com/terms.