Transport

Sur l’onglet Transport, vous configurez le délai d’expédition, les frais de port pour l’export des offres, le transporteur PrestaShop utilisé par défaut, le mapping des transporteurs Mirakl vers PrestaShop à l’import des commandes, et (en option) les points relais Mondial Relay.

Configurez les champs de haut en bas.

Une configuration par marketplace : Multi-marketplace.

Étape 1 — Shipping Delay

Champ Delivery time.

Saisissez le délai d’expédition habituel en jours (ex. 1 ou 2).

Cette valeur est envoyée avec vos offres à Mirakl (délai avant envoi du colis).

Vous pouvez toujours définir un délai différent par profil (Delay Preparing) ou par produit (Shipping Delay Override sur l’onglet Mirakl de la fiche produit).

Étape 2 — Shipping Fees

Champ Additional.

Saisissez un pourcentage de frais de port supplémentaires (ex. 0 ou 10).

Ce % s’ajoute au montant de port calculé à partir du transporteur Standard (étape 3) lors de l’export des offres.

• Exemple : si la grille du transporteur donne 5 € de port et que Additional vaut 10, le module envoie environ 5,50 € de frais de port sur l’offre.
• Laissez 0 si vous ne voulez aucun % supplémentaire.

Étape 3 — Carriers → Standard

Choisissez un transporteur PrestaShop (ex. DPD, Colissimo…).

Le module utilise la grille de frais de port de ce transporteur pour calculer le shipping à l’export des offres.

C’est aussi le transporteur PrestaShop par défaut sur les commandes Mirakl importées, sauf si un mapping plus précis est défini à l’étape 5.

Étape 4 — Mondial Relay integration (optionnel)

Section : Pickup Point Integrations → Mondial Relay integration.

Quand l’activer

Cochez uniquement si :

1. Les clients peuvent choisir un point relais Mondial Relay / PUDO / locker sur votre marketplace Mirakl, et
2. Vous avez un module Mondial Relay PrestaShop installé et activé, par exemple :
3. • mondialrelay
   • mondialrelayadvanced
   • mondialrelayinpost (Mondial Relay – InPost)

Si vous n’expédiez pas en points relais Mondial Relay, laissez la case décochée (valeur par défaut).

Ce que cela fait

Lorsque l’option est activée, pour les commandes Mirakl qui incluent un relais / PUDO (identifiant de point relais) :

1. Le module Mirakl importe la commande dans PrestaShop comme d’habitude.
2. Il copie le relais sélectionné (ID du point + adresse provenant de Mirakl) dans les tables du module Mondial Relay.
3. La commande peut alors apparaître dans le back-office Mondial Relay (ex. Generating Labels / génération d’étiquettes) pour imprimer les étiquettes.

Sans cette option, la commande peut quand même s’importer, mais le point relais peut être manquant dans Mondial Relay → les étiquettes échouent souvent, ou la commande n’apparaît pas dans « Generating Labels ».

Ce qu’il faut aussi configurer

• Mapper les modes de livraison Mondial Relay / PUDO Mirakl vers le bon transporteur PrestaShop Mondial Relay dans Incoming order - carrier mapping (étape 5).
• Garder le module Mondial Relay configuré (API / compte / règles de poids) selon sa propre documentation.
• Après un changement de marketplace ou de transporteurs, utilisez Verify connection (onglet Authentification) pour mettre à jour la liste des transporteurs Mirakl.

Outils Mondial Relay (affichés quand l’intégration est activée)

Après avoir activé l’intégration et cliqué sur Enregistrer, un bloc Mondial Relay tools peut apparaître. Ce sont des URL de réparation manuelle (à ouvrir dans le navigateur). Elles ne sont pas destinées au crontab.

Elles nécessitent le Instant token du module (MIRAKL_INSTANT_TOKEN) lorsque votre boutique l’exige (souvent sur PrestaShop 1.7 ; sur PS 8+, le token peut être optionnel selon la configuration).

