DocumentazioneCommerceGuida Catalog Service

Note sulla versione Commerce Storefront Catalog Service

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

Creato per:

  • Amministratore

Queste note sulla versione descrivono gli ultimi aggiornamenti di Commerce Catalog Service, inclusi:

  • Versioni di Storefront Catalog Service

    • Miglioramenti allo schema API di Catalog Service per un migliore recupero dei dati.
    • Miglioramenti a livello di sicurezza, prestazioni e affidabilità per l’API Catalog Service e l’infrastruttura sottostante.

  • Versioni del metapacchetto Catalog Service

    • Sono state aggiornate le dipendenze per migliorare le prestazioni, la stabilità e la compatibilità con altri componenti di Adobe Commerce.

Gli aggiornamenti sono suddivisi per tipo:

Nuove nuove funzionalità
Correzioni correzioni e miglioramenti
Bug problemi noti

È disponibile il supporto per la versione più recente. Sono incluse per riferimento le note sulla versione per le versioni precedenti.

Servizio catalogo vetrina

versione v1.48

19 febbraio 2025

Nuovo La query categoryTree nell'API di GraphQL ora restituisce descrizioni di categorie, immagini e metatag SEO. Questo aggiornamento fornisce i dati necessari agli sviluppatori di vetrine per visualizzare le immagini delle categorie e migliorare l’ottimizzazione dei motori di ricerca con metatitoli, descrizioni e parole chiave appropriati. Supportato solo nelle implementazioni di Commerce che utilizzano il modello dati catalogo componibile per vetrine headless<

versione v1.47

12 febbraio 2025

Nuovo Il servizio API ora supporta il tipo CategoryProductView, abilitando visualizzazioni e query avanzate per i prodotti per categoria. Questo aggiornamento consente agli sviluppatori di recuperare e filtrare in modo efficiente i dati di prodotto in base alla categoria, migliorando la flessibilità e le prestazioni per i casi d’uso basati sulle categorie. Per ulteriori dettagli, vedere Implementare le categorie nella vetrina. Supportato solo nelle implementazioni di Commerce che utilizzano il modello dati catalogo componibile per gli storefront headless

versione v1.46

11 dicembre 2025

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare prestazioni e stabilità.

versione v1.45

17 novembre 2025

Nuovo Filtro attributi per nome-La query di GraphQL productSearch ora supporta il filtro degli attributi di prodotto con il campo names. Con questo filtro è possibile:

  • Riduci la dimensione del payload di risposta richiedendo solo attributi specifici

  • Combina con il filtro roles esistente per restringere per ruolo di visibilità e nome attributo

  • Esempi:

    Filtra solo per nomi di attributo

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

    Filtra per ruoli e nomi:

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) {
      name
      label
      value
      roles
    }
  }
}
NOTE
Per recuperare tutti gli attributi senza filtro, omettere l'argomento names o fornire una matrice vuota.

versione v1.44

6 novembre 2025

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare prestazioni e stabilità.

versione v1.43

3 novembre 2025

Nuovo Livelli di prodotto per la personalizzazione di prodotti multidimensionali. È stato aggiunto il supporto per la distribuzione di contenuti specifici per canale e in base alle impostazioni locali per le implementazioni di Adobe Commerce Optimizer.

  • Distribuire contenuti di prodotti diversi a segmenti di clienti diversi

  • Applicare personalizzazioni specifiche delle impostazioni internazionali senza duplicare i dati di base

  • Controllare le sostituzioni a livello di campo con le maschere di livello

  • Supporto per livelli di contenuto premium, stagionali e ottimizzati per dispositivi mobili

    I livelli vengono recuperati utilizzando la query products esistente, vengono applicati sul lato server dalle intestazioni delle richieste e non richiedono modifiche allo schema. Vedi Livello catalogo nella Guida di Adobe Commerce Optimizer.

Correzione È ora possibile eseguire una query sui prodotti raggruppati quando il padre non ha alcun prezzo; i prodotti secondari restituiscono i propri ruoli di visibilità.

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare prestazioni e stabilità.

versione v1.42

8 settembre 2025

Nuovo Aggiunta del supporto per la determinazione dei prezzi per il livello per la determinazione dei prezzi per il volume delle query:

Per recuperare i prezzi dei livelli:

  1. Utilizza la query products con gli SKU desiderati
  2. Per SimpleProductView, accedere a price.tiers
  3. Per ComplexProductView, accedere a priceRange.minimum.tiers e priceRange.maximum.tiers
  4. Ogni livello contiene il prezzo scontato tier e le condizioni quantity
  5. Definisci soglie quantità con gte (maggiore o uguale a) e lt (minore di)

