O gateway não devolve serviços
Um gateway de frete não tem uma lista fixa de serviços. Ao conectar, o Cota Frete lê da sua conta quais transportadoras e serviços estão contratados lá e mostra exatamente esses. Isso quer dizer que o que aparece no app depende de três coisas: a conexão estar válida, a conta ter serviços contratados e o gateway aceitar cotar a partir da sua origem.
Há dois sintomas, com causas diferentes:
- A lista de serviços do cartão vem vazia. O problema está na conexão ou na conta.
- A lista está cheia, mas nada cota na loja. O problema está no que foi marcado, no peso ou na origem.
Antes de tudo#
Rode o Simular frete com um produto de peso conhecido e um CEP que o gateway atende. Depois cote o mesmo produto e o mesmo CEP direto no painel do gateway. Se o painel do gateway também não cota, a causa está na conta, não no Cota Frete.
A lista de serviços vem vazia#
1. A credencial é inválida ou expirou#
Como conferir. O cartão mostra o aviso Erro ao validar credenciais quando o gateway recusa o token ou a chave. No Melhor Envio, a autorização pode expirar ou ser revogada pelo próprio Melhor Envio: o botão do cartão vira Reconectar com Melhor Envio.
Como resolver.
- Frenet, Intelipost, SmartEnvios e SuperFrete: gere ou copie de novo o token (ou a chave de API) no painel do gateway, cole no cartão inteiro, sem espaços no início ou no fim, e salve.
- Melhor Envio: clique em Reconectar com Melhor Envio e refaça a autorização no site do Melhor Envio.
Passo a passo por gateway: Melhor Envio, Frenet, Intelipost, SmartEnvios, SuperFrete.
2. A conta não tem transportadoras contratadas#
O app mostra o que a conta tem. Uma conta sem nenhuma transportadora habilitada no gateway devolve uma lista vazia.
Como resolver. Habilite as transportadoras no painel do gateway. O app lê a conta de novo quando você salva um token novo e, sozinho, quando você abre a tela Início (no máximo uma vez por dia). Os serviços novos chegam desmarcados: marque os que quer oferecer.
A lista está cheia, mas nada cota#
3. Nenhum serviço está marcado#
É a causa mais comum. Sem nenhum serviço marcado em Serviços do contrato, o gateway não cota, e o cartão avisa “Selecione pelo menos um serviço para realizar cotações corretamente.”.
Como resolver. Marque os serviços que quer oferecer e salve.
4. O CEP do remetente não é o que o gateway espera#
Cada gateway cota a partir do CEP do remetente do próprio cartão. Na SmartEnvios a regra é mais rígida: ela só cota a partir do CEP de origem cadastrado na conta dela. Com outro CEP no cartão, nenhum serviço cota, e a resposta é “Este serviço não atende esta origem”.
Como resolver. Na SmartEnvios, use no cartão exatamente o CEP da conta. Se a loja envia de outro lugar, o ajuste é feito com a SmartEnvios.
5. O peso está fora da faixa do cartão#
O cartão tem Peso mínimo para ativar frete e Peso máximo para ativar frete. Fora da faixa, o gateway não cota. Produto sem peso na Shopify entra com o Peso padrão por item de Transportadoras → Geral.
Como resolver. Ajuste a faixa e confira o peso das variantes. Veja Peso dos produtos.
6. O serviço não atende a rota#
Um serviço pode estar na lista e não cotar para um trecho específico. É o gateway dizendo que aquela transportadora não atende aquele destino. As outras seguem normais.
7. Cota no produto, mas não no checkout#
A opção Exibir cotações no checkout, em TransportadorasGeral, liga o checkout para todas as origens de uma vez, gateways incluídos. Desligada, o gateway cota só no widget. Veja O checkout não mostra o Cota Frete.