DokumentationCommerceCatalog Service

Versionsinformation för Commerce Storefront Catalog Service

Senast uppdaterad: 11 maj 2026

Skapat för:

  • Admin

Versionsinformationen innehåller de senaste uppdateringarna av Commerce Catalog Service, inklusive:

NOTE
Om ditt Commerce-projekt använder Adobe Commerce Optimizer för att leverera katalogdata till Commerce Edge Delivery Service eller headless-butiker kan du läsa versionsinformationen för Adobe Commerce Optimizer för de senaste API-uppdateringarna.

Uppdateringar kategoriseras efter typ:

Nya nya funktioner
Korrigera Korrigeringar och förbättringar
Fel Kända fel

Stöd finns för den senaste versionen. Versionsinformation för äldre versioner finns med som referens.

Katalogtjänsten Storefront

Maj 2026

Utgivningsdatum: 13 maj 2026

Nytt Kategorisorteringsordning i GraphQL - GraphQL-typen CategoryView innehåller nu ett positionsfält, så butiker kan visa kategorier i den ordning handlarna har konfigurerat i kataloghierarkin.

Utgivningsdatum: 4 maj 2026

Korrigera Produktpriserna för Storefront visar nu rätt valutakod (till exempel USD) för alla produkttyper. Tidigare visade vissa produkter NONE i stället för den förväntade valutan, vilket resulterade i saknade priser. Den här uppdateringen säkerställer konsekvent och korrekt prisåtergivning i hela butiken.

April 2026

Utgivningsdatum: 29 april 2026

Nytt En begränsning på högst 100 SKU per begäran för Adobe Commerce Optimizer och Adobe Commerce as a Cloud Service
klienter enligt dokumenterade gränser och gränser.

Utgivningsdatum: 17 april 2026

Ny har lagt till en ny searchCategory GraphQL-fråga som gör att klienter kan söka efter kategorier efter namn med sidnumrerade resultat. Frågan accepterar obligatoriska searchTerm (minst 3 tecken) och valfria family-, pageSize- och currentPage-parametrar. Resultaten innehåller matchande CategoryTreeView-objekt med fullständiga kategorimetadata, en totalCount och pageInfo för sidnumrering.

Frågan är bara tillgänglig för kunder som använder Adobe Commerce Optimizer Merchandising Services. Se searchCategory.

Mars 2026

Utgivningsdatum: 24 mars 2026

Nytt Stöd har lagts till för att beräkna och returnera prisintervallet för dynamiska paket.

December 2025

Utgivningsdatum: 11 december 2025

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra prestanda och stabilitet.

November 2025

Utgivningsdatum: 17 november 2025

Nytt Attributfiltrering efter namn-GraphQL-frågan productSearch har nu stöd för filtrering av produktattribut med fältet names. Med det här filtret kan du

  • Minska svarsnyttolastens storlek genom att endast begära specifika attribut

  • Kombinera med det befintliga roles-filtret för att begränsa efter synlighetsroll och attributnamn

  • Exempel:

    Filtrera endast efter attributnamn

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

    Filtrera efter både roller och namn:

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) {
      name
      label
      value
      roles
    }
  }
}
NOTE
Om du vill hämta alla attribut utan filtrering utelämnar du argumentet names eller anger en tom array.

Utgivningsdatum: 6 november 2025

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra prestanda och stabilitet.

Åtgärda Grupperade produkter kan nu efterfrågas när den överordnade inte har något pris; underordnade produkter returnerar sina egna synlighetsroller.

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra prestanda och stabilitet.

September 2025

Utgivningsdatum: 8 september 2025

Nytt Stöd för nivåprissättning har lagts till för att fråga efter volympriser:

Så här hämtar du nivåpriser:

  1. Använd products-frågan med de SKU:er du vill använda
  2. För SimpleProductView, gå till price.tiers
  3. För ComplexProductView, gå till priceRange.minimum.tiers och priceRange.maximum.tiers
  4. Varje skikt innehåller det rabatterade priset tier och villkoren quantity
  5. Definiera tröskelvärden för kvantitet med gte (större än eller lika med) och lt (mindre än)

Exempel:

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

Korrigera Nivåpriser filtrerade efter lägsta slutpris

API:t returnerar nu bara skikt vars rabatterade pris är lägre än produktens lägsta slutliga pris. Högre nivåer utelämnas eftersom det slutliga minimipriset i stället skulle gälla för butiken.

Gäller för:

  • Enkla produkter: price.tiers innehåller bara lager med tier.amount.value < price.final.amount.value (minimum final).
  • Komplexa produkter: priceRange.minimum.tiers och priceRange.maximum.tiers använder samma regel när prisintervallet skapas.

