Commerce Storefront Catalog Service Versionshinweise

In diesen Versionshinweisen werden die neuesten Aktualisierungen des Commerce Catalog Service behandelt, darunter:

  • Versionen des Storefront Catalog Service

    • Verbesserungen des Catalog Service-API-Schemas für einen verbesserten Datenabruf.
    • Verbesserungen der Sicherheit, Leistung und Zuverlässigkeit für die Catalog Service-API und die zugrunde liegende Infrastruktur.
  • Catalog Service Metapaket-Versionen

    • Abhängigkeiten wurden aktualisiert, um die Leistung, Stabilität und Kompatibilität mit anderen Adobe Commerce-Komponenten zu verbessern.

Aktualisierungen werden nach Typ kategorisiert:

Neu Neue Funktionen
Fehlerbehebung Fehlerbehebungen und Verbesserungen
Bug Bekannte Probleme

Unterstützung wird für die neueste Version bereitgestellt. Versionshinweise für ältere Versionen sind als Referenz enthalten.

Storefront Catalog Service

Version 1.48

19. Februar 2025

Neu Die categoryTree Abfrage in der GraphQL-API gibt jetzt Kategoriebeschreibungen, Bilder und SEO-Meta-Tags zurück. Dieses Update liefert die Daten, die Entwickler von Storefronts benötigen, um Kategoriebilder anzuzeigen und die Suchmaschinenoptimierung mit korrekten Metadaten-Titeln, Beschreibungen und Keywords zu verbessern. Wird nur bei Commerce-Implementierungen mit dem zusammensetzbaren Katalogdatenmodell für Headless-Storefronts unterstützt<

Version 1.47

12. Februar 2025

Neu Der API-Service unterstützt jetzt den CategoryProductView und ermöglicht erweiterte Ansichten und Abfragen für Produkte nach Kategorie. Diese Aktualisierung ermöglicht es Entwicklerinnen und Entwicklern, Produktdaten basierend auf der Kategorie effizient abzurufen und zu filtern, was die Flexibilität und Leistung für kategoriegesteuerte Anwendungsfälle verbessert. Weitere Informationen finden Sie unter Implementieren von Kategorien in der Storefront. Wird nur bei Commerce-Implementierungen mit dem zusammensetzbaren Katalogdatenmodell für Headless-Storefronts unterstützt

Version 1.46

11. Dezember 2025

Fix Verbesserungen auf Systemebene und Infrastrukturverbesserungen zur Verbesserung von Leistung und Stabilität.

Version 1.45

17. November 2025

Neu Attributfilterung nach Name-Die productSearch GraphQL-Abfrage unterstützt jetzt das Filtern von Produktattributen mit dem names. Mit diesem Filter können Sie:

  • Verringern der Größe der Antwort-Payload durch die Anforderung nur bestimmter Attribute

  • Kombination mit dem vorhandenen roles, um die Sichtbarkeit nach Rolle und Attributname einzugrenzen

  • Beispiele:

    Nur nach Attributnamen filtern

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

    Filtern Sie nach Rollen und Namen:

    code language-graphql
    query {
      products(skus: ["SKU-001"]) {
        attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) {
          name
          label
          value
          roles
        }
      }
    }
    
NOTE
Um alle Attribute ohne Filterung abzurufen, lassen Sie das names-Argument weg oder geben Sie ein leeres -Array an.

Version 1.44

6. November 2025

Fix Verbesserungen auf Systemebene und Infrastrukturverbesserungen zur Verbesserung von Leistung und Stabilität.

Version 1.43

3. November 2025

Neu Produktebenen für die mehrdimensionale Produktanpassung - Es wurde Unterstützung für die kanalspezifische, gebietsschemasensitive Inhaltsbereitstellung für Adobe Commerce Optimizer-Implementierungen hinzugefügt.

  • Bereitstellen verschiedener Produktinhalte für verschiedene Kundensegmente

  • Anwenden von gebietsschemaspezifischen Anpassungen ohne Duplizieren von Basisdaten

  • Überschreibungen auf Feldebene mit Ebenenmasken steuern

  • Unterstützung für Premium-, Saison- und Mobile-optimierte Inhaltsebenen

    Ebenen werden mit der vorhandenen products Abfrage abgerufen, werden Server-seitig aus Anfrage-Headern angewendet und erfordern keine Schemaänderungen. Siehe Katalogebene im Adobe Commerce Optimizer-Handbuch.