Esempio:

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

Correzione I prezzi di livello sono filtrati in base al prezzo finale minimo

L'API ora restituisce solo i livelli il cui prezzo scontato è inferiore al prezzo finale minimo del prodotto. I livelli più alti vengono omessi perché il prezzo finale minimo si applicherebbe invece alla vetrina.

Si applica a:

  • Prodotti semplici: price.tiers include solo livelli con tier.amount.value < price.final.amount.value (minimo finale).
  • Prodotti complessi: priceRange.minimum.tiers e priceRange.maximum.tiers utilizzano la stessa regola per la creazione dell'intervallo di prezzi.

versione v1.41

2 settembre 2025

Correzione È stata migliorata la gestione degli errori per le informazioni sul prezzo mancanti. Quando i dati sul prezzo non vengono ancora ricevuti, l'API restituisce null per il campo del prezzo invece di generare un errore, consentendo ai client di gestire i dati mancanti in modo corretto.

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare le prestazioni e la stabilità.

versione v1.40

30 luglio 2025

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.39

24 luglio 2025

Nuovo Recupera unità di consigli per ID unità-Il nuovo endpoint GraphQL recommendationsByUnitIds recupera le unità di consigli in base al loro ID univoco per un accesso più flessibile e mirato.

  • unitIds è obbligatorio (elenco di recId da recuperare).

  • I parametri di contesto (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) si comportano come nella query di consigli esistente.

  • Esempio

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

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.38

15 luglio 2025

Nuovo Tipi di prodotto per le carte regalo-Catalog Storefront Service ora supporta gli attributi di prodotto come oggetti o array JSON, consentendo una gestione flessibile di tipi complessi come le gift card.

versione v1.37

20 giugno 2025

Nuovo Configurazione gerarchica del listino prezzi: intervalli di prezzi precisi per i listini prezzi padre-figlio. I calcoli rispettano la gerarchia e le regole ereditate; riducono gli errori di determinazione prezzi quando più listini prezzi sono collegati. Solo Adobe Commerce Optimizer. Consulta Libri Prezzi.

Nuovo Chiavi senza distinzione tra maiuscole e minuscole. Le ricerche di chiavi nelle query non fanno distinzione tra maiuscole e minuscole, riducendo gli errori relativi alle maiuscole e minuscole.

versione v1.36

20 giugno 2025

Nuovi Eventi I/O pubblici per Catalog Storefront. Sono stati aggiunti eventi I/O pubblici per l'integrazione e l'osservabilità in tempo reale (CSS ed EDS).

Nuovo Server-Side Rendering (SSR)—Miglioramenti architetturali per supportare SSR per migliori prestazioni, SEO e UX in cataloghi di grandi dimensioni.

Nuovo Infrastruttura e sicurezza: nuovi ruoli AWS, integrazione ServiceNow e pipeline CI/CD per il servizio eventi.

Nuovo Formati degli eventi e osservabilità—Payload semplificati, monitoraggio migliorato, dati evento variante migliorati.

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

Versioni precedenti

versione v1.35

13 giugno 2025

Nuovo Recupera dati non memorizzati in cache-Abilita l'intestazione Magento-Is-Preview per passare dati non memorizzati in cache dall'endpoint del catalogo al servizio di ricerca.

Nuovo Opzioni di prodotto a selezione multipla-L'API GraphQL ora indica se le opzioni di prodotto consentono selezioni multiple (ad esempio, il bundle "scegli più elementi").

Nuovo È stata aggiornata la convalida del prezzo all'acquisizione dei dati per supportare i prodotti senza prezzi.

Correzione è stata migliorata la gestione degli errori per i prezzi dei bundle semplici in Adobe Commerce Optimizer.

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.34

23 marzo 2025

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.33

29 aprile 2025

Correzione miglioramenti a livello di sistema e di infrastruttura. L'infrastruttura ora supporta cataloghi di grandi dimensioni (fino a circa 440 milioni di SKU) senza influire sui carichi di lavoro esistenti.

versione v1.32

28 marzo 2025

Correzione Gli attributi senza ruoli non vengono più indicizzati per impostazione predefinita per il catalogo componibile, migliorando il tempo di indicizzazione e riducendo l'archiviazione. Il comportamento legacy può essere riabilitato tramite un flag di funzione.

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.31

18 febbraio 2025

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.30

9 dicembre 2024

Versione principale: modello dati catalogo componibile per vetrine headless, gestione intestazione e gestione dati prodotto.

