Pular para o conteúdo
Cota Frete Manual
16.3

O checkout não mostra o Cota Frete

Planos:BasicBusinessCheckout requer CCS

No checkout, quem pede a cotação não é o widget: é a própria Shopify. Ela só consulta um app se três condições forem verdadeiras ao mesmo tempo:

  1. A loja tem o Carrier Calculated Shipping (CCS, “cotação calculada pela transportadora”) ativo.
  2. O perfil de frete da Shopify tem o Cota Frete como forma de calcular a tarifa.
  3. O plano do Cota Frete inclui a cotação no checkout.

Mesmo com as três, a Shopify ainda filtra a resposta: ela só mostra um frete cujo nome está cadastrado na lista do Cota Frete no perfil de entrega. Por isso este problema quase nunca está na transportadora.

Antes de tudo#

Rode o Simular frete com o produto e o CEP. Olhe a coluna No checkout:

  • “Seu plano não cobre as cotações no checkout.”: é a causa 1.
  • “Nenhuma cotação retornada.”: o app não tem o que devolver para aquele CEP. Veja as causas 4, 6 e 7.
  • Cotações aparecem, mas o checkout real não mostra: o problema está na Shopify. Veja as causas 2, 3 e 5.

1. O plano é o Widget#

O Widget cobre a cotação antes do checkout: página do produto, carrinho e gaveta. A cotação no checkout começa no Basic.

Como resolver. Se a loja tem CCS e você quer o frete no checkout, mude de plano na tela Planos. Veja Escolher o plano.

2. A loja não tem o CCS ativo#

O CCS é um recurso da Shopify, não do Cota Frete, e depende do plano da loja na Shopify. No plano Basic da Shopify, não existe. No Grow mensal, é um adicional pedido à Shopify. Quando falta, a tela Transportadoras do app mostra o aviso Ative o CCS para cotar frete no checkout, com o botão Abrir guia de ativação do CCS.

Como resolver. Peça a ativação à Shopify ou mude de plano na Shopify. Veja Ativar o CCS na Shopify e a tabela em CCS por plano da Shopify.

3. O Cota Frete não está no perfil de frete da Shopify#

Com o CCS ativo, o Cota Frete aparece como opção de tarifa nos perfis de frete. Em algumas lojas ele entra sozinho; em outras, precisa ser adicionado.

Como conferir. No admin da Shopify, abra Configurações → Envio e entrega e o perfil de frete. Nas tarifas, o Cota Frete deve aparecer como tarifa calculada pelo app.

Como resolver. Adicione a tarifa calculada pelo Cota Frete em cada local de processamento e salve. Detalhes em Conferir o Cota Frete na Shopify.

Se o perfil também tem tarifas fixas (um “Frete fixo”, por exemplo), elas continuam aparecendo ao lado das do Cota Frete. Remova as que não quer oferecer.

4. “Exibir cotações no checkout” está desligado#

Em TransportadorasGeral, a opção Exibir cotações no checkout liga as cotações das transportadoras, dos gateways e das entregas locais no checkout. Desligada, o app cota no widget e não no checkout.

Como resolver. Ligue a opção e salve.

5. O nome do frete muda a cada cotação#

A Shopify esconde no checkout o frete cujo nome não está cadastrado na lista do Cota Frete no perfil de entrega. O app mantém essa lista sozinho, inclusive quando uma regra de renomear ou agrupar muda o nome. O que quebra a lista é um nome que muda a cada cotação.

Isso acontece quando o card Prazo no checkout, em TransportadorasGeral, está com Nome do Serviço + alguma coisa (dias úteis ou data) no campo do nome. O próprio app avisa: “Com um complemento, o nome do frete muda a cada cotação.”.

Como resolver. Volte o campo para Nome do Serviço e coloque o prazo nas linhas de descrição, logo abaixo, que não mexem no nome. Veja Prazo no checkout e data prevista.

6. A transportadora está fora do ar ou recusou a credencial#

O app testa as transportadoras do checkout 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”. Enquanto isso, as opções dela não aparecem no checkout.

O aviso diz qual é o caso:

  • “A transportadora recusou as credenciais desta loja”: o problema é a sua conta ou o seu contrato. Confira usuário, senha, token e contrato na aba e salve de novo. Veja Erro ao conectar uma transportadora.
  • “Detectamos a falha…”: é instabilidade da transportadora. As cotações voltam sozinhas, e o aviso some quando ela responde de novo.

Para ser avisado por e-mail, ligue Receber avisos de instabilidade por e-mail em TransportadorasGeral. Veja Aba Geral.

7. Uma regra ou o carrinho mudam a cotação#

O checkout cota o carrinho inteiro, com o peso somado e o valor do pedido. Uma regra de bloquear ou de limitar com condição de valor ou de peso pode valer no carrinho e não no produto sozinho. A opção Bloquear cotações para CEPs inválidos também age só no checkout.

Se o checkout mostra menos opções que o widget, mas mostra alguma, veja Por que o checkout mostra fretes diferentes do widget.

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