Integration Mirakl

Connectez Products Manager aux marketplaces propulsees par Mirakl (Darty, Boulanger, Leroy Merlin, etc.) pour publier vos offres et synchroniser les commandes.

Vue d'ensemble

Mirakl est la plateforme technique derriere de nombreuses marketplaces B2C et B2B. L'integration Products Manager permet de gerer vos offres sur toutes les marketplaces Mirakl depuis une interface unique.

Fonctionnalites

• Push offres : Publication d'offres basees sur EAN (produits deja catalogues)
• Gestion des prix : Mise a jour des prix et promotions
• Gestion des stocks : Synchronisation des quantites disponibles
• Pull commandes : Recuperation des commandes marketplace
• Webhooks HMAC : Notifications en temps reel

Prerequis

• Compte vendeur actif sur une marketplace Mirakl
• Cle API Mirakl (generee dans votre espace vendeur)
• Products Manager v5.0.0 minimum

Configuration

1. Obtenir la cle API

1. Connectez-vous a votre espace vendeur Mirakl
2. Allez dans Mon compte > Cles API
3. Generez une nouvelle cle avec les permissions :
   • OFFER_READ, OFFER_WRITE
   • ORDER_READ, ORDER_WRITE
   • PRODUCT_READ

2. Configurer dans Products Manager

Allez dans Parametres > Integrations > Mirakl :

3. Tester la connexion

Connexion a Mirakl reussie
Marketplace: Darty Marketplace
Shop ID: 12345
Offres actives: 342
Commandes en attente: 8

Push offres EAN

Sur les marketplaces Mirakl, les produits sont catalogues par l'operateur. Les vendeurs publient des offres sur des produits existants identifies par EAN.

POST /api/v1/connectors/{connector_id}/sync/push
{
  "product_ids": ["uuid-1", "uuid-2"],
  "offer_defaults": {
    "state_code": "11",
    "logistic_class": "STANDARD",
    "leadtime_to_ship": 3
  }
}

Champs de l'offre

Pull commandes

GET /api/v1/connectors/{connector_id}/orders

Recupere les commandes en attente de traitement. Les commandes suivent le workflow Mirakl standard :

1. WAITING_ACCEPTANCE : Nouvelle commande a accepter
2. SHIPPING : Commande acceptee, en preparation
3. SHIPPED : Commande expediee (tracking fourni)
4. RECEIVED : Commande recue par le client

Webhooks HMAC

Configuration

Configurez l'URL webhook dans votre espace vendeur Mirakl :

URL: https://api.productsmanager.app/api/v1/connectors/webhooks/mirakl

Verification de signature

Les webhooks Mirakl sont signes via HMAC-SHA256. Products Manager verifie automatiquement chaque requete :

signature = hmac.new(
    webhook_secret.encode(),
    payload,
    hashlib.sha256
).hexdigest()

Evenements supportes

Troubleshooting

Erreur "Product not found in catalog"

L'EAN du produit n'existe pas dans le catalogue de la marketplace. Verifiez que l'EAN est correct et que le produit a ete catalogue par l'operateur.

Offre refusee

Verifiez les conditions de la marketplace :

• Prix dans les limites autorisees
• Stock minimum requis
• Champs obligatoires renseignes (description, delai)

Ressources Associees

• Platform Connectors
• API Connecteurs
• Documentation Mirakl