Frete não aparece no checkout Magento 2? Faça 10 verificações antes de trocar o módulo

Quando o frete não aparece no checkout Magento 2, trocar o módulo ou limpar todos os caches raramente é o melhor primeiro passo. O método pode estar indisponível para aquele endereço, ser bloqueado por uma condição comercial, falhar ao consultar a transportadora ou até ser calculado corretamente sem aparecer no frontend.

Antes de modificar configurações, registre o CEP utilizado, os produtos e quantidades do carrinho, a store view, o tipo de cliente, o horário do teste e os métodos esperados. As dez verificações abaixo ajudam a separar erro de configuração, indisponibilidade externa e falha técnica.

Frete não aparece no checkout Magento 2: onde começa o cálculo?

O Magento coleta as opções de entrega a partir dos itens do carrinho e do endereço informado pelo cliente. Cada método habilitado avalia suas próprias condições, como país, região, faixa de preço, peso, dimensões, grupo de cliente e disponibilidade do serviço externo.

Isso significa que a mensagem “nenhum método disponível” não identifica, sozinha, o ponto da falha. Ela pode indicar que nenhum método atendeu às condições, mas também pode ser consequência de uma exceção no servidor ou de uma resposta que o checkout não conseguiu exibir.

1. Reproduza o problema com um carrinho controlado

Crie um teste simples com apenas um produto físico, quantidade igual a um e um endereço completo. Use um SKU habilitado, associado ao website correto e com dados consistentes de peso e estoque.

Depois, altere uma variável por vez: CEP, produto, quantidade, login do cliente ou store view. Se o frete aparece com outro item, a investigação deve priorizar atributos e regras do produto. Se falha apenas em uma região, examine a cobertura e a configuração geográfica.

Caso os itens desapareçam durante o teste, trate primeiro a sessão. O guia sobre carrinho Magento 2 esvaziando sozinho ajuda a distinguir perda da cotação de um problema específico de entrega.

2. Confirme país, estado, cidade e CEP

Uma opção de frete pode depender de mais campos do que o checkout inicialmente exibe. Verifique se o país está correto, se a região foi selecionada ou digitada no formato esperado e se o CEP contém caracteres incompatíveis com a integração.

Teste também um endereço conhecido dentro da área atendida pelo método. Se o serviço funciona para esse endereço, mas não para o CEP original, consulte as regras de cobertura antes de concluir que existe defeito no módulo.

3. Verifique o escopo da configuração do método

No painel administrativo, confirme se o método está habilitado no website, na loja e na store view utilizados pelo checkout. Uma configuração salva no escopo padrão pode ser sobrescrita em um nível inferior.

Revise, conforme o método instalado:

• status de habilitação;
• países permitidos e bloqueados;
• valor mínimo ou máximo do pedido;
• frete grátis e suas condições;
• ordem de exibição;
• credenciais e ambiente de homologação ou produção;
• tratamento quando a consulta externa retorna erro.

Em um ambiente autorizado, a equipe técnica pode inspecionar a configuração efetiva pelo terminal:

bin/magento config:show carriers
bin/magento config:show general/country/default

Evite publicar a saída completa desses comandos em chamados abertos, pois configurações de extensões podem incluir informações sensíveis.

4. Teste peso, dimensões e tipo dos produtos

Transportadoras e gateways de frete podem rejeitar itens sem peso, com dimensões inválidas ou fora dos limites aceitos pelo serviço. Confira os valores diretamente no escopo em que o produto é vendido, inclusive quando atributos são herdados da visão padrão.

Produtos virtuais e baixáveis normalmente não exigem entrega física. Em carrinhos mistos, uma extensão personalizada pode interpretar incorretamente o conjunto de itens. Compare o comportamento entre um produto físico simples e o carrinho que apresenta o problema.

5. Confirme disponibilidade e vínculo com o canal de vendas

Um item sem disponibilidade comercial pode impedir a continuidade do checkout ou alterar a cotação. Verifique se o produto está associado ao website, se a quantidade vendável é suficiente e se o estoque relacionado ao canal de vendas contém fontes válidas.

Não aumente o saldo apenas para liberar o teste. Quando houver divergência, siga uma análise específica para produto com estoque que aparece esgotado no Magento 2.

6. Procure regras que removem ou substituem métodos

Módulos de frete, promoções, restrição por região, retirada em loja, marketplace e regras personalizadas podem filtrar as opções retornadas. Também é possível que uma condição de frete grátis substitua a modalidade paga, em vez de apenas alterar seu preço.

Compare clientes visitantes e autenticados, grupos de cliente, cupons e subtotais diferentes. Desative extensões somente em homologação e com um plano de reversão. Em produção, remover módulos sem avaliar dependências pode afetar pedidos, checkout e comandos de implantação.

