AutoCEP

O melhor plugin de CEP e frete do Brasil — completo e 100% gratuito

O AutoCEP transforma a logística da sua loja WooCommerce: autocompleta o endereço do cliente ao digitar o CEP e simula o frete em tempo real — na página do produto, no carrinho e no checkout — eliminando as duas maiores causas de abandono de carrinho no e-commerce brasileiro: o atrito de preencher um formulário longo e a incerteza do valor do frete antes da decisão de compra.

Desenvolvido pela equipe de engenharia da TESW, em parceria estratégica com a Ritmo Digital, todos os módulos — tabela de frete própria por CEP e peso, frete por Km, Growth Marketing (previsão de entrega e barra de frete grátis), retirada em loja por proximidade, personalização visual completa e o dashboard de Analytics — vêm desbloqueados desde a instalação, sem cobrança de mensalidade, sem versão “Pro” e sem recursos limitados atrás de upgrade.

Novidades da versão 2.48

• Tabela de Frete por CEP e Peso (novo método de envio): cadastre sua própria planilha de frete — cole as linhas direto do Excel/Google Planilhas ou importe um arquivo CSV. Várias opções por CEP (ex.: Econômico e Expresso), prazo em dias úteis integrado à previsão de entrega e taxa adicional opcional. Ao salvar, a Zona de Entrega é limitada sozinha às faixas de CEP da tabela e posicionada na ordem certa.
• Checkout Moderno em 3 etapas (novo): transforma o checkout clássico em Identificação → Entrega → Pagamento, com resumo do pedido sempre visível, validação a cada etapa, modo compacto e layout que se adapta à forma de pagamento (Pix, cartão ou boleto). Na página de pedido recebido, destaca o QR Code Pix com botão “Copiar código Pix”.
• Analytics do Checkout (funil de conversão): na aba Analytics, veja a taxa de conversão do checkout, onde os clientes desistem (entrada → entrega → pagamento → finalizar → pedido), receita e ticket médio, tempo médio até o pedido, conversão por forma de pagamento (Pix, cartão, boleto) e por aparelho (celular x computador) e os campos que mais travam os clientes. Anônimo: nenhum nome, e-mail ou endereço é gravado.
• Sugestões de endereço ao digitar: enquanto o cliente digita a rua, aparece uma lista de ruas reais (ex.: “Av Paulista” → “Avenida Paulista (até 610 – lado par) — Bela Vista, São Paulo/SP · CEP 01310-000”); ao escolher, preenche rua, bairro, cidade, estado e o CEP. Grátis pelo ViaCEP (com cidade e estado) ou pelo Google Maps, se a loja tiver chave.
• Autocompletar no Checkout em Blocos: o endereço agora é preenchido também no novo checkout em blocos do WooCommerce (padrão nas lojas novas).
• Compatível com HPOS e WooCommerce 11: fim do aviso “1 plugin incompatível detectado (AutoCEP)” — pode manter o armazenamento de pedidos de alto desempenho ativado.
• Mais rápido quando uma API cai: a API de CEP ou o Google Maps que ficar lento/fora do ar entra em pausa automática e a próxima alternativa assume na hora — sem o cliente ficar esperando o “carregando”.
• Sem zoom no iPhone/iPad: o campo de CEP não amplia mais a página ao ser tocado, e campo e botão ficaram maiores no celular.
• Correções: título em branco e janela de configuração vazia nos métodos de envio do AutoCEP; “CEP não encontrado” indevido quando uma API bloqueava o servidor; consulta à ApiCEP corrigida.

Assista ao Vídeo de Apresentação e Demonstração

Documentação Oficial do Plugin

Guia completo de instalação, configuração de cada aba, integração com transportadoras e personalização visual: tesw.com.br/documentacao-autocep

Por que instalar o AutoCEP