Une commande est considérée comme en échec (pour ces outils) lorsque, en gros :

• la commande est liée dans les commandes marketplace Mirakl, et
• le transporteur d’expédition est un transporteur du module Mondial Relay, et
• la ligne « selected relay » Mondial Relay est absente ou le numéro de relais est vide.

Sécurité : ne passez pas des IDs de commande Mirakl et des IDs PrestaShop dans la même requête.

Si le module Mondial Relay n’est pas installé ou pas activé, les outils affichent un avertissement et restent désactivés.

Il peut aussi y avoir un sélecteur de réparation dans la zone Orders / Commandes du module pour les commandes Mirakl en échec (sélectionner des commandes ou « toutes les commandes en échec »).

Checklist typique Mondial Relay

1. Installer / activer le module Mondial Relay (ou InPost) et le configurer.
2. Dans Transport, activer Mondial Relay integration → Enregistrer.
3. Mapper les transporteurs pickup Mirakl → transporteur PrestaShop Mondial Relay (étape 5).
4. Importer une commande relais de test → vérifier Mondial Relay Generating Labels.
5. Si le relais manque, utiliser un outil Repair, puis réessayer l’étiquette.

Étape 5 — Incoming order - carrier mapping

Liez :

transporteur / mode de livraison Mirakl → transporteur PrestaShop

Exemple : Mirakl « Standard » → PrestaShop « DPD » ; Mirakl « Mondial Relay » → votre transporteur PrestaShop Mondial Relay.

Avant de mapper, utilisez le lien Verify connection to update the list of Mirakl carriers (onglet Authentification) pour rafraîchir la liste Mirakl.

Cliquez sur +, choisissez le transporteur Mirakl à gauche et le transporteur PrestaShop à droite. Ajoutez une ligne par mode de livraison Mirakl utilisé.

Sans mapping, l’import des commandes échoue souvent avec un message demandant de configurer Transport → Carrier Mapping.

Étape 6 — Resolve Unmapped Carrier

Si une commande arrive avec un transporteur Mirakl absent du mapping ci-dessus :

• case désactivée → l’import peut échouer avec une erreur ;
• case activée → choisissez ensuite :
• • Use default carrier — un transporteur PrestaShop de secours pour tous les cas non mappés, ou
  • Auto create carrier — PrestaShop crée un nouveau transporteur à partir du nom du transporteur Mirakl.

Préférez un mapping complet (étape 5). Utilisez cette option seulement comme filet de sécurité.

Étape 7 — Carrier Code Mapping

Pour chaque transporteur PrestaShop, vous pouvez saisir le code transporteur Mirakl de la marketplace.

• Avec code → lors de l’expédition, le suivi part vers Mirakl avec ce code officiel.
• Sans code → le module envoie le nom du transporteur PrestaShop + l’URL de suivi.

Vérifiez aussi l’URL de suivi dans Livraison → Transporteurs (@ = numéro de colis).

Demandez les codes officiels à votre opérateur Mirakl en cas de doute.

Étape 8 — Enregistrer

Cliquez sur Enregistrer / Valider en bas de l’onglet (ou de la page du module). Rien n’est conservé tant que vous n’avez pas enregistré.

Erreurs fréquentes

• Utiliser Additional % en pensant majorer les prix produits → utilisez plutôt Profiles / Profils Price Rule (voir la doc Profils FR si publiée sous un autre slug).
• Activer Mondial Relay sans avoir installé le module Mondial Relay.
• Activer Mondial Relay sans mapper les transporteurs PUDO Mirakl à l’étape 5.
• Oublier Verify connection → les transporteurs Mirakl n’apparaissent pas dans la liste de mapping.
• Carrier Code Mapping incomplet → les mises à jour de suivi échouent ou utilisent un mauvais libellé sur Mirakl.

Suite

Commandes, Export Offres, Tâches Planifiées, Obtenir les clés API de Mirakl.

Mis à jour le : 16/10/2026