DokumentationHandelCatalog Service Användarhandbok

Versionsinformation för Commerce Storefront Catalog Service

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

Skapat för:

  • Administratör

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

  • Storefront Catalog Service släpper

    • API-schemaförbättringar för katalogtjänst för förbättrad datahämtning.
    • Förbättringar av säkerhet, prestanda och tillförlitlighet för Catalog Service API och underliggande infrastruktur.

  • Metapaketversioner för katalogtjänst

    • Uppdaterade beroenden för bättre prestanda, stabilitet och kompatibilitet med andra Adobe Commerce-komponenter.

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

v1.48-utgåvan

19 februari 2025

Nytt Frågan categoryTree i GraphQL API returnerar nu kategoribeskrivningar, bilder och SEO-metataggar. Den här uppdateringen innehåller de data som utvecklare av butiker behöver för att visa kategoribilder och förbättra sökmotoroptimeringen med korrekta metatitlar, beskrivningar och nyckelord. Stöds endast för Commerce-implementeringar som använder datamodellen för sammansatta kataloger för headless-butiker<

Version v1.47

12 februari 2025

Nytt API-tjänsten har nu stöd för typen CategoryProductView, vilket möjliggör förbättrade vyer och frågor för produkter per kategori. Med den här uppdateringen kan utvecklare effektivt hämta och filtrera produktdata baserat på kategori, vilket förbättrar flexibiliteten och prestandan för kategoristyrda användningsfall. Mer information finns i Implementera kategorier på butiken. Stöds endast för Commerce-implementeringar som använder datamodellen composiable catalog för headless Store

Version v1.46

11 december 2025

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

Version v1.45

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 detta filter 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.

Version v1.44

6 november 2025

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

Version v1.43

3 november 2025

Nytt Produktlager för flerdimensionell produktanpassning - Stöd har lagts till för kanalspecifik lokal innehållsleverans för Adobe Commerce Optimizer-implementeringar.

  • Leverera olika produktinnehåll till olika kundsegment

  • Använda språkspecifika anpassningar utan att duplicera basdata

  • Kontrollera fältnivååsidosättningar med lagermasker

  • Stöd för förstklassiga, säsongsrelaterade och mobiloptimerade innehållslager

    Lager hämtas med den befintliga products-frågan, används på serversidan från begärandehuvuden och inga schemaändringar krävs. Se Kataloglager i Adobe Commerce Optimizer Guide.

Korrigera Grupperade produkter kan nu efterfrågas när den överordnade inte har några priser. 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.

Version v1.42

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.

Version v1.41

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.

Version v1.40

30 juli 2025

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

v1.39-utgåvan

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.

v1.38-utgåvan

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.

Version v1.37

20 juni 2025

Ny Hierarkisk prisbokskonfiguration - Korrekta prisintervall för överordnade/underordnade prisböcker. Beräkningar respekterar hierarkin och ärvda regler. Minskar prissättningsfel när flera prisböcker ä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.

Version v1.36

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.

Tidigare versioner

Version v1.35

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.

Version v1.34

23 mars 2025

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

Version v1.33

29 april 2025

Åtgärda Förbättringar på systemnivå och i infrastrukturen. Infrastrukturen har nu stöd för extremt stora kataloger (upp till ca 440 miljoner SKU:er) utan att påverka befintliga arbetsbelastningar.

Version v1.32

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.

Version v1.31

18 februari 2025

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

Version v1.30

9 december 2024

Huvudversion: sammansättningsbar katalogdatamodell för headless-butiker, 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 Sidhuvudshantering-AC-Locale har bytt namn till AC-Scope-Locale för API-åtgärder för sammansättningsbar 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.

Version v1.29

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.

Version v1.28

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

Version v1.27

26 september 2024

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

Version v1.26

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

Version v1.23

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 returnerades följande frågor: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Version v1.22

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änst.

Version v1.19

23 maj 2024

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

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

Version v1.18

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.

Version v1.17

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

Version v1.16

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:

Version v1.13

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.

Version v1.12

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.

Version v1.11

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.

Version v1.10

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.

v1.7-utgåva

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.

v1.6-utgåva

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.

v1.5-utgåva

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.

v1.4-utgåva

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.

v1.3-utgåva

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.

v1.1-utgåva

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.

v1.0-utgåva

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.

0.3-utgåvan - Beta+

12 september 2022

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

Nytt Variantbilder: produktbilder returneras baserat på valda alternativ.
Ny 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.

Beta Release

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 rekommenderar Adobe att du använder Composer för att uppgradera Catalog Service-metapaketet i dina molnmiljöer.

v3.3.0-utgåva

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.
ea
Nytt Uppdaterad version och metadata för version 3.3.0.

v3.2.0-utgåva

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

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.

Relaterad dokumentation

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