Utgivningsdatum: 2 september 2025

Korrigera Förbättrad felhantering för saknad prisinformation - När prisdata inte har tagits emot ännu returnerar API null för prisfältet i stället för att utlösa ett fel, vilket gör att klienter kan hantera saknade data på ett bra sätt.

Korrigera Förbättringar på systemnivå och infrastruktur för att förbättra prestanda och stabilitet.

Juli 2025

Utgivningsdatum: 30 juli 2025

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Utgivningsdatum: 24 juli 2025

Nytt Hämta rekommendationsenheter efter enhets-ID-Ny GraphQL-slutpunkt recommendationsByUnitIds hämtar rekommendationsenheter med deras unika ID för mer flexibel, riktad åtkomst.

  • unitIds krävs (lista över recIds som ska hämtas).

  • Kontextparametrar (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) fungerar på samma sätt som i den befintliga rekommendationsfrågan.

  • Exempel

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

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Utgivningsdatum: 15 juli 2025

Ny Presentkortsprodukter-Katalogtjänsten Storefront stöder nu produktattribut som JSON-objekt eller -matriser, vilket möjliggör flexibel hantering av komplexa typer som presentkort.

Tidigare versioner

Juni 2025

Utgivningsdatum: 20 juni 2025

Ny Hierarkisk prisbokskonfiguration - Korrekta prisintervall för överordnade/underordnade prisböcker. Beräkningarna respekterar hierarkin och ärvda regler. minskar prisfelen när flera prislistor är kopplade. Endast Adobe Commerce Optimizer. Se Prisböcker.

Nytt Skiftlägeskänsliga tangenter - Nyckelsökningar i frågor är nu skiftlägeskänsliga, vilket minskar antalet fel som beror på tangentförskjutning.

Utgivningsdatum: 20 juni 2025

Nytt Publika IO-händelser för katalogbutiken - Lagt till offentliga IO-händelser för realtidsintegrering och observerbarhet (CSS och EDS).

Nytt SSR (Server-Side Rendering) - Arkitekturförbättringar som stöder SSR för bättre prestanda, SEO och UX för stora kataloger.

Nytt Infrastruktur och säkerhet - Nya AWS-roller, ServiceNow-integrering och CI/CD-pipelines för händelsetjänsten.

Nytt Händelseformat och observerbarhet - Effektivare nyttolaster, förbättrad övervakning, förbättrade data för varianthändelser.

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Utgivningsdatum: 13 juni 2025

Nytt Hämta ocachelagrade data-Aktivera Magento-Is-Preview-rubriken för att skicka ocachelagrade data från katalogslutpunkten till söktjänsten.

Nytt Flervalsproduktalternativ-GraphQL-API:t visar nu om produktalternativ tillåter flera val (t.ex.“välj flera objekt”).

Nytt Prisvalidering vid dataöverföring har uppdaterats för att ge stöd åt produkter utan priser.

Åtgärda Förbättrad felhantering för enkla paketpriser i Adobe Commerce Optimizer.

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

April 2025

Utgivningsdatum: 8 april 2025

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Korrigera Infrastruktur har nu stöd för extremt stora kataloger (upp till cirka 440 miljoner SKU:er) utan att påverka befintliga arbetsbelastningar.

Mars 2025

Utgivningsdatum: 28 mars 2025

Korrigera Attribut utan roller indexeras inte längre som standard för den sammansatta katalogen, vilket förbättrar indexeringstiden och minskar lagringsutrymmet. Äldre beteenden kan återaktiveras via en funktionsflagga.

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Februari 2025

Utgivningsdatum: 18 februari 2025

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

December 2024

Utgivningsdatum: 9 december 2024

Huvudversion: sammansättningsbar katalogdatamodell för headless storefront, rubrikhantering och hantering av produktdata.

Ny CCDM (Composable Catalog Data Model) - Stöder kunder som använder den sammansatta katalogen för headless-butiker. Nya slutpunkter accepterar katalogvy och princip-ID (bakåtkompatibla). Konfigurerbar produktinformation och priser med inbyggd sidnumrering.

Nytt Rubrikhantering-AC-Locale har bytt namn till AC-Scope-Locale för API-åtgärder för sammanställningsbar katalog; huvudmappning och standardvärden har angetts.

Nytt Produktdata och priser-Stöd för datamodell för sammanställningsbar katalog och förbättrad prishantering för konfigurerbara produkter.

CurrencyEnum har uppdaterats med stöd för NONE för produktsökningsfrågor, i linje med federationslogik.

Korrigera Infrastruktur och uppgraderingar - Förbättringar på systemnivå för säkerhet, prestanda och stabilitet.

Åtgärda Produktalternativen för paketet visar nu bara aktiverade produkter.

Utgivningsdatum: 9 december 2024

Nytt Bildbeställning i produktfrågor - Produktbilder i fältet GraphQL images följer nu katalogexport sortOrder för konsekvent butiks- och API-beteende.

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Utgivningsdatum: December 2024

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Oktober 2024

Utgivningsdatum: 22 oktober 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nytt GraphQL-schema innehåller nu lastModifiedAt i produktinformationen för korrekt webbplatskartor och omindexering av sökmotorer (t.ex. Google).

September 2024

Utgivningsdatum: 26 september 2024

Åtgärda Förbättringar på systemnivå och i infrastrukturen för att förbättra säkerhet, prestanda och stabilitet.

Augusti 2024

Utgivningsdatum: 22 augusti 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Korrigera Produktinformation kan nu hämtas utan data för produktåsidosättning (priser). Tidigare returnerade dessa frågor: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Utgivningsdatum: 13 augusti 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nytt Stöd har lagts till för att hämta alla varianter efter produkt-SKU. Se API-referens för katalogtjänsten.

Maj 2024

Utgivningsdatum: 23 maj 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Åtgärda Flaggan InStock för alternativvärden respekterar nu produktvariantens omfångsstatus enabled.

Korrigera Stöd för produktpriser med upp till 16 siffror och 4 decimaler har lagts till. Synkronisera om från kontrollpanelen för datahantering eller CLI för att tillämpa uppdateringar.

Kända begränsningar

Följande funktioner stöds ännu inte:

  • Den största tillåtna storleken för dynamisk attributnyttolast är 9 MB.
  • Gruppens produktpris kan beräknas med enkla produktpriser.
  • I en bildarray innehåller endast den första bilden roller.

Använd API Mesh och Core GraphQL API för:

  • Lägsta kampanjpris
  • Nivåpriser
  • Paketprodukter med fasta priser

Mer information och exempel finns i Katalogtjänst och API-nät.

April 2024

Utgivningsdatum: 11 april 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nytt Stöd för PHP 8.3 har lagts till.

Nytt products - och refineProduct-frågorna returnerar nu anpassningsbara alternativdata för både enkla och komplexa produkter.

Februari 2024

Utgivningsdatum: 22 februari 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nytt Data Management Dashboard är nu tillgängligt för dataströmmar (produktrekommendationer, Live Search, katalogtjänst). Kräver catalog-service metapaket v3.1.0+.

Utgivningsdatum: 13 februari 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nya produktvideor stöds nu av katalogtjänstens API.
Korrigera Utmediefiler visas nu i PDP-widgeten.

Kända begränsningar

Dessa funktioner stöds ännu inte:

  • Den största tillåtna storleken för dynamisk attributnyttolast är 9 MB.
  • Gruppproduktpris. Detta värde kan beräknas med enkla produktpriser.
  • I en bildarray innehåller endast den första bilden roller.

Använd API Mesh och Core GraphQL API för:

Oktober 2023

Utgivningsdatum: 12 oktober 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny katalogtjänst stöder flaggan inStock för produktvarianter.
Nytt Fälten urlKey och externalId har lagts till i GraphQL-schemat.
Nya hämtningsbara produkter och presentkort stöds nu.

September 2023

Utgivningsdatum: 19 september 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny katalogtjänst använder nu SaaS-prisindexering.
Korrigera Den här versionen innehåller felkorrigeringar och förbättringar på tjänstsidan.

Juli 2023

Utgivningsdatum: 18 juli 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny katalogtjänst har nu stöd för GraphQL-frågan recommendations för produktrekommendationer.

Juni 2023

Utgivningsdatum: 27 juni 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nytt Katalogtjänstens API har nu stöd för related products.

April 2023

Utgivningsdatum: 12 april 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny katalogtjänst rensar nu bort produktvarianter som tagits bort.
Korrigera Infrastrukturskalbarhet och prestandaförbättringar.

Mars 2023

Utgivningsdatum: 28 mars 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nya tillagda färgrutor i frågan products.
Nytt har lagt till möjligheten att hämta entityId med API-nät.

Utgivningsdatum: 6 mars 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny tillagd categories GraphQL-funktionalitet.
Korrigera Förbättrade prestanda och API-skalbarhet.

Februari 2023

Utgivningsdatum: 7 februari 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.x och senare

Nytt Katalogtjänstmetapaket har publicerats för att förenkla installationsstegen.
Åtgärda API-skalbarhet och prestandaförbättringar.

