DocumentationCommerceGuide Catalog Service

Notes de mise à jour de Commerce Storefront Catalog Service

Dernière mise à jour : 11 mai 2026

Créé pour :

  • Admin

Ces notes de mise à jour couvrent les dernières mises à jour du service de catalogue Commerce, notamment :

NOTE
Si votre projet Commerce utilise Adobe Commerce Optimizer pour diffuser des données de catalogue vers le service Commerce Edge Delivery ou les storefronts découplés, consultez les notes de mise à jour de Adobe Commerce Optimizer pour connaître les dernières mises à jour de l’API.

Les mises à jour sont classées par type :

Nouveau Nouvelles fonctionnalités
Correctifs Correctifs et améliorations
Bogue Problèmes connus

La prise en charge est fournie pour la dernière version. Les notes de mise à jour des versions plus anciennes sont incluses à titre de référence.

Service de catalogue Storefront

Mai 2026

Date de publication : 4 mai 2026

Corriger les prix des produits Storefront affichent désormais le code de devise correct (par exemple, USD) pour tous les types de produits. Auparavant, certains produits affichaient des NONE au lieu de la devise attendue, ce qui entraînait des prix manquants. Cette mise à jour garantit un rendu des prix cohérent et précis sur l’ensemble du storefront.

Avril 2026

Date de publication : 29 avril 2026

Nouveau ​ limite forcée de 100 SKU maximum par demande pour Adobe Commerce Optimizer et Adobe Commerce as a Cloud Service
clients conformément limites et limites documentées.

Date de publication : 17 avril 2026

Nouveau Ajout d’une nouvelle requête searchCategory GraphQL qui permet aux clients de rechercher des catégories par nom avec des résultats paginés. La requête accepte un searchTerm obligatoire (3 caractères minimum) et des paramètres facultatifs family, pageSize et currentPage. Les résultats incluent la correspondance d’objets CategoryTreeView avec des métadonnées de catégorie complètes, une totalCount et des pageInfo pour la pagination.

Cette requête est disponible uniquement pour les clients qui utilisent les services de marchandisage Adobe Commerce Optimizer. Voir searchCategory.

Mars 2026

Date de publication : 24 mars 2026

Nouveau Ajout de la prise en charge pour calculer et renvoyer la plage de prix des lots dynamiques.

Décembre 2025

Date de publication : 11 décembre 2025

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer les performances et la stabilité.

Novembre 2025

Date de publication : 17 novembre 2025

Nouveau Filtrage des attributs par nom-La requête GraphQL productSearch prend désormais en charge le filtrage des attributs de produit avec le champ names. Avec ce filtre, vous pouvez :

  • Réduire la taille de la payload de réponse en demandant uniquement des attributs spécifiques

  • Combinez-la avec le filtre roles existant pour affiner par rôle de visibilité et nom d’attribut

  • Exemples :

    Filtrer uniquement par nom d’attribut

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(names: ["color", "size", "material"]) {
      name
      label
      value
    }
  }
}

    Filtrez par rôles et noms :

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) {
      name
      label
      value
      roles
    }
  }
}
NOTE
Pour récupérer tous les attributs sans filtrer, omettez l’argument names ou fournissez un tableau vide.

Date de publication : 6 novembre 2025

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer les performances et la stabilité.

Correctif Les produits regroupés peuvent désormais être interrogés lorsque le parent n’a pas de tarification ; les produits enfants renvoient leurs propres rôles de visibilité.

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer les performances et la stabilité.

Septembre 2025

Date de publication : 8 septembre 2025

Nouvelle Prise en charge de la tarification de niveau ajoutée pour interroger la tarification de volume :

Pour récupérer la tarification de niveau :

  1. Utilisez la requête products avec les SKU de votre choix.
  2. Pour SimpleProductView, accédez à price.tiers
  3. Pour ComplexProductView, accédez aux priceRange.minimum.tiers et aux priceRange.maximum.tiers
  4. Chaque niveau contient le prix tier réduit et les conditions de quantity
  5. Définir des seuils de quantité avec gte (supérieur ou égal à) et lt (inférieur à)

Exemple:

query {
  products(skus: ["SKU-001"]) {
    ... on SimpleProductView {
      price {
        regular { amount { value currency } }
        tiers {
          tier { amount { value currency } }
          quantity {
            ... on ProductViewTierRangeCondition { gte lt }
          }
        }
      }
    }
  }
}

Fixe Prix de base filtrés par le prix final minimum

L’API renvoie désormais uniquement les niveaux dont le prix réduit est inférieur au prix final minimum du produit. Les niveaux supérieurs sont omis, car le prix final minimum s’appliquerait sur le storefront à la place.

Application :

  • Produits simples : price.tiers comprend uniquement les niveaux avec tier.amount.value < price.final.amount.value (final minimum).
  • Produits complexes : priceRange.minimum.tiers et priceRange.maximum.tiers utilisent la même règle lors de la création de la gamme de prix.

Date de publication : 2 septembre 2025

Correctif Amélioration de la gestion des erreurs en cas d’informations de prix manquantes : lorsque les données de prix ne sont pas encore reçues, l’API renvoie des null pour le champ de prix au lieu de générer une erreur, ce qui permet aux clients de gérer les données manquantes de manière élégante.

Correctif améliorations au niveau du système et de l’infrastructure pour améliorer les performances et la stabilité.

Juillet 2025

Date de publication : 30 juillet 2025

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Date de publication : 24 juillet 2025

Nouveau Récupérer les unités de recommandation par ID d’unité-Nouveau point d’entrée GraphQL recommendationsByUnitIds récupère les unités de recommandation par leur ID unique pour un accès plus flexible et ciblé.

  • unitIds est obligatoire (liste des recId à récupérer).

  • Les paramètres de contexte (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) se comportent de la même manière que dans la requête Recommendations existante.

  • Exemple

    code language-graphql 
    query {
  recommendationsByUnitIds(
    unitIds: ["11ee89d1-bfae-4582-a921-2ced44ff6bf7"]
    currentSku: "24-MB01"
    cartSkus: ["24-MB01"]
  ) {
    totalResults
    results {
      unitId
      unitName
      totalProducts
      productsView {
        sku
      }
      pageType
      typeId
      storefrontLabel
      displayOrder
    }
  }
}

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Date de publication : 15 juillet 2025

Nouveau Types de produits de cartes-cadeaux-Le service Storefront de catalogue prend désormais en charge les attributs de produit en tant qu’objets ou tableaux JSON, ce qui permet une gestion flexible de types complexes tels que les cartes-cadeaux.

Versions précédentes

Juin 2025

Date de publication : 20 juin 2025

Nouveau Configuration hiérarchique du catalogue des prix : plages de prix précises pour les catalogues des prix parent-enfant. Les calculs respectent la hiérarchie et les règles héritées ; réduit les erreurs de tarification lorsque plusieurs tarifs sont liés. Adobe Commerce Optimizer uniquement. Voir Livres de prix.

Nouvelles clés non sensibles à la casse : les recherches de clés dans les requêtes ne sont désormais plus sensibles à la casse, ce qui réduit les erreurs de casse des clés.

Date de publication : 20 juin 2025

Nouvel ​ Événements d’E/S publics pour Catalog Storefront : ajout d’événements d’E/S publics pour une intégration et une observabilité en temps réel (CSS et EDS).

Nouveau Rendu côté serveur (SSR) : améliorations architecturales pour prendre en charge le rendu côté serveur afin d’améliorer les performances, l’optimisation du moteur de recherche et l’expérience utilisateur sur les catalogues volumineux.

Nouveau Infrastructure et sécurité : nouveaux rôles AWS, intégration de ServiceNow et pipelines CI/CD pour le service d’événements.

Nouveau Formats d’événement et observabilité : payloads rationalisés, surveillance améliorée, données d’événement de variante améliorées.

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Date de publication : 13 juin 2025

Nouveau Récupérer les données non mises en cache-Activez l’en-tête Magento-Is-Preview pour transmettre les données non mises en cache du point d’entrée du catalogue au service de recherche.

Nouvelle Options de produit à sélection multiple-L’API GraphQL indique désormais si les options de produit permettent des sélections multiples (par exemple, le lot « Choisir plusieurs éléments »).

Nouveau Mise à jour de la validation des prix sur l’ingestion des données pour prendre en charge les produits sans prix.

Correctif Amélioration de la gestion des erreurs pour une tarification simple des offres groupées dans Adobe Commerce Optimizer.

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Avril 2025

Date de publication: 8 avril 2025

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

L’infrastructure Fix prend désormais en charge des catalogues extrêmement volumineux (jusqu’à 440 millions de SKU) sans affecter les charges de travail existantes.

Mars 2025

Date de publication : 28 mars 2025

Correction Les attributs sans rôles ne sont plus indexés par défaut pour le catalogue composable, ce qui améliore le temps d’indexation et réduit le stockage. Le comportement hérité peut être réactivé à l’aide d’un indicateur de fonctionnalité.

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Février 2025

Date de publication : 18 février 2025

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Décembre 2024

Date de publication: 9 décembre 2024

Version majeure : modèle de données de catalogue composable pour les storefronts découplés, la gestion des en-têtes et la gestion des données de produit.

Nouveau Modèle de données de catalogue composable (CCDM) : prend en charge les clients qui utilisent le catalogue composable pour les vitrines découplées. Les nouveaux points d’entrée acceptent les ID de vue de catalogue et de politique (rétrocompatible). Détails et prix des produits configurables avec pagination intégrée.

Nouveau Gestion des en-têtes-AC-Locale renommé en AC-Scope-Locale pour les opérations de l’API de catalogue composable ; mappage des en-têtes et valeurs par défaut spécifiés.

Nouveau Données et tarification des produits-Prise en charge du modèle de données de catalogue composable et amélioration de la gestion des prix des produits configurables.

CurrencyEnum mis à jour pour prendre en charge les NONE pour les requêtes de recherche de produit, en s’alignant sur la logique de fédération.

Correctif Infrastructure et mises à niveau : améliorations au niveau du système pour la sécurité, les performances et la stabilité.

Correctif les options de regroupement des produits n’affichent désormais que les produits activés.

Date de publication: 9 décembre 2024

Nouveau Ordre des images dans les requêtes de produit—Les images de produit dans le champ images GraphQL suivent désormais les sortOrder d’exportation de catalogue pour un comportement cohérent du storefront et de l’API.

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Date de publication : décembre 2024

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Octobre 2024

Date de publication : 22 octobre 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau le schéma GraphQL inclut désormais des lastModifiedAt dans les informations produit pour des plans de site et une réindexation du moteur de recherche précis (par exemple, Google).

Septembre 2024

Date de publication : 26 septembre 2024

Correctif améliorations apportées au niveau du système et de l’infrastructure pour améliorer la sécurité, les performances et la stabilité.

Août 2024

Date de publication : 22 août 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Correctif Les informations sur les produits peuvent désormais être récupérées sans données de remplacement de produit (prix). Auparavant, ces requêtes renvoyaient : The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Date de publication : 13 août 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Ajout de la prise en charge de la récupération de toutes les variantes par SKU de produit. Voir Référence de l’API Catalog Service.

Mai 2024

Date de publication : 23 mai 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Correction l’indicateur InStock pour les valeurs d’option respecte désormais le statut de enabled étendue de la variante de produit.

Correctif Ajout de la prise en charge des prix des produits avec jusqu’à 16 chiffres et 4 décimales. Resynchronisez à partir du tableau de bord de gestion des données ou de l’interface de ligne de commande pour appliquer les mises à jour.

Limites connues

Les fonctionnalités suivantes ne sont pas encore prises en charge :

  • La taille maximale de la payload des attributs dynamiques est de 9 Mo.
  • Le prix des produits du Groupe peut être calculé avec des prix de produits simples.
  • Dans un tableau d’images, seule la première image contient des rôles.

Utilisez le maillage API et l’API Core GraphQL pour :

  • Prix minimum annoncé
  • Tarification par niveau
  • Offre groupée de produits à prix fixes

Pour plus d’informations et des exemples, voir Service de catalogue et maillage API.

Avril 2024

Date de publication : 11 avril 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Ajout de la prise en charge de PHP 8.3.

Nouveau ​ les requêtes products et refineProduct renvoient désormais des données d’options personnalisables pour les produits simples et complexes.

Février 2024

Date de publication : 22 février 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau ​ l’Data Management Dashboard est désormais disponible pour les flux de données (recommandations de produits, recherche en direct, service de catalogue). Nécessite catalog-service métapaquet v3.1.0+.

Date de publication : 13 février 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Les nouvelles vidéos produit ​ sont désormais prises en charge par l’API Catalog Service.
Correctif Les options en rupture de stock s’affichent désormais dans le widget PDP.

Limites connues

Ces fonctionnalités ne sont pas encore prises en charge :

  • La taille maximale de la payload des attributs dynamiques est de 9 Mo.
  • Prix du produit du groupe. Cette valeur peut être calculée avec des prix de produit simples.
  • Dans un tableau d’images, seule la première image contient des rôles.

Utilisez le maillage API et l’API Core GraphQL pour :

Octobre 2023

Date de publication : 12 octobre 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Catalog Service prend en charge l’indicateur inStock pour les variantes de produits.
Nouveau Les champs urlKey et externalId ont été ajoutés au schéma GraphQL.
Nouveau Les produits téléchargeables et les cartes-cadeaux sont désormais pris en charge.

Septembre 2023

Date de publication : 19 septembre 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Catalog Service utilise désormais l’indexation des prix SaaS.
Correctif cette version contient des correctifs et des améliorations du côté des services.

Juillet 2023

Date de publication : 18 juillet 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau le service de catalogue prend désormais en charge la requête recommendations GraphQL pour les recommandations de produits.

Juin 2023

Date de publication : 27 juin 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau l’API Catalog Service prend désormais en charge related products.

Avril 2023

Date de publication : 12 avril 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau le service de catalogue nettoie désormais les variantes de produits supprimées.
Correctif Évolutivité de l’infrastructure et améliorations des performances.

Mars 2023

Date de publication : 28 mars 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Des échantillons ont été ajoutés à la requête products.
Nouveau Ajout de la possibilité de entityId à l’aide du maillage API.

Date de publication : 6 mars 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Ajout de la fonctionnalité categories GraphQL.
Correctif Amélioration des performances et de l’évolutivité des API.

Février 2023

Date de publication : 7 février 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.x et ultérieures

Nouveau métapaquet de service de catalogue publié pour simplifier les étapes d’installation.
Correctif Amélioration de l’évolutivité et des performances de l’API.

Janvier 2023

Date de publication : 17 janvier 2023

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.x et ultérieures

Nouveau Expérience d’intégration simplifiée et améliorée.
Nouveau ​ de nouveaux points d’entrée de sandbox client sont disponibles pour les tests de pré-production.
Nouveau Ajout de la prise en charge des produits virtuels.
Correctif Amélioration de l’évolutivité et des performances de l’API.

Novembre 2022

Date de publication : 18 novembre 2022

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.x et ultérieures

Nouveau le service de catalogue prend désormais en charge Adobe maillage API.
Correctif Amélioration de l’évolutivité et des performances globales des API.

Octobre 2022

Date de publication : 4 octobre 2022

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.x et ultérieures

Nouveau Prise en charge des produits groupés.
Nouveau Ajout de remplacements de visibilité B2B. Les produits peuvent désormais faire l’objet de recherches et peuvent être ajoutés au panier pour des groupes de clients spécifiques.
Le service Fix est désormais plus stable et offre de meilleures performances.

Septembre 2022

Date de publication : 12 septembre 2022

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.x et ultérieures

