Connectez votre entreprise à un catalogue produits plus large et davantage d'opportunités

L'API B2B de MediaMax permet de connecter une boutique en ligne, un ERP ou un système interne à notre catalogue, nos prix, nos stocks, nos commandes et nos expéditions au moyen de requêtes HTTP authentifiées.

Le catalogue permet de récupérer une liste paginée, puis de consulter le détail à jour d'un SKU. Les données peuvent comprendre le nom, la référence, le prix client, la disponibilité, l'EAN, les images et les informations énergétiques, selon le produit.

Obtenir le catalogue

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/all?pag=1&max=25' \
  --header 'HTTP-API-KEY: VOTRE_TOKEN' \
  --header 'Accept-Language: fr'
              

Consulter un produit

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/SKU-EXEMPLE' \
  --header 'HTTP-API-KEY: VOTRE_TOKEN'
              

Réponse illustrative simplifiée

                {
  "id": 12345,
  "attributes": {
    "name": "Produit exemple",
    "sku": "SKU-EXEMPLE",
    "price": 199.99,
    "qty_available": 8,
    "gallery": []
  }
}
              

Les feeds fournissent des fichiers à importer périodiquement dans un eCommerce, un ERP ou un intégrateur. Ils constituent une alternative ou un complément à l'API : ils permettent des synchronisations par lots sans avoir à effectuer de requêtes individuelles par produit.

Feed rapide de prix et de disponibilité

Fréquence de mise à jour recommandée : toutes les 15 à 30 minutes, selon le processus d'intégration.

Format documenté : séparateur de champs | ; délimiteur de texte '.

Le Catalogue Exclusif Étendu comprend des références qui ne sont pas encore publiées sur notre site web, ce qui vous permet d'accéder à un catalogue beaucoup plus vaste.

Quels avantages offre-t-il ?

Son objectif est d'améliorer le matching avec les fiches existantes sur des plateformes comme Amazon, Miravia et d'autres marketplaces, afin d'augmenter les possibilités de commercialiser nos produits.

Quels avantages offre-t-il ?

Chaque intégration API est associée à un utilisateur et à un e-mail MediaMax liés à la configuration commerciale et fiscale du client. Cette association influe sur le tarif, les prix et le traitement de la facturation.

Une commande API regroupe la référence propre du client, l'adresse de facturation, l'adresse de livraison et les lignes avec SKU et quantité. MediaMax renvoie un identifiant qui doit être conservé avec la référence d'origine.

Créer une commande

                curl --request POST \
  --url 'https://www.mediamax.es/api/order' \
  --header 'HTTP-API-KEY: VOTRE_TOKEN' \
  --header 'Content-Type: application/json' \
  --data @commande.json
              

Exemple de commande.json

                {
  "b2b_reference": "COMMANDE-CLIENT-2026-0001",
  "order_billing_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Entreprise Exemple SL",
    "email": "achats@example.com",
    "phone": "+34900000000",
    "street": "Rue Exemple 1",
    "postcode": "03001",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES"
  },
  "order_shipping_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Entreprise Exemple SL",
    "email": "logistique@example.com",
    "phone": "+34900000000",
    "street": "Avenue de Livraison 10",
    "postcode": "03002",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES",
    "express": 0
  },
  "order_lines": [
    {"sku": "SKU-EXEMPLE", "quantity": 1}
  ]
}
              

Consulter plusieurs références

                curl --request GET \
  --url 'https://www.mediamax.es/api/batch/reference?pag=1&max=25&references=COMMANDE-001&references=COMMANDE-002' \
  --header 'HTTP-API-KEY: VOTRE_TOKEN'
              

Avec Dropship, MediaMax prépare et expédie les commandes au nom du client, en utilisant la configuration du compte pour la documentation et l'étiquetage. Selon la procédure décrite, les commandes passées par API utilisent cette modalité.

Une commande peut générer une ou plusieurs expéditions. Chacune peut avoir sa propre référence de picking, son transporteur, son numéro de suivi et son état logistique.

Consulter une expédition par référence

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/reference/WH%2FOUT%2F00000' \
  --header 'HTTP-API-KEY: VOTRE_TOKEN'
              

Réponse illustrative simplifiée

                {
  "code": "200",
  "status": "success",
  "data": {
    "id": 4567,
    "attributes": {
      "reference": "WH/OUT/00000",
      "tracking": "TRACKING-EXEMPLE",
      "status": "done"
    }
  }
}
              

Consulter toutes les expéditions de la commande

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/order/odoo/S00000' \
  --header 'HTTP-API-KEY: VOTRE_TOKEN'
              

Le passage de DEMO à la production nécessite de superviser les premières opérations pour confirmer que l'intégration fonctionne avec des données réelles. Un blocage de contact est utilisé pour contrôler le transfert du picking jusqu'à la fin de la vérification.

Résumé des opérations