Januari 2023

Utgivningsdatum: 17 januari 2023

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.x och senare

Nytt Förenklat och förbättrat startupplevelsen.
Nya slutpunkter för kundsandlådan är tillgängliga för testning före produktion.
Nytt -stöd har lagts till för virtuella produkter.
Åtgärda API-skalbarhet och prestandaförbättringar.

November 2022

Utgivningsdatum: 18 november 2022

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.x och senare

Ny katalogtjänst har nu stöd för Adobe API Mesh.
Korrigera Förbättrad API-skalbarhet och övergripande prestanda.

Oktober 2022

Utgivningsdatum: 4 oktober 2022

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.x och senare

Nytt -stöd för paketerade och grupperade produkter.
Ny har lagt till åsidosättningar av B2B-synlighet. Produkterna är nu sökbara och kan läggas till i kundvagnen för specifika kundgrupper.
Korrigera -tjänsten är nu stabilare och har förbättrat prestandan.

September 2022

Utgivningsdatum: 12 september 2022

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.x och senare

Nya variantbilder: produktbilder returneras baserat på valda alternativ.
Nya prisroller: endast medlemmar i specifika kundgrupper kan se produktpriser.
Korrigera Förbättrad stabilitet och prestanda för tjänsten.
Nya uppdateringar tas emot när produkter tas bort från katalogen.

Augusti 2022

Utgivningsdatum: 9 augusti 2022

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.x och senare

Nya products - och refineProduct-frågor returnerar följande data:

  • Fördefinierade produktattribut (system).
  • Dynamiska produktattribut och filtrera dem efter roll (produktvisningssida/produktlistsida).
  • Produktalternativ.
  • Produktbilder och filtrera dem efter roll (PDP/PLP).
  • Ett specifikt pris för enkla produkter och prisintervall för konfigurerbara produkter.
  • Kundgruppspriser och prisintervall. De returnerar ett standardgrundpris för kunderna utan någon kundgrupp.
  • Produkttyper där B2B-kundspecifika priser används.

Metapaket för katalogtjänst

Uppdateringar av PHP-metapaketet för katalogtjänsten (magento/catalog-service).

  • För Adobe Commerce as a Cloud Service-kunder installeras den senaste versionen i din miljö.

  • För Adobe Commerce i molnet eller lokalt rekommenderar Adobe att du använder Composer för att uppgradera Catalog Service-metapaketet i dina molnmiljöer.

v3.3.0-utgåva

Utgivningsdatum: 14 oktober 2025

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny Data Services-uppgradering—magento/data-services-beroendet har uppdaterats till ^8.0.0. Verifiera miljön och anpassad API-användning för datatjänster för 8.x-kompatibilitet innan du uppgraderar.

Nytt Uppdaterad version och metadata för version 3.3.0.

v3.2.0-utgåva

Utgivningsdatum: 12 april 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Ny -version och metadata har uppdaterats för 3.2.0. Inga andra beroendeändringar.

v3.1.0-utgåva

Utgivningsdatum: 26 januari 2024

[Stöds]{class="badge informative" title="Stöds"} Adobe Commerce version 2.4.4 och senare

Nytt har lagt till nya paketberoenden:

  • Datautexporterare för kategoribehörighet (magento/module-category-permission-data-exporter) för export av kategoribehörighetsdata som används av katalogtjänsten.
  • Katalogsynkroniseringsadministratör magento/module-catalog-sync-admin för administratörsgränssnitt och konfiguration som är relaterad till katalogsynkronisering.

Nytt Uppdaterad version och metadata för version 3.1.0.

Installationsprogram för katalogtjänst

Installationsprogrammet levereras med tillägget Katalogtjänst och hanterar installations- och miljökontroller så att katalogtjänsten matchar din Commerce-stack.

  • För Adobe Commerce as a Cloud Service-kunder installeras den senaste installationsversionen i din miljö.

  • För Adobe Commerce i molninfrastrukturen eller på plats måste installationsprogrammet vara justerat efter katalogtjänstmetapaketet.

När du uppgraderar magento/catalog-service med Composer uppdateras installationspaketet automatiskt till den senaste versionen. Du kan också använda Composer för att uppgradera magento/catalog-service-installer separat när versionsinformationen beskriver en ändring som du behöver, till exempel stöd för en ny PHP-version. På så sätt förblir installationsverktygen kompatibla med den katalogtjänstversion du kör.

v1.0.6-utgåva

Utgivningsdatum: 25 mars 2026

Nytt PHP 8.5 - Garanterar kompatibilitet när katalogtjänsten används i PHP 8.5.

Relaterad dokumentation

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