• Painel de Latência em Tempo Real (ms) e Prioridade de APIs: o AutoCEP consulta ViaCEP, BrasilAPI e ApiCEP. Na aba “Frete e Busca de CEP”, o botão “Testar CEP Agora” mede a latência de cada provedor em milissegundos, para você definir a ordem de prioridade (1ª, 2ª, 3ª escolha). Se uma API oscilar, a próxima assume automaticamente em cascata.
• 100% gratuito de verdade: tabela de frete, frete por Km, simulador de produto, Growth Marketing, previsão de entrega, personalização visual e dashboard de Analytics vêm todos desbloqueados, sem custo.
• Zero divergência de valores: o simulador não inventa estimativas — ele lê as Zonas de Entrega reais do seu WooCommerce (transportadoras, frete fixo, frete grátis ou a Tabela de Frete do próprio AutoCEP). O valor simulado é o mesmo cobrado no checkout.
• Fallback automático para o Google Maps: no cálculo de frete por Km e na retirada por proximidade, se a Distance Matrix API do Google sofrer timeout ou instabilidade, o plugin recalcula por estimativa (linha reta × 1.3), sem deixar de mostrar uma opção de frete ao cliente.
• Navegação ágil com submenus dedicados: atalhos diretos com ícones próprios para Visão Geral, Analytics, Growth Marketing, Retirada em Loja, Integrações de Frete, Suporte Técnico e Diagnóstico.
• Suporte integrado ao painel: abra chamados direto do WordPress, com número sequencial (ex.: AC-000123) e botões de contato rápido (e-mail e WhatsApp) que já carregam uma mensagem pronta com o site e a versão do plugin.
• Cache duplo de alta performance: Cache de CEPs (dias configuráveis) e Cache de Cotações de Frete (horas configuráveis), deixando simulações repetidas quase instantâneas e reduzindo chamadas a APIs de transportadoras como Melhor Envio e Frenet.
• Pausa automática de APIs lentas: se uma API de CEP ou o Google Maps não responder, ela é pulada por alguns minutos e a próxima alternativa assume — só o primeiro cliente sente a demora, nunca a loja inteira.
• Seleção real no checkout e no carrinho: clicar em “Selecionar” aplica de verdade aquele método à sessão do WooCommerce, sempre revalidado no servidor antes de ser aplicado.
• Compatibilidade universal com CSS de prioridade garantida: funciona com o checkout clássico e o Checkout em Blocos do WooCommerce, Fluid Checkout, CartFlows e Elementor Pro — as cores e tipografia configuradas no painel sobrepõem até temas com estilos globais agressivos.

Funcionalidades Incluídas (Todas Gratuitas)

