AutoCEP vs Payment and Shipping Method Checkout Fee for WooCommerce

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 Faça o upload da pasta autocep para /wp-content/plugins/ (ou envie o .zip diretamente em Plugins > Adicionar Novo > Enviar Plugin). Ative o plugin no menu Plugins do WordPress. 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: Vá em Produtos, abra o produto testado e confira a aba Entrega — preencha peso e, se possível, dimensões (comprimento, largura, altura). Repita a simulação de frete. 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/

This plugin lets you attach an extra fee — either a percentage of the cart subtotal or a fixed amount — to any WooCommerce payment gateway or shipping method. Configuration lives under WooCommerce → Settings → Checkout Fee. Typical use cases: Pass card-processing surcharges to customers paying with specific gateways. Add a handling fee for Cash on Delivery. Add a packaging/insurance fee for express shipping methods. Features: Per-method configuration — every payment gateway and shipping method has its own settings. Choose between a percentage of cart subtotal or a fixed amount. Optional taxable flag so the fee can be included in tax calculations when required. Customisable fee label shown to the customer. Works with the classic checkout and the block-based Cart & Checkout. Declares compatibility with WooCommerce High-Performance Order Storage (HPOS).