Korrigieren Gruppierte Produkte können jetzt abgefragt werden, wenn das übergeordnete Element keine Preise hat. Untergeordnete Produkte geben ihre eigenen Sichtbarkeitsrollen zurück.

Fix Verbesserungen auf Systemebene und Infrastrukturverbesserungen zur Verbesserung von Leistung und Stabilität.

Version 1.42

8. September 2025

Neu Unterstützung für Tier Pricing um Volumenpreise abzufragen:

So rufen Sie die Preisstufe ab:

  1. Verwenden der products Abfrage mit Ihren gewünschten SKUs
  2. Greifen Sie für SimpleProductView auf price.tiers zu
  3. Greifen Sie für ComplexProductView auf priceRange.minimum.tiers und priceRange.maximum.tiers zu.
  4. Jede Stufe enthält die ermäßigten tier- und quantity
  5. Mengenschwellenwerte mit gte (größer oder gleich) und lt (kleiner als) definieren

Beispiel:

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

Fixpreis Stufenpreise gefiltert nach Endpreis-

Die API gibt jetzt nur noch Preisstufen zurück, deren ermäßigter Preis niedriger als der Mindestendpreis des Produkts ist. Höhere Ebenen werden weggelassen, da stattdessen der Mindestendpreis für die Storefront gelten würde.

Gilt für:

  • Einfache Produkte: price.tiers umfasst nur Ebenen mit tier.amount.value < price.final.amount.value (Minimum final).
  • Komplexe Produkte: priceRange.minimum.tiers und priceRange.maximum.tiers verwenden beim Erstellen der Preisspanne dieselbe Regel.

Version 1.41

2. September 2025

Behebung Verbesserte Fehlerbehandlung bei fehlenden Preisinformationen - Wenn die Preisdaten noch nicht eingegangen sind, gibt die API null für das Preisfeld zurück, anstatt einen Fehler auszulösen, sodass Kunden fehlende Daten ordnungsgemäß verarbeiten können.

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um die Leistung und Stabilität zu verbessern.

Version 1.40

30. Juli 2025

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.39

24. Juli 2025

Neu Empfehlungseinheiten nach Einheitenkennung abrufen-Neuer GraphQL-Endpunkt recommendationsByUnitIds ruft Empfehlungseinheiten anhand ihrer eindeutigen ID ab, um den Zugriff flexibler und zielgerichteter zu gestalten.

  • unitIds ist erforderlich (Liste der abzurufenden recIds).

  • Kontextparameter (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) verhalten sich genauso wie in der vorhandenen Recommendations-Abfrage.

  • Beispiel

    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
        }
      }
    }
    

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.38

15. Juli 2025

Neu Produkttypen für Geschenkkarten-Katalog-Storefront-Service unterstützt jetzt Produktattribute als JSON-Objekte oder Arrays und ermöglicht so eine flexible Verwaltung komplexer Typen wie Geschenkkarten.

Version 1.37

20. Juni 2025

Neu Hierarchische Preisbuchkonfiguration - Präzise Preisbereiche für über- und untergeordnete Preisbücher. Berechnungen berücksichtigen Hierarchie und übernommene Regeln; reduziert Preisfehler, wenn mehrere Preisbücher verknüpft sind. Nur Adobe Commerce Optimizer. Siehe Preisbücher.

Neu Schlüssel ohne Unterscheidung von Groß- und Kleinschreibung - Bei Schlüsselsuchen in Abfragen wird jetzt nicht mehr zwischen Groß- und Kleinschreibung unterschieden, wodurch Fehler durch Schlüsselschreibungen reduziert werden.

