DocumentationCommerceGuide Catalog Service

Notes de mise à jour de Commerce Storefront Catalog Service

Last update: Thu Feb 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

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

  • Versions du service de catalogue Storefront

    • Améliorations du schéma de l’API Catalog Service pour une récupération des données améliorée.
    • Amélioration de la sécurité, des performances et de la fiabilité de l’API Catalog Service et de l’infrastructure sous-jacente.

  • Versions des métapaquets du service de catalogue

    • Mise à jour des dépendances pour améliorer les performances, la stabilité et la compatibilité avec d’autres composants Adobe Commerce.

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

version 1.47

12 février 2025

Nouveau Le service d’API prend désormais en charge le type de CategoryProductView , ce qui permet d’améliorer les vues et les requêtes pour les produits par catégorie. Cette mise à jour permet aux développeurs et développeuses de récupérer et de filtrer efficacement les données de produit en fonction de la catégorie, ce qui améliore la flexibilité et les performances pour les cas d’utilisation orientés catégorie. Pour plus d’informations, consultez Implémentation de catégories sur le storefront. Pris en charge uniquement sur les implémentations Commerce utilisant le modèle de données de catalogue composable pour les storefronts découplés

version 1.46

1 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é.

version 1.45

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.

version 1.44

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é.

version 1.43

3 novembre 2025

Nouveau Calques de produit pour la personnalisation multidimensionnelle des produits—Ajout de la prise en charge de la diffusion de contenu spécifique au canal et tenant compte des paramètres régionaux pour les implémentations de Adobe Commerce Optimizer.

  • Diffuser un contenu de produit différent à différents segments de clientèle

  • Appliquer des personnalisations spécifiques aux paramètres régionaux sans dupliquer les données de base

  • Contrôle des remplacements au niveau du champ avec des masques de calque

  • Prise en charge des calques de contenu premium, saisonniers et optimisés pour les appareils mobiles

    Les calques sont récupérés à l’aide de la requête products existante, sont appliqués côté serveur à partir des en-têtes de requête et ne nécessitent aucune modification de schéma. Voir Calque de catalogue dans le guide de Adobe Commerce Optimizer __.

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é.

version 1.42

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.

version 1.41

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é.

version 1.40

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é.

version 1.39

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é.

version 1.38

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.

version 1.37

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.

version 1.36

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é.

Versions précédentes

version 1.35

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é.

version 1.34

23 mars 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é.

version 1.33

29 avril 2025

Correctif améliorations au niveau du système et de l’infrastructure. L’infrastructure prend désormais en charge des catalogues extrêmement volumineux (jusqu’à 440 millions de SKU) sans affecter les charges de travail existantes.

version 1.32

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é.

version 1.31

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é.

version 1.30

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.

version 1.29

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é.

version 1.28

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é.

version 1.27

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é.

version 1.26

2 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).

version 1.23

2 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.

version 1.22

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.

version 1.19

23 mai 2024

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

Correctif L’indicateur InStock pour les valeurs d’option respecte désormais le statut de enabled défini 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.

version 1.18

1 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.

version 1.17

2 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+.

version 1.16

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 :

version 1.13

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.

version 1.12

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.

version 1.11

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.

version 1.10

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.

version 1.7

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.

version 1.6

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.

version 1.5

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.

version 1.4

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.

version 1.3

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.

version 1.1

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.

version 1.0

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.

version 0.3 - Beta+

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.

Version de Beta

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-premise sur le cloud, 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

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.
mer
Nouveau Mise à jour de la version et des métadonnées pour la version 3.3.0.

version v3.2.0

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

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.

Documentation connexe

recommendation-more-help
caa758b0-fff2-4350-a281-16253ff7b81f