Pular para o conteúdo
Cota Frete Manual
8.7

Mensagens do widget

Planos:WidgetBasicBusinessNo app:Widgets da lojaWidget de cotação

Nem toda consulta de frete termina com uma lista de opções. Às vezes o CEP foi digitado errado. Às vezes nenhuma opção sobra para aquele destino. O que o cliente lê nesse momento decide se ele vai embora sem entender ou se sabe o que fazer em seguida.

As mensagens#

O widget tem três mensagens, com texto fixo:

MensagemQuando aparece
“Por favor, insira um CEP válido.”O que foi digitado não tem o formato de um CEP (8 dígitos)
“CEP de destino inexistente.”A consulta terminou sem nenhuma opção de frete para o CEP
“Erro ao consultar o frete. Tente novamente.”A consulta falhou no caminho (rede, tempo esgotado)

Os textos não são editáveis na tela Widgets da loja. Dá para mudar a aparência delas pelo CSS personalizado, com a classe .cotafrete-error (veja Personalizar o widget).

“CEP de destino inexistente” nem sempre quer dizer isso#

A segunda mensagem aparece sempre que a lista volta vazia, por qualquer motivo:

  • o CEP realmente não existe;
  • uma regra de bloqueio tirou todas as opções daquele destino;
  • nenhuma transportadora ativa atende aquele CEP, ou o peso do pedido passou do limite de todas;
  • nenhum serviço do Cota Frete está ligado no perfil de entrega da Shopify em que o produto está.

Por isso, quando um cliente reclama dessa mensagem com um CEP válido, a investigação começa pela configuração, não pelo CEP. O Simular frete mostra, para o produto e o CEP do cliente, o que cada ponto da loja devolve.

Para o cliente não ficar sem saída#

Se uma região aparece muito sem frete, a melhor resposta é ter uma opção, não um texto melhor. Algumas saídas:

  • manter uma transportadora que atenda a faixa, por exemplo os Correios, que chegam a CEPs onde as transportadoras privadas não chegam;
  • criar um serviço de Fretes Próprios, como retirada na loja, para a região;
  • revisar as regras de bloqueio que cobrem aquele CEP.

Se a loja não atende uma região de propósito, diga isso perto do widget, no texto da página do produto ou nas políticas de entrega, para o cliente não interpretar a mensagem como defeito.

No checkout#

No checkout, quem controla a tela é a Shopify. Quando nenhuma opção de frete existe para um endereço, o checkout mostra o aviso padrão dela, sem texto do app.

Veja também Uma transportadora não cota para um CEP.

Atualizado em 25/10/2026 Algo desatualizado nesta página? Avise a equipe