# 16.1 A cotação não aparece na página do produto

> O cliente abre o produto e não vê o campo de CEP, ou digita o CEP e nenhuma opção de frete aparece: o que conferir, na ordem.

Fonte: https://www.cotafrete.app/manual/solucao-de-problemas/cotacao-nao-aparece-produto/
Planos: Widget, Basic, Business
Atualizado em 25/10/2026

---

Há dois sintomas diferentes que parecem o mesmo problema:

- **O campo de CEP não aparece.** O widget não está no tema, ou não achou onde entrar. É um problema de instalação.
- **O campo aparece, mas nenhuma opção de frete volta.** O widget está no tema, mas o app não tem o que cotar para aquele produto e aquele CEP. É um problema de configuração.

Comece descobrindo qual dos dois é o seu caso.

## Antes de tudo

Rode o [Simular frete](https://www.cotafrete.app/manual/inicio/simular-frete/) com o mesmo produto e o mesmo CEP. Se a coluna **No widget da loja** mostra cotações, a configuração do app está certa e o problema é a instalação no tema (causas 1 e 2). Se mostra "Nenhuma cotação retornada.", pule para a causa 3.

Se o simulador não abre e a tela Início mostra "Complete as configurações para liberar a simulação.", falta o básico: o CEP de origem em Transportadoras → Geral e ao menos uma transportadora ou gateway ativo. Comece pelo [guia de configuração](https://www.cotafrete.app/manual/primeiros-passos/guia-de-configuracao/).

## 1. O CotaFrete não está ativo no tema

O widget só aparece na loja depois que a extensão do CotaFrete é ativada no editor de temas da Shopify. Há duas formas de ela entrar na página do produto:

- o **App Embed** "CotaFrete (automático)", ligado em **Incorporações de app**, que insere o widget sozinho no lugar definido pelo seletor (causa 2);
- o bloco de app **Frete no produto**, que você posiciona à mão no template do produto.

**Como conferir.** Em **Widgets da loja → Widget de cotação**, o aviso **Ative o CotaFrete no tema** tem o botão **Ativar no tema**, que abre o editor já no lugar certo. No editor, confira se a chave do "CotaFrete (automático)" está ligada, ou se o bloco "Frete no produto" está no template **Produto padrão**.

**Como resolver.** Ative e clique em **Salvar** no editor de temas. Dois detalhes que enganam:

- **Outro template.** Se você usa o bloco e o produto está num template alternativo, o bloco precisa estar nesse template também.
- **Outro tema.** A ativação vale para o tema em que foi feita. Se você publicou outro tema, ative de novo.

O passo a passo está em [Widget na página do produto](https://www.cotafrete.app/manual/widgets-da-loja/pagina-do-produto/).

## 2. O seletor da página do produto não existe no seu tema

Com o App Embed, o widget entra ao lado do elemento indicado em **Seletor de página de produto**, na seção **Posicionamento** de **Widgets da loja → Widget de cotação**. O padrão serve para o tema Dawn e derivados. Se o seu tema dá outro nome ao elemento, o widget não acha onde entrar e não aparece.

**Como resolver.** Clique em **Escolher posição no tema** e aponte o lugar na própria página do produto, ou informe a classe certa no campo e salve. Veja [Personalizar o widget](https://www.cotafrete.app/manual/widgets-da-loja/personalizar-o-widget/).

## 3. Nenhum serviço ativo para cotar

O widget só mostra o que alguma origem de cotação devolve. Se a transportadora está inativa ou nenhum serviço está marcado, não há o que mostrar.

**Como conferir.** Em **Transportadoras**, veja se ao menos uma aba está **Ativo**, com serviços marcados em **Serviços do contrato**. O menu lateral da tela mostra quantos serviços cada uma tem ativos. Se você cota por um gateway, confira o mesmo em **Gateways de frete**.

**Como resolver.** Ative a transportadora ou o gateway, marque os serviços e salve. O aviso "Selecione pelo menos um serviço para realizar cotações corretamente." aparece quando nenhum está marcado.

## 4. O peso do produto atrapalha

A transportadora cota pelo peso. Um produto sem peso na Shopify entra na cotação com o **Peso padrão por item** de **Transportadoras → Geral**. Além disso, cada gateway tem **Peso mínimo para ativar frete** e **Peso máximo para ativar frete**: fora dessa faixa, ele não cota.

**Como conferir.** Abra o produto no admin da Shopify e confira o peso de cada variante. No cartão do gateway, veja a faixa de peso.

**Como resolver.** Cadastre o peso de todas as variantes e ajuste a faixa do gateway, se ela estiver estreita demais. Veja [Peso dos produtos](https://www.cotafrete.app/manual/produtos-e-caixas/peso-dos-produtos/).

## 5. O CEP está fora da área atendida

Nem toda transportadora atende todo CEP. A R3 Express cota só para a área do seu contrato. A Lalamove cota só na região metropolitana da coleta. Um serviço de entrega local só aparece dentro da faixa de CEP que você definiu.

**Como conferir.** Repita o teste com um CEP da sua cidade e com um de outro estado. Se só um deles mostra cotação, é cobertura. Veja [Uma transportadora não cota para um CEP](https://www.cotafrete.app/manual/solucao-de-problemas/transportadora-nao-cota-cep/).

**Como resolver.** Mantenha ao menos uma transportadora de cobertura nacional ativa, como os Correios, para todo CEP receber alguma opção.

## 6. Uma regra de frete tira as opções

As regras de frete valem para o widget também. Uma regra de **bloquear** pode cobrir o CEP, o estado, a faixa de valor, a faixa de peso ou o período do teste. Uma regra de **limitar** reduz o número de opções.

**Como conferir.** Em **Regras de frete**, filtre por **Ativas** e leia a coluna da regra de cada linha. O Simular frete já mostra o resultado com as regras aplicadas.

**Como resolver.** Ajuste ou desative a regra. Veja [Bloquear](https://www.cotafrete.app/manual/regras-de-frete/bloquear/) e [Limitar](https://www.cotafrete.app/manual/regras-de-frete/limitar/).

## 7. A cotação sai da origem do perfil de entrega

Com a **Origem da cotação** pelos perfis de entrega da Shopify (plano Business), o widget cota a partir da origem do perfil do produto e só com os serviços que participam daquele perfil.

**Como conferir.** Em **Transportadoras → Geral**, veja o que está escolhido em **Origem da cotação**. Se for o perfil de entrega, confira na Shopify em que perfil o produto está.

**Como resolver.** Veja [Cotação por perfis de entrega](https://www.cotafrete.app/manual/multiplas-origens/perfis-de-entrega/).

## 8. A transportadora parou de responder

Credencial trocada no painel da transportadora, autorização do Melhor Envio expirada ou a API da transportadora fora do ar: a origem para de cotar sem nenhuma mudança no tema.

**Como conferir.** Abra a aba da transportadora ou o cartão do gateway. O aviso **Erro ao validar credenciais** indica credencial recusada. Nos planos com checkout, o app testa as transportadoras a cada 5 minutos: quando uma para de cotar, a tela Início mostra um aviso, e a aba dela traz "(nome da transportadora) está sem retornar cotações", com o motivo.

**Como resolver.** Veja [Erro ao conectar uma transportadora](https://www.cotafrete.app/manual/solucao-de-problemas/erro-ao-conectar/).
