Point relais qui ne s'affiche pas sur PrestaShop : les causes

Un bug qui coûte directement des commandes

Quand un point relais PrestaShop ne s'affiche pas, le client ne vous appelle pas : il abandonne son panier. C'est l'un des bugs les plus coûteux du tunnel de commande, et l'un des plus fréquents. Sur l'historique d'interventions d'une agence française spécialisée, les modules de livraison représentent plusieurs centaines de tickets, dominés par Colissimo et Mondial Relay, avec des pics de sinistralité qui suivent les montées de version.

La bonne nouvelle : les causes se ramènent à un petit nombre de scénarios, et une méthode d'isolement permet de trancher en quinze minutes.

Étape 1 : la carte est vide ou ne se charge pas

Le widget de sélection s'affiche mais reste blanc, ou tourne indéfiniment. Ouvrez la console du navigateur, onglet Console puis Réseau : l'erreur est presque toujours explicite.

Clé Google Maps expirée ou quota dépassé. Message typique : RefererNotAllowedMapError ou OverQuotaMapError. La clé doit être valide, associée à un projet avec facturation active, et autoriser le domaine de la boutique en referer. C'est de loin la première cause.

Conflit JavaScript avec le thème. Testez en basculant temporairement sur le thème Classic. Si la carte revient, le problème vient d'une bibliothèque chargée deux fois par votre thème, typiquement jQuery.

Le CCC casse le chargement. Dans Paramètres avancés > Performances, les options « Combiner, Compresser et Mettre en cache » regroupent les fichiers JavaScript. Les widgets transporteurs chargent souvent leurs scripts de façon asynchrone et supportent mal ce regroupement. Désactivez CCC, videz le cache, retestez. Si la carte revient, vous savez où chercher.

Contenu mixte. Un widget appelé en HTTP sur une page HTTPS est bloqué silencieusement par le navigateur. Message : Mixed Content.

Étape 2 : le transporteur n'apparaît pas du tout au tunnel

Ici, le problème n'est pas le widget mais la logique de disponibilité des transporteurs. Vérifiez dans cet ordre :

1. Zone et pays. Le pays de livraison du client doit appartenir à une zone associée au transporteur. Une zone décochée rend le transporteur invisible sans le moindre message.
2. Groupes clients. Dans l'onglet du transporteur, les groupes autorisés doivent inclure celui du client, y compris « Visiteur » si vous acceptez la commande sans compte.
3. Tranches de poids et de prix. C'est le grand classique : la dernière tranche s'arrête à une valeur inférieure au panier réel. Un panier de 12 kg sur une grille qui s'arrête à 10 kg fait disparaître le transporteur. Vérifiez aussi le comportement choisi hors intervalle.
4. Transporteur supprimé logiquement. En base, ps_carrier.deleted = 1 masque le transporteur. Cela arrive après une modification de transporteur, PrestaShop créant une nouvelle ligne et archivant l'ancienne.
5. Disponibilité produit. Un produit configuré avec des transporteurs spécifiques restreint le choix pour tout le panier.

Une requête utile pour y voir clair :

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

Étape 3 : l'étiquette ne se génère pas

Le client a bien choisi son relais, mais l'expédition échoue côté back-office.

• Identifiants ou contrat expirés. Les modules transporteurs stockent un identifiant, un mot de passe et souvent un numéro de contrat. Un changement de contrat commercial invalide les accès sans prévenir.
• Adresse rejetée. Les formats d'adresse des transporteurs sont stricts. Colissimo tronque au-delà d'une certaine longueur de ligne, et les caractères accentués ou spéciaux dans address1 provoquent des rejets. Les adresses saisies en copier-coller depuis un autre site sont les plus problématiques.
• Poids à zéro. Un produit sans poids renseigné casse le calcul chez certains transporteurs. Vérifiez qu'aucun produit actif n'a un poids nul.

Étape 4 : les frais de port sont aberrants

Deux causes dominent :

• Tranches qui se chevauchent. Une grille 0-1 kg puis 1-5 kg crée une ambiguïté à exactement 1 kg. Utilisez des bornes qui ne se recouvrent pas.
• Franco de port mal réglé. Le seuil de livraison gratuite se règle dans les préférences de livraison, et s'applique avant ou après remise selon la configuration. Un seuil mal placé rend la livraison gratuite plus souvent que prévu.

La méthode d'isolement en quinze minutes

Une seule règle : changer un paramètre à la fois. Dans l'ordre, thème Classic, puis CCC désactivé, puis modules non essentiels désactivés. Le premier changement qui restaure le comportement normal désigne le coupable.

Documentez chaque test. Sur un tunnel de commande, revenir en arrière sans savoir ce qu'on a modifié coûte plus cher que le bug initial.

Si la panne est apparue après une montée de version, la cause est probablement plus large : voyez notre article sur les modules cassés après une mise à jour.

Tunnel de commande cassé ?

Nous intervenons sur les bugs de transporteur et de tunnel de commande en urgence. Diagnostic gratuit, réponse sous 1h — voir le dépannage PrestaShop.