> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Transport ![Prestashop Mirakl configurer transport](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-mirakl-configurer-t_16lojyw.jpg) 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](https://doc.common-services.com/fr/article/multi-marketplace-mogx70/). --- ### É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 : * `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). | Outil | Quand l’utiliser | | ---- | ---- | | **Repair Mondial Relay all the failed orders** | Resynchroniser **toutes** les commandes Mirakl importées détectées comme en échec. | | **Repair by PrestaShop order ID(s)** | Corriger une ou plusieurs commandes PS (ex. `326358` ou `326358,326359`). | | **Repair by Mirakl order ID(s)** | Corriger via l’id Mirakl (ex. `1000182751-A`) ; l’outil trouve les commandes PrestaShop liées puis les répare. | 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](https://doc.common-services.com/fr/article/profiles-16bb40d/) / [Profils](https://doc.common-services.com/fr/article/profiles-16bb40d/) **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](https://doc.common-services.com/fr/article/commandes-1saee4g/), [Export Offres](https://doc.common-services.com/fr/article/export-offres-4vwyll/), [Tâches Planifiées](https://doc.common-services.com/fr/article/taches-planifiees-etwsoi/), [Obtenir les clés API de Mirakl](https://doc.common-services.com/fr/article/obtenir-les-cles-api-de-mirakl-1ftl7lx/).