Version 1.36

20. Juni 2025

Neu Öffentliche I/O-Ereignisse für Katalog-Storefront - Es wurden öffentliche I/O-Ereignisse für die Echtzeit-Integration und -Beobachtbarkeit (CSS und EDS) hinzugefügt.

Neu Server-Side Rendering (SSR) - Architektonische Verbesserungen zur Unterstützung von SSR für bessere Leistung, SEO und UX in großen Katalogen.

Neu Infrastruktur und Sicherheit - Neue AWS-Rollen, ServiceNow-Integration und CI/CD-Pipelines für den Ereignis-Service.

Neu Ereignisformate und Beobachtbarkeit - Optimierte Payloads, verbesserte Überwachung, verbesserte Variantenereignisdaten.

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Frühere Versionen

Version 1.35

13. Juni 2025

Neu Nicht zwischengespeicherte Daten abrufen-Aktivieren Sie die Magento-Is-Preview-Kopfzeile, um nicht zwischengespeicherte Daten vom Katalog-Endpunkt an den Suchdienst zu übergeben.

Neu Produktoptionen mit Mehrfachauswahl-GraphQL-API macht jetzt verfügbar, ob Produktoptionen mehrere Auswahlen zulassen (z. B. Bundle „mehrere Elemente auswählen„).

Neu Aktualisierte Preisvalidierung bei der Datenaufnahme, um Produkte ohne Preise zu unterstützen.

Behebung Verbesserte Fehlerbehandlung für einfache Paketpreise in Adobe Commerce Optimizer.

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.34

23. März 2025

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.33

29. April 2025

Behebung Verbesserungen auf Systemebene und in der Infrastruktur. Die Infrastruktur unterstützt jetzt extrem große Kataloge (bis zu ~440 Millionen SKUs), ohne die vorhandene Arbeitslast zu beeinträchtigen.

Version 1.32

28. März 2025

Beheben Attribute ohne Rollen werden für den zusammenstellbaren Katalog nicht mehr standardmäßig indiziert. Dies verbessert die Indizierungszeit und reduziert den Speicher. Altes Verhalten kann über ein Feature Flag wieder aktiviert werden.

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.31

18. Februar 2025

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.30

9. Dezember 2024

Hauptversion: Zusammensetzbares Katalogdatenmodell für Headless-Storefronts, Header-Management und die Handhabung von Produktdaten.

Neu Zusammensetzbares Katalogdatenmodell (CCDM) - Unterstützt Kunden bei der Verwendung des zusammensetzbaren Katalogs für Headless-Storefronts. Neue Endpunkte akzeptieren Katalogansicht- und Richtlinien-IDs (abwärtskompatibel). Konfigurierbare Produktdetails und Preise mit integrierter Paginierung.

Neu Kopfzeilenverwaltung-AC-Locale für zusammenstellbare Katalog-API-Vorgänge in AC-Scope-Locale umbenannt. Kopfzeilenzuordnung und Standardwerte wurden angegeben.

Neu Produktdaten und Preise-Unterstützung für zusammenstellbares Katalogdatenmodell und verbesserte Preisverwaltung für konfigurierbare Produkte.

CurrencyEnum wurde aktualisiert, um NONE für Produktsuchabfragen zu unterstützen, die an der Verbundlogik ausgerichtet sind.

Behebung Infrastruktur und Upgrades - Verbesserungen auf Systemebene für Sicherheit, Leistung und Stabilität.

Fix Bundle-Produktoptionen zeigen jetzt nur noch aktivierte Produkte an.

Version 1.29

9. Dezember 2024

Neu Bildreihenfolge in Produktabfragen - Produktbilder im Feld "GraphQL-images" folgen jetzt der sortOrder für den Katalogexport, um ein konsistentes Verhalten bei Storefronts und APIs zu gewährleisten.

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.28

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.27

26. September 2024

Beheben Verbesserungen auf Systemebene und in der Infrastruktur, um Sicherheit, Leistung und Stabilität zu verbessern.

