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.
Weitere zu diesen APIs finden in der Commerce Developer-Dokumentation unter „Schema für Storefront-Services“.
-
Catalog Service Metapaket-Versionen
- Abhängigkeiten wurden aktualisiert, um die Leistung, Stabilität und Kompatibilität mit anderen Adobe Commerce-Komponenten zu verbessern.
-
Catalog Service-Installationsprogrammversionen
- Abhängigkeiten wurden aktualisiert, um die Kompatibilität zwischen dem Katalog-Service und Ihrem Commerce-Stack zu gewährleisten.
Aktualisierungen werden nach Typ kategorisiert:
Unterstützung wird für die neueste Version bereitgestellt. Versionshinweise für ältere Versionen sind als Referenz enthalten.
Storefront Catalog Service
Mai 2026
Veröffentlichungsdatum: 4. Mai 2026
NONE anstelle der erwarteten Währung, was zu fehlenden Preisen führte. Diese Aktualisierung gewährleistet ein konsistentes und genaues Preis-Rendering in der Storefront.
April 2026
Veröffentlichungsdatum:. April 2026
Clients gemäß dokumentierte Beschränkungen und
Veröffentlichungsdatum:. April 2026
searchCategory GraphQL-Abfrage hinzugefügt, mit der Kunden Kategorien anhand des Namens mit paginierten Ergebnissen suchen können. Die Abfrage akzeptiert eine erforderliche searchTerm (mindestens 3 Zeichen) und optionale family-, pageSize- und currentPage. Zu den Ergebnissen gehören der Abgleich von CategoryTreeView mit vollständigen Kategoriemetadaten, ein totalCount und pageInfo für die Paginierung.
Diese Abfrage ist nur für Kunden verfügbar, die Adobe Commerce Optimizer Merchandising Services verwenden. Siehe searchCategory.
März 2026
Veröffentlichungsdatum: 24. März 2026
Dezember 2025
Veröffentlichungsdatum:. Dezember 2025
November 2025
Veröffentlichungsdatum: 17. November 2025
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 } } }
names-Argument weg oder geben Sie ein leeres -Array an.Veröffentlichungsdatum:. November 2025
September 2025
Veröffentlichungsdatum:. September 2025
So rufen Sie die Preisstufe ab:
- Verwenden der
productsAbfrage mit Ihren gewünschten SKUs - Greifen Sie für SimpleProductView auf
price.tierszu - Greifen Sie für ComplexProductView auf
priceRange.minimum.tiersundpriceRange.maximum.tierszu. - Jede Stufe enthält die ermäßigten
tier- undquantity - Mengenschwellenwerte mit
gte(größer oder gleich) undlt(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 }
}
}
}
}
}
}
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.tiersumfasst nur Ebenen mittier.amount.value<price.final.amount.value(Minimum final). - Komplexe Produkte:
priceRange.minimum.tiersundpriceRange.maximum.tiersverwenden beim Erstellen der Preisspanne dieselbe Regel.
Veröffentlichungsdatum:. September 2025
null für das Preisfeld zurück, anstatt einen Fehler auszulösen, sodass Kunden fehlende Daten ordnungsgemäß verarbeiten können.
Juli 2025
Veröffentlichungsdatum:. Juli 2025
Veröffentlichungsdatum: 24. Juli 2025
recommendationsByUnitIds ruft Empfehlungseinheiten anhand ihrer eindeutigen ID ab, um den Zugriff flexibler und zielgerichteter zu gestalten.
-
unitIdsist 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 } } }
Veröffentlichungsdatum: 15. Juli 2025
Juni 2025
Veröffentlichungsdatum:. Juni 2025
Veröffentlichungsdatum:. Juni 2025
Veröffentlichungsdatum:. Juni 2025
Magento-Is-Preview-Kopfzeile, um nicht zwischengespeicherte Daten vom Katalog-Endpunkt an den Suchdienst zu übergeben.
April 2025
Veröffentlichungsdatum:. April 2025
März 2025
Veröffentlichungsdatum: 28. März 2025
Februar 2025
Veröffentlichungsdatum: 18. Februar 2025
Dezember 2024
Veröffentlichungsdatum:. Dezember 2024
Hauptversion: Zusammensetzbares Katalogdatenmodell für Headless-Storefronts, Header-Management und die Handhabung von Produktdaten.
AC-Locale für zusammenstellbare Katalog-API-Vorgänge in AC-Scope-Locale umbenannt. Kopfzeilenzuordnung und Standardwerte wurden angegeben.
CurrencyEnum wurde aktualisiert, um NONE für Produktsuchabfragen zu unterstützen, die an der Verbundlogik ausgerichtet sind.
Veröffentlichungsdatum:. Dezember 2024
images” folgen jetzt der sortOrder für den Katalogexport, um ein konsistentes Verhalten bei Storefronts und APIs zu gewährleisten.
Veröffentlichungsdatum: Dezember 2024
Oktober 2024
Veröffentlichungsdatum:. Oktober 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
lastModifiedAt in Produktinformationen für genaue Sitemaps und die Neuindizierung von Suchmaschinen (z. B. Google).
September 2024
Veröffentlichungsdatum: 26. September 2024
August 2024
Veröffentlichungsdatum: 22. August 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.
Veröffentlichungsdatum:. August 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Mai 2024
Veröffentlichungsdatum:. Mai 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
InStock-Flag für Optionswerte berücksichtigt jetzt den enabled der Produktvariante.
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.
April 2024
Veröffentlichungsdatum:. April 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
products- und refineProduct-Abfragen geben jetzt anpassbare Optionsdaten für einfache und komplexe Produkte zurück.
Februar 2024
Veröffentlichungsdatum: 22. Februar 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
catalog-service Metapaket v3.1.0+.
Veröffentlichungsdatum: 13. Februar 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
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:
- Mindestpreis
- Preisstufe
Oktober 2023
Veröffentlichungsdatum:. Oktober 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
inStock-Flag für Produktvarianten.
urlKey und externalId wurden zum GraphQL-Schema hinzugefügt.
September 2023
Veröffentlichungsdatum:. September 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Juli 2023
Veröffentlichungsdatum: 18. Juli 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
recommendations GraphQL-Abfrage für Produktempfehlungen.
Juni 2023
Veröffentlichungsdatum: 27. Juni 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
related products.
April 2023
Veröffentlichungsdatum:. April 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
März 2023
Veröffentlichungsdatum: 28. März 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
products Abfrage wurden Farbfelder hinzugefügt.
entityId mithilfe von API Mesh) .
Veröffentlichungsdatum:. März 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
categories GraphQL hinzugefügt.
Februar 2023
Veröffentlichungsdatum: 7. Februar 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Januar 2023
Veröffentlichungsdatum: 17. Januar 2023
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
November 2022
Veröffentlichungsdatum: 18. November 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
Oktober 2022
Veröffentlichungsdatum:. Oktober 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
September 2022
Veröffentlichungsdatum:. September 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
August 2022
Veröffentlichungsdatum:. August 2022
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.x und neuer
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 Adobe Commerce in der Cloud oder On-Premise empfiehlt Adobe die Verwendung von Composer , um das Catalog Service-Metapaket in Ihren Cloud-Umgebungen auf die neueste Version zu aktualisieren.
Version v3.3.0
Veröffentlichungsdatum:. Oktober 2025
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
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.
Version v3.2.0
Veröffentlichungsdatum:. April 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
Version v3.1.0
Veröffentlichungsdatum: 26. Januar 2024
[Unterstützt]{class="badge informative" title="Unterstützt"} Adobe Commerce-Versionen 2.4.4 und neuer
- 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-adminfür die Admin-Benutzeroberfläche und Konfiguration im Zusammenhang mit der Katalogsynchronisierung.
Installationsprogramm für den Katalog-Service
Das Installationsprogramm wird mit der Catalog Service-Erweiterung bereitgestellt und verarbeitet Installations- und Umgebungsprüfungen, damit der Katalog-Service mit Ihrem Commerce-Stack übereinstimmt.
-
Für Kunden von Adobe Commerce as a Cloud Service) wird die neueste Installationsprogrammversion in Ihrer Umgebung installiert.
-
Halten Sie bei Adobe Commerce in der Cloud Infrastruktur oder On-Premise das Installationsprogramm mit dem Metapaket Katalog-Service) .
Jedes Mal, wenn Sie Composer zum Aktualisieren des magento/catalog-service verwenden, wird das Installationspaket automatisch auf die neueste Version aktualisiert. Sie können Composer auch verwenden, um magento/catalog-service-installer separat zu aktualisieren, wenn diese Versionshinweise eine Änderung beschreiben, die Sie benötigen, z. B. Unterstützung für eine neue PHP-Version. Auf diese Weise bleiben Ihre Installations-Tools mit der von Ihnen ausgeführten Version des Katalog-Service kompatibel.
Version v1.0.6
Veröffentlichungsdatum: 25. März 2026
Verwandte Dokumentation
-
Informationen zu Projekten, die in **Adobe Commerce in der Cloud, lokal oder in Adobe Commerce as a Cloud Service bereitgestellt werden, finden Sie in der folgenden Dokumentation:
-
Informationen zu Projekten, die Adobe Commerce Optimizer oder Adobe Commerce Optimizer Connector verwenden, finden Sie in der folgenden Dokumentation: