AutoCEP — Documentação Completa

O AutoCEP resolve dois problemas clássicos de qualquer loja WooCommerce: preencher o endereço do cliente 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.

O comportamento clássico (autocompletar endereço no checkout) continua ativo por padrão assim que o plugin é instalado, sem nenhuma configuração necessária, tanto no checkout clássico quanto no Checkout em Blocos do WooCommerce. Todo o restante — simuladores de frete, previsão de entrega, barra de frete grátis, retirada em loja, frete por Km, tabela de frete própria, testes de integração e dashboard de inteligência de frete — é opcional e fica disponível no painel AutoCEP do WordPress ou nas Zonas de Entrega do WooCommerce.

Novidades da versão 2.48

• Funil do Checkout no Analytics — taxa de conversão, desistência por etapa, pagamento, aparelho e campos com mais erros (seção 12).
• Checkout Moderno em 3 etapas — Identificação, Entrega e Pagamento, com resumo fixo, modo compacto e layout por forma de pagamento (seção 5).
• Tabela de Frete por CEP e Peso — planilha própria do Excel/Google Planilhas ou CSV, com várias opções por CEP, prazo e limitação automática da Zona de Entrega (seção 8).
• Autocompletar no Checkout em Blocos — o novo checkout padrão do WooCommerce (seção 4).
• Compatível com HPOS e WooCommerce 11 — fim do aviso "1 plugin incompatível detectado" (seção 18).
• Mais rápido quando uma API cai — pausa automática de APIs lentas ou fora do ar (seções 4 e 17).
• Sem zoom no iPhone/iPad ao tocar no campo de CEP (seção 5).
• Correções — títulos dos métodos de envio do AutoCEP, "CEP não encontrado" indevido e consulta à ApiCEP.

1. Envie a pasta autocep para /assets/p/, ou faça upload do .zip diretamente em Plugins > Adicionar Novo > Enviar Plugin.
2. Ative o plugin no menu Plugins.
3. Acesse o menu AutoCEP no painel — o autocompletar de CEP no checkout já estará funcionando; as demais abas permitem ativar o que fizer sentido para a loja.

A partir da v2.12.0, o painel administrativo adota uma identidade visual com mais tons de azul, reduzindo o uso de amarelo/branco predominante das versões anteriores:

• Ícone do menu lateral: mapa dobrado com um pin de localização em destaque, exibido imediatamente à frente do texto "AutoCEP".
• Badge "+" ao lado do nome do menu: gradiente azul.
• Cabeçalho do painel de configurações: faixa com gradiente azul no topo de todas as telas do AutoCEP.
• Ícone da aba Suporte Técnico: ícone de headset de atendimento.

Controla o autocompletar de endereço e a busca de CEP:

• Liga/desliga o autocompletar de Cobrança e Entrega separadamente.
• Cascata de três APIs — ViaCEP → BrasilAPI → ApiCEP — com prioridade configurável; se uma falhar ou expirar o tempo, a próxima é consultada automaticamente.
• Botão de teste de velocidade/status das três APIs, direto no painel.
• Detecção automática de campo de bairro (tenta neighborhood, bairro, district antes de usar o campo configurado manualmente).
• Foco automático no campo "Número" após o preenchimento do endereço.
• Cache de CEPs (duração configurável em dias) e cache de cotações de frete (duração em horas), com botão de limpeza manual. CEPs inexistentes ficam memorizados por 6 horas, sem novas consultas às APIs.
• Pausa automática de API lenta (v2.48): se uma API de CEP não responder (queda ou lentidão), ela é pulada por 5 minutos e a próxima da cascata é usada direto — só o primeiro cliente sente a demora.
• Tempo máximo de espera por API: 5 segundos.

Sugestões de Endereço ao Digitar NOVO na v2.48

Enquanto o cliente digita no campo Endereço, aparece uma lista de ruas reais. Ao escolher, o AutoCEP preenche rua, bairro, cidade, estado e o CEP — ótimo para quem não sabe o próprio CEP. Exemplo: "Av Paulista 1000" mostra "Avenida Paulista (de 611 a 1045 - lado ímpar) — Bela Vista, São Paulo/SP · CEP 01311-100".

• ViaCEP (grátis, padrão): busca na base dos Correios, depois que o cliente informa a cidade e o estado (sem eles, a lista mostra uma dica).
• Google Maps (opcional): com a chave de API da aba Retirada em Loja e a "Places API (New)" ativada, as sugestões funcionam sem precisar da cidade. A consulta passa pelo servidor — a chave nunca aparece para o cliente. Uso cobrado pelo Google.
• Entende abreviações (Av, R., Al., Tv., Dr., Prof., Gal., Sta.…), corrige o tipo digitado errado ("Rua Paulista" encontra a Avenida Paulista), mostra o trecho de numeração de ruas longas, ignora CEPs de grandes usuários e caixas postais e, em cidades de CEP único, sugere o CEP geral mantendo a rua digitada.
• Cidades de CEP único (muitas cidades pequenas não têm ruas na base dos Correios, só um CEP geral): as ruas vêm do OpenStreetMap (serviço Photon, gratuito), e o CEP preenchido é sempre o CEP geral oficial dos Correios.
• Funciona com o teclado (setas, Enter, Esc) e com toque, no checkout clássico e no Checkout Moderno. No campo de rua, a lista do AutoCEP substitui a do navegador.
• Opções em Frete e Busca de CEP > Sugestões de Endereço ao Digitar: ligar/desligar e escolher a fonte (Automático, só ViaCEP ou só Google).

Sem "carregando" a cada letra NOVO na v2.48

O WooCommerce recalcula frete e totais (e mostra o ícone de carregamento no resumo) a cada pausa na digitação de qualquer campo de endereço. O AutoCEP evita isso nos campos que não mudam o frete — rua, número, complemento e bairro. CEP, cidade, estado e país continuam recalculando normalmente, assim como o preenchimento automático por CEP.

Autocompletar no Checkout em Blocos NOVO na v2.48

O Checkout em Blocos (padrão nas instalações novas do WooCommerce) é montado de forma diferente do checkout clássico, e o preenchimento automático do endereço não funcionava nele. A partir da v2.48, o AutoCEP detecta esse checkout e preenche rua, bairro, cidade e estado assim que o cliente termina de digitar o CEP. O frete é recalculado automaticamente em seguida.

• Quando a cobrança usa o mesmo endereço da entrega (padrão), o CEP é buscado uma única vez.
• O Checkout em Blocos não tem campo de Bairro: o bairro é colocado no campo Complemento, sem apagar o que o cliente já tiver digitado ali.
• Se o CEP não tiver rua cadastrada (comum em cidades pequenas), cidade e estado são preenchidos e o cliente é avisado para digitar a rua.
• Se o cliente já tiver um endereço salvo, nada é sobrescrito ao abrir o checkout; o preenchimento acontece quando o CEP é alterado.

Três caixas de simulação de frete independentes, cada uma com posição e título configuráveis, todas consultando as Zonas de Entrega do WooCommerce em tempo real:

O CEP e o método enviados ao clicar em "Selecionar" são sempre revalidados no servidor no momento da seleção — o plugin nunca aplica cegamente o que o navegador envia.

Celulares e tablets (iPhone/iPad) NOVO na v2.48

O Safari do iPhone/iPad amplia a página automaticamente ao tocar em campos com letra menor que 16px, o que desorientava o cliente (especialmente o público 45+). Em telas de toque, o campo de CEP agora usa fonte de 16px, e o campo e o botão "Calcular" ficam um pouco maiores para facilitar o toque. No computador continua valendo o tamanho de fonte configurado na aba Aparência. O zoom manual da página continua disponível. O campo também passou a sugerir o CEP já salvo no aparelho do cliente.

Checkout Moderno (Multietapas) NOVO na v2.48

Na aba AutoCEP > Checkout (também no menu lateral do AutoCEP, junto com o simulador de frete do checkout), o checkout clássico do WooCommerce pode ser dividido em 3 etapas, com foco em conversão:

• Resumo do pedido sempre visível ao lado (computador) ou recolhível com o total no topo (celular).
• Validação a cada etapa: campos obrigatórios, e-mail, telefone com DDD, CEP com 8 dígitos e forma de entrega escolhida — com a mensagem embaixo do campo. Se o WooCommerce recusar o pedido ao finalizar, o cliente volta automaticamente para a etapa do campo com erro.
• Modo Compacto: empresa, complemento (quando não é o campo do bairro) e observações ficam atrás de links "+ adicionar", deixando as etapas mais curtas.
• Layout por forma de pagamento: o tipo de cada gateway (Pix, cartão ou boleto) é detectado automaticamente pelo nome — Mercado Pago, Pagar.me, Asaas, PagSeguro, Cielo, Efí e outros — e uma mensagem configurável aparece conforme a escolha (ex.: "O QR Code aparece na próxima tela").
• Pix no pedido recebido: o QR Code e o código copia e cola gerados pelo gateway ganham destaque e um botão "Copiar código Pix".
• Personalizável: títulos das etapas, texto do botão "Continuar" e cor de destaque.
• Tamanho do checkout (aba Checkout > Tamanho do Checkout): largura do formulário (padrão 580px), largura do resumo do pedido (340px) e altura dos campos (38px). As larguras valem no computador (a partir de 992px); no celular o checkout ocupa a tela toda, com campos de 16px de fonte para o iPhone não dar zoom.
• Conta do cliente (aba Checkout > Conta do Cliente): Seguir o WooCommerce (padrão), Opcional (recomendado — muitos clientes desistem quando são obrigados a criar senha), Obrigatória ou Sem conta (compra como visitante). Vale só com o Checkout Moderno ligado, sem alterar as configurações do WooCommerce.
• Aviso de criação de conta: na etapa Identificação, quem não tem conta vê por que e como a conta é criada, com o e-mail que digitou ("vamos criar sua conta com o e-mail ana@gmail.com"). O texto se adapta à configuração (obrigatória, senha automática ou opcional) e pode ser personalizado com {email}.
• Login em um só lugar: o formulário "Já é cliente? Clique aqui para entrar" do topo da página é substituído pelo link "Já tem conta? Entrar" da etapa Identificação, que abre e-mail e senha ali mesmo (o campo "Criar senha" some enquanto o login está aberto). Quem faz o login continua sendo o WooCommerce.
• Entregar em um endereço diferente: começa desmarcado (o cliente marca se quiser); opção para seguir a configuração do WooCommerce. Os campos de entrega têm o mesmo tamanho e a mesma grade dos de cobrança.
• Cupom no resumo: o cupom de desconto fica dentro do resumo do pedido ("Tem um cupom de desconto?"), aplicado pelo próprio WooCommerce.
• Simulador de frete integrado: a caixa "Simular Frete" do AutoCEP fica no topo da etapa Entrega (ou oculta, pela opção "Simulador de Frete"), já com o CEP do cliente; e as formas de entrega são recalculadas assim que o CEP fica completo, com o aviso "Calculando o frete...".
• Gerenciador de campos (seção "Campos do Checkout" da aba): esconda empresa, complemento, sobrenome, telefone ou observações; torne-os obrigatórios ou opcionais; mude o rótulo. E crie campos extras (texto, texto longo, número, data, lista de opções ou caixa de seleção), escolhendo a etapa (Identificação ou Entrega) e se é obrigatório — o valor fica salvo no pedido e aparece na tela do pedido e nos e-mails.
• Liga/desliga: com "Ativar Checkout Moderno" desmarcado, o AutoCEP não altera nada no checkout (nem layout nem campos) — use assim se a loja já tiver outro checkout personalizado.

Pós-Compra: Status do Pedido e Página de Obrigado NOVO na v2.48

Na aba AutoCEP > Pós-Compra (também no menu lateral), opcional:

• Status do pedido em tempo real: na página de pedido recebido e na página do pedido em Minha Conta, o AutoCEP acompanha o status enquanto o cliente está na tela — por exemplo, pagando o Pix. Quando muda, aparece uma mensagem (aprovado, concluído, em espera, falhou, cancelado, reembolsado), editável no painel com {pedido} e {nome}.
• Página de obrigado: com o pagamento aprovado, o cliente é levado para a página que você escolher (ex.: agradecimento, grupo VIP, área de membros), depois de alguns segundos com a mensagem na tela. Pedidos com Pix ou boleto pendente continuam na página do WooCommerce até o pagamento, para o cliente não perder o QR Code.
• Pedido já pago (ex.: cartão aprovado na hora): também mostra a mensagem e redireciona, uma única vez.
• Seguro e leve: só o dono do pedido consulta o status (pela chave secreta do pedido); a verificação roda apenas nessas páginas, a cada 5 segundos, por até 15 minutos, e pausa com a aba em segundo plano. Compatível com HPOS.

Verificação de campos extras (checkout seguro) NOVO na v2.48

Para que um campo novo nunca quebre o checkout nem saia do padrão do WooCommerce, o AutoCEP verifica cada campo extra em três momentos:

1. Ao salvar: só é gravado o que o WooCommerce aceita. O que não passa fica de fora e o motivo aparece como aviso no topo da página (ex.: O campo extra "Como conheceu" não foi adicionado: informe ao menos uma opção).
2. Na tela do painel: campos já salvos com problema mostram um alerta ⚠ logo abaixo da linha ("Este campo não aparece no checkout: ...").
3. No checkout: mesmo que haja dados antigos ou alterados direto no banco, campo inválido é simplesmente ignorado — a página não quebra.

Pagamento na Entrega NOVO na v2.48

Forma de pagamento própria do AutoCEP para delivery e retirada, em WooCommerce > Configurações > Pagamentos > Pagamento na Entrega — AutoCEP (ou pelo botão na aba Checkout do AutoCEP):

• O cliente escolhe como vai pagar ao receber: Dinheiro, Pix na entrega, Cartão de débito ou crédito na maquininha, Vale-refeição/alimentação — você escolhe quais aceitar.
• No dinheiro: "Troco para quanto?" (o valor precisa ser maior que o total) ou "Não preciso de troco".
• Somente para estes fretes: libere só para Motoboy (Frete por Km), Retirada em Loja ou outros métodos — Correios e transportadoras normalmente não cobram na entrega.
• Status do pedido: Processando (vai direto para separação) ou Aguardando (para confirmar manualmente).
• A forma e o troco ("Dinheiro — troco para R$ 50,00, levar R$ 4,10 de troco") aparecem na tela do pedido, nas notas do pedido, na página de pedido recebido, em Minha Conta e nos e-mails.

Previsão de Entrega (Data Estimada)

Em vez de "Prazo: 5 dias úteis", exibe a data estimada de chegada (ex.: "Chega entre Quarta-feira (25/10) e Sexta-feira (27/10)"). A ordem de prioridade para determinar o prazo é:

1. Prazo informado pela própria transportadora ou método de frete (meta da taxa, quando disponível — Correios, Melhor Envio, Frenet, Tabela de Frete do AutoCEP etc.).
2. Número de dias extraído do próprio texto do rótulo da taxa (ex.: "PAC - até 5 dias úteis").
3. Estimativa padrão configurada nesta aba (mínimo/máximo de dias), se habilitada.

Pode contar apenas dias úteis (pulando sábado/domingo) e usa uma margem configurável para formar o intervalo "chega entre X e Y".

Barra de Progresso de Frete Grátis Dinâmico

Exibida nas caixas de simulação, mostrando quanto falta em R$ para o cliente ganhar frete grátis. O limite é obtido por um valor manual configurado nesta aba ou, com a detecção automática ligada, pelo menor "Valor mínimo do pedido" encontrado entre os métodos "Frete Grátis" configurados nas Zonas de Entrega.

Nunca afirma "você ganhou frete grátis" antes de o cliente simular um CEP real — antes disso, o limite usado é apenas uma estimativa global.

Retirada em Loja por Proximidade

Cadastre lojas/depósitos físicos (nome, CEP, raio de retirada, taxa, instruções). Para cada CEP de cliente, o plugin calcula a distância rodoviária real via Google Distance Matrix API e exibe automaticamente cada loja cujo raio cobre aquele CEP — incluindo lojas de cidades vizinhas. Uma lista de "CEPs Atendidos Manualmente" por loja garante cobertura mesmo quando o Google não geocodifica corretamente um CEP rural/pequeno.

Para que as lojas apareçam como opção de frete, adicione o método "Retirada em Loja por Proximidade — AutoCEP" na Zona de Entrega desejada (WooCommerce > Configurações > Entrega). Na v2.48 foi corrigido o título em branco e a janela de configuração vazia desse método na lista da zona.

A aba inclui dois testes de diagnóstico: status rápido da chave de API (um clique) e teste de distância entre dois CEPs específicos, mostrando o endereço enviado ao Google e o resultado bruto.

Frete por Quilometragem (Km) — Entrega Local/Motoboy

Fórmula:

Valor Final = Taxa Fixa + (Distância em Km × Valor por Km)

respeitando um valor mínimo configurável. Funciona de forma autônoma, sem precisar de Zona de Entrega no WooCommerce — o módulo injeta a opção diretamente nas simulações quando o CEP do cliente está dentro do raio máximo configurado.

Permite que o lojista cadastre a própria planilha de frete — por faixa de CEP e faixa de peso — sem depender de transportadora via API. É um método de envio do WooCommerce, então funciona automaticamente no simulador da página do produto, no carrinho e no checkout (clássico e em blocos).

Onde configurar

1. Acesse WooCommerce > Configurações > Entrega e abra a Zona de Entrega desejada (ex.: "Brasil").
2. Clique em Adicionar método de entrega e escolha "Tabela de Frete — AutoCEP".
3. Clique em Editar no método adicionado. A janela de configuração tem:
   • Nome exibido ao cliente — usado quando a linha da tabela não tem a coluna "nome";
   • Tabela de Frete — caixa de texto com o botão "Importar arquivo CSV";
   • Taxa adicional — valor fixo opcional somado ao frete (ex.: embalagem);
   • Prazo no nome — exibe "(3 dias úteis)" ao lado do nome do frete;
   • Limitar a zona — ativado por padrão: ao salvar, a zona passa a atender só as faixas de CEP da tabela (veja abaixo).
4. Clique em Salvar.

Como enviar a planilha

• Copiar e colar: selecione as linhas no Excel ou Google Planilhas, copie (Ctrl+C) e cole (Ctrl+V) na caixa "Tabela de Frete".
• Arquivo CSV: no Excel, use Arquivo > Salvar como > CSV (separado por ponto e vírgula) e depois clique em "Importar arquivo CSV". O conteúdo é carregado na caixa para conferência antes de salvar.

Limitar a zona automaticamente

Com a opção "Limitar a zona" ativada (padrão), ao salvar a tabela o AutoCEP preenche sozinho o campo "Limitar para CEPs específicos" nas Regiões da zona com as faixas de CEP da planilha. Faixas vizinhas são unidas (ex.: 01000-000 a 05999-999 e 06000-000 a 09999-999 viram uma só). Se a zona não tiver nenhuma região definida, o Brasil é adicionado; se já tiver (ex.: um estado), ela é mantida e apenas os CEPs são atualizados.

• Assim, clientes de CEPs fora da tabela não caem nessa zona e podem ser atendidos por outra zona (ex.: uma zona "Resto do Brasil" com outra transportadora).
• Só em zona exclusiva: as regiões e a ordem só são alteradas quando a Tabela de Frete é o único método ativo da zona. Se a zona tiver outros métodos (ex.: Melhor Envio), nada é alterado e um aviso é exibido ao salvar.
• Desativou ou excluiu a tabela? A zona que ficar sem métodos ativos desce sozinha para o fim da lista, para não bloquear as outras zonas (ex.: o Melhor Envio volta a aparecer). Ao reativar a tabela, a zona sobe de novo.
• Ordem das zonas corrigida sozinha: o WooCommerce usa só a primeira zona da lista que combina com o endereço. Se houver uma zona mais geral acima (ex.: "Brasil" com Melhor Envio), a tabela nunca seria usada — por isso, ao salvar, a zona da tabela é movida para logo acima dessa zona geral. Zonas mais específicas (por CEP ou por estado) continuam acima dela.
• A limitação vale para todos os métodos da zona, não só para a tabela. Se precisar que outros métodos atendam CEPs fora da tabela, desative a opção ou use outra zona.
• Recarregue a página da zona depois de salvar para ver as regiões atualizadas.

Formato das colunas

Separadores aceitos: ponto e vírgula, tabulação (colado do Excel) ou vírgula. Uma linha de cabeçalho é ignorada automaticamente. Exemplo:

cep_inicial;cep_final;peso_min;peso_max;valor;prazo;nome
01000-000;05999-999;0;5;12,90;1;Econômico
01000-000;19999-999;0;5;16,90;2;Econômico
01000-000;19999-999;5;;29,90;2;Econômico
01000-000;19999-999;0;;49,90;1;Expresso

Como o valor é escolhido

1. O plugin pega o CEP de destino do cliente.
2. Soma o peso dos produtos do carrinho (peso × quantidade). Produtos virtuais ou que não precisam de entrega não entram na soma.
3. Percorre a tabela de cima para baixo e, para cada nome de frete, usa a primeira linha em que o CEP e o peso se encaixam. Nomes diferentes viram opções separadas para o cliente escolher.
4. Soma a taxa adicional, se houver.

Situações comuns

Aba com testes de conexão em tempo real para as APIs de transportadoras de terceiros, permitindo confirmar rapidamente se o token está válido e se a API do fornecedor está no ar — sem precisar simular um pedido completo e sem precisar digitar nenhum token: o AutoCEP lê automaticamente a credencial já salva pelo plugin oficial de cada transportadora.

Teste da API do Melhor Envio

O AutoCEP lê diretamente as opções que o próprio plugin oficial do Melhor Envio ("Melhor Envio — Frete Fácil pra Todos") já salva no banco:

• wpmelhorenvio_token_environment — diz se o ambiente ativo é produção ou sandbox.
• wpmelhorenvio_token ou wpmelhorenvio_token_sandbox — o token correspondente ao ambiente ativo.

Basta clicar em "Testar Conexão com o Melhor Envio". O plugin já mostra, acima do botão, qual ambiente foi detectado, e escolhe automaticamente o host de API correto para testar:

Teste da API da Frenet

A Frenet guarda a configuração por Zona de Entrega (não é uma opção global única). O AutoCEP percorre todas as zonas, encontra a instância do método oficial da Frenet já configurada, e lê diretamente dela o token e o CEP de origem. Basta clicar em "Testar Conexão com a Frenet" — o plugin monta uma cotação de teste (CEP de origem detectado → CEP de destino fixo, Av. Paulista/SP) e interpreta a resposta, já que a Frenet costuma responder HTTP 200 mesmo com token inválido — o motivo real vem dentro do corpo da resposta.

Edição de todos os textos exibidos ao cliente (buscando endereço, CEP não encontrado, calculando frete, CEP inválido, erro genérico, textos dos botões de seleção de frete etc.) e o comportamento de bloquear o botão "Finalizar Compra" enquanto uma requisição de CEP/frete está em andamento.

Personalização visual das caixas de frete no front-end: cor de fundo/borda/texto do campo de CEP, cores do botão "Calcular" (normal e hover), cor de fundo/borda da caixa, arredondamento, tamanho de fonte, espaçamento e cores da barra de frete grátis — tudo via seletor de cores nativo do WordPress.

