Modules de livraison PrestaShop — 757 interventions analysées depuis 2018

Vos clients sont bloqués au checkout parce qu'aucun transporteur ne s'affiche ? Le widget Mondial Relay ne charge plus ? Les étiquettes Colissimo refusent de s'imprimer ? Vous n'êtes pas seul. Depuis 2018, MonSiteBug a traité 757 interventions liées aux modules de livraison PrestaShop — pannes de modules, frais de port incorrects, transporteurs invisibles, erreurs fatales après mise à jour.

Cet article est une étude exclusive basée sur nos données réelles. Pas de théorie : des chiffres tirés de nos 8 809 tickets de support et des cas concrets traités par notre équipe. Quand votre tunnel de vente est cassé, chaque minute compte — et chaque commande perdue ne revient pas.

Les chiffres clés par transporteur

Sur nos 757 interventions livraison, voici la répartition par transporteur ou type de problème :

Constat : Colissimo et Mondial Relay concentrent à eux seuls 26,5% de tous les tickets livraison. Ce sont les deux modules les plus utilisés en France — et de loin les plus problématiques. Les problèmes de frais de port génériques (grilles tarifaires, zones, livraison gratuite) arrivent en troisième position.

Évolution des problèmes de livraison : 2018–2026

Les problèmes de livraison sont constants et croissants, en corrélation directe avec l'adoption du e-commerce :

Pic 2020-2021 : L'explosion du e-commerce pendant le COVID a généré un afflux massif de marchands qui ont installé des modules de livraison dans l'urgence, souvent mal configurés. 2021 reste notre année record avec 139 interventions livraison, aggravée par les mises à jour PrestaShop 1.7.7 et 1.7.8 qui ont cassé la compatibilité de nombreux modules transporteurs.

Les 6 problèmes les plus fréquents

1. Module disparu ou cassé après mise à jour PrestaShop

C'est le problème numéro 1 que nous traitons. Après une mise à jour de PrestaShop (mineure ou majeure), le module de livraison cesse de fonctionner : erreur fatale, page blanche au checkout, ou transporteur qui disparaît simplement de la liste.

Les modules Mondial Relay et Colissimo sont les plus touchés car ils dépendent d'API externes et de hooks spécifiques qui changent entre les versions de PrestaShop.

