# Capítulo 16: Solução de problemas

> Quando algo não aparece ou não bate: o que conferir, na ordem, para cada sintoma comum.

Fonte: https://www.cotafrete.app/manual/solucao-de-problemas/

Cada página deste capítulo parte de um sintoma: a cotação que não aparece, o checkout sem o Cota Frete, o valor que não bate. Para cada sintoma, as causas estão em ordem, da mais provável para a menos provável, cada uma com **como conferir** e **como resolver**.

A ordem importa. A maior parte dos casos que chegam ao atendimento se resolve nas duas primeiras causas da lista. Vale conferir de cima para baixo antes de pular para a explicação mais complicada.

## Antes de tudo: rode o Simular frete

O **Início → Simular frete** é a primeira ferramenta para qualquer problema de cotação. Você escolhe um produto, a quantidade, o valor do pedido e um CEP, e o app mostra, lado a lado, o que o widget da loja e o checkout devolvem. A simulação roda o mesmo código da loja, com as regras, os bloqueios e os descontos aplicados.

O resultado já separa o problema em dois:

- **O simulador mostra a cotação, mas a loja não.** A configuração do app está certa. O problema está no tema (o bloco ou o App Embed) ou no checkout da Shopify.
- **O simulador também não mostra.** O problema está na configuração do app: a transportadora, o gateway, o peso do produto ou uma regra.

Como usar o simulador em detalhe: [Simular frete](https://www.cotafrete.app/manual/inicio/simular-frete/).

## Neste capítulo

- [16.1 A cotação não aparece na página do produto](https://www.cotafrete.app/manual/solucao-de-problemas/cotacao-nao-aparece-produto/index.md): 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.
- [16.2 A cotação não aparece na gaveta do carrinho](https://www.cotafrete.app/manual/solucao-de-problemas/cotacao-nao-aparece-gaveta/index.md): A página do produto mostra o frete, mas a gaveta lateral do carrinho não: App Embed desligado, seletor do carrinho errado ou tema muito customizado.
- [16.3 O checkout não mostra o Cota Frete](https://www.cotafrete.app/manual/solucao-de-problemas/checkout-sem-cota-frete/index.md): A página do produto cota, mas o checkout mostra outras tarifas, menos opções ou nenhuma: plano, CCS, perfil de frete da Shopify, nome do frete e transportadora fora do ar.
- [16.4 Uma transportadora não cota para um CEP](https://www.cotafrete.app/manual/solucao-de-problemas/transportadora-nao-cota-cep/index.md): As outras opções aparecem, mas uma transportadora some para certos CEPs: área do contrato, regras de frete, limites de peso, gateway e origem.
- [16.5 O gateway não devolve serviços](https://www.cotafrete.app/manual/solucao-de-problemas/gateway-sem-servicos/index.md): O Melhor Envio, a Frenet, a Intelipost, a SmartEnvios ou a SuperFrete estão conectados, mas a lista de serviços vem vazia ou nenhum serviço cota na loja.
- [16.6 O valor do frete está diferente do esperado](https://www.cotafrete.app/manual/solucao-de-problemas/valor-diferente/index.md): O frete na loja não bate com a tabela da transportadora, com o painel do gateway ou com o que foi cobrado na postagem: contrato, pacote, acréscimos, descontos e agrupamento.
- [16.7 Erro ao conectar uma transportadora](https://www.cotafrete.app/manual/solucao-de-problemas/erro-ao-conectar/index.md): A aba da transportadora ou o cartão do gateway acusa erro ao salvar: os avisos que o app mostra e as causas por tipo, do espaço a mais ao contrato sem API habilitada.