Em celulares e tablets, o campo de CEP usa no mínimo 16px de fonte, independentemente do tamanho configurado, para evitar o zoom automático do iPhone/iPad (veja a seção 5).

Funil do Checkout NOVO na v2.48

Mede o Checkout Moderno do início ao pedido, com o mesmo filtro de período (7/30/90 dias):

• Taxa de conversão e desistência do checkout (pedidos ÷ visitas), receita, ticket médio e tempo médio da entrada no checkout até o pedido.
• Onde os clientes desistem: barras do funil — entraram no checkout → chegaram à Entrega → chegaram ao Pagamento → clicaram em Finalizar → concluíram o pedido —, com quantos desistiram em cada etapa.
• Conversão por forma de pagamento: quem clicou em Finalizar com Pix, cartão ou boleto e quantos pedidos saíram. Conversão baixa costuma indicar pagamento recusado ou erro no gateway.
• Celular x computador: visitas, pedidos e conversão por aparelho.
• Campos com mais erros: o campo em que o cliente travou ao tentar avançar (ou que o WooCommerce recusou). Bons candidatos a ficar opcionais ou ganhar instrução mais clara.

Frete e CEP

Dashboard de Inteligência de Frete, com filtro por período (7/30/90 dias):

• CEPs e regiões (UF) mais pesquisados.
• Frete médio calculado (simulações) vs. efetivamente pago (pedidos concluídos).
• Taxa estimada de desistência relacionada ao frete (sessões que simularam mas não converteram em até 48h).
• Ranking dos métodos de frete mais escolhidos nos pedidos — compatível com o armazenamento de pedidos de alto desempenho (HPOS) do WooCommerce a partir da v2.48.

Nenhum dado pessoal do cliente é armazenado além do CEP/cidade/estado pesquisado e dos valores de frete. A coleta pode ser desativada na aba Geral.

Formulário de abertura de chamados (tipo, título, descrição, até 5 anexos de imagem/PDF), com número sequencial próprio (ex.: AC-000123) exibido em "Meus Chamados", onde o próprio lojista pode marcar como resolvido ou reabrir. Contatos diretos (e-mail e WhatsApp) da equipe TESW já vêm com uma mensagem padrão pronta, identificando o site e a versão do plugin.

Se o envio do e-mail falhar (comum em hospedagem compartilhada sem SMTP configurado), o chamado continua salvo localmente e o painel explica a causa mais provável, com sugestão de correção (ex.: instalar um plugin de SMTP).

Disponível também no submenu e no cabeçalho do painel. Permite avaliar o AutoCEP de 1 a 5 estrelas, com comentário e sugestões de melhoria; a avaliação é salva no site e enviada à equipe TESW. Notas 4 e 5 exibem um convite para repetir a avaliação no WordPress.org. A aba também traz o vídeo de apresentação do plugin (youtu.be/EkEC8CJ_H5c).

Histórico das últimas falhas/timeouts registrados por qualquer API ou método de frete integrado — incluindo quando um método habilitado na Zona de Entrega não retorna taxa (comum quando o produto está sem peso cadastrado, ou a transportadora não atende ao destino).

Pontos de segurança implementados e auditados no plugin:

• Nonces em toda ação AJAX — cada requisição verifica uma nonce própria (check_ajax_referer / wp_verify_nonce) antes de processar qualquer coisa.
• Verificação de capacidade (current_user_can('manage_options')) em todas as ações administrativas; as rotas públicas (busca de CEP, simulação de frete) usam nonce sem exigir capacidade, por serem usadas por visitantes anônimos no checkout.
• Consultas ao banco sempre parametrizadas ($wpdb->prepare) em toda operação com dado variável.
• Escape de saída (esc_html, esc_attr, esc_url) em todo HTML gerado dinamicamente.
• Tabela de Frete sanitizada: o conteúdo colado/importado é sanitizado ao salvar e só pode ser alterado por administradores da loja (tela de Zonas de Entrega do WooCommerce, protegida por nonce e capacidade).
• Tokens de API protegidos: Google Maps, Melhor Envio e Frenet são usados apenas em requisições feitas pelo servidor — nunca expostos ao HTML ou JavaScript do front-end.
• Upload de anexos validado pelo conteúdo real do arquivo com wp_check_filetype_and_ext(), conferindo a extensão e a assinatura binária real contra uma lista permitida (JPG, PNG, GIF, WEBP, PDF).
• JSON dos gráficos de Analytics protegido contra XSS com as flags JSON_HEX_TAG / AMP / APOS / QUOT.
• Nenhuma execução de código dinâmico (sem eval, create_function, ou inclusão de arquivos por caminho vindo do cliente).
• Nenhuma rota REST API registrada — toda comunicação passa por admin-ajax.php, já protegido pelos pontos acima.
• Limite de uso por visitante (v2.48): os endpoints públicos que consultam serviços externos ou gravam no banco têm limite por IP — busca de CEP 120/min, sugestões de endereço 90/min, detalhes do Google 40/min, funil do checkout 120/min e status do pedido 60/min. São valores bem acima do uso humano; impedem que robôs usem a chave de segurança da página para gerar milhares de consultas (inclusive cobradas pelo Google). Ajuste com o filtro autocep_rate_limit (retornar 0 desliga o limite de um grupo).
• Status do pedido sem nonce, por desenho: a página de pedido recebido costuma ficar em cache, e um nonce guardado expiraria. A autorização é a chave secreta do pedido (order key), que só o dono tem; a resposta é só leitura (apenas o status).
• Privacidade nos logs: o CEP dos clientes só vai para o log do servidor (error_log) com o modo de depuração do WordPress ativo.
• Nenhum script de terceiros carregado por CDN externo — o Chart.js é empacotado localmente em assets/js/vendor/.

• Toda chamada externa (ViaCEP, BrasilAPI, ApiCEP, Google Maps, Melhor Envio, Frenet) trata timeout, código HTTP de erro (4xx/5xx) e corpo JSON corrompido/vazio antes de acessar qualquer dado da resposta — nunca gera erro fatal, sempre cai no próximo item da cascata ou numa mensagem amigável.
• Exceções lançadas por plugins de transportadora de terceiros durante o cálculo de frete são capturadas (try/catch) e registradas no log, sem interromper o checkout.
• Quando um método de frete habilitado não retorna taxa, o log de diagnóstico aponta produtos sem peso/dimensão cadastrados como causa provável — comportamento comum de transportadoras via API (Melhor Envio, Frenet) que exigem peso mínimo para cotar; os Correios costumam ser mais tolerantes.
• O cálculo de distância (Retirada em Loja / Frete por Km) tem 3 camadas de fallback: endereço completo → apenas cidade/UF → estimativa por linha reta (Haversine × 1.3).
• A Tabela de Frete não depende de nenhuma API externa: o cálculo é feito inteiramente no servidor da loja, então continua funcionando mesmo com transportadoras fora do ar.

• Armazenamento de pedidos de alto desempenho (HPOS): compatibilidade declarada oficialmente — o aviso "1 plugin incompatível detectado (AutoCEP)" em WooCommerce > Configurações > Avançado > Recursos deixa de aparecer. Pode manter o HPOS ativado, com ou sem o modo de compatibilidade (sincronização).
• Checkouts: checkout clássico do WooCommerce, Checkout em Blocos (compatibilidade declarada), Fluid Checkout, CartFlows, Elementor Pro (checkout em etapas).
• Métodos de frete: Frete Fixo, Frete Grátis, retirada local, Melhor Envio, Frenet, Tabela de Frete do AutoCEP e qualquer outro método registrado como Zona de Entrega do WooCommerce.
• Dispositivos: desktop, Android, iPhone e iPad (sem zoom automático no campo de CEP).

Desenvolvido e mantido pela TESW — Tecnologia e Soluções Web, com desenvolvimento principal de Wanderson Cesar.

• Site institucional: tesw.com.br
• Suporte: aba AutoCEP > Suporte Técnico dentro do painel do WordPress, ou pelos contatos diretos exibidos ali.