AutoCEP

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 — 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 e sem recursos limitados atrás de upgrade.

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

Assista no YouTube

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: 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 plugin não estima nem usa tabela própria — ele lê as Zonas de Entrega reais do seu WooCommerce. 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.
• 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 padrão 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), 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.
• 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.
• 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.

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.

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

• Checkouts compatíveis: checkout padrão do WooCommerce, Fluid Checkout, CartFlows e montagens em etapas via Elementor Pro.
• Integradores de frete: Melhor Envio, Frenet, Correios, Frete Fixo, Frete Grátis e Retirada Local.
• 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 Retirada por Proximidade).

Documentação de Terceiros

Este plugin pode consultar as seguintes APIs de CEP, conforme configuração:
* ViaCEP
* BrasilAPI
* ApiCEP

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).

Bibliotecas de Terceiros Empacotadas

• Chart.js 4.4.0 (licença MIT) — usado apenas nos gráficos da aba AutoCEP > Analytics, empacotado localmente em assets/js/vendor/ (nunca carregado de um CDN externo).

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.
* Abra um chamado direto pela aba “Suporte Técnico” do painel.

Desenvolvedores & Créditos

O AutoCEP é mantido pela TESW — Tecnologia em Soluções Web, em parceria estratégica com a Ritmo Digital.

Wanderson Cesar
* Desenvolvedor, Fundador da TESW e Criador do AutoCEP.
* Versão 2.0 (reformulação completa do plugin) e todas as versões seguintes.
* Perfil WordPress.org: profiles.wordpress.org/wanderson100
* LinkedIn: linkedin.com/in/wanderson-cesar-2710a621b

Alfonso Fontenla Neto
* Diretor Executivo da TESW e CEO da Ritmo Digital.
* LinkedIn: linkedin.com/in/alfonso-fontenla-neto

Contribuição pontual na versão 1.5: Samuel Canale.

Páginas Oficiais

• Plugins TESW
• Site TESW

Suporte

• E-mail: teswinfor@gmail.com
• WhatsApp: +55 (83) 99407-5812
• Ou direto pela aba AutoCEP > Suporte Técnico do painel, que já abre com número de chamado e contexto do site preenchidos.

Licença

GPLv2 ou posterior.