Title: AutoCEP Author: wanderson100 Published: 5. Septembra 2024. Last modified: 20. Augusta 2026. --- Pretražite dodatke ![](https://ps.w.org/autocep/assets/banner-772x250.jpg?rev=3650457) ![](https://ps.w.org/autocep/assets/icon-256x256.jpg?rev=3650457) # AutoCEP Od [wanderson100](https://profiles.wordpress.org/wanderson100/) [Skini](https://downloads.wordpress.org/plugin/autocep.zip) * [Detalji](https://bs.wordpress.org/plugins/autocep/#description) * [Recenzije](https://bs.wordpress.org/plugins/autocep/#reviews) * [Razvoj](https://bs.wordpress.org/plugins/autocep/#developers) [Podrška](https://wordpress.org/support/plugin/autocep/) ## Opis Autocompletar CEP no checkout do WooCommerce e simular frete em tempo real — produto, carrinho e checkout — com múltiplas APIs, cache, fallback automático e compatibilidade com Melhor Envio, Frenet, Fluid Checkout e CartFlows. ### Descrição **AutoCEP** resolve dois problemas clássicos de qualquer loja WooCommerce: fazer o cliente **preencher o endereço automaticamente ao digitar o CEP** e **mostrar o valor do frete antes de chegar ao checkout** — na página do produto, no carrinho e no próprio checkout. Se você procurou por _“autocompletar CEP no checkout WooCommerce”_, _“simular frete WooCommerce”_, _“calculadora de frete na página de produto”_ ou _“preencher endereço automático WooCommerce”_, é exatamente isso que o AutoCEP faz — e sem travar seu checkout, seja ele o padrão do WooCommerce, o **Fluid Checkout**, o **CartFlows** ou um checkout em etapas feito no **Elementor Pro**. O comportamento clássico do plugin (autocompletar endereço no checkout ao digitar o CEP) continua ativo por padrão assim que você instala — nenhuma configuração é necessária para isso. Todo o resto é opcional e fica no painel **AutoCEP** do WordPress. #### Por que instalar o AutoCEP * Reduz abandono de carrinho: o cliente vê o valor do frete **antes** de chegar ao checkout, na própria página do produto ou no carrinho. * Agiliza o preenchimento do endereço no checkout, reduzindo erros de digitação e abandono por formulário longo. * Funciona com o método de frete que sua loja já usa — Frete Fixo, Frete Grátis, retirada local, **Melhor Envio**, **Frenet** ou qualquer outro registrado como Zona de Entrega do WooCommerce — sem precisar reconfigurar nada. * Não depende de nenhuma API paga: usa ViaCEP, BrasilAPI e ApiCEP, com cache e fallback automático entre elas. #### Autocompletar de Endereço por CEP * Preenche Rua, Bairro, Cidade e Estado automaticamente a partir do CEP, na Cobrança e/ou na Entrega — cada uma pode ser ligada/desligada separadamente. * Consulta em cascata três APIs (ViaCEP, BrasilAPI e ApiCEP): se uma falhar ou não encontrar o CEP, a próxima é consultada automaticamente. * Cache de CEPs já consultados, com duração configurável e botão de limpeza manual— menos requisições externas, resposta mais rápida para o cliente. * Aviso automático quando o CEP é válido mas não tem rua específica cadastrada ( comum em cidades pequenas), em vez de deixar o campo vazio sem explicação. * Mensagem de erro visível para CEP inválido ou não encontrado. * Sugestões automáticas do navegador (autocomplete) nos campos de endereço, opcional. * **Compatível com qualquer checkout construído sobre o formulário padrão do WooCommerce**— incluindo Fluid Checkout, CartFlows e Elementor Pro — através de detecção automática de mudanças no formulário, sem depender de eventos específicos de cada plugin de checkout. #### Simulador de Frete: Produto, Carrinho e Checkout Três caixas de simulação de frete independentes, cada uma com posição e título configuráveis: * **Simular frete na página do produto**, considerando (opcionalmente) a quantidade e a variação selecionadas. * **Simular frete no carrinho de compras**, com os itens já adicionados. * **Simular frete no checkout**, cálculo rápido só com o CEP. Todas consultam as **Zonas de Entrega do WooCommerce** em tempo real, reconhecendo automaticamente qualquer transportadora já configurada — incluindo **Melhor Envio** e **Frenet** — sem nenhuma integração adicional. #### Personalização Visual Cores do campo de CEP e do botão “Calcular” (fundo, borda, texto e hover) personalizáveis com o seletor de cores nativo do WordPress, para combinar com a identidade visual da loja. #### Diagnóstico e Logs Status em tempo real (online/offline) de cada API de CEP e log das últimas falhas— incluindo falhas de métodos de frete de terceiros, como Melhor Envio ou Frenet, quando não retornam nenhuma taxa. ### Instalação 1. Faça o upload da pasta `autocep` para `/wp-content/plugins/` (ou envie o `.zip` diretamente em **Plugins > Adicionar Novo > Enviar Plugin**). 2. Ative o plugin no menu **Plugins** do WordPress. 3. Acesse o menu **AutoCEP** no painel administrativo — o autocompletar de CEP no checkout já estará funcionando; as demais abas permitem ativar o que fizer sentido para a sua loja. **Atualizando de uma versão anterior**: basta substituir os arquivos do plugin pelos desta versão (ou desativar e reativar depois de sobrescrever). As configurações já salvas são preservadas. ### Como usar cada aba do painel **Geral & Busca de CEP** — liga/desliga o autocompletar de Cobrança e Entrega no checkout, escolhe quais APIs de CEP ficam ativas e em qual ordem de prioridade, mapeia o campo de bairro, ativa o foco automático, define a duração do cache e o autocomplete do navegador. **Frete na Página de Produto** — ativa a caixa de frete no produto, escolhe a posição na página (ou “Manual — via shortcode” para posicionar com `[shipping_calculator_on_product_page]` dentro da descrição do produto), se deve considerar a quantidade selecionada, e o título da caixa. **Frete no Carrinho** — mesma ideia, para a página do carrinho de compras. **Frete no Checkout** — mesma ideia, para o checkout. **Mensagens & UX** — edita todos os textos exibidos ao cliente e o comportamento do botão “Finalizar Compra”. **Aparência** — personaliza as cores das caixas de frete. **Diagnóstico e Logs** — verifica o status das APIs de CEP em tempo real e consulta o histórico de falhas. ### Como o simulador de frete se relaciona com o frete real do pedido * **Na página do produto**: a caixa é **informativa** — mostra ao cliente, antecipadamente, quais métodos e valores estariam disponíveis para o CEP digitado. Como o item ainda nem está no carrinho, não há “seleção” possível ali; é só para ajudar na decisão de compra. * **No carrinho e no checkout**: cada opção de frete simulada tem um botão **“Selecionar”**— clicar nele aplica de verdade aquele método ao pedido, usando o mesmo mecanismo de sessão que o WooCommerce usa nos próprios botões de rádio de frete. Ou seja, não é cosmético: a partir do clique, esse é o frete escolhido para o pedido, e a etapa “Método de Entrega” do checkout (ou os totais do carrinho) refletem essa escolha automaticamente. O CEP e o método enviados no clique de “Selecionar” são sempre revalidados no servidor no momento da seleção — o plugin nunca aplica cegamente o que o navegador envia. ### Segurança Pontos de segurança implementados no plugin, para quem for avaliar antes de instalar: * **Nonces em toda ação AJAX**: cada requisição (busca de CEP, cálculo de frete, limpeza de cache, verificação de status, limpeza de logs) verifica uma nonce própria (`check_ajax_referer`) antes de processar qualquer coisa. * **Verificação de capacidade** (`current_user_can('manage_options')`) em todas as ações administrativas. * **Sanitização e validação de entrada** em todo dado recebido do cliente — CEPs são validados por formato antes de qualquer consulta ou cálculo. * **Consultas ao banco de dados preparadas** (`$wpdb->prepare`) em toda operação com dados variáveis. * **Escape de saída** (`esc_html`, `esc_attr`, `esc_url` etc.) em todo HTML gerado dinamicamente. * **Nenhuma execução de código dinâmico** (sem `eval`, sem `create_function`, sem inclusão de arquivos por caminho vindo do cliente). * **Requisições externas restritas** às APIs de CEP documentadas neste README e aos métodos de frete já configurados pela própria loja — o plugin não envia dados da loja ou dos clientes para nenhum outro destino. * **Tratamento de falhas de terceiros isolado**: se um plugin de frete de terceiros( ex.: Melhor Envio, Frenet) lançar uma exceção ou ficar indisponível, isso é capturado e registrado no log, sem interromper o restante do checkout. Este plugin é desenvolvido e mantido pela equipe da TESW. Como em qualquer software, recomendamos testar em ambiente de homologação antes de colocar em produção, e manter WordPress, WooCommerce e PHP sempre atualizados. ### Compatibilidade * **WordPress** até a versão 7.0.3 * **WooCommerce** (checkout padrão) * **Fluid Checkout** * **CartFlows** * **Elementor Pro** (checkout em etapas) * Métodos de frete: Frete Fixo, Frete Grátis, retirada local, **Melhor Envio**,** Frenet** e qualquer outro método registrado como Zona de Entrega do WooCommerce ### Documentação de Terceiros Este plugin pode consultar as seguintes APIs de CEP, conforme configuração: * ViaCEP— https://viacep.com.br/ * BrasilAPI — https://brasilapi.com.br/ * ApiCEP — https:// apicep.com/ O cálculo de frete usa exclusivamente as Zonas de Entrega já configuradas em WooCommerce > Configurações > Entrega — o AutoCEP não se conecta diretamente a nenhuma transportadora; ele lê os métodos que a própria loja já configurou (nativos do WooCommerce ou de plugins como Melhor Envio e Frenet). ### Perguntas Frequentes #### O autocompletar de CEP parou de funcionar depois que troquei de tema/checkout? O plugin observa automaticamente mudanças no formulário de checkout, então continua funcionando na maioria dos casos sem configuração extra, inclusive em checkouts de terceiros como Fluid Checkout e CartFlows. Se mesmo assim não funcionar, confira em Diagnóstico e Logs se alguma API está offline, e limpe o cache de CEPs. #### Por que aparecem duas caixas de frete na página de produto? Provavelmente outro plugin (ex.: Melhor Envio) também insere sua própria caixa automática. O AutoCEP desliga a do Melhor Envio automaticamente quando detecta o plugin instalado; para outras integrações, desative a exibição automática delas nas configurações do próprio plugin, ou desligue o simulador de produto do AutoCEP em vez disso. #### O simulador de frete não encontra nenhuma opção para um CEP que deveria funcionar Confirme que existe uma Zona de Entrega em WooCommerce > Configurações > Entrega que cubra o estado/CEP testado, com pelo menos um método habilitado. Consulte também a aba Diagnóstico e Logs — falhas de métodos de terceiros ficam registradas ali com a mensagem de erro específica. #### Apenas algumas transportadoras aparecem, mesmo com várias habilitadas na zona (ex.: Melhor Envio, Frenet) Isso normalmente **não é um bug** — é a própria transportadora rejeitando a cotação silenciosamente (sem erro, só sem preço) para aquele produto ou destino. A causa mais comum é o **produto estar sem peso cadastrado**: transportadoras via API (Melhor Envio, Frenet) costumam exigir peso mínimo para calcular a caixa/embalagem; Correios costuma ser mais tolerante e retornar preço mesmo sem peso definido, enquanto transportadoras privadas (Jadlog, Azul Ecommerce etc.) geralmente não. Como resolver: 1. Vá em **Produtos**, abra o produto testado e confira a aba **Entrega** — preencha peso e, se possível, dimensões (comprimento, largura, altura). 2. Repita a simulação de frete. 3. Se ainda faltar alguma transportadora, veja a aba **AutoCEP > Diagnóstico e Logs**— a partir da versão 2.3.0, o plugin registra ali exatamente quais transportadoras habilitadas na zona não retornaram taxa, e aponta produtos sem peso cadastrado como possível causa. #### Aparece “CEP não encontrado” mesmo digitando um CEP que parece válido Confira se o CEP foi digitado corretamente (é comum trocar um dígito, ex. 58264- 000 por 58265-000). Se o CEP realmente não existir na base dos Correios, nenhuma das três APIs consultadas (ViaCEP, BrasilAPI, ApiCEP) vai encontrá-lo — isso é esperado, não é uma falha do plugin. A aba Diagnóstico e Logs mostra uma linha “CEP não encontrado nesta API” para cada uma das três quando isso acontece, confirmando que o problema é o CEP em si. #### Clicar em uma opção de frete simulada aplica esse frete ao pedido? No carrinho e no checkout, sim — clicar em “Selecionar” aplica de verdade aquele método ao pedido. Na página do produto, a simulação é apenas informativa, já que o item ainda não está no carrinho. Veja a seção “Como o simulador de frete se relaciona com o frete real do pedido” acima. ### Ajuda e Suporte Em caso de dúvidas ou problemas: * Verifique se o CEP é válido. * Confirme se o plugin e as APIs desejadas estão ativos em AutoCEP > Geral & Busca de CEP. * Consulte a aba “Diagnóstico e Logs” para verificar falhas recentes. * Teste possíveis conflitos com outros plugins. ### Créditos * **Versão 2.0**: criada pela equipe TESW, com desenvolvimento principal de Wanderson Cesar. * **Contribuição pontual na versão 1.5**: Samuel Canale. ### Licença GPLv2 ou posterior. ### Desenvolvedor * **Empresa**: TESW * **Site**: https://tesw.com.br/plugins/ ## Slike ekrana [⌊Geral & Busca de CEP — autocompletar de Cobrança/Entrega, campo de bairro, autocomplete do navegador e prioridade das APIs de CEP.⌉⌊Geral & Busca de CEP — autocompletar de Cobrança/Entrega, campo de bairro, autocomplete do navegador e prioridade das APIs de CEP.⌉[ Geral & Busca de CEP — autocompletar de Cobrança/Entrega, campo de bairro, autocomplete do navegador e prioridade das APIs de CEP. [⌊Frete na Página de Produto — ativação, posição na página e opção de considerar a quantidade selecionada.⌉⌊Frete na Página de Produto — ativação, posição na página e opção de considerar a quantidade selecionada.⌉[ Frete na Página de Produto — ativação, posição na página e opção de considerar a quantidade selecionada. [⌊Frete no Carrinho — simulador de frete configurável para a página do carrinho de compras.⌉⌊Frete no Carrinho — simulador de frete configurável para a página do carrinho de compras.⌉[ Frete no Carrinho — simulador de frete configurável para a página do carrinho de compras. [⌊Frete no Checkout — cálculo rápido de frete por CEP direto no checkout.⌉⌊Frete no Checkout — cálculo rápido de frete por CEP direto no checkout.⌉[ Frete no Checkout — cálculo rápido de frete por CEP direto no checkout. [⌊Mensagens & UX — todos os textos exibidos ao cliente, editáveis.⌉⌊Mensagens & UX — todos os textos exibidos ao cliente, editáveis.⌉[ Mensagens & UX — todos os textos exibidos ao cliente, editáveis. [⌊Aparência — personalização das cores do campo de CEP e do botão "Calcular".⌉⌊Aparência— personalização das cores do campo de CEP e do botão "Calcular".⌉[ Aparência — personalização das cores do campo de CEP e do botão “Calcular”. [⌊Diagnóstico e Logs — status em tempo real das APIs de CEP e histórico de falhas.⌉⌊ Diagnóstico e Logs — status em tempo real das APIs de CEP e histórico de falhas.⌉[ Diagnóstico e Logs — status em tempo real das APIs de CEP e histórico de falhas. [[ [[ [[ ## Recenzije ![](https://secure.gravatar.com/avatar/2bdf973d405b780d42828dd26e26414a0e09072b39a524c6ea8ea7d958b21ced? s=60&d=retro&r=g) ### 󠀁[Funcionando Perfeito](https://wordpress.org/support/topic/funcionando-perfeito/)󠁿 [abraaocostaof](https://profiles.wordpress.org/abraaocostaof/) 3. Augusta 2026. Irmãos e irmãs esta funcionando perfeitamente bem na versão wordpress e woocommerce em 3/8/26 parabéns irmão tamo junto ![](https://secure.gravatar.com/avatar/eb1de03eb0e0a2e156bfb206636fc0270956a62fd66c80832be9549fe8819650? s=60&d=retro&r=g) ### 󠀁[Excelente Plugin, fácil e rápido](https://wordpress.org/support/topic/excelente-plugin-facil-e-rapido/)󠁿 [raulsilvaitpro](https://profiles.wordpress.org/raulsilvaitpro/) 30. Maja 2025. Por mais programadores brasileiros com iniciativa em resolver soluções como essa, já que o plugin core do woocommerce não investe em melhorias. ![](https://secure.gravatar.com/avatar/b0ce32d74a7e614032461eac70ef9fb3dcf08e46b5337de855df150c0da8daf4? s=60&d=retro&r=g) ### 󠀁[Funcionou Muito bem](https://wordpress.org/support/topic/funcionou-muito-bem-8/)󠁿 [startoys](https://profiles.wordpress.org/startoys/) 14. Novembra 2024. Este plugin é fantástico! Sem necessidade de configurações complexas: é só instalar, e ele já começa a funcionar imediatamente. Diferente das alternativas, não há necessidade de conectar com a chave API dos Correios. Super prático! Parabéns pela solução e muito obrigado por facilitar nosso trabalho! ![](https://secure.gravatar.com/avatar/fa76fd85929ca10995aff861cb0c51ebcdd17d7387048806d5098d95741d2261? s=60&d=retro&r=g) ### 󠀁[Incompatibilidade](https://wordpress.org/support/topic/funcionou-perfeitamente-15/)󠁿 [eduardokasse](https://profiles.wordpress.org/eduardokasse/) 20. Augusta 2026. Sempre usei esse plugin e tem sido ótimo, contudo, nas últimas atualizações têm indicado a incompatibilidade com o Woocommerce através da mensagem: “1 plug -in incompatível detectado (AutoCEP).” Tem previsão de ajustar isso? ![](https://secure.gravatar.com/avatar/660eaec308773b66dad0c1c083fcbbcbc5b65c3125ce9036388b7225a773b5df? s=60&d=retro&r=g) ### 󠀁[Excelente! Muito melhor que outros por aí](https://wordpress.org/support/topic/excelente-muito-melhor-que-outros-por-ai/)󠁿 [Leonardo](https://profiles.wordpress.org/engleonardo/) 28. Oktobra 2024. Esse plugin é excelente, muito bom mesmo! Não precisa configurar nada, apenas instalar e pronto, já está funcionando. Diferentemente do concorrente… Não precisa conectar com chave API dos correios. Muito simples! Parabéns pela solução criada e muitíssimo obrigado!!! ![](https://secure.gravatar.com/avatar/2f9fbaea2c38a390ba88690bdf99d21de1caeb8f9bcfeefa47d4f9290bae10c3? s=60&d=retro&r=g) ### 󠀁[Muito bom! Funcionou no Fluid Checkout](https://wordpress.org/support/topic/muito-bom-funcionou-no-fluid-checkout/)󠁿 [guilherme3301](https://profiles.wordpress.org/guilherme3301/) 17. Septembra 2024. Funcionou perfeitamente no Fluid Checkout. Estava usando o plugin dos correios, mas o preenchimento automático não funciona com o fluid checkout. Muito bom, parabéns! [ Read all 6 reviews ](https://wordpress.org/support/plugin/autocep/reviews/) ## Saradnici i programeri “AutoCEP” is open source software. The following people have contributed to this plugin. Doprinositelji * [ wanderson100 ](https://profiles.wordpress.org/wanderson100/) [Prevedi “AutoCEP” na vaš jezik.](https://translate.wordpress.org/projects/wp-plugins/autocep) ### Zainteresirani za razvoj? [Pregledajte kôd](https://plugins.trac.wordpress.org/browser/autocep/), pogledajte [SVN spremište](https://plugins.svn.wordpress.org/autocep/)ili se pretplatite na [dnevnik razvoja](https://plugins.trac.wordpress.org/log/autocep/) od [RSS](https://plugins.trac.wordpress.org/log/autocep/?limit=100&mode=stop_on_copy&format=rss). ## Zapis promijena #### 2.3.6 * Corrigido problema no checkout onde o Bairro era preenchido incorretamente no campo Complemento e deixava o Bairro vazio, impedindo o cálculo de frete. #### 2.3.5 * Vídeo demonstrativo (https://youtu.be/CygVGP-LUJg) adicionado no topo da Descrição do README, no formato que o WordPress.org converte automaticamente em player incorporado. * Removido o arquivo de vídeo local do pacote (`store-assets/`), já hospedado no YouTube — reduz bastante o tamanho do .zip do plugin. * Créditos esclarecidos: versão 2.0 criada pela equipe TESW, com desenvolvimento principal de Wanderson Cesar. #### 2.3.4 * Corrigido: ao selecionar um frete simulado no checkout, os campos de Cidade e Estado podiam continuar mostrando o endereço antigo mesmo com o CEP já atualizado, quando o autocompletar de Cobrança/Entrega estava desligado nas configurações. Como essa sincronização acontece por uma ação explícita do cliente (clicar em“ Selecionar”), agora ela sempre atualiza o endereço completo (rua/bairro/cidade/ estado), independente dessa opção. * A sincronização de endereço ao selecionar um frete agora espera a busca terminar de verdade antes de recalcular o checkout, em vez de um tempo fixo — mais confiável em conexões lentas. * Adicionados materiais de divulgação do plugin (ícone, banner e capturas de tela do painel) na pasta `store-assets/`, e seção de Screenshots no README. #### 2.3.3 * Corrigido: ao selecionar um frete simulado no checkout quando a etapa “Método de Entrega” já estava renderizada com uma opção diferente marcada, o próprio recálculo nativo do WooCommerce reenviava o valor do rádio ainda marcado na tela( o antigo) e sobrescrevia a seleção feita — mostrando “Frete selecionado com sucesso” mas mantendo o método/valor anterior. Agora o rádio nativo correspondente é marcado antes do recálculo, garantindo que a escolha feita na simulação seja a que efetivamente é enviada e aplicada. #### 2.3.2 * Card de simulação de frete menor e mais compacto (menos padding, fonte e espaçamentos reduzidos), para ocupar menos espaço na página de produto/carrinho/checkout. * Corrigida (definitivamente) a aparência “torta” do texto dentro do botão “Calcular”: duas causas — o `letter-spacing` adicionava espaço também depois da última letra, descentralizando visualmente o texto; e a quebra de linha/indentação dentro da tag `