Title: PB Autocomplete CEP for WooCommerce Author: Ricardo Martins (PagBank Integrações) Published: April 6, 2026 Last modified: April 6, 2026 --- Search plugins ![](https://ps.w.org/pb-autocomplete/assets/banner-772x250.png?rev=3499619) ![](https://ps.w.org/pb-autocomplete/assets/icon-256x256.png?rev=3499619) # PB Autocomplete CEP for WooCommerce By [Ricardo Martins (PagBank Integrações)](https://profiles.wordpress.org/martins56/) [Download](https://downloads.wordpress.org/plugin/pb-autocomplete.1.0.6.zip) [Live Preview](https://wordpress.org/plugins/pb-autocomplete/?preview=1) * [Details](https://wordpress.org/plugins/pb-autocomplete/#description) * [Reviews](https://wordpress.org/plugins/pb-autocomplete/#reviews) * [Installation](https://wordpress.org/plugins/pb-autocomplete/#installation) * [Development](https://wordpress.org/plugins/pb-autocomplete/#developers) [Support](https://wordpress.org/support/plugin/pb-autocomplete/) ## Description **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](https://opencep.com/) e [ViaCEP](https://viacep.com.br/) e só é carregado quando o [PagBank Connect](https://wordpress.org/plugins/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](https://wordpress.org/plugins/woocommerce/) instalado e ativo * [PagBank Connect](https://wordpress.org/plugins/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. ## Screenshots * [[ * Checkout em Blocos com campo CEP e autocomplete de endereço * [[ * Painel PB Autocomplete no editor de blocos ao editar o bloco de endereço do checkout ## Installation 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` ## FAQ ### O plugin funciona no checkout legado (shortcode) do WooCommerce? Não. O PB Autocomplete foi desenvolvido apenas para o **Checkout em Blocos** do WooCommerce. No checkout legado, os campos não são preenchidos automaticamente por este plugin. Existem outros plugins para esse cenário. ### Por que o autocomplete não aparece no meu checkout? Verifique se: (1) o PagBank Connect está ativo e tem ao menos um método de pagamento habilitado nas configurações do WooCommerce; (2) a loja usa o Checkout em Blocos( página de checkout com blocos); (3) o CEP tem 8 dígitos e é válido no OpenCEP ou ViaCEP. ### De onde vêm os dados de endereço? Os dados vêm da API pública [OpenCEP](https://opencep.com/), que retorna logradouro, bairro, cidade e UF a partir do CEP. Se o OpenCEP estiver indisponível, é usado o [ViaCEP](https://viacep.com.br/) como alternativa. ### Posso usar sem o PagBank Connect? Não. O PB Autocomplete integra o ecossistema PagBank Integrações e exige o PagBank Connect ativo com método de pagamento disponível. Caso contrário, o script de autocomplete não é carregado no checkout. ### Como faço para o CEP aparecer primeiro? Edite a página de checkout no editor de blocos, selecione o bloco de endereço (entrega ou cobrança) e, no painel à direita, abra a secção PB Autocomplete. Marque as opções e clique em Salvar no topo. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “PB Autocomplete CEP for WooCommerce” is open source software. The following people have contributed to this plugin. Contributors * [ Ricardo Martins (PagBank Integrações) ](https://profiles.wordpress.org/martins56/) [Translate “PB Autocomplete CEP for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/pb-autocomplete) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/pb-autocomplete/), check out the [SVN repository](https://plugins.svn.wordpress.org/pb-autocomplete/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/pb-autocomplete/) by [RSS](https://plugins.trac.wordpress.org/log/pb-autocomplete/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.4 * Documentação de serviços de terceiros (OpenCEP, ViaCEP, PagBank Connect) no readme para conformidade com o WordPress.org. * Avisos de dependência limitados às telas Plugins e Adicionar plugin (diretriz 11 do diretório de plugins WordPress.org). * Detecção de métodos PagBank pelos IDs de gateway `rm-pagbank` (unificado) ou ` rm-pagbank-*` (PIX, cartão, boleto, Checkout PagBank, recorrência etc.); aviso opcional no admin quando o PagBank Connect está ativo mas nenhum método PagBank está habilitado (Plugins, Adicionar plugin, WooCommerce Configurações Finalizar compra). * A verificação “sem método PagBank” executa no hook `init`, para não carregar traduções de outros plugins cedo demais (WordPress 6.7+). #### 1.0.3 * Versão atual do plugin. ## Meta * Version **1.0.6** * Last updated **23 hours ago** * Active installations **Fewer than 10** * WordPress version ** 5.2 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Tags * [autocomplete](https://wordpress.org/plugins/tags/autocomplete/)[brasil](https://wordpress.org/plugins/tags/brasil/) [cep](https://wordpress.org/plugins/tags/cep/)[checkout](https://wordpress.org/plugins/tags/checkout/) [woocommerce](https://wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://wordpress.org/plugins/pb-autocomplete/advanced/) ## Ratings No reviews have been submitted yet. [Add my review](https://wordpress.org/support/plugin/pb-autocomplete/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/pb-autocomplete/reviews/) ## Contributors * [ Ricardo Martins (PagBank Integrações) ](https://profiles.wordpress.org/martins56/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/pb-autocomplete/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://github.com/sponsors/r-martins)