2. Widget point relais cassé (carte qui ne s'affiche pas)

Le widget de sélection de point relais (carte Google Maps ou Leaflet) refuse de se charger. Le client voit un espace vide ou un message d'erreur à la place de la carte. Causes fréquentes : clé API Google Maps expirée, conflit JavaScript avec le thème, ou module incompatible avec la version de PrestaShop.

3. Frais de port incorrects ou à zéro

Les grilles tarifaires sont mal configurées : livraison gratuite qui s'applique à tout le monde, frais de port qui ne changent pas selon le poids ou la zone, ou au contraire des frais astronomiques qui font fuir les clients. Ce problème est souvent lié à des zones de livraison mal définies ou des tranches de poids incorrectes.

4. Étiquettes de transport non générées

Le marchand ne peut plus imprimer ses étiquettes de transport depuis le back-office. L'API du transporteur retourne une erreur, les identifiants API ont expiré, ou le format de l'adresse est rejeté. Colissimo et Mondial Relay sont les plus concernés, avec des changements d'API fréquents côté transporteur.

5. Erreur fatale liée au module (500 / page blanche)

Le module de livraison provoque une erreur fatale PHP qui casse tout le front-office ou uniquement la page de checkout. Le site devient inaccessible ou les clients ne peuvent plus finaliser leur commande. Souvent causé par une incompatibilité PHP 8.x avec un module écrit pour PHP 7.x.

6. Transporteur invisible en front-office

Le transporteur est bien configuré en back-office mais n'apparaît pas sur la page de commande. Les clients ne voient aucune option de livraison et ne peuvent pas commander. Causes : zone de livraison non associée, groupe client non coché, module désactivé en front, ou poids du panier hors des tranches configurées.

Cas réels tirés de nos tickets

Cas #1 — Bug point relais Colissimo (Ticket #469, 2019)

Titre original : "bug point relais colissimo"

Un marchand ne peut plus proposer le retrait en point relais Colissimo à ses clients. Le widget de sélection ne se charge pas, les clients sont bloqués au checkout. Après investigation, le problème venait d'un conflit entre le module Colissimo officiel et un module de cache agressif qui empêchait le chargement du JavaScript nécessaire au widget.

Cas #2 — Erreur d'impression étiquette Mondial Relay (Ticket #501, 2020)

Titre original : "Erreur d'impression étiquette mondial relay"

Le marchand ne peut plus générer ses étiquettes Mondial Relay depuis le back-office PrestaShop. L'API retourne une erreur silencieuse. La cause : Mondial Relay avait changé son endpoint API sans préavis, et le module tiers utilisé par le marchand n'avait pas été mis à jour pour refléter ce changement. Migration vers le module officiel Mondial Relay pour résoudre le problème.

Cas #3 — Aucun transporteur disponible (Ticket #636, 2020)

Titre original : "il n'y a aucun transporteur"

Situation critique : les clients ne voient aucun transporteur au checkout, la boutique ne peut plus vendre. Après diagnostic, les zones de livraison avaient été réinitialisées lors d'une mise à jour PrestaShop. Aucun transporteur n'était associé à la France métropolitaine. Reconfiguration complète des zones et des associations transporteurs/zones.

Cas #4 — Transporteur invisible en front (Ticket #696, 2020)

Titre original : "Impossible de faire apparaitre un transporteur en FO"

Le transporteur est bien visible en back-office, toutes les configurations semblent correctes, mais il refuse d'apparaître en front-office. Le problème : le groupe client "Visiteur" n'était pas coché dans les paramètres du transporteur, ce qui empêchait les clients non connectés de le voir.

Cas #5 — Clients bloqués au checkout (Ticket #232, 2019)

Titre original : "cliente sont bloquée lorsqu'elle choisissent un transporteur"

Les clientes sélectionnent un transporteur mais la page se fige, impossible de passer à l'étape suivante. Un conflit JavaScript entre le thème et le module de livraison empêchait la validation de l'étape transporteur. Le thème surchargeait le fichier order.js de PrestaShop avec une version obsolète incompatible avec le module.

Cas #6 — Grille tarifaire cassée (Ticket #356, 2019)

Titre original : "Pb grille tarif transporteur"

Les frais de port affichés ne correspondent pas aux tarifs configurés. Un transporteur facture 5€ au lieu de 8€, un autre affiche 0€. La grille tarifaire contenait des tranches de poids qui se chevauchaient, provoquant des calculs erronés. Nettoyage et reconfiguration complète des tranches.

Cas #7 — Bug livraison gratuite (Ticket #401, 2019)

Titre original : "Bug Livraison gratuite"

La livraison gratuite s'applique à toutes les commandes au lieu de se déclencher uniquement au-dessus d'un certain montant. Le module de livraison gratuite PrestaShop interférait avec les règles panier et ignorait la condition de montant minimum. Désactivation du module natif et configuration via les règles panier à la place.

Cas #8 — Erreur fatale Mondial Relay après MAJ (Ticket #8658, 2026)

Titre original : "Erreur fatale liée à un module Mondial Relay après mise à jour"

Cas récent et représentatif : après une mise à jour de PrestaShop, le module Mondial Relay provoque une erreur fatale PHP qui casse l'intégralité du front-office. Le site est complètement inaccessible. Cause : le module utilisait une syntaxe PHP dépréciée, incompatible avec PHP 8.1+. Mise à jour du module et correction des incompatibilités.

Point commun : Dans la grande majorité des cas, le problème est déclenché par une mise à jour (PrestaShop, PHP ou module) qui casse une compatibilité. Le marchand découvre le problème quand ses clients ne peuvent plus commander — parfois après plusieurs heures, voire plusieurs jours de ventes perdues.

Solutions par transporteur

Colissimo (106 tickets)

Colissimo est le transporteur le plus utilisé en France et celui qui génère le plus de tickets chez nous.

• Module officiel vs module tiers — Privilégiez toujours le module officiel Colissimo de La Poste. Les modules tiers sont souvent en retard sur les changements d'API et provoquent des incompatibilités.
• API Colissimo — L'API change régulièrement. Gardez vos identifiants API à jour et vérifiez que votre contrat Colissimo est actif. Une API désactivée = plus d'étiquettes.
• Widget point relais — Si le widget ne charge pas, vérifiez : clé API Google Maps valide, pas de conflit JS avec le thème, module compatible avec votre version de PrestaShop.
• Après MAJ PrestaShop — Testez systématiquement le tunnel de commande avec une livraison Colissimo après chaque mise à jour.

Mondial Relay (95 tickets)

Mondial Relay est le deuxième transporteur le plus problématique, principalement à cause de son widget de point relais et de ses changements d'API.

• Widget Mondial Relay — Le widget de sélection de point relais est la source numéro 1 de tickets. Si la carte ne s'affiche pas : vérifiez la clé API, le chargement jQuery, et les conflits avec le thème.
• Étiquettes — L'impression d'étiquettes dépend de l'API Mondial Relay. Si elle échoue, vérifiez vos identifiants API (Enseigne, clé privée) et que votre contrat est actif.
• Module officiel — Mondial Relay a changé plusieurs fois son module officiel PrestaShop. Assurez-vous d'utiliser la dernière version disponible sur la marketplace Addons.
• Erreurs fatales — Après une MAJ PrestaShop ou PHP, le module Mondial Relay est souvent le premier à casser. Gardez toujours un backup avant de mettre à jour.

Chronopost (36 tickets)

• Module officiel — Utilisez exclusivement le module officiel Chronopost. Les modules tiers ne suivent pas les évolutions de l'API.
• Créneaux horaires — Le module Chronopost Predict (livraison sur rendez-vous) est particulièrement sensible aux incompatibilités de thème. Testez avec le thème par défaut en cas de problème.
• Étiquettes — L'impression d'étiquettes Chronopost nécessite des identifiants API spécifiques (numéro de compte, sous-compte). Vérifiez-les en premier en cas d'erreur.

UPS, DPD, GLS

• UPS (41 tickets) — Les problèmes sont principalement liés aux tarifs temps réel (API de cotation) qui retournent des erreurs quand les dimensions/poids ne sont pas renseignés sur les produits.
• DPD (30 tickets) — Module souvent obsolète, maintenu par des développeurs tiers. Envisagez le module Boxtal/EnvoimoinsCher comme alternative multi-transporteurs.
• GLS (11 tickets) — Peu de tickets mais des problèmes récurrents d'étiquettes et de suivi. Le module officiel GLS est relativement stable.

Bonnes pratiques : éviter les pannes de livraison

Voici les mesures que nous recommandons à tous les marchands PrestaShop, tirées de 757 interventions :

• Toujours tester après une mise à jour — Après chaque MAJ de PrestaShop, PHP ou d'un module, passez une commande test complète avec chaque transporteur. C'est la première cause de panne.
• Garder un transporteur de backup — Si Colissimo tombe, vos clients doivent pouvoir commander avec un autre transporteur. Configurez toujours au minimum 2 transporteurs actifs.
• Vérifier les zones de livraison — C'est la cause invisible la plus fréquente : un transporteur qui ne s'affiche pas parce que la zone n'est pas associée. Vérifiez que la France est bien dans la zone de livraison de chaque transporteur.
• Surveiller les expiration d'API — Les identifiants API Colissimo, Mondial Relay et Chronopost expirent. Notez les dates de renouvellement et renouvelez avant expiration.
• Utiliser les modules officiels — Les modules tiers sont souvent moins maintenus. Privilégiez les modules officiels des transporteurs, disponibles sur PrestaShop Addons.
• Sauvegarder avant chaque mise à jour — Un backup complet (fichiers + base de données) avant chaque MAJ vous permet de revenir en arrière en cas de casse.
• Vérifier les groupes clients — Un transporteur invisible en front-office ? Vérifiez que tous les groupes clients (Visiteur, Client, Invité) sont cochés dans les paramètres du transporteur.
• Tester sur mobile — De nombreux widgets de point relais (Mondial Relay, Colissimo) ne fonctionnent pas correctement sur mobile. Testez le tunnel de commande sur smartphone.

Rappel critique : Un checkout cassé = des ventes perdues en temps réel. Contrairement à un bug cosmétique, un problème de livraison empêche physiquement vos clients de commander. Chaque heure compte.

Diagnostic rapide : votre transporteur ne s'affiche pas ?

Si aucun transporteur ne s'affiche au checkout, voici la checklist de diagnostic que nous suivons :

• 1. Le module du transporteur est-il activé ? (Modules > Module Manager)
• 2. Le transporteur est-il actif ? (Livraison > Transporteurs > Actif = Oui)
• 3. Les zones de livraison sont-elles associées ? (Transporteur > Zones)
• 4. Les groupes clients sont-ils cochés ? (Transporteur > Groupes)
• 5. Les tranches de poids/prix couvrent-elles le panier actuel ?
• 6. Le produit dans le panier a-t-il un poids renseigné ?
• 7. Y a-t-il une erreur PHP dans les logs ? (var/logs/)
• 8. Le thème surcharge-t-il les templates de checkout ?

Nos chiffres livraison en un coup d'oeil

Pourquoi nous confier vos problèmes de livraison ?

Depuis 2018, nous avons résolu 757 problèmes de livraison PrestaShop. Nous connaissons chaque module, chaque API, chaque piège de configuration. Quand votre checkout est cassé et que vous perdez des ventes, nous intervenons rapidement pour remettre vos transporteurs en service.

Ce qui nous différencie :

• 757 interventions livraison — une expertise terrain inégalée sur les modules de transport PrestaShop
• Connaissance de tous les transporteurs — Colissimo, Mondial Relay, Chronopost, UPS, DPD, GLS et leurs API respectives
• Intervention rapide — Un checkout cassé est une urgence commerciale, nous le traitons comme tel
• Diagnostic précis — Nous identifions la cause exacte (zone, API, conflit module, incompatibilité PHP) et la corrigeons
• Test complet — Après chaque intervention, nous testons le tunnel de commande de bout en bout avec chaque transporteur
• Conseil — Nous vous recommandons les bonnes configurations et les modules fiables pour éviter les pannes futures