Version 1.26

22. Oktober 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Das GraphQL-Schema enthält jetzt lastModifiedAt in Produktinformationen für genaue Sitemaps und die Neuindizierung von Suchmaschinen (z. B. Google).

Version 1.23

22. August 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Fix Produktinformationen können jetzt ohne Produktüberschreibungsdaten (Preise) abgerufen werden. Zuvor haben diese Abfragen Folgendes zurückgegeben: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Version 1.22

13. August 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Unterstützung zum Abrufen aller Varianten nach Produkt-SKU hinzugefügt. Siehe die Catalog Service API-Referenz.

Version 1.19

23. Mai 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Beheben Das InStock für Optionswerte berücksichtigt jetzt den enabled der Produktvariante.

Fix Unterstützung für Produktpreise mit bis zu 16 Stellen und 4 Dezimalstellen hinzugefügt. Synchronisieren Sie über das Data Management-Dashboard oder CLI neu, um Aktualisierungen anzuwenden.

Bekannte Einschränkungen

Die folgenden Funktionen werden noch nicht unterstützt:

  • Die maximale Größe für die Payload dynamischer Attribute beträgt 9 MB.
  • Der Gruppenproduktpreis kann mit einfachen Produktpreisen berechnet werden.
  • In einem Bild-Array enthält nur das erste Bild Rollen.

Verwenden Sie API Mesh und die GraphQL-Kern-API für:

  • Mindestpreis
  • Preisstufe
  • Bundle-Produkte mit Festpreisen

Weitere Informationen und Beispiele finden Sie unter Katalog-Service und API-Mesh.

Version 1.18

11. April 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Es wurde Unterstützung für PHP 8.3 hinzugefügt.

Neu Die products- und refineProduct-Abfragen geben jetzt anpassbare Optionsdaten für einfache und komplexe Produkte zurück.

Version 1.17

22. Februar 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Die Data Management Dashboard ist jetzt für Datenströme verfügbar (Produktempfehlungen, Live-Suche, Katalog-Service). Erfordert catalog-service Metapaket v3.1.0+.

Version v1.16

13. Februar 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Produktvideos werden jetzt von der Catalog Service-API unterstützt.
Beheben Nicht vorrätige Optionen werden jetzt im PDP-Widget angezeigt.

Bekannte Einschränkungen

Diese Funktionen werden noch nicht unterstützt:

  • Die maximale Größe für die Payload dynamischer Attribute beträgt 9 MB.
  • Gruppenproduktpreis. Dieser Wert kann mit einfachen Produktpreisen berechnet werden.
  • In einem Bild-Array enthält nur das erste Bild Rollen.

Verwenden Sie API Mesh und die GraphQL-Kern-API für:

Version 1.13

12. Oktober 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Der Katalog-Service unterstützt das inStock-Flag für Produktvarianten.
Neu Die Felder urlKey und externalId wurden zum GraphQL-Schema hinzugefügt.
Neu Herunterladbare Produkte und Geschenkkarten werden jetzt unterstützt.

Version 1.12

19. September 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Der Katalog-Service verwendet jetzt SaaS-Preisindizierung.
Behebung Diese Version enthält Fehlerbehebungen und Verbesserungen auf der Service-Seite.

Version 1.11

18. Juli 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Der Katalog-Service unterstützt jetzt die recommendations GraphQL-Abfrage für Produktempfehlungen.

Version 1.10

27. Juni 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Die Catalog Service-API unterstützt jetzt related products.

Version v1.7

12. April 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Der Katalog-Service bereinigt jetzt gelöschte Produktvarianten.
Behebung Infrastrukturskalierbarkeit und Leistungsverbesserungen.

Version v1.6

28. März 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Zur products Abfrage wurden Farbfelder hinzugefügt.
Neu Es wurde die Möglichkeit hinzugefügt, entityId mithilfe von API Mesh) ​.

Version v1.5

6. März 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Funktion categories GraphQL hinzugefügt.
Behebung Verbesserte Leistung und API-Skalierbarkeit.

Version v1.4

7. Februar 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer

Neu Veröffentlichtes Katalog-Service-Metapaket zur Vereinfachung der Installationsschritte.
Fix API-Skalierbarkeit und Leistungsverbesserungen.

Version 1.3

17. Januar 2023

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer

Neu Das Onboarding wurde vereinfacht und verbessert.
Neu Neue Kunden-Sandbox-Endpunkte sind für Vorproduktionstests verfügbar.
Neu Unterstützung für virtuelle Produkte hinzugefügt.
Fix API-Skalierbarkeit und Leistungsverbesserungen.

Version v1.1

18. November 2022

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer

Neu Der Katalog-Service unterstützt jetzt das Adobe API Mesh.
Fix Verbesserte API-Skalierbarkeit und Gesamtleistung.

Version 1.0

4. Oktober 2022

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer

Neu Unterstützung für gebündelte und gruppierte Produkte.
Neu Es wurden Überschreibungen der B2B-Sichtbarkeit hinzugefügt. Produkte können jetzt durchsucht und für bestimmte Kundengruppen zum Warenkorb hinzugefügt werden.
Fix Service ist jetzt stabiler und hat die Leistung verbessert.

Version 0.3 - Beta+

12. September 2022

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer

Neu Variantenbilder: Produktbilder werden basierend auf ausgewählten Optionen zurückgegeben.
Neu Preisrollen: Nur Mitglieder bestimmter Kundengruppen können Produktpreise sehen.
Behebung Verbesserte Stabilität und Leistung des Service.
Neu Aktualisierungen werden empfangen, wenn Produkte aus dem Katalog gelöscht werden.

Beta-Version

9. August 2022

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer

Neu Die products- und refineProduct-Abfragen geben die folgenden Daten zurück:

  • Vordefinierte (System-)Produktattribute.
  • Dynamische Produktattribute und deren Filterung nach Rolle (Produktanzeigeseite/Produktlistenseite).
  • Produktoptionen.
  • Produktbilder und Filtern nach Rolle (PDP/PLP).
  • Ein spezifischer Preis für einfache Produkte und Preisspannen für konfigurierbare Produkte.
  • Kundengruppenpreise und Preisspannen. Sie geben einen standardmäßigen Fallback-Preis für Käufer ohne Kundengruppe zurück.
  • Produkttypen, die B2B-kundenspezifische Preise verwenden.

Catalog Service-Metapaket

Aktualisierungen des Katalog-Service PHP-Metapakets (magento/catalog-service).

  • Für Kunden von Adobe Commerce as a Cloud Service wird die neueste Version in Ihrer Umgebung installiert.

  • Für lokale Adobe Commerce on Cloud-Standorte empfiehlt Adobe die Verwendung von Composer , um das Metapaket Catalog Service in Ihren Cloud-Umgebungen auf die neueste Version zu aktualisieren.

Version v3.3.0

14. Oktober 2025

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Data Services-Upgrade - magento/data-services auf ^8.0.0 aktualisiert. Überprüfen Sie vor dem Upgrade die Verwendung der Umgebung und der benutzerdefinierten Data Services-API auf Kompatibilität mit 8.x.
Tee
Neu Aktualisierte Version und Metadaten für die Version 3.3.0.

Version v3.2.0

12. April 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Version und Metadaten aktualisiert für 3.2.0. Keine weiteren Abhängigkeitsänderungen.

Version v3.1.0

26. Januar 2024

[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer

Neu Neue Paketabhängigkeiten hinzugefügt:

  • Category Permission Data Exporter (magento/module-category-permission-data-exporter) zum Exportieren von Kategorieberechtigungsdaten, die vom Katalog-Service verwendet werden.
  • Catalog Sync Admin magento/module-catalog-sync-admin für die Admin-Benutzeroberfläche und Konfiguration im Zusammenhang mit der Katalogsynchronisierung.

Neu Aktualisierte Version und Metadaten für die Version 3.1.0.

Verwandte Dokumentation

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