Premiers pas
Accueil
Le module Mirakl Connecteur Multi-Marketplaces pour PrestaShop synchronise votre boutique avec les marketplaces basées sur Mirakl : catalogue / offres, stocks, commandes et suivi d’expédition. Un seul module peut gérer plusieurs marketplaces ; chaque marketplace a sa propre configuration, ses offres et ses commandes. Ce que couvre cette documentation Premiers pas — compatibilité, multi-marketplace, structure du catalogue Configurer — clés API, profils, transport, catégoriesPeu de lecturesPréambule
Compatibilité Le module Mirakl est compatible avec PrestaShop 1.7, 8 et 9. Note : Les anciennes versions PrestaShop 1.4, 1.5 et 1.6 ne sont plus supportées. Côté PHP, le module nécessite PHP 7.1 ou supérieur (PHP 8.x supporté ; PHP 9 non supporté). PHP 7.4 ou supérieur est recommandé. Préconfiguration Par défaut, la configuration convient à la plupart des boutiques. Ne modifiez les réglages avancés que si vous en avez besoin et si vous comprenez leurs conséquences.PopulaireMulti-marketplace
Vous pouvez utiliser un seul module pour gérer de nombreuses marketplaces sur la plateforme Mirakl. Chaque marketplace est indépendante et possède ses propres configurations, offres et commandes. Le module permet de cibler une marketplace précise selon le contexte (configuration, export, import, cron). Ajouter une marketplace supplémentaire Le module inclut une marketplace. Pour en ajouter d’autres, vous devez acheter des licences marketplace sur notre boutique : [Tous nos produits MPopulaireMultiboutique PrestaShop + Mirakl
Deux notions différentes : PrestaShop multiboutique Plusieurs boutiques PrestaShop (groupes / shops). Le contexte BO (boutique sélectionnée en haut) définit quels produits / stocks / commandes le module voit. Note : Configurez et exportez dans le contexte de la boutique PrestaShop concernée. Shop ID Mirakl Identifiant(s) boutique côté Mirakl (onglet Authentification). Plusieurs shop ID sur la même marketplace = virgules dans Shop ID, puis sélecteur à l’export /Peu de lecturesValider votre structure de catalogue
Appliquez toujours la même méthode pour créer vos produits (référence, code EAN, etc.). Votre catalogue sera ainsi cohérent pour PrestaShop et pour les marketplaces Mirakl. Référence = SKU Mirakl Dans tous les cas, le champ Référence PrestaShop est utilisé comme SKU sur Mirakl : c’est votre identifiant interne unique. Ce champ sert à identifier vos offres et à importer les commandes. S’il est vide, mal renseigné ou dupliqué dans le catalogue, l’export et l’import ne fonctionnerPopulaireChecklist première mise en service
Checklist pour une première mise en service Mirakl (PrestaShop). 1. Catalogue PrestaShop Références (SKU) uniques — Structure de catalogue EAN valides Produits actifs, images, stock cohérent 2. Connexion Marketplace sélectionnée — Multi-marketplace API Key + Shop ID — [Clés API](https://doc.commPeu de lectures
Configurer
Obtenir les clés API de Mirakl
Lors de la première utilisation du module, configurez la connexion Mirakl dans l’onglet Authentification (API Key + Shop ID). Chaque marketplace Mirakl nécessite sa propre clé API (et souvent un ou plusieurs shop ID). Voir aussi : Multi-marketplace. Générer / retrouver la clé API La clé API se génère ou se consulte sur Mes paramètres d’utilisateur / Paramètres personnels (clic sur l’identifiant enPopulaireProfils
Les profils (onglet Profiles) complètent le flux d’export. Une catégorie cochée sans profil n’exporte pas ses produits : Catégories. Pour démarrer : créez un profil, enregistrez, puis associez-le aux catégories. Exemple de profil : Créer un profil Marketplace sélectionnée : [Multi-marketplace](https://doc.commonPopulaireCatégories
Onglet Categories : choisissez les catégories PrestaShop à exporter et associez un profil. Une config par marketplace : Multi-marketplace. Étape 1 — Créer un profil Avant de cocher des catégories, créez au moins un profil dans l’onglet [ProfiPopulaireTransport
Onglet Transport du module Mirakl. Configurez chaque champ dans l’ordre de la page, de haut en bas. Une config par marketplace : Multi-marketplace. Note : Les listes déroulantes affichent vos transporteurs PrestaShop (Livraison → Transporteurs), pPopulaireCommandes
Onglet Orders / Commandes du module Mirakl : mapping des statuts PrestaShop ↔ Mirakl. Sélectionnez d’abord la bonne marketplace : Multi-marketplace. Note : Les transporteurs se configurent dans l’onglet [Transport](https://doc.common-services.com/PopulaireParamètres Mirakl
L’onglet Paramètres regroupe les réglages généraux du module pour la marketplace sélectionnée. Dans la plupart des cas, conservez les valeurs par défaut après installation. Sélectionnez d’abord la bonne marketplace : Multi-marketplace. Note : Certaines sections sont rPopulaireFiltres
Onglet Filters / Filtres : export sélectif du catalogue (marques, fournisseurs, prix). Sélectionnez d’abord la bonne marketplace : Multi-marketplace. Les filtres s’ajoutent aux catégories cochées : Catégories.Populaire
Utiliser
Export Offres
Envoi des offres (prix, stock, SKU…) vers Mirakl depuis PrestaShop. Chemin : Catalogue → Mirakl (onglet Update Mode / Mise à jour). Étape 1 — Préparer l’envoi Avant d’exporter, vérifiez : [Valider votre structure de catalogue](https://doc.common-services.com/fr/article/valider-votre-structure-de-catalogue-1hPopulaireCréation de produits Mirakl (Mode Création CSV)
Chemin : Catalogue → Mirakl → onglet Mode Création. Note importante : Le module ne crée pas les fiches produit Mirakl par API. Il génère un fichier CSV à télécharger et à importer dans le back-office Mirakl. Un mapping colonnes CSV ↔ champs Mirakl se fait une fois, puis il est réutilisé. Pour mettre à jour prix / stock sur des offres déjà liées : Export Offres (Update Mode). Étape 1 — PréparerPeu de lecturesImport des Commandes
Import des commandes Mirakl dans PrestaShop. Chemin : Commandes → Mirakl (onglet Import Orders). Étape 1 — Préparer API Key + Shop ID OK : Obtenir les clés API de Mirakl. Statuts configurés : Commandes. Transporteurs / mapping : Transport. SKU cohérentPopulaireFiche Produit
Sur chaque fiche produit PrestaShop, un onglet Mirakl permet des réglages optionnels pour l’export (par produit, et par marketplace si plusieurs). Ces valeurs priorisent souvent le profil / les paramètres globaux pour ce produit uniquement. Étape 1 — Ouvrir l’onglet Mirakl Allez sur un produit (**CataloguPopulaireTâches Planifiées
Onglet Cron / Tâches planifiées : URLs à appeler automatiquement pour synchroniser offres et commandes avec Mirakl. Une config (et des URLs) par marketplace : Multi-marketplace. Note : La crontab doit être mise en place par un webmaster / hébergeur. LPopulaireWorkflow complet : offre → commande → expédition
Enchaînement type une fois le module configuré. 1. Offres sur Mirakl (Optionnel) Mode Création → CSV → import fiches dans Mirakl Export Offres → prix / stock / SKU Vérifier le rapport Mirakl Automatiser : cron Offers Update — Tâches Planifiées.Peu de lecturesMise à jour des stocks seulement (Offers Update Lite)
Cron / URL Offers Update Lite : envoie surtout SKU + quantité (version légère), plus rapide qu’un Offers Update complet. Affichée dans l’onglet Tâches Planifiées (Manual Cron URLs). Quand l’utiliser Mises à jour fréquentes de stock Catalogue déjà créé / offres déjà présentes Prix et attributs stables Quand ne pas l’utiliser seule Premier envoi d’offres Changement de prix / règles profil BesPeu de lecturesAnnulations Mirakl → PrestaShop
Quand une commande passe annulée / fermée côté Mirakl, le module peut appliquer le statut annulé PrestaShop. Configuration Onglet Commandes : Choose a default canceled order status → statut PS (ex. Annulé) Mirakl States (multi) : CANCELED, CLOSED, REFUSED, INCIDENT_CLOSED Lookback days (ex. 5) — fenêtre de recherche Cron URL Sync Canceled Orders — [Tâches Planifiées](https://docPeu de lecturesRevert Mirakl import (réimporter une commande)
Outil dans l’onglet Commandes : Revert Mirakl import. Supprime la commande PrestaShop importée via Mirakl (et les liens) pour pouvoir réimporter la même commande Mirakl. Note : Irréversible côté PrestaShop pour les commandes éligibles. Dépannage uniquement. URLs par ID PrestaShop (ps_order_id) par ID Mirakl (mp_order_id) Après le revert [Import des Commandes](https://doc.common-servicesPeu de lecturesFactures / documents Mirakl sur la commande
Sur une commande importée, le bloc Mirakl de la fiche commande PrestaShop affiche notamment : Order ID — lien vers la commande Mirakl Documents → Delivery slip (bon de livraison / document Mirakl via le module) Relay ID si point relais champs additionnels / Latest Ship Date si présents Télécharger le delivery slip Ouvrir la commande PrestaShop Section Mirakl → lien Delivery slip Le module appelle l’API documents (token / marketplace de la commande)Peu de lectures
Support
Contact
Support Common-Services — module Mirakl (PrestaShop) Avant de contacter le support, lisez la documentation, surtout les problèmes fréquents. La plupart des cas sont déjà documentés. Vous pouvez nous contacter par e-mail ou par chat en bas à droite. E-mail : [support.mirakl@common-services.com](mailto:support.mirakl@common-servicesPopulaireLimites & Garanties
Cette page précise ce que le support et la garantie couvrent — et ce qu’ils ne couvrent pas. Pour contacter le support (éligibilité, horaires, e-mail / chat) : Contact. Limites du support Le support ne couvre pas : le paramétrage lié au volume de la boutique (nombre de produits, images, catégories, etc.) ; les mises à jour de version PrestaShop ; un changement de serveur, d’hébergeur ou de vePopulaire
Problèmes Fréquents
Erreurs d’import de commandes (liste)
Messages fréquents à l’import / acceptation. Textes issus du module (FR). SKU / produit introuvable Messages : Impossible de récupérer le SKU pour cette commande Impossible de trouver la référence pour ce produit Impossible de trouver ce produit Impossible de récupérer le SKU pour cette commande / ce produit Causes SKU Mirakl ≠ Référence PrestaShop Produit / déclinaison absent, désPeu de lecturesSynchro expédition / tracking refusée
Vous passez la commande en Expédié dans PrestaShop avec un numéro de suivi, mais Mirakl ne passe pas à Envoyé (ou l’API refuse). Checklist Commandes — bon statut sent / expédié Numéro de suivi renseigné Transport — Carrier Code Mapping = code officiel marketplace Transporteur accepté par la marketplace (sinon refus type « alternPeu de lecturesProblème de permissions, droits en écriture
Messages possibles (textes du module) : Le répertoire export n'est pas accessible en écriture, veuillez corriger les permissions Vous devez mettre les droits en écriture sur le répertoire …/modules/mirakl/export et tous ses fichiers Impossible de créer le répertoire Cause fréquente : PHP n’a pas le droit d’écrire dans : modules/mirakl/export Étape 1 — Se connecter au serveur Client FTP / SFTP (ex. FileZilla) ou gestionnaire de fichiers hébergeur → …/modules/mirakl/ ![PopulaireL’execution du script AJAX a échoué / Une erreur serveur est intervenue
Lors d’un export / action catalogue, le module peut afficher : Une erreur serveur est intervenue. Veuillez contacter votre administrateur système Sur import / acceptation de commandes, l’interface peut aussi indiquer simplement : AJAX Error. Étape 1 — Même URL que PrestaShop Cause fréquente : BO ouvert avec une URL différente du domaine boutique (www / sans www, http / https). Exemple : vous ouvrez http://maboutique.com/admin PrestaShop est sur `http://www.maboutPopulaireInformations – Erreurs Courrantes
L’onglet Informations du module Mirakl vérifie PHP et PrestaShop. Les alertes rouges bloquent souvent le fonctionnement ; les jaunes sont des recommandations. Si un message n’est pas listé ici : Contact. Prérequis PHP (bloquant) cURL manquant Message : PHP cURL doit être installé sur votre serveur. Ce module nécessite la librairie cURL et ne peut fonctionner sans. Pourquoi : le module appelle l’APopulaireCode EAN manquant
À l’export, vous obtenez un message du type : Le code EAN est manquant, Références: [SKU1, SKU2] ou, si le produit n’a pas de référence : Le code EAN est manquant, Références: [#123] Le module a ignoré le produit (ou la déclinaison) parce que le code EAN n’est pas renseigné. En mode Matching, le message peut être :PopulaireCodes EAN en double pour les produits
À l’export, message du module : Codes EAN en double pour les produits, Références: [SKU1, SKU2] Le même EAN est utilisé sur plusieurs produits ou déclinaisons. Le module refuse l’export (sauf si « Allow to export duplicate EAN » est activé — déconseillé). Étape 1 — Comprendre le doublon Chaque produit / déclinaisPopulaireCode EAN incorrect pour les produits…
À l’export, message du module : Code EAN incorrect pour les produits, Identifiants Produits: [12/0, 45/3] Les nombres sont des ID produit PrestaShop (et éventuellement ID déclinaison : id_product/id_product_attribute). Pourquoi ce message Le module vérifie la clé de contrôle de l’EAN/UPC (algorithme type GS1). L’EAN est rejeté s’il : n’est pas numérique ; a moins de 12 chiffres ; a une clé de vérification invalide. Les marketplaces attendent des codPopulaireRéférence en double pour ces produits
À l’export, message du module : Référence en double pour ces produits, Identifiants Produits: [12, 45/3] Les nombres sont des ID produit PrestaShop (et éventuellement id_product/id_product_attribute pour une déclinaison). La référence (SKU) PrestaShop sert d’identifiant d’offre Mirakl. Elle doit être unique pour chaque produit / déclinaison. Étape 1 — Comprendre le doublon La même référence apparaît sur au moins deux lignes du catalogue (souvent après le générateurPopulaireProduits ayant une référence manquante
À l’export, message du module : Produits ayant une référence manquante, Identifiants Produits: [12, 45/3] Les nombres sont des ID produit PrestaShop (et éventuellement id_product/id_product_attribute). Sans référence, le module ne peut pas construire le SKU Mirakl : le produit est ignoré. Étape 1 — Ouvrir le produit Cherchez l’ID dans Catalogue → Produits. . En général une erreur PHP est masquée. Il faut l’afficher pour la corriger ou l’envoyer au support. Étape 1 — Activer le mode debug (temporairement) Via le back-office (si accessible) : Paramètres avancés → Performances → Mode debug → Oui → Enregistrer. Via FTP si le BO est inacPopulaireProblème d'exportation : Un produit n'apparaît pas dans le flux
Un produit (ou toute une catégorie) est censé être exporté, mais il n’apparaît pas dans le flux / sur Mirakl. Vérifiez dans l’ordre ci-dessous. Étape 1 — Catégories + profil Module → Catégories : La catégorie du produit est cochée. Un profil est choisi à droite (Profiles Mapping). Sans profil → pas d’export. Selon Paramètres → *Peu de lectures