A cotação não aparece na página do produto
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 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.
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 lojaWidget 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.
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 lojaWidget 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.
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 TransportadorasGeral. 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.
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.
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 e 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 TransportadorasGeral, 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.
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.