Table of Contents
Dernière mise à jour : juin 2026
Version du plugin : 5.0.0
Prérequis : WordPress 5.6+ | WooCommerce 3.0+ | PHP 8.3+
Vue d’ensemble
Le connecteur Mirakl pour WooCommerce Pro fait le pont entre votre boutique WooCommerce et l’écosystème de places de marché Mirakl. Il vous permet de gérer les produits, les stocks, les prix, les commandes et l’expédition sur plusieurs places de marché alimentées par Mirakl — Carrefour, Decathlon, Best Buy, et plus de 400 autres — directement depuis votre tableau de bord WordPress.
Contrairement aux plugins génériques pour places de marché, ce connecteur est conçu pour l’architecture Mirakl MMP (Marketplace Platform) et prend en charge le mirakl/sdk-php-shop officiel avec une couche de transport HTTP native pour WordPress. Il gère l’ensemble du cycle de vie : exportation du catalogue produits, synchronisation des stocks en temps réel, importation automatisée des commandes, génération des bons de livraison et intégration des transporteurs.
Qu’est-ce que Mirakl ?
Mirakl est la principale plateforme de places de marché pour les entreprises, alimentant plus de 400 places de marché dans le monde. Les vendeurs qui s’intègrent à Mirakl peuvent atteindre des millions d’acheteurs sur plusieurs canaux grâce à une seule intégration technique. Le connecteur Mirakl pour WooCommerce Pro rend cette intégration native dans votre boutique WooCommerce.
À qui s’adresse ce produit ?
- Les propriétaires de boutiques WooCommerce vendant sur Carrefour, Decathlon, Best Buy ou d’autres places de marché alimentées par Mirakl
- Les responsables e-commerce gérant plusieurs canaux de places de marché depuis un seul backend WooCommerce
- Les développeurs créant des flux de synchronisation automatisés entre WooCommerce et Mirakl
- Les agences gérant des intégrations de places de marché pour des clients WooCommerce
Principales fonctionnalités
| Fonctionnalité | Description |
|---|---|
| Prise en charge multi-boutiques | Connectez plusieurs boutiques Mirakl à une seule instance WooCommerce |
| Exportation des produits | Envoyez les produits, catégories, marques et données GTIN vers Mirakl |
| Synchronisation des stocks | Synchronisation des niveaux de stock en temps réel et via cron |
| Synchronisation des prix | Mises à jour groupées des prix via l’API d’importation PRI01 de Mirakl |
| Importation des commandes | Création automatique des commandes à partir des ventes sur les places de marché Mirakl |
| Bons de livraison | Générateur de PDF intégré (Dompdf, sans API externe) |
| Gestion des remboursements | Traitement des remboursements des places de marché depuis WooCommerce |
| Gestion des transporteurs | Synchronisation des codes transporteurs et des URL de suivi depuis Mirakl |
| Mappage des attributs | Interface visuelle pour mapper les attributs WooCommerce aux attributs de produit Mirakl |
| Mappage des valeurs | Mappage des valeurs de produit WooCommerce aux listes de valeurs Mirakl |
| Paramètres régionaux par boutique | Étiquettes d’attributs et listes de valeurs spécifiques à la langue pour chaque place de marché |
| Automatisation par cron | Intervalles de synchronisation configurables (5, 10, 15, 30 min, toutes les heures) |
| Suppression des e-mails | Empêche les doublons d’e-mails clients pour les commandes des places de marché |
| Historique et journaux de synchronisation | Traçabilité complète de toutes les opérations de synchronisation |
| Tableau de bord de santé | Vérifications de la connectivité API et outils de diagnostic |
Comment ça fonctionne
Le connecteur fonctionne comme un moteur de synchronisation bidirectionnelle entre votre boutique WooCommerce et la plateforme MMP de Mirakl :
┌─────────────────────┐ API Mirakl MMP ┌─────────────────────┐
│ │ ──────── Produits ──────────▶ │ │
│ │ ──────── Stocks ────────────▶ │ │
│ Boutique │ ──────── Prix ──────────────▶ │ Mirakl │
│ WooCommerce │ ◀──────── Commandes ────────── │ Place de │
│ │ ◀─────── Transporteurs ────── │ Marché │
│ │ ◀─────── Remboursements ───── │ (400+) │
│ │ ◀─── Définitions d'attributs ─ │ │
└─────────────────────┘ └─────────────────────┘
│ │
│ ┌─────────────────────────┐ │
└──────────▶│ Panneau d'administration│◀────────────────┘
│ WordPress │
│ • Tableau de bord │
│ • Gestion des commandes │
│ • Interface de mappage │
│ • Paramètres de synchro │
│ • Journaux & historique │
│ • Bons de livraison PDF │
└─────────────────────────┘Toutes les communications passent par le SDK officiel Mirakl (mirakl/sdk-php-shop) en utilisant un gestionnaire HTTP personnalisé pour WordPress — pas de dépendance cURL, pas de bibliothèques HTTP externes. La pile middleware inclut une logique de relance, un suivi de la limitation de débit et une journalisation des requêtes.
Points d’API pris en charge
| Point d’API | Objectif | Direction |
|---|---|---|
| OF24 | Exportation des données produits | Woo → Mirakl |
| ST01 | Mise à jour des stocks | Woo → Mirakl |
| PRI01 | Importation des prix | Woo → Mirakl |
| OR01/OR02 | Récupération des commandes | Mirakl → Woo |
| OR11 | Expédition des commandes vendeur | Woo → Mirakl |
| VL11 | Récupération des listes de valeurs | Mirakl → Woo |
| PM11 | Définitions des attributs de produit | Mirakl → Woo |
| OF21 | Liste des offres (cache SKU) | Mirakl → Woo |
| CA01 | Liste des transporteurs | Mirakl → Woo |
| RE01 | Traitement des remboursements | Woo → Mirakl |
Installation
Prérequis
- WordPress 5.6 ou supérieur
- WooCommerce 3.0 ou supérieur
- PHP 8.3 ou supérieur
- Extensions PHP :
json,mbstring,gd(pour le redimensionnement du logo des bons de livraison),dom(pour la génération des PDF) - Limite mémoire : 512 Mo recommandée (pour la synchronisation des attributs avec de grands catalogues)
Installer le plugin
- Téléchargez le fichier zip du plugin depuis votre fournisseur
- Connectez-vous à votre panneau d’administration WordPress
- Accédez à Extensions → Ajouter → Téléverser une extension
- Choisissez le fichier zip et cliquez sur Installer maintenant
- Cliquez sur Activer
Vérifier l’installation
Après activation, vous verrez un menu Mirakl dans la barre latérale d’administration WordPress avec les sous-menus suivants :
- Tableau de bord — Aperçu et statistiques des boutiques
- Commandes — Gestion des commandes des places de marché
- Remboursements — Traitement des remboursements
- Stocks — Gestion de la synchronisation des stocks
- Prix — Gestion de l’importation des prix
- Exportation des produits — Exportation du catalogue produits
- Transporteurs — Gestion des codes transporteurs
- Boutiques — Configuration des boutiques Mirakl
- Planification de la synchronisation — Configuration des intervalles cron
- Journaux de synchronisation — Historique des opérations
- Santé de l’API — Diagnostics de connectivité
Configuration
Ajouter votre première boutique Mirakl
- Accédez à Mirakl → Boutiques
- Cliquez sur Ajouter une boutique
- Remplissez les champs suivants :
| Champ | Description |
|---|---|
| Nom de la boutique | Un libellé pour cette boutique (ex. “Douglas DE”, “Carrefour FR”) |
| Point d’API | L’URL de base de votre API Mirakl (ex. https://votre-instance.mirakl.net) |
| Clé API | Votre clé API Mirakl |
| ID de boutique | Facultatif — requis pour les points d’API limités aux boutiques |
| Langue de la boutique | Langue pour les étiquettes d’attributs et les listes de valeurs (ex. de_DE, fr_FR) |
Le paramètre Langue de la boutique est important car il contrôle le filtrage spécifique aux paramètres régionaux dans l’interface de mappage des attributs — les valeurs étiquetées pour d’autres paramètres régionaux (ex. [ro_RO]) sont automatiquement masquées.
- Cliquez sur Enregistrer la boutique
- Utilisez le bouton Tester la connexion sur la page des boutiques pour vérifier la connectivité
Configurer les intervalles de synchronisation
Accédez à Mirakl → Planification de la synchronisation pour configurer quand et à quelle fréquence la synchronisation s’exécute :
| Type de synchronisation | Par défaut | Intervalles disponibles |
|---|---|---|
| Commandes | Toutes les heures | 5, 10, 15, 30 min, toutes les heures |
| Stocks | Toutes les heures | 5, 10, 15, 30 min, toutes les heures |
| Prix | Désactivé | 5, 10, 15, 30 min, toutes les heures |
| Produits | Désactivé | 5, 10, 15, 30 min, toutes les heures |
Vous pouvez également déclencher une synchronisation manuelle à tout moment depuis la page Planification de la synchronisation.
Gestion des produits
Exportation des produits
Le système d’exportation des produits envoie vos produits WooCommerce vers les places de marché Mirakl. Seuls les produits publiés et actifs sont exportés.
Comment ça fonctionne :
- Les produits marqués comme actifs pour Mirakl (
_mirakl_activepostmeta) sont inclus dans l’exportation - Les SKU WC sont résolus en SKU de boutique Mirakl via le cache des SKU d’offres (auto-rempli depuis l’API OF21)
- Les données produit incluent : titre, description, prix, stock, images, catégories, marque, GTIN
- Le format d’exportation correspond à l’API d’importation de produits Mirakl (OF24)
Activer les produits pour Mirakl
Vous pouvez contrôler quels produits sont synchronisés avec Mirakl :
- Par produit : Modifier un produit → Onglet Général → cocher “Actif dans Mirakl”
- Modification groupée : Liste des produits → Modification groupée → Définir le statut Actif dans Mirakl
- Actions groupées : Sélectionner des produits → Appliquer l’action groupée “Activer/Désactiver dans Mirakl”
- Modification rapide : Modification rapide depuis la liste des produits
Une colonne Mirakl dans la liste des produits affiche le statut actif/inactif en un coup d’œil.
Champs Marque et GTIN
WooCommerce n’inclut pas les champs de marque et GTIN par défaut. Le plugin ajoute des champs dédiés dans l’onglet Général de chaque produit :
_mirakl_brand— Nom de la marque du produit (correspond à l’attributbrandde Mirakl)_mirakl_gtin— Numéro d’article global (correspond à l’attributgtin/eande Mirakl)
Ces champs apparaissent sous l’onglet Données du produit → Général. Ils sont requis pour la plupart des places de marché Mirakl.
Mappage des catégories
Les produits sont assignés aux catégories Mirakl via la postmeta _mirakl_category_{nom_boutique}. Le connecteur peut importer l’arborescence des catégories de votre canal Mirakl dans WooCommerce, créant une hiérarchie de catégories navigable dans l’interface de mappage des attributs.
Les catégories sont stockées dans la table {$prefix}mirakl_channel_categories avec leur structure hiérarchique (chemins séparés par des pipes comme Parfum | Damendüfte | Deodorants et des clés numériques).
Mappage des attributs
La page de mappage des attributs est une interface AJAX à deux panneaux qui vous permet de mapper visuellement les attributs de produit Mirakl aux sources de données WooCommerce.
Accéder à l’interface de mappage
Accédez à Mirakl → Mappage des attributs (disponible après la synchronisation des données d’attributs).
Première synchronisation
Avant de pouvoir mapper les attributs, vous devez synchroniser les définitions d’attributs Mirakl :
- Sélectionnez une boutique dans le menu déroulant
- Cliquez sur Synchroniser maintenant — cela appelle l’API PM11 de Mirakl pour télécharger tous les attributs de l’opérateur
- L’API VL11 est également appelée pour récupérer les listes de valeurs pour les attributs de type liste déroulante/sélection
- Une fois terminée, l’arborescence des attributs apparaît dans le panneau de gauche
Comment fonctionne le mappage
L’interface comporte deux panneaux :
| Panneau | Contenu |
|---|---|
| Gauche | Arborescence des catégories — parcourez par catégorie de produit Mirakl |
| Droite | Fiches d’attributs — chaque fiche montre un attribut Mirakl, son type, son niveau d’exigence et un sélecteur de source WooCommerce |
Pour mapper un attribut :
- Cliquez sur une catégorie dans l’arbre de gauche — les attributs de cette catégorie se chargent à droite
- Chaque fiche d’attribut possède un menu déroulant pour sélectionner une source WooCommerce :
pa_*— Attributs de produit WooCommerce (taxonomies)__brand__— Champ postmeta de la marque__gtin__— Champ postmeta GTIN__title__— Titre du produit
- Sélectionnez une source — le mappage est automatiquement enregistré via AJAX
- Utilisez le filtre Uniquement les requis pour vous concentrer sur les attributs obligatoires
Attributs auto-mappés
Certains attributs sont mappés automatiquement et masqués dans l’interface :
| Attribut Mirakl | Source WC |
|---|---|
name | Titre du produit |
description | Extrait du produit |
brand | _mirakl_brand |
gtin / ean | _mirakl_gtin |
image1 | Image principale du produit |
variant-group-code | Code du groupe de variantes |
Mappage des valeurs
Pour les attributs avec des listes de valeurs prédéfinies (type LIST, MULTIPLE_VALUES_LIST ou CHECKBOX), vous pouvez mapper les valeurs de produit WooCommerce aux codes de valeur Mirakl :
- Sélectionnez une source WooCommerce pour l’attribut
- Développez la section de mappage des valeurs sous la fiche d’attribut
- Chaque valeur WC de vos produits s’affiche avec un champ pour la valeur Mirakl correspondante
- Tapez pour filtrer depuis la liste des valeurs Mirakl (autocomplétion via datalist)
- Les modifications sont automatiquement enregistrées lors du flou
La grille de mappage des valeurs comprend :
- Bascule “Non mappé uniquement” — concentrez-vous sur les valeurs qui doivent encore être mappées
- Indicateurs d’état — point vert pour les valeurs mappées, retour visuel lors de l’enregistrement
- Filtrage par paramètres régionaux — les listes de valeurs Mirakl sont filtrées pour n’afficher que les entrées correspondant à la langue configurée de la boutique
Synchronisation des stocks
La synchronisation des stocks maintient les niveaux de stock à jour entre WooCommerce et les places de marché Mirakl.
Comment ça fonctionne
- Direction : WooCommerce → Mirakl
- Déclenchement : Basé sur cron (intervalle configurable) ou manuel
- API : ST01 (mise à jour des stocks)
- Périmètre : Uniquement les produits avec
_mirakl_active = yes
La synchronisation lit les quantités de stock depuis WooCommerce et les envoie à Mirakl. Elle respecte les paramètres de gestion des stocks de WooCommerce — les produits avec “Gérer le stock” désactivé peuvent se voir attribuer une valeur d’inventaire maximale (999999).
Stock mis de côté
Vous pouvez mettre de côté une quantité de chaque produit pour les ventes exclusives à WooCommerce. Par exemple, si vous avez 100 unités et que vous en réservez 10 pour votre boutique WooCommerce, seules 90 sont reportées à Mirakl.
Verrouillage de synchronisation
Pour éviter les synchronisations simultanées pour la même boutique et le même type, le plugin utilise Mirakl_Sync_Lock. Chaque synchronisation acquiert un verrou avec un TTL configurable (360 secondes par défaut). Si une synchronisation est déjà en cours, les requêtes suivantes sont ignorées.
Synchronisation des prix
La synchronisation des prix utilise l’API d’importation PRI01 de Mirakl pour les mises à jour groupées des prix.
Comment ça fonctionne
- Le plugin rassemble les produits avec prix (actifs dans Mirakl)
- Soumet un fichier d’importation des prix à l’API PRI01
- Enregistre l’importation dans
{$prefix}mirakl_pricing_importsavec suivi de l’état - Interroge l’état de l’importation jusqu’à son achèvement
- Rapporte les compteurs de succès/échec et des rapports d’erreur détaillés
Sources
| Source | Déclencheur |
|---|---|
cron | Synchronisation automatisée à l’intervalle configuré |
manual | Synchronisation manuelle depuis l’interface d’administration |
Suivi de l’état d’importation
Chaque importation de prix est suivie avec :
- Nombre de lignes, compteurs de succès et d’échec
- Horodatages pour la soumission, l’achèvement et la dernière interrogation
- Nombre d’interrogations (pour surveiller les importations de longue durée)
- Rapport d’erreur détaillé lorsqu’il est disponible
Commandes
Importation automatique des commandes
Les commandes passées sur les places de marché Mirakl sont automatiquement importées dans WooCommerce :
- Récupération : Le cron appelle l’API OR01/OR02 de Mirakl pour récupérer les nouvelles commandes
- Création : Une commande WooCommerce est créée pour chaque commande Mirakl
- Lien : L’ID de la commande Mirakl est stocké dans la postmeta
_mirakl_order_id - Produits : Les lignes de commande incluent les données produit de la commande Mirakl
La fenêtre de récupération des commandes est gérée automatiquement :
- Première exécution : Recherche sur 9 jours
- Exécutions suivantes : À partir du dernier horodatage de récupération réussi
Transitions de statut des commandes
Lorsque vous mettez à jour le statut d’une commande WooCommerce, le connecteur peut refléter ce changement dans Mirakl :
- Terminée → Déclenche la notification d’expédition à Mirakl (appelle
handle_order_shipped()) - Suit le statut dans
{$prefix}mirakl_orders
Actions manuelles sur les commandes
Depuis la page de modification de la commande WooCommerce, vous pouvez effectuer des actions sur la place de marché :
| Action | Description |
|---|---|
| Accepter | Accepter une commande sur la place de marché |
| Refuser | Refuser une commande avec un motif |
| Expédier | Soumettre les informations de suivi |
| Bon de livraison | Générer et télécharger un bon de livraison PDF |
| Remboursement | Traiter un remboursement sur la place de marché |
Ces actions apparaissent dans la metabox “Actions Mirakl” lorsque la commande a une valeur meta _mirakl_order_id.
Suppression des e-mails
WooCommerce envoie automatiquement des e-mails de confirmation de commande. Pour les commandes importées de Mirakl, ces e-mails sont supprimés car la place de marché gère la communication avec les clients. Le plugin s’intègre à quatre déclencheurs d’e-mails WooCommerce :
customer_on_order_receivedcustomer_on_order_completedcustomer_on_order_processingcustomer_on_order_on_hold
Formatage du numéro de commande
Les commandes importées de Mirakl affichent l’ID de commande Mirakl comme numéro de commande, ce qui les rend facilement identifiables dans votre liste de commandes WooCommerce.
Bons de livraison
Le connecteur inclut un générateur de bons de livraison PDF intégré — aucun appel de service externe ou abonnement API requis.
Architecture
- Bibliothèque : Dompdf v3.1 — rend le HTML+CSS directement en PDF
- Composer : Dompdf est chargé à la demande uniquement lors du rendu du PDF (pas à chaque chargement de page)
- Déclenchement : Via
admin-post.php?action=mirakl_delivery_note&order_id=N&store_name=S
Configuration par boutique
Chaque boutique peut avoir ses propres paramètres de bon de livraison :
| Paramètre | Description |
|---|---|
| Logo | Télécharger un logo de boutique via la bibliothèque média WordPress (redimensionné automatiquement à 200×70px) |
| Langue | Choisir parmi : DE, EN, FR, NL, ES |
| Pied de page | Texte personnalisé du pied de page (revient à la langue par défaut) |
Document généré
Le bon de livraison est un document professionnel A4 au format portrait comprenant :
- Logo de la boutique (côté droit, 200×70px)
- Adresse de livraison (gauche)
- Tableau des informations de commande (droite) : numéro de commande, commande partenaire, date de commande, date du bon de livraison
- Tableau des produits : position, quantité, SKU, description, quantité de retour, motif de retour
- Grille des codes de motif de retour (disposition sur 3 colonnes)
- Instructions de retour numérotées
- Pied de page avec les coordonnées de la boutique
- Pur noir et blanc (pas de couleurs)
Prise en charge multilingue
Traductions intégrées pour 5 langues : allemand (par défaut), anglais, français, néerlandais, espagnol. Le modèle adapte toutes les étiquettes, en-têtes, instructions et texte du pied de page à la langue sélectionnée.
Remboursements
Le système de remboursement traite les remboursements des places de marché directement depuis WooCommerce.
- Accédez à la commande WooCommerce avec un ID de commande Mirakl
- Utilisez l’action Remboursement dans la metabox Actions Mirakl
- Saisissez le montant du remboursement et le motif
- Le remboursement est traité via l’API RE01 de Mirakl
- L’historique de synchronisation est mis à jour avec le résultat
Les remboursements sont suivis dans {$prefix}mirakl_sync_history avec le type return.
Gestion des transporteurs
Les codes transporteurs sont synchronisés depuis Mirakl vers WooCommerce pour un suivi précis des commandes sur les places de marché.
Comment ça fonctionne
- Récupération : Le connecteur appelle l’API CA01 de Mirakl pour la liste des transporteurs
- Stockage : Les transporteurs sont enregistrés dans
{$prefix}mirakl_carriersavec le code, le libellé, le code standard et l’URL de suivi - Mappage : Les mappages de transporteurs par boutique+canal sont stockés dans
{$prefix}mirakl_carrier_mapping - Utilisation : Lors de l’expédition d’une commande, le code transporteur est inclus dans la mise à jour du suivi
Champs des transporteurs
| Champ | Description |
|---|---|
code | Code transporteur Mirakl |
label | Nom lisible du transporteur |
standard_code | Identifiant de transporteur standardisé |
tracking_url | Modèle d’URL pour le suivi des colis |
Cron et automatisation
Intervalles personnalisés
Le plugin enregistre des intervalles cron personnalisés :
mirakl_5min— Toutes les 5 minutesmirakl_10min— Toutes les 10 minutesmirakl_15min— Toutes les 15 minutesmirakl_30min— Toutes les 30 minutes
Tâches planifiées
| Tâche | Hook | Objectif |
|---|---|---|
| Importation des commandes | mirakl_connector_orders_import_cron | Récupérer les nouvelles commandes des places de marché |
| Mise à jour du suivi | mirakl_connector_tracking_update_cron | Synchroniser les numéros de suivi |
| Synchronisation des stocks | mirakl_connector_auto_stock_sync_cron | Envoyer les niveaux de stock |
| Synchronisation des prix | mirakl_connector_prices_sync_cron | Soumettre les importations de prix |
| Synchronisation des produits | mirakl_connector_products_sync_cron | Exporter le catalogue produits |
Reprogrammation
Lorsque vous modifiez les intervalles de synchronisation sur la page Planification de la synchronisation, tous les hooks cron sont effacés et réenregistrés avec les nouveaux intervalles. Vous pouvez également déclencher manuellement n’importe quel type de synchronisation.
Schéma de la base de données
Le plugin crée son propre ensemble de tables de base de données (préfixées par {$wpdb->prefix}mirakl_) pour une gestion fiable et performante des données :
| Table | Objectif |
|---|---|
mirakl_api_settings | Identifiants API et configuration par boutique |
mirakl_orders | Mappage des commandes Mirakl vers les commandes WC |
mirakl_sync_history | Traçabilité de toutes les opérations de synchronisation |
mirakl_carriers | Codes transporteurs et URL de suivi |
mirakl_carrier_mapping | Mappages de transporteurs par boutique |
mirakl_channel_categories | Hiérarchie des catégories depuis Mirakl |
mirakl_product_mappings | Références croisées des ID produits |
mirakl_offer_sku_cache | Cache de résolution des SKU (auto-rempli depuis OF21) |
mirakl_pricing_imports | Suivi du cycle de vie des importations de prix |
mirakl_attributes | Définitions d’attributs en cache (PM11 + VL11) |
mirakl_fetch_times | Horodatages de récupération des commandes/entités |
mirakl_tracking_update_times | Horodatages de synchronisation du suivi |
Toutes les modifications du schéma sont non destructives — elles ajoutent des colonnes et des tables sans supprimer les données existantes.
Sécurité
Le plugin suit les meilleures pratiques de sécurité de WordPress :
- Vérifications des capacités : Toutes les pages d’administration et les gestionnaires AJAX vérifient
manage_optionsoumanage_woocommerce - Vérification des nonces : Chaque formulaire et requête AJAX inclut une vérification de nonce (
check_ajax_referer) - Assainissement des entrées : Toutes les entrées utilisateur sont assainies avec les fonctions WordPress (
sanitize_text_field,esc_url_raw, etc.) - Échappement des sorties : Toutes les données dynamiques sont échappées avec
esc_attr(),esc_html(),esc_url() - Requêtes SQL préparées : Toutes les requêtes de base de données utilisent
$wpdb->prepare()pour prévenir les injections SQL - Stockage des clés API : Les clés API sont stockées dans la base de données (chiffrées au repos via WordPress)
- Convention WP_Error : Les erreurs API utilisent la classe standard
WP_Errorde WordPress - User-Agent : Le plugin s’identifie comme
Mirakl Connector/{version}— pas de fuite d’URL interne
Tableau de bord d’administration
Page du tableau de bord
Le Mirakl → Tableau de bord vous donne un aperçu en un coup d’œil :
- Nombre de boutiques et statut
- Derniers horodatages de synchronisation
- Résumé des boutiques actives
Santé de l’API
La page Mirakl → Santé de l’API vous permet de :
- Tester la connectivité API pour chaque boutique
- Voir le statut des identifiants API
- Diagnostiquer les problèmes de connexion
Journaux de synchronisation
La page Mirakl → Journaux de synchronisation fournit une traçabilité complète :
- Filtrer par boutique, type de synchronisation et statut
- Voir les opérations réussies, échouées et en attente
- Messages d’erreur pour les synchronisations échouées
- Horodatages pour chaque opération
Foire aux questions
Combien de boutiques Mirakl puis-je connecter ?
Il n’y a pas de limite stricte. Chaque boutique possède ses propres identifiants API, paramètres de synchronisation et mappages d’attributs. Vous pouvez gérer des dizaines de boutiques depuis une seule installation WooCommerce.
Le plugin prend-il en charge plusieurs devises ?
Oui. Chaque boutique Mirakl peut avoir sa propre devise, configurée dans vos paramètres Mirakl. Le connecteur transmet les informations de devise avec chaque commande.
Comment les conflits sont-ils gérés si le même produit est mis à jour dans WooCommerce et sur la place de marché simultanément ?
Le verrouillage de synchronisation empêche les opérations simultanées pour la même combinaison boutique+type. Pour les conflits de données, WooCommerce est traité comme la source de vérité pour les stocks et les prix.
Puis-je synchroniser sélectivement certains produits uniquement ?
Oui. Utilisez la case à cocher “Actif dans Mirakl” par produit, les actions groupées d’activation/désactivation ou l’option de filtre de produit pour inclure/exclure des SKU spécifiques.
Dois-je installer un logiciel supplémentaire sur mon serveur ?
Non. Le plugin inclut toutes les dépendances via Composer, y compris le SDK Mirakl et Dompdf. Aucun service externe ni extension serveur n’est requis au-delà de la pile PHP standard de WordPress.
Que se passe-t-il si une synchronisation échoue ?
Les synchronisations échouées sont enregistrées dans l’historique des synchronisations avec des messages d’erreur. La prochaine synchronisation programmée réessaie automatiquement. Pour les importations de prix, les lignes échouées sont signalées avec des rapports d’erreur détaillés.
Puis-je utiliser le générateur de bons de livraison dans d’autres langues que l’allemand ?
Oui. Le bon de livraison prend en charge 5 langues : allemand, anglais, français, néerlandais et espagnol. Les paramètres de langue par boutique peuvent être configurés sur la page des boutiques.
Dépannage
Le test de connexion échoue
- Vérifiez que l’URL de votre point d’API est correcte (doit se terminer par
.mirakl.net) - Confirmez que la clé API dispose des autorisations requises
- Vérifiez que votre serveur peut effectuer des requêtes HTTPS sortantes
- Recherchez les règles de pare-feu bloquant les domaines de l’API Mirakl
Les produits ne se synchronisent pas
- Confirmez que le produit a la case “Actif dans Mirakl” cochée
- Vérifiez que les champs de marque et GTIN sont remplis (attributs requis)
- Consultez les journaux de synchronisation pour les messages d’erreur
- Assurez-vous que les identifiants API de la boutique sont valides
- Lancez une synchronisation manuelle pour déclencher un traitement immédiat
Les commandes ne s’importent pas
- Vérifiez que la synchronisation des commandes est activée dans la Planification de la synchronisation
- Vérifiez la plage de dates minimale des commandes (la première exécution remonte 9 jours)
- Consultez l’historique des synchronisations pour les erreurs API