• Autocompletar de Endereço Inteligente: preenchimento automático de Rua, Bairro, Cidade e Estado (Cobrança e Entrega) no checkout clássico e no Checkout em Blocos, foco automático no campo “Número”, detecção dos campos de bairro mais comuns (billing_neighborhood, billing_bairro, billing_district) e aviso para CEPs sem rua específica cadastrada.
• Checkout Moderno (Multietapas) e Gerenciador de Campos: checkout clássico dividido em Identificação, Entrega e Pagamento, com campos extras e campos padrão que você esconde ou torna obrigatórios pelo painel, com barra de progresso, resumo do pedido fixo (recolhível no celular), validação de e-mail, telefone e CEP a cada etapa, escolha de frete em cartões, modo compacto (campos opcionais atrás de “+ adicionar”) e mensagens por forma de pagamento (Pix, cartão, boleto) detectadas automaticamente nos gateways brasileiros. Usa os campos originais do WooCommerce, então gateways, plugins de CPF/CNPJ e o autocompletar de CEP continuam funcionando. Mobile-first e compatível com Astra, Hello Elementor, GeneratePress e outros temas.
• Sugestões de Endereço ao Digitar: lista de ruas reais no campo Endereço, com o trecho de numeração de ruas longas, entendendo abreviações (Av, R., Al., Dr., Prof.…) e sem CEPs de grandes usuários/caixas postais. Ao escolher, preenche rua, bairro, cidade, estado e o CEP — ideal para quem não sabe o CEP. Grátis via ViaCEP (precisa de cidade e estado) ou via Google Places (opcional, com a chave da loja, consultado pelo servidor). Funciona com teclado (setas, Enter, Esc) e toque.
• Tabela de Frete por CEP e Peso: método de envio próprio em WooCommerce > Configurações > Entrega. Cole a planilha do Excel/Google Planilhas ou importe um CSV com as colunas cep_inicial; cep_final; peso_min; peso_max; valor; prazo; nome. Várias opções de frete por CEP, prazo integrado à previsão de entrega, taxa adicional, aviso de linhas com erro e limitação automática da Zona de Entrega às faixas de CEP da tabela. Calculada no próprio servidor da loja, sem depender de nenhuma API externa.
• Simuladores de Frete (Produto, Carrinho e Checkout): cotação na página do produto (considerando quantidade e variação), no carrinho (somando os itens) e no checkout (cálculo rápido por CEP). Pode ser posicionado manualmente com o shortcode [shipping_calculator_on_product_page], e desliga automaticamente a caixa nativa do Melhor Envio para não duplicar campos.
• Growth Marketing — Previsão de Entrega e Frete Grátis Dinâmico: datas estimadas de entrega (ex.: “Chega entre Quarta-feira (25/10) e Sexta-feira (27/10)”), com opção de contar só dias úteis, e Barra de Progresso de Frete Grátis com a tag dinâmica {missing} (ex.: “Faltam {missing} para você ganhar Frete Grátis!”), detectando automaticamente as regras de frete grátis já configuradas no WooCommerce.
• Retirada em Loja por Proximidade e Frete por Km (Google Maps): cálculo de distância rodoviária real com fórmula de Taxa Fixa + (Km × Valor por Km), raio e valor mínimo configuráveis, e testes integrados de Status Rápido da API e Diagnóstico Detalhado de distância entre dois CEPs.
• Integrações de Frete: testes de conexão em tempo real com as APIs do Melhor Envio e da Frenet — o token é detectado automaticamente a partir do que já está salvo nos plugins oficiais de cada transportadora (nenhum campo para preencher), confirmando se ele é válido e se a API está no ar, sem precisar simular um pedido completo.
• Personalização Visual Completa: cor de fundo, borda e texto da caixa e do botão, arredondamento (nenhum/pequeno/médio/grande), tipografia (tamanho e peso da fonte) e espaçamento (compacto/normal/espaçoso), incluindo cores próprias para a barra de frete grátis em progresso e ao ser conquistada.
• Pagamento na Entrega: dinheiro com troco, Pix, débito, crédito ou vale na entrega, liberado só para os fretes que você escolher (ex.: Motoboy e Retirada), com a forma e o troco no pedido e nos e-mails.
• Pós-Compra — Status do Pedido e Página de Obrigado: mensagem em tempo real quando o pagamento é aprovado (ou falha, é cancelado…), na página de pedido recebido, e redirecionamento opcional para a sua página de agradecimento depois da aprovação.
• Analytics — Funil do Checkout: taxa de conversão e desistência do checkout etapa por etapa, receita e ticket médio, tempo médio até o pedido, conversão por forma de pagamento e por aparelho, e ranking dos campos que mais geram erro — dados anônimos, com filtro de 7/30/90 dias.
• Analytics — Inteligência de Frete: frete médio calculado vs. pago, taxa de conversão vs. desistência, ranking dos CEPs e estados que mais geram cotações, e os métodos de frete mais escolhidos nos pedidos.
• Diagnóstico e Detecção de Produtos sem Peso: histórico de falhas e timeouts de transportadoras. Quando um método habilitado na zona não retorna taxa, o plugin aponta produtos sem peso/dimensões cadastrados (Produtos > Editar Produto > Entrega) como causa provável — comum em transportadoras privadas via API (ex.: Jadlog, Azul Ecommerce), que costumam exigir esse dado para cotar, diferente dos Correios.

Segurança e Padrões de Engenharia