7. Verifique se a consulta externa está falhando

Quando o cálculo depende de uma transportadora ou intermediador, valide conectividade, DNS, certificados, tempo limite e credenciais a partir do mesmo ambiente que executa o PHP da loja. Uma API pode responder no computador do desenvolvedor e falhar no servidor por bloqueio de rede ou configuração diferente.

Consulte os logs próprios do módulo e correlacione o horário da tentativa com os registros gerais:

tail -n 200 var/log/system.log
tail -n 200 var/log/exception.log

Busque erros de autenticação, conexão, resposta inválida e tempo esgotado. Não registre tokens, senhas, dados pessoais ou o conteúdo integral de endereços em logs permanentes.

8. Descubra se o backend calculou o frete

Abra as ferramentas de desenvolvedor do navegador, acesse a aba de rede e repita o preenchimento do endereço. Observe a requisição responsável pela estimativa de entrega e sua resposta.

• Nenhuma requisição é enviada: investigue JavaScript, componentes do checkout e validação dos campos.
• A resposta contém métodos: o problema provavelmente está na renderização ou no estado do frontend.
• A resposta está vazia: examine condições comerciais e disponibilidade dos serviços.
• A resposta apresenta erro: correlacione o horário com os logs do servidor.

Esse teste evita alterar a transportadora quando o cálculo já está correto e apenas a interface deixou de apresentar o resultado.

9. Analise erros JavaScript e personalizações do checkout

Temas e módulos podem substituir componentes responsáveis por endereço, cotação e seleção da entrega. No console do navegador, procure erros que surgem imediatamente após informar o CEP ou modificar o carrinho.

Compare o checkout afetado com o tema padrão somente em um ambiente de homologação. Verifique ainda se arquivos estáticos e código gerado correspondem ao último deploy. Se o problema começou após instalar ou atualizar uma extensão, confirme suas dependências antes de mudar versões. O diagnóstico de conflitos do Composer no Magento 2 pode ajudar nessa etapa.

10. Limpe apenas o cache relacionado e repita o teste

Depois de corrigir uma configuração, limpe primeiro os tipos de cache relacionados, em vez de apagar diretórios ou reiniciar serviços indiscriminadamente:

bin/magento cache:status
bin/magento cache:clean config full_page

Repita o teste em uma sessão anônima e confirme se a resposta do servidor mudou. Se a loja utiliza CDN, proxy reverso ou cache adicional, avalie cada camada separadamente. Cache não corrige credencial inválida, regra de cobertura ou produto sem dados necessários para cotação.

O que registrar antes de acionar o suporte

Um diagnóstico técnico fica mais rápido quando o chamado inclui:

• CEP e região usados, com dados pessoais removidos;
• SKUs, quantidades e subtotal do carrinho;
• website, store view e grupo de cliente;
• método esperado e métodos apresentados;
• horário exato da reprodução;
• status e resposta da requisição de cotação;
• trechos relevantes dos logs, sem credenciais;
• últimas alterações em tema, módulos e configurações.

Conclusão

Quando o frete não aparece no checkout Magento 2, o caminho mais seguro é acompanhar o cálculo do carrinho até a apresentação no navegador. Endereço, escopo, produtos, estoque, regras, integração externa e frontend precisam ser verificados de forma isolada.

Se o problema persistir ou afetar pedidos em produção, uma análise técnica pode localizar a camada responsável sem trocar módulos ou alterar configurações às cegas. A equipe do SuporteMagento.com.br pode auxiliar no diagnóstico do checkout, dos logs e das integrações de frete.

Perguntas frequentes

Por que o frete aparece para um CEP e não para outro?

O endereço pode estar fora da cobertura, exigir outra modalidade ou não atender às regras configuradas. País, região, formato do CEP, peso, dimensões e valor do carrinho também podem mudar o resultado.

Limpar o cache resolve frete ausente no checkout?

Pode ajudar depois de uma mudança de configuração, mas não corrige falhas de API, credenciais, cobertura, estoque ou JavaScript. Antes de limpar caches, verifique a requisição de cotação e os logs.

Como saber se o erro está no módulo ou no tema?

Observe a resposta da requisição de estimativa no navegador. Se ela contém métodos válidos, mas a tela não os apresenta, priorize o frontend. Se a resposta está vazia ou apresenta erro, investigue o backend e a integração.

É seguro desativar o módulo de frete para testar?

Faça isso apenas em homologação, após verificar dependências e preparar a reversão. Desativar uma extensão em produção pode remover todas as opções de entrega ou afetar pedidos já em processamento.