Frete não aparece no checkout Magento 2? Faça estes 9 testes

Quando o frete não aparece no checkout Magento 2, o cliente pode ficar preso na etapa de entrega ou receber uma mensagem informando que nenhum método está disponível. Embora pareça uma falha da transportadora, o problema também pode estar no endereço, nas condições comerciais, no conteúdo do carrinho, em uma integração externa ou no próprio frontend.

Ativar métodos aleatoriamente ou limpar todos os caches pode esconder evidências sem resolver a origem. O diagnóstico mais seguro é acompanhar a cotação desde os dados informados pelo comprador até a resposta exibida no checkout. Veja os nove testes prioritários.

Por que o frete não aparece no checkout Magento 2?

O Magento coleta os métodos de entrega aplicáveis ao carrinho e ao endereço informado. Cada transportadora pode validar país, região, CEP, subtotal, peso, quantidade, grupo de clientes e outras condições. Integrações externas ainda dependem de credenciais, conectividade e respostas válidas da API.

Por isso, “nenhum frete disponível” não identifica uma causa específica. A mensagem pode significar que nenhum método atende às condições atuais, mas também pode surgir quando a coleta falha, a requisição do checkout é interrompida ou uma resposta válida não consegue ser renderizada.

1. Descubra se a falha depende do produto ou do endereço

Comece criando uma matriz simples de testes. Use um produto físico conhecido, em estoque e com peso preenchido. Faça cotações com pelo menos dois CEPs atendidos pela operação e compare o comportamento como visitante e cliente autenticado.

• O problema acontece com todos os produtos ou somente com alguns?
• Todos os CEPs falham ou apenas determinadas regiões?
• A falha aparece no carrinho, no checkout ou nos dois?
• O método some depois do login ou de uma alteração de endereço?
• Outras formas de entrega continuam disponíveis?

Se a cotação falha somente com um SKU, investigue seus atributos e sua condição de venda. Se ocorre apenas em uma região, concentre-se nas restrições geográficas e na resposta da transportadora.

2. Confirme que o carrinho realmente exige entrega

Carrinhos formados exclusivamente por produtos virtuais ou digitais não seguem o fluxo normal de expedição. Em carrinhos mistos, extensões podem alterar indevidamente a maneira como o checkout decide se existe uma etapa de entrega.

Verifique o tipo de cada produto e reproduza o teste com um item físico simples. Se o erro estiver restrito a carrinhos virtuais, avalie o fluxo de pagamento em vez de tentar forçar uma cotação. Nosso guia sobre erro 400 no checkout virtual Magento mostra como dados incompletos podem interromper essa modalidade de compra.

3. Valide país, estado, cidade e CEP

Um CEP aparentemente correto não garante que o endereço enviado à cotação esteja completo. Máscaras, preenchimento automático, temas e módulos de endereço podem apagar a região, trocar o código do país ou mandar um valor diferente daquele mostrado na tela.

Abra as ferramentas de desenvolvedor do navegador, acesse a aba de rede e refaça a cotação. Examine a requisição responsável por estimar os métodos de entrega e confirme os valores efetivamente enviados. Procure por erros HTTP, respostas vazias e mensagens de validação. Não compartilhe publicamente payloads que contenham nome, telefone, endereço ou tokens.

4. Revise a configuração no escopo correto

Uma transportadora pode estar ativa globalmente, mas desabilitada no website ou na store view utilizada pelo cliente. No painel, confira o escopo selecionado antes de revisar status, países permitidos, título, nome do método, tratamento de erros e condições comerciais.

Para verificar um caminho conhecido pelo terminal, use o usuário responsável pela aplicação. Por exemplo, para o método de taxa fixa:

php bin/magento config:show carriers/flatrate/active
php bin/magento config:show carriers/flatrate/sallowspecific
php bin/magento config:show carriers/flatrate/specificcountry

Os valores precisam ser interpretados de acordo com a configuração por escopo. Não grave mudanças pelo terminal sem documentar o valor anterior e confirmar em qual website ou store view a alteração deve valer.

5. Confira peso, subtotal e regras de elegibilidade

Métodos de entrega podem desaparecer quando o carrinho fica fora de seus limites. Verifique o peso dos produtos, a quantidade, o subtotal usado pela condição, o destino e eventuais regras de frete grátis. Considere também descontos, impostos e moedas quando uma extensão usa esses valores para decidir a elegibilidade.

