O cliente encontrou o produto, colocou no carrinho e informou o CEP. A loja responde que não há transportadoras disponíveis. Esse aviso mostra onde a compra parou, mas ainda não explica a causa. Pode existir uma restrição legítima de entrega ou uma combinação de cadastro e configuração que eliminou opções que deveriam aparecer. Antes de mudar preços, ativar serviços indiscriminadamente ou culpar a transportadora, vale descobrir qual condição produz o problema.
Comece por um caso que outra pessoa consiga repetir
Escolha um carrinho sem dados pessoais: referência do produto, combinação selecionada, quantidade e CEP usado na simulação. Anote o horário e em qual etapa a mensagem aparece. Registre também um caso semelhante em que o frete funciona. Essa dupla ajuda a separar uma falha geral de uma condição específica. Um print da mensagem, sozinho, costuma esconder justamente a diferença que importa.
Faça uma comparação por vez. Mantenha o produto e troque o CEP; depois mantenha o CEP e troque o produto. Se houver variações, repita com a mesma combinação. Não conclua que uma cidade inteira está sem atendimento porque um único carrinho falhou. Produto, quantidade e endereço precisam acompanhar o registro.
Separe cobertura real de restrição na loja
Confirme se o serviço atende àquela origem e àquele destino. Uma cotação externa com condições equivalentes pode ajudar, quando o operador oferece essa consulta. Compare o mesmo pacote, não apenas o mesmo CEP. Encontrar preço no site da transportadora não prova que a integração deveria apresentar exatamente aquela oferta: contrato, serviço habilitado e montagem do volume podem ser diferentes.
No PrestaShop, confira as zonas atendidas e os vínculos da transportadora. Consulte também restrições de grupo e de loja, quando usadas na instalação. Os nomes dos campos variam entre versões e módulos. O objetivo é seguir a regra efetivamente aplicada ao comprador, sem ampliar a cobertura comercial como tentativa de corrigir uma configuração.
Confira o produto e o pacote que serão cotados
Um item leve sozinho pode caber em um serviço que deixa de aceitar o carrinho com várias unidades. Verifique peso, dimensões e limites aplicáveis. Confirme se a integração usa os dados de cada produto ou recebe volumes já montados. Não substitua medidas por valores fictícios só para fazer uma modalidade aparecer: isso pode gerar uma cotação incompatível com a postagem.
Como exemplo de exigência específica, a documentação do Melhor Envio informa centímetros para dimensões e quilogramas para peso. Essa referência não deve ser generalizada para todo fornecedor. Confira a unidade exigida pelo módulo e pela API utilizados. Observe especialmente conversões como gramas para quilogramas e os valores enviados para uma combinação de produto.
Procure lacunas nas faixas e nas condições
Quando a transportadora usa faixas, compare o total do carrinho com os intervalos configurados e o comportamento fora deles. Um preço ou peso na fronteira entre faixas merece atenção. Registre o resultado esperado de acordo com a regra da loja; não invente um valor de frete para preencher o vazio sem validação comercial.
Use uma pequena matriz de diagnóstico: produto A com um CEP atendido; produto A com o CEP que falha; produto B com esse mesmo CEP; produto A com quantidade maior. Anote quais modalidades aparecem em cada combinação. Essa matriz é uma proposta de investigação, não um conjunto universal de testes: adapte os casos ao catálogo e às regiões relevantes para a operação.
Se há integração, siga a cotação até a resposta
Com apoio técnico, verifique se a loja enviou a solicitação e qual resposta recebeu. Diferencie ausência de serviço, dados rejeitados, falha de autenticação e indisponibilidade temporária. Preserve o código e o horário do erro, sem copiar tokens, credenciais ou endereços completos para conversas e planilhas. O diagnóstico precisa de evidência técnica mínima, não de exposição dos dados do cliente.
Uma resposta válida do fornecedor também precisa chegar à interface da loja. Se ela contém uma opção que não aparece ao comprador, investigue o tratamento do retorno e os filtros posteriores. Se não houve solicitação, comece pela condição que impediu o envio. Trocar várias configurações simultaneamente destrói essa pista e dificulta saber o que resolveu.
Corrija a causa e repita os casos de controle
Após identificar a causa, altere somente o necessário e registre o antes e o depois. Repita o carrinho que falhava e os casos que já funcionavam. Confira modalidade, valor e prazo apresentados. Se a intenção era reparar uma faixa, por exemplo, não considere o trabalho encerrado apenas porque qualquer transportadora passou a aparecer.
Essa verificação normalmente pode parar antes da criação de um pedido. Testes que envolvam compra, pagamento, emissão de etiqueta ou mensagem ao cliente exigem um ambiente e uma autorização apropriados. Em produção, evite efeitos reais durante o diagnóstico. Uma integração em modo de testes também não prova, por si só, que uma postagem real foi contratada.
Deixe uma evidência útil para a próxima ocorrência
Guarde a referência do cenário, o período, o resultado esperado e a causa confirmada. Registre hipóteses separadamente das conclusões. Uma frase como “não havia faixa para esse peso” é muito mais útil do que “o frete voltou”. Se a causa não foi confirmada, descreva a recuperação observada e a investigação que continua pendente.
Escolha alguns cenários importantes para rever após mudanças relevantes e durante campanhas. A intenção é perceber quando uma combinação deixa de oferecer entrega, sem transformar cada verificação em um pedido real. O acompanhamento deve refletir o catálogo e a cobertura da loja, incluindo exceções conhecidas e limitações dos serviços externos.
O melhor ponto de partida é um carrinho reproduzível, não uma mudança geral nas regras. Se a sua loja precisa de apoio para investigar o cálculo de frete ou o comportamento de um módulo, fale com a AGTI pelo site agti.eng.br. Leve um exemplo sem dados pessoais e descreva o resultado esperado: isso torna a conversa técnica mais objetiva.