Nuovo Composable Catalog Data Model (CCDM)—Supporta i clienti che utilizzano il catalogo componibile per vetrine headless. I nuovi endpoint accettano gli ID di criteri e vista catalogo (compatibili con le versioni precedenti). Dettagli prodotto configurabili e prezzi con impaginazione incorporata.

Nuovo Gestione intestazioni-AC-Locale rinominato in AC-Scope-Locale per le operazioni API del catalogo componibile. Sono stati specificati il mapping delle intestazioni e i valori predefiniti.

Nuovo Dati di prodotto e prezzi-Supporto per il modello di dati di catalogo componibile e migliore gestione dei prezzi per i prodotti configurabili.

CurrencyEnum aggiornato per supportare NONE per le query di ricerca prodotti, in allineamento con la logica di federazione.

Correzione Infrastruttura e aggiornamenti: miglioramenti a livello di sistema per sicurezza, prestazioni e stabilità.

Correzione Le opzioni del prodotto del bundle ora visualizzano solo i prodotti abilitati.

versione v1.29

9 dicembre 2024

Nuovo Ordinamento delle immagini nelle query di prodotto. Le immagini di prodotto nel campo GraphQL images ora seguono l'esportazione del catalogo sortOrder per un comportamento coerente in vetrina e API.

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.28

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.27

26 settembre 2024

Correzione miglioramenti a livello di sistema e di infrastruttura per migliorare la sicurezza, le prestazioni e la stabilità.

versione v1.26

22 ottobre 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Il nuovo schema di GraphQL ora include lastModifiedAt nelle informazioni sul prodotto per mappe del sito precise e reindicizzazione del motore di ricerca (ad esempio, Google).

versione v1.23

22 agosto 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Correzione È ora possibile recuperare le informazioni sul prodotto senza i dati di sostituzione (prezzi) del prodotto. In precedenza, queste query restituivano: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

versione v1.22

13 agosto 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovo è stato aggiunto il supporto per recuperare tutte le varianti per SKU prodotto. Vedi il riferimento API di Catalog Service.

versione v1.19

23 maggio 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Correzione Il flag InStock per i valori delle opzioni ora rispetta lo stato enabled con ambito della variante di prodotto.

Correzione È stato aggiunto il supporto per i prezzi dei prodotti fino a 16 cifre e 4 cifre decimali. Risincronizza dal dashboard di gestione dati o CLI per applicare gli aggiornamenti.

Limitazioni note

Le seguenti funzioni non sono ancora supportate:

  • La dimensione massima per il payload degli attributi dinamici è di 9 MB.
  • Il prezzo del prodotto del gruppo può essere calcolato con prezzi del prodotto semplici.
  • In un array di immagini, solo la prima immagine contiene ruoli.

Utilizza API Mesh e l’API core di GraphQL per:

  • Prezzo minimo annunciato
  • Prezzi a livelli
  • Prodotti in bundle a prezzi fissi

Per ulteriori dettagli ed esempi, vedere Catalog Service and API Mesh.

versione v1.18

11 aprile 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovo aggiunto supporto per PHP 8.3.

Nuovo Le query products e refineProduct ora restituiscono dati di opzioni personalizzabili per prodotti semplici e complessi.

versione v1.17

22 febbraio 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovo Data Management Dashboard è ora disponibile per i flussi di dati (Product Recommendations, Live Search, Catalog Service). Richiede catalog-service metapackage v3.1.0+.

versione v1.16

13 febbraio 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

I nuovi video di prodotto sono ora supportati dall'API Catalog Service.
Correzione Le opzioni esaurite sono ora visualizzate nel widget PDP.

Limitazioni note

Queste funzioni non sono ancora supportate:

  • La dimensione massima per il payload degli attributi dinamici è di 9 MB.
  • Prezzo del prodotto di gruppo. Questo valore può essere calcolato con prezzi dei prodotti semplici.
  • In un array di immagini, solo la prima immagine contiene ruoli.

Utilizza API Mesh e l’API core di GraphQL per:

versione v1.13

12 ottobre 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

New Catalog Service supporta il flag inStock per le varianti di prodotto.
Nuovo I campi urlKey e externalId sono stati aggiunti allo schema di GraphQL.
Sono ora supportati Nuovi prodotti scaricabili e gift card.

versione v1.12

19 settembre 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

New Catalog Service ora utilizza l'indicizzazione dei prezzi SaaS 🔗.

Correzione Questa versione contiene correzioni di bug e miglioramenti sul lato servizio.

versione v1.11

18 luglio 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

New Catalog Service ora supporta la query GraphQL recommendations per i consigli di prodotto.

versione v1.10

27 giugno 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovo L'API di Catalog Service ora supporta related products.

versione v1.7

12 aprile 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

New Catalog Service ora ripulisce le varianti di prodotto eliminate.
Correggi Miglioramenti a livello di scalabilità e prestazioni dell'infrastruttura.

versione v1.6

28 marzo 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovi campioni aggiunti alla query products.
Nuovo Aggiunta la possibilità di ottenere entityId utilizzando Mesh API.

versione v1.5

6 marzo 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovo Aggiunta funzionalità di categories GraphQL.
Correzione Prestazioni e scalabilità API migliorate.

versione v1.4

7 febbraio 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.x e successive

Nuovo Metapackage del servizio catalogo pubblicato per semplificare i passaggi dell'installazione.
Correggi miglioramenti a livello di scalabilità e prestazioni dell'API.

versione v1.3

17 gennaio 2023

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.x e successive

Nuovo ha semplificato e migliorato l'esperienza di onboarding.
Nuovi nuovi endpoint sandbox del cliente sono disponibili per il test di pre-produzione.
Nuovo supporto aggiunto per i prodotti virtuali.
Correggi miglioramenti a livello di scalabilità e prestazioni dell'API.

versione v1.1

18 novembre 2022

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.x e successive

New Catalog Service ora supporta API Mesh di Adobe.
Correzione Miglioramento della scalabilità API e delle prestazioni complessive.

versione v1.0

4 ottobre 2022

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.x e successive

Nuovo supporto per prodotti raggruppati e raggruppati.
Nuovo Aggiunte Override Di Visibilità B2B. È ora possibile cercare i prodotti e aggiungerli al carrello per gruppi di clienti specifici.
Il servizio Correzione è ora più stabile e offre prestazioni migliorate.

Versione 0.3 - Beta+

12 settembre 2022

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.x e successive

Nuove immagini variante: le immagini del prodotto restituite in base alle opzioni selezionate.
Nuovo Ruoli di prezzo: solo i membri di gruppi di clienti specifici possono visualizzare i prezzi dei prodotti.
Correzione Sono state migliorate la stabilità e le prestazioni del servizio.
Nuovi aggiornamenti ricevuti quando i prodotti vengono eliminati dal catalogo.

Versione Beta

9 agosto 2022

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.x e successive

Nuovo Le query products e refineProduct restituiscono i dati seguenti:

  • Attributi di prodotto predefiniti (di sistema).
  • Attributi di prodotto dinamici e filtrali per ruolo (pagina di visualizzazione prodotto/pagina di elenco prodotti).
  • Opzioni prodotto.
  • Immagini dei prodotti e filtrale per ruolo (PDP/PLP).
  • Un prezzo specifico per prodotti semplici e fasce di prezzo per prodotti configurabili.
  • Prezzi e fasce di prezzo del gruppo di clienti. Restituiscono un prezzo predefinito di fallback sugli acquirenti senza un gruppo di clienti.
  • Tipi di prodotto che utilizzano prezzi specifici per il cliente B2B.

Metapackage di Catalog Service

Aggiornamenti al metapacchetto PHP del servizio catalogo (magento/catalog-service).

  • Per i clienti di Adobe Commerce as a Cloud Service, l’ultima versione viene installata nel tuo ambiente.

  • Per Adobe Commerce on-premise su cloud, Adobe consiglia di utilizzare Composer per aggiornare il metapacchetto Catalog Service negli ambienti cloud all’ultima versione.

Versione v3.3.0

14 ottobre 2025

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuova Dipendenza aggiornamento servizi dati—magento/data-services aggiornata a ^8.0.0. Prima dell’aggiornamento, verifica l’utilizzo dell’ambiente e delle API dei servizi dati personalizzate per verificare la compatibilità con la versione 8.x.
ea
Nuovo versione aggiornata e metadati per la versione 3.3.0.

Versione v3.2.0

12 aprile 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuova versione e metadati aggiornati per 3.2.0. Nessun'altra modifica di dipendenza.

Versione v3.1.0

26 gennaio 2024

[Supportato]{class="badge informative" title="Supportato"} Adobe Commerce versioni 2.4.4 e successive

Nuovo aggiunte nuove dipendenze pacchetto:

  • Esportatore dati autorizzazioni categoria (magento/module-category-permission-data-exporter) per l'esportazione dei dati autorizzazioni categoria utilizzati dal servizio catalogo.
  • Amministrazione sincronizzazione catalogo magento/module-catalog-sync-admin per l'interfaccia utente amministratore e la configurazione relativa alla sincronizzazione catalogo.

Nuovo versione aggiornata e metadati per la versione 3.1.0.

Documentazione correlata

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