Faça um teste controlado alterando apenas uma variável por vez. Adicione uma unidade, troque o produto ou ajuste o CEP no ambiente de homologação. Isso ajuda a identificar a condição exata que remove o método.

6. Verifique estoque e origem de expedição

A disponibilidade comercial do item pode interferir no cálculo, especialmente quando a integração de frete considera fontes, depósitos ou regras de separação. Confirme se o produto está vendável, atribuído ao estoque correto e disponível para o canal da loja.

Não edite tabelas para tentar liberar a cotação. Se quantidade física, reservas e disponibilidade estiverem divergentes, siga o diagnóstico de salable quantity e reservas no Magento 2 antes de alterar os dados.

7. Teste a comunicação com a transportadora

Em módulos conectados a serviços externos, confira se a aplicação consegue resolver o domínio, abrir a conexão e receber uma resposta dentro do tempo esperado. Credenciais inválidas, contrato sem determinado serviço, timeout, proxy e bloqueio de saída podem impedir a cotação.

Consulte os logs do módulo e da aplicação no intervalo exato do teste. Arquivos normalmente relevantes ficam em var/log, mas extensões podem manter logs próprios ou enviá-los a uma plataforma de observabilidade. Redija chaves, tokens e dados pessoais antes de copiar qualquer registro.

Se houver acesso a uma ferramenta de testes do fornecedor, compare a requisição com o payload gerado pela loja. Evite testar repetidamente em produção quando a API contabilizar chamadas ou aplicar limites.

8. Procure erros JavaScript e respostas descartadas

Às vezes, o backend devolve as opções, mas o checkout não consegue exibi-las. No navegador, verifique o console e a aba de rede. Um componente JavaScript incompatível, um mixin, um tema customizado ou um módulo de checkout pode interromper a atualização da lista.

Compare o problema em uma janela privada e, se possível, em homologação com as customizações não essenciais desativadas de maneira controlada. Se o carrinho também muda ou desaparece durante a navegação, investigue cookies e sessões com o roteiro sobre carrinho esvaziando no Magento 2.

9. Compare código, configuração e deploy

Se a falha começou após uma implantação, compare o último estado funcional com o atual. Revise módulos de frete, checkout, endereço, promoções e estoque. Confirme que todos os nós receberam a mesma versão do código e do conteúdo estático.

Antes de limpar caches, salve os logs e registre uma requisição que reproduza o problema. Depois, execute apenas as ações compatíveis com a mudança realizada. Uma limpeza indiscriminada pode aumentar a carga da loja e dificultar a comparação.

Checklist rápido para organizar o diagnóstico

1. Registre horário, loja, carrinho, SKU e CEP usados no teste.
2. Confirme que há produto físico vendável e com peso válido.
3. Examine o endereço enviado pela requisição.
4. Revise a configuração no escopo correto.
5. Valide limites de peso, subtotal e destino.
6. Consulte logs do Magento e do módulo de transporte.
7. Compare a resposta da API com o que aparece na tela.
8. Verifique erros JavaScript e mudanças recentes.
9. Corrija primeiro em homologação e teste o pedido completo.

Perguntas frequentes

Limpar o cache faz o frete voltar ao checkout?

Pode atualizar uma configuração que estava em cache, mas não corrige CEP inválido, regra comercial, indisponibilidade de estoque, erro da API ou falha JavaScript. Preserve as evidências e identifique a camada responsável antes de limpar caches.

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

O método pode ter restrições de país, estado, faixa de CEP, peso, valor ou serviço disponível na região. Compare os payloads e as respostas da cotação para descobrir qual condição muda.

Um produto sem peso pode impedir a cotação?

Sim, dependendo da transportadora e do módulo utilizado. Valores ausentes ou incorretos podem produzir uma cotação inválida, especialmente quando peso e dimensões são obrigatórios para calcular o serviço.

É seguro testar uma transportadora diretamente em produção?

Testes simples podem ser necessários para reproduzir o problema, mas mudanças de configuração e código devem passar por homologação. Evite expor credenciais, gerar chamadas excessivas ou alterar regras durante pedidos em andamento.

Conclusão

Quando o frete não aparece no checkout Magento 2, a solução depende de descobrir onde a cotação foi interrompida: carrinho, endereço, regra, estoque, transportadora ou frontend. Um teste controlado, com requisições e logs preservados, costuma ser mais eficaz do que alterar várias configurações ao mesmo tempo.

Se a loja continua sem apresentar métodos de entrega ou a falha afeta pedidos em produção, solicite uma análise técnica especializada em Magento para revisar o fluxo sem comprometer a operação.