Nouvelle Images de variante : images de produit renvoyées en fonction des options sélectionnées.
Nouveau Rôles de prix : seuls les membres de groupes de clients spécifiques peuvent voir les prix des produits.
Correctif Amélioration de la stabilité et des performances du service.
Nouveau Des mises à jour sont reçues lorsque des produits sont supprimés du catalogue.

Août 2022

Date de publication : 9 août 2022

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.x et ultérieures

Nouveau Les requêtes products et refineProduct renvoient les données suivantes :

  • Attributs de produit (système) prédéfinis.
  • Attributs de produit dynamiques et les filtrer par rôle (page d’affichage du produit/page de liste des produits).
  • Options du produit.
  • Images de produit et filtrage par rôle (PDP/PLP).
  • Prix spécifique pour les produits simples et plages de prix pour les produits configurables.
  • Prix et fourchettes de prix du groupe de clients. Ils renvoient un prix de secours par défaut pour les acheteurs sans groupe de clients.
  • Types de produits qui utilisent une tarification spécifique au client B2B.

Métapaquet du service de catalogue

Mises à jour du métapaquet PHP du service de catalogue (magento/catalog-service).

  • Pour les clients Adobe Commerce as a Cloud Service, la dernière version est installée dans votre environnement.

  • Pour Adobe Commerce on cloud ou on-premise, Adobe recommande d’utiliser le compositeur pour mettre à niveau le métapaquet du service de catalogue dans vos environnements cloud vers la dernière version.

version v3.3.0

Date de publication : 14 octobre 2025

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouveau Mise à niveau des services de données—Dépendance magento/data-services mise à jour vers ^8.0.0. Vérifiez l’environnement et l’utilisation de l’API Data Services personnalisée pour la compatibilité 8.x avant la mise à niveau.

Nouveau Mise à jour de la version et des métadonnées pour la version 3.3.0.

version v3.2.0

Date de publication : 12 avril 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

Nouvelle Version et métadonnées mises à jour pour 3.2.0. Aucune autre modification de dépendance.

version v3.1.0

Date de publication : 26 janvier 2024

[Pris en charge]{class="badge informative" title="Pris en charge"} Adobe Commerce versions 2.4.4 et ultérieures

New Ajout de nouvelles dépendances de package :

  • Exportateur de données d’autorisation de catégorie (magento/module-category-permission-data-exporter) pour exporter les données d’autorisation de catégorie utilisées par le service de catalogue.
  • Administration de la synchronisation des catalogues magento/module-catalog-sync-admin pour l’interface utilisateur d’administration et la configuration liée à la synchronisation des catalogues.

Nouveau Mise à jour de la version et des métadonnées pour la version 3.1.0.

Programme d’installation du service de catalogue

Le programme d’installation est fourni avec l’extension du service de catalogue qui gère les vérifications d’installation et d’environnement afin que le service de catalogue corresponde à votre pile Commerce.

  • Pour les clients Adobe Commerce as a Cloud Service, la dernière version du programme d’installation est installée dans votre environnement.

  • Pour Adobe Commerce sur l’infrastructure cloud ou sur site, veillez à ce que le programme d’installation soit aligné sur le métapaquet Service de catalogue.

Chaque fois que vous utilisez le compositeur pour mettre à niveau le magento/catalog-service, le package du programme d’installation est automatiquement mis à jour vers la dernière version. Vous pouvez également utiliser le compositeur pour mettre à niveau les magento/catalog-service-installer séparément lorsque ces notes de mise à jour décrivent une modification dont vous avez besoin, par exemple, la prise en charge d’une nouvelle version de PHP. Ainsi, vos outils d’installation restent compatibles avec la version du service de catalogue que vous exécutez.

version 1.0.6

Date de publication : 25 mars 2026

Nouveau PHP 8.5 : garantit la compatibilité lorsque le service de catalogue fonctionne sur PHP 8.5.

Documentation connexe

recommendation-more-help
commerce-help-catalog-service