En novembre, une étiquette refusée coûte vite une soirée d’expéditions : les clients attendent leur numéro de suivi, les colis restent sur la table. Sur une boutique Mondial Relay PrestaShop ou Colissimo, le module affiche un message court, et le premier réflexe est d’accuser le transporteur ou le passage au compte InPost.
Environ 9 % des demandes que nous avons reçues entre mars et septembre 2026 portent sur la livraison, les étiquettes ou les transporteurs. Avant de conclure à une panne chez Mondial Relay ou Colissimo, plusieurs points se vérifient depuis la boutique. Voici dans quel ordre, et ce qu’il faut régler avant le 27 novembre. Commandes déjà bloquées : décrivez-nous la panne.
Compte InPost : depuis le 18 mai 2026, il sert au site et à l’appli Mondial Relay. Aucun changement des clés du module n’est publié à ce jour.
Mondial Relay 4.x crée les étiquettes par l’API2, avec les identifiants de Mondial Relay Connect. Une ancienne 3.x (3.1.1 relevée) passe encore par le WebService SOAP, avec le code enseigne et la clé privée.
Colissimo : passez en clé de connexion avant la fin de l’identifiant et du mot de passe, annoncée « courant 2026 ».
Version : Mondial Relay 4.x demande PrestaShop 8 et PHP 8.
- 01D’où vient le refus d’étiquette
- 02Mondial Relay PrestaShop : quels identifiants servent à créer les étiquettes
- 03Colissimo PrestaShop : la clé de connexion remplace le mot de passe
- 04Version du module et PHP, quand la mise à jour bloque
- 058 vérifications avant le Black Friday
- 06Questions fréquentes
- 07Étiquettes bloquées, décrivez-nous la panne
D’où vient le refus d’étiquette
Le message du module se lit avant de toucher au moindre réglage. Dans Mondial Relay, ouvrez l’onglet « Historique des étiquettes », puis « Logs d’Activité » : la réponse du transporteur y figure, commande par commande. Le module Colissimo a son propre écran Logs, qui garde le code d’erreur renvoyé.
Notez ce message mot pour mot. Une copie d’écran suffit. Il range presque toujours la panne dans l’une de ces familles :
- Identifiants refusés : chez Mondial Relay, clés API2 absentes ou fausses (4.x) ou code enseigne et clé privée (ancienne 3.x) ; chez Colissimo, identifiant et mot de passe Colissimo bloqués ou à remplacer par une clé de connexion.
- Données de la commande : poids nul ou dans la mauvaise unité, adresse trop longue, téléphone mal formaté, pays ou point relais non desservi.
- Module ou PHP : version qui ne correspond pas à la boutique, mise à jour dont les migrations n’ont jamais été jouées.
Un refus qui touche toutes les commandes oriente vers les identifiants ou le module. Quand une seule commande bloque, cherchez d’abord dans ses données : adresse, poids, numéro de téléphone.
Le transporteur a disparu du tunnel de commande et le client lit « Aucun transporteur ne peut être appliqué » ? C’est un autre symptôme, traité dans notre guide Aucun transporteur ne peut être appliqué. Ici, la commande passe normalement et seule l’étiquette échoue.
L’arbre ci-dessous résume ce tri, du message du module à la piste à vérifier.
Share this infographic: Copy the code below to embed it on your site.
<a href="https://cyberial.fr/etiquettes-mondial-relay-colissimo-prestashop/"><img src="https://cyberial.fr/wp-content/uploads/arbre-etiquette-refusee-mondial-relay-colissimo.png.webp" alt="Arbre de décision pour une étiquette Mondial Relay ou Colissimo refusée dans PrestaShop : message d'accès refusé, vérifier les identifiants (API2 en 4.x, WebService SOAP en 3.x, clé de connexion Colissimo) ; donnée refusée, vérifier poids, adresse, téléphone, pays ; erreur technique, vérifier version du module, PHP, mise à jour à moitié faite." /></a><p>Infographic by <a href="https://cyberial.fr">cyberial.fr</a></p>Nous corrigeons le réglage ou le module en cause : dépannage PrestaShop dès 150 € HT, recherche de la cause comprise, prix fixe validé avant toute intervention. Ces 150 € sont déduits si vous passez ensuite à la maintenance.
Nous décrire la panne ou 09 72 03 59 17, réponse en moins d’une heure, 7j/7, de 8 h à 22 h.
Mondial Relay PrestaShop : quels identifiants servent à créer les étiquettes
Côté Mondial Relay, le marchand manipule deux sortes d’accès. Il y a son compte sur le site et l’appli, et il y a les identifiants que le module envoie à l’API pour chaque étiquette. La bascule de mai touche le premier. Rien de publié ne dit qu’elle touche le second.
Compte InPost du 18 mai 2026, ce qui change et ce qui reste
Mondial Relay appartient à InPost depuis le 2 juillet 2021. Les conditions d’utilisation du compte InPost en vigueur au 18 mai 2026 s’appliquent, en France, aux utilisateurs du site et de l’application Mondial Relay. C’est ce changement qu’on appelle la bascule Mondial Relay InPost.
Ce qui change :
- la connexion au site et à l’appli Mondial Relay passe par le compte InPost ;
- ce compte suit les conditions d’utilisation d’InPost.
Ce qui reste, à la date où nous écrivons :
- le code enseigne (8 caractères), le code marque et la clé privée saisis dans le module ;
- les identifiants API2, pour un module en 4.x ;
- aucune source officielle n’annonce de changement ni de coupure de ces identifiants.
Si vos étiquettes ont cassé après mai, laissez le mot de passe du site de côté et lancez d’abord le test de connexion du module.
Identifiants API2 dans Connect et test de connexion
Mondial Relay expose deux API. L’API1, en SOAP, cherche les points relais et suit les colis. L’API2, en REST, crée les expéditions et les étiquettes ; ses paramètres de sécurité sont à part, dans l’extranet Mondial Relay Connect (présentation officielle des WebServices, avril 2025).
La 4.x crée l’étiquette par l’API2. Dans la 3.4.0, le guide officiel mentionnait déjà le réglage « API Version V2.0 » dans Connect, sans le rendre obligatoire. Une ancienne 3.x, comme la 3.1.1 que nous avons relevée, passe encore par le WebService SOAP historique avec le code enseigne et la clé privée. Selon la version installée, vous ne vérifiez donc pas les mêmes identifiants.
En 4.x, la configuration du module Mondial Relay PrestaShop garde le code enseigne, le code marque et la clé privée, utilisés pour les points relais et le test de connexion. Elle ajoute ces champs, à recopier depuis Mondial Relay Connect sans espace parasite :
- « Identifiant API 2 » ;
- « Mot de passe API 2 » ;
- « Brand Id API 2 ».
Enregistrez, puis cliquez sur le bouton de test de connexion. En cas d’échec, cherchez dans ces valeurs ou dans votre contrat. Si le test passe et que l’étiquette reste refusée malgré tout, le problème se trouve dans les données du colis.
Poids, adresse, téléphone et point relais
Connexion validée, étiquette toujours refusée : regardez ces causes courantes d’un refus.
- Unité de poids : le module travaille en grammes ou en kilos, et ce réglage doit correspondre à celui des produits. Un 0,5 lu en grammes donne un colis sans poids réel.
- Poids vide sur la fiche produit, donc colis à zéro.
- Ligne d’adresse de plus de 32 caractères.
- Téléphone mal formaté.
- Point relais fermé ou retiré depuis la commande.
- Mode de livraison non prévu à votre contrat, ou multi-colis hors de France.
- Caractères spéciaux comme # ou / dans l’adresse.
Corrigez l’adresse ou le poids, puis relancez la génération depuis l’onglet « Générer des étiquettes » du module.
Colissimo PrestaShop : la clé de connexion remplace le mot de passe
Chez Colissimo, l’échéance est annoncée. Le transporteur supprime « courant 2026 » la connexion par identifiant et mot de passe, au profit de la clé de connexion, comme il l’écrit dans ses extensions officielles. Au 1er novembre 2026, aucune date de coupure n’est publiée, et elle peut tomber en plein pic de commandes.
Une boutique Colissimo PrestaShop encore réglée sur l’identifiant et le mot de passe perdra ses étiquettes ce jour-là. Le module officiel propose déjà la clé de connexion à partir de la version 2.2.3.
Générer la clé dans la Colissimo Box
- Connectez-vous à la Colissimo Box avec votre compte entreprise.
- Ouvrez l’édition du compte, rubrique « Gestion des utilisateurs », et générez la clé de connexion.
- Dans PrestaShop, ouvrez la configuration du module Colissimo, choisissez la clé de connexion et collez-la à côté de votre numéro de compte.
- Enregistrez, puis générez une étiquette test sur une vraie commande.
Le champ « Clé de connexion » apparaît avec la version 2.2.3 du module Colissimo PrestaShop : absent en 2.0.0 et 2.1.0, présent en 2.2.5 et en 3.0.3 sur les copies que nous avons relevées. Avant la 2.2.3, mettez d’abord le module à jour, sur une copie de la boutique.
Sur une boutique encore en PrestaShop 1.6, la marge est plus étroite, car les versions 2.x du module demandent la 1.7 au minimum. Regardez si le champ existe dans votre configuration. S’il manque, la clé ne pourra pas être saisie et la sortie durable passe par une migration PrestaShop : 469 € HT pour une migration standard de 1.6 vers 8, selon l’accès à votre hébergement actuel.
Codes d’erreur fréquents et où les corriger
Le code s’affiche en tête du message, dans l’écran Logs du module. Ci-dessous, les codes renvoyés par Colissimo que l’on croise le plus.
| Code | Cause | Où corriger |
|---|---|---|
| 30013 | Identifiant ou mot de passe refusé, compte verrouillé après trop d’essais | Module : passer en clé de connexion |
| 30011 | Compte bloqué | Votre interlocuteur Colissimo |
| 30047 | Téléphone de l’expéditeur invalide | Adresse expéditeur du module |
| 30221 | Portable du destinataire absent ou invalide | Adresse de la commande |
| 30301 | Poids incorrect | Poids des produits |
| 30312 | Option demandée (signature) non autorisée | Transporteur choisi, contrat |
| 30123 | Pays ou code postal du destinataire incorrect | Adresse de la commande |
Un 30013 qui revient à chaque envoi vise les identifiants. Plutôt que de retaper le mot de passe, passez à la clé de connexion : Colissimo annonce la fin de l’ancien mode de connexion courant 2026.
Outre-mer et CN23
Vers l’outre-mer et hors de l’Union européenne, le colis part avec une déclaration douanière CN23, que le module Colissimo sait produire. Chaque article doit alors porter un code SH, le numéro de nomenclature douanière ; un code SH manquant ou faux renvoie l’erreur 30519. Le 30123 se rencontre aussi outre-mer. Un cas a été relevé en Martinique : vérifiez que le pays et le code postal de l’adresse vont ensemble.
Version du module et PHP, quand la mise à jour bloque
Reste le module lui-même. Lancée en novembre pour réparer les étiquettes, une mise à jour peut couper toute la livraison si elle ne correspond pas à la version de PrestaShop ou de PHP du serveur. Les modules officiels déclarent ces minimums.
| Module | Version | PrestaShop minimum | PHP minimum |
|---|---|---|---|
| Mondial Relay | 3.1.1 | 1.6.1 | non déclaré |
| Mondial Relay | 4.3.x | 8.0.0 (jusqu’à 9.x) | 8.0 |
| Colissimo | 2.2.5 | 1.7 | non déclaré |
| Colissimo | 3.0.3 | 9.0.1 | non déclaré |
Une boutique en PrestaShop 1.7, ou sur un serveur en PHP 7.4, ne peut donc pas passer Mondial Relay en 4.x. Lors d’une de nos montées, la version 4.2 a mis un site en erreur 500 tant que PHP restait en 7.4. Avant d’y toucher, vérifiez la version de PHP de votre serveur : notre guide quelle version de PHP pour PrestaShop donne les correspondances.
L’autre piège est la mise à jour à moitié faite : fichiers neufs en place, migrations du module jamais jouées. Le module affiche sa nouvelle version, sa configuration ne suit pas, et une migration ratée peut même désactiver le transporteur, qui disparaît du tunnel. Nous avons déjà dû finir des mises à jour de ce type sur Mondial Relay comme sur Colissimo.
En novembre, une mise à jour de module transporteur se fait sur une copie de la boutique, puis en production une fois l’étiquette test sortie. La méthode complète est dans notre guide pour mettre à jour un module PrestaShop sans casse.
8 vérifications avant le Black Friday
Le Black Friday tombe le 27 novembre 2026. Faites ces contrôles dans l’ordre, un jour calme, et notez ce que vous trouvez.
- Test de connexion des deux modules, depuis leur page de configuration.
- Colissimo : clé de connexion saisie, module en 2.2.3 au moins.
- Mondial Relay : unité de poids du module identique à celle des produits.
- Poids renseigné sur chaque produit expédié.
- Une étiquette test sur une vraie commande, pour Mondial Relay, pour Colissimo et pour chaque mode de livraison proposé.
- Tâche planifiée Mondial Relay active : le guide officiel conseille une exécution par jour, entre 4 h et 5 h.
- Versions du module, de PrestaShop et de PHP notées, avec la date du relevé.
- Un contact de secours joignable pendant le pic, si les étiquettes tombent un vendredi soir.
D’ici le 27, évitez toute mise à jour de module de livraison qui n’a pas été testée sur une copie. Avec notre maintenance PrestaShop, les mises à jour des modules sont incluses, et nous ne changeons pas un module d’expédition sans votre accord.
Maintenance 69 € HT/mois, sans engagement : audit complet offert au démarrage, mises à jour des modules incluses, testées d’abord sur une copie isolée si la boutique est hébergée chez nous.
Questions fréquentes
Mon compte InPost change-t-il mes identifiants Mondial Relay Connect ?
À la date où nous écrivons, aucune source officielle ne le dit. La bascule Mondial Relay InPost du 18 mai 2026 concerne le site et l’appli. Les identifiants API2 du module se vérifient dans Mondial Relay Connect, puis par le test de connexion.
Le module Mondial Relay fonctionne-t-il sur PrestaShop 9 ?
Oui en 4.3.x : le module Mondial Relay PrestaShop accepte alors PrestaShop 8.0.0 à 9.x et demande PHP 8. Avant de passer en 9, lisez notre point sur PrestaShop 9.
Le module Colissimo fonctionne-t-il sur PrestaShop 9 ?
Oui en 3.x, branche prévue pour PrestaShop 9 : la 3.0.3 demande la 9.0.1 au minimum et gère la clé de connexion.
Où trouver la clé de connexion Colissimo ?
Dans la Colissimo Box : édition du compte, rubrique « Gestion des utilisateurs ». Collez-la dans le module, avec votre numéro de compte, et ne l’envoyez à personne.
Pourquoi le site passe-t-il en erreur 500 après la mise à jour de Mondial Relay ?
La 4.x exige PHP 8 ; sur un serveur resté en 7.4, elle provoque une erreur fatale, donc une page 500. Restaurez la sauvegarde d’avant la mise à jour, puis préparez PHP 8 sur une copie.
Combien coûte un dépannage des étiquettes ?
Chez CYBERIAL, dès 150 € HT, recherche de la cause comprise, prix fixe validé avant toute intervention. Ces 150 € sont déduits si vous passez ensuite à la maintenance.
Étiquettes bloquées, décrivez-nous la panne
Dépannage PrestaShop : envoyez le message du module Mondial Relay PrestaShop ou Colissimo et votre version, sans mot de passe, clé ni identifiant, et dites si la maintenance vous intéresse. Rappel 7j/7, de 8 h à 22 h, au 09 72 03 59 17.