• Nonces em toda ação AJAX (check_ajax_referer) e 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, e consultas ao banco sempre parametrizadas ($wpdb->prepare).
• Escape de saída (esc_html, esc_attr, esc_url) em todo HTML gerado dinamicamente.
• Tokens de API (Google Maps, Melhor Envio, Frenet) nunca expostos ao front-end — usados apenas em requisições feitas pelo servidor.
• Upload de anexos do chamado de suporte validado pelo conteúdo real do arquivo (wp_check_filetype_and_ext()), não apenas pelo tipo declarado pelo navegador.
• Nenhum script de terceiros carregado por CDN externo — bibliotecas empacotadas localmente (ver “Bibliotecas de Terceiros Empacotadas” abaixo).
• Nenhum dado pessoal do cliente é repassado a servidores externos além das APIs de CEP/frete estritamente necessárias para o cálculo em curso.

Como usar cada aba do painel

Geral & Busca de CEP — liga/desliga o autocompletar de Cobrança e Entrega, escolhe as APIs de CEP ativas e a ordem de prioridade, mapeia o campo de bairro, ativa o foco automático e define a duração do cache.

Frete na Página de Produto / Carrinho / Checkout — ativa cada simulador, escolhe a posição na página e o título da caixa.

Checkout (também no menu lateral) — reúne o simulador de frete do checkout e o Checkout Moderno: ativa o checkout em 3 etapas e o modo compacto, define os títulos das etapas, o texto do botão, a cor de destaque, as mensagens por forma de pagamento (Pix, cartão, boleto) e o destaque do Pix na página de pedido recebido. Funciona com o checkout clássico; com Checkout em Blocos, Fluid Checkout ou CartFlows ele se desativa sozinho (a aba mostra o motivo).

Growth Marketing — ativa a Previsão de Entrega e a Barra de Progresso de Frete Grátis Dinâmico.

Retirada em Loja — chave de API do Google Maps, cadastro de lojas físicas e configuração do Frete por Km.

Integrações de Frete — testa a conexão com as APIs do Melhor Envio e da Frenet.

Tabela de Frete (em WooCommerce > Configurações > Entrega) — abra ou crie uma Zona de Entrega, clique em “Adicionar método de entrega” e escolha “Tabela de Frete — AutoCEP”. Em “Editar”, cole a planilha ou use “Importar arquivo CSV” e salve. Com “Limitar a zona” ligado, a zona passa a atender só as faixas de CEP da tabela e é colocada acima de zonas mais gerais (ex.: Brasil inteiro). Dica: use uma zona só para a tabela.

Mensagens & UX — edita todos os textos exibidos ao cliente e o bloqueio do botão “Finalizar Compra” durante requisições.

Aparência — personaliza cores, arredondamento, tipografia e espaçamento das caixas de frete.

Analytics — dashboard de inteligência de frete.

Suporte Técnico — abre chamados com anexos, acompanha “Meus Chamados” e traz os contatos diretos da equipe TESW.

Diagnóstico e Logs — status em tempo real das APIs de CEP e 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 — o item ainda não está no carrinho, então não há “seleção” possível ali.
• No carrinho e no checkout: cada opção simulada tem um botão “Selecionar” que 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.

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.

Compatibility

• WooCommerce: 4.0 ou superior, testado até a 11.1. Compatível com o armazenamento de pedidos de alto desempenho (HPOS).
• Checkouts compatíveis: checkout clássico e Checkout em Blocos do WooCommerce, Fluid Checkout, CartFlows e montagens em etapas via Elementor Pro. O Checkout Moderno (multietapas) do AutoCEP funciona sobre o checkout clássico.
• Integradores de frete: Melhor Envio, Frenet, Correios, Frete Fixo, Frete Grátis, Retirada Local e a Tabela de Frete do AutoCEP.
• Dispositivos: desktop, Android, iPhone e iPad (sem zoom automático no campo de CEP).
• APIs de CEP: ViaCEP, BrasilAPI e ApiCEP.
• APIs de rota: Google Maps Distance Matrix API (opcional, usada apenas nos módulos de Frete por Km e …