Ponto de recolha que não aparece no PrestaShop: as causas

Uma avaria que custa encomendas diretamente

Quando um ponto de recolha PrestaShop não aparece, o cliente não telefona: abandona o carrinho. É um dos problemas mais caros do processo de compra e também um dos mais frequentes. No historial de intervenções de uma agência francesa especializada, os módulos de entrega representam várias centenas de pedidos de assistência, dominados pela Colissimo e pela Mondial Relay, com picos de incidentes que acompanham as subidas de versão.

A boa notícia: as causas reduzem-se a um número pequeno de cenários e um método de isolamento permite decidir em quinze minutos.

Passo 1: o mapa está vazio ou não carrega

O widget de seleção aparece mas fica em branco, ou roda indefinidamente. Abra a consola do navegador, separador Consola e depois Rede: o erro é quase sempre explícito.

Chave da Google Maps expirada ou quota esgotada. Mensagem típica: RefererNotAllowedMapError ou OverQuotaMapError. A chave tem de ser válida, estar associada a um projeto com faturação ativa e autorizar o domínio da loja como referer. É de longe a primeira causa.

Conflito de JavaScript com o tema. Faça o teste a mudar temporariamente para o tema Classic. Se o mapa voltar, o problema está numa biblioteca carregada duas vezes pelo seu tema, normalmente o jQuery.

O CCC parte o carregamento. Em Parâmetros avançados > Desempenho, as opções «Combinar, comprimir e colocar em cache» agrupam os ficheiros JavaScript. Os widgets das transportadoras carregam muitas vezes os seus scripts de forma assíncrona e lidam mal com esse agrupamento. Desative o CCC, limpe a cache e volte a testar. Se o mapa voltar, já sabe onde procurar.

Conteúdo misto. Um widget chamado em HTTP numa página HTTPS é bloqueado em silêncio pelo navegador. Mensagem: Mixed Content.

Passo 2: a transportadora não aparece de todo no checkout

Aqui o problema não está no widget, mas na lógica de disponibilidade das transportadoras. Verifique por esta ordem:

1. Zona e país. O país de entrega do cliente tem de pertencer a uma zona associada à transportadora. Uma zona desmarcada torna a transportadora invisível sem a mais pequena mensagem.
2. Grupos de clientes. No separador da transportadora, os grupos autorizados têm de incluir o do cliente, incluindo «Visitante» se aceitar encomendas sem conta.
3. Escalões de peso e de preço. É o grande clássico: o último escalão termina num valor inferior ao do carrinho real. Um carrinho de 12 kg numa grelha que acaba nos 10 kg faz a transportadora desaparecer. Confirme também o comportamento definido para fora do intervalo.
4. Transportadora eliminada logicamente. Na base de dados, ps_carrier.deleted = 1 esconde a transportadora. Acontece a seguir a uma alteração de transportadora: o PrestaShop cria uma nova linha e arquiva a antiga.
5. Disponibilidade do produto. Um produto configurado com transportadoras específicas restringe a escolha para todo o carrinho.

Uma consulta útil para ver com clareza:

SELECT id_carrier, name, active, deleted, id_reference
FROM ps_carrier ORDER BY id_reference, id_carrier;

Passo 3: a etiqueta não é gerada

O cliente escolheu o ponto de recolha, mas a expedição falha do lado do back-office.

• Credenciais ou contrato expirados. Os módulos das transportadoras guardam um identificador, uma palavra-passe e, muitas vezes, um número de contrato. Uma alteração do contrato comercial invalida os acessos sem aviso.
• Morada rejeitada. Os formatos de morada das transportadoras são rígidos. A Colissimo trunca acima de um certo comprimento de linha, e os caracteres acentuados ou especiais em address1 provocam rejeições. As moradas introduzidas por copiar-colar a partir de outro site são as mais problemáticas.
• Peso a zero. Um produto sem peso preenchido parte o cálculo em algumas transportadoras. Confirme que nenhum produto ativo tem peso nulo.

Passo 4: os portes de envio são absurdos

Dominam duas causas:

• Escalões que se sobrepõem. Uma grelha 0-1 kg seguida de 1-5 kg cria uma ambiguidade exatamente em 1 kg. Use limites que não se sobreponham.
• Portes grátis mal configurados. O limite de entrega gratuita define-se nas preferências de entrega e aplica-se antes ou depois do desconto, consoante a configuração. Um limite mal colocado torna a entrega gratuita com mais frequência do que o previsto.

O método de isolamento em quinze minutos

Uma única regra: alterar um parâmetro de cada vez. Por esta ordem: tema Classic, depois CCC desativado, depois módulos não essenciais desativados. A primeira alteração que repõe o comportamento normal identifica o culpado.

Documente cada teste. Num processo de compra, voltar atrás sem saber o que se alterou custa mais caro do que o problema inicial.

Se a avaria surgiu depois de uma subida de versão, a causa é provavelmente mais ampla: veja o nosso artigo sobre os módulos que se partem depois de uma atualização.

Processo de compra avariado?

Intervimos com urgência em problemas de transportadoras e de processo de compra. Diagnóstico gratuito, resposta em 1 h — veja o suporte urgente PrestaShop.