DocumentazioneCommerceGuida Catalog Service

Note sulla versione Commerce Storefront Catalog Service

Ultimo aggiornamento: 11 maggio 2026

Creato per:

  • Admin

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

NOTE
Se il progetto Commerce utilizza Adobe Commerce Optimizer per inviare i dati del catalogo a Commerce Edge Delivery Service o headless storefront, consulta le note sulla versione di Adobe Commerce Optimizer per gli ultimi aggiornamenti API.

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

Maggio 2026

Data di rilascio: 4 maggio 2026

Correzione I prezzi dei prodotti della vetrina ora visualizzano il codice valuta corretto (ad esempio, USD) per tutti i tipi di prodotto. In precedenza, alcuni prodotti mostravano NONE invece della valuta prevista, con conseguente perdita dei prezzi. Questo aggiornamento garantisce un rendering dei prezzi coerente e accurato in tutta la vetrina.

Aprile 2026

Data di rilascio: 29 aprile 2026

Nuovo Limite massimo imposto di 100 SKU per richiesta per Adobe Commerce Optimizer e Adobe Commerce as a Cloud Service
client in base a limiti e limiti documentati.

Data di rilascio: 17 aprile 2026

Nuovo aggiunta nuova query di GraphQL searchCategory che consente ai client di cercare le categorie per nome con risultati impaginati. La query accetta i parametri obbligatori searchTerm (minimo 3 caratteri) e facoltativi family, pageSize e currentPage. I risultati includono CategoryTreeView oggetti corrispondenti con metadati di categoria completi, totalCount e pageInfo per l’impaginazione.

Questa query è disponibile solo per i clienti che utilizzano Adobe Commerce Optimizer Merchandising Services. Vedi searchCategory.

Marzo 2026

Data di rilascio: 24 marzo 2026

Nuovo Aggiunto supporto per calcolare e restituire l’intervallo di prezzo per i bundle dinamici.

Dicembre 2025

Data di rilascio: 11 dicembre 2025

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

Novembre 2025

Data di rilascio: 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, puoi:

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

Data di rilascio: 6 novembre 2025

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

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

Settembre 2025

Data di rilascio: 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.

Data di rilascio: 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à.

Luglio 2025

Data di rilascio: 30 luglio 2025

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

Data di rilascio: 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à.

Data di rilascio: 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.

Versioni precedenti

Giugno 2025

Data di rilascio: 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.

Data di rilascio: 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à.

Data di rilascio: 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à.

Aprile 2025

Data di rilascio: 8 aprile 2025

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

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

Marzo 2025

Data di rilascio: 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à.

Febbraio 2025

Data di rilascio: 18 febbraio 2025

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

Dicembre 2024

Data di rilascio: 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.

Data di rilascio: 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à.

Data di rilascio: dicembre 2024

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

Ottobre 2024

Data di rilascio: 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).

Settembre 2024

Data di rilascio: 26 settembre 2024

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

Agosto 2024

Data di rilascio: 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.

Data di rilascio: 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. Consulta il Riferimento API di Catalog Service.

Maggio 2024

Data di rilascio: 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 aggiunta del 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.

Aprile 2024

Data di rilascio: 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.

Febbraio 2024

Data di rilascio: 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+.

Data di rilascio: 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:

Ottobre 2023

Data di rilascio: 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.

Settembre 2023

Data di rilascio: 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.

Luglio 2023

Data di rilascio: 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.

Giugno 2023

Data di rilascio: 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.

Aprile 2023

Data di rilascio: 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.

Marzo 2023

Data di rilascio: 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.

Data di rilascio: 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.

Febbraio 2023

Data di rilascio: 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.

Gennaio 2023

Data di rilascio: 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.

Novembre 2022

Data di rilascio: 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.

Ottobre 2022

Data di rilascio: 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.

Settembre 2022

Data di rilascio: 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.

Agosto 2022

Data di rilascio: 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 o sul cloud, Adobe consiglia di utilizzare Composer per aggiornare il metapacchetto Catalog Service negli ambienti cloud all’ultima versione.

Versione v3.3.0

Data di rilascio: 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.

Nuovo versione aggiornata e metadati per la versione 3.3.0.

Versione v3.2.0

Data di rilascio: 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

Data di rilascio: 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.

Programma di installazione di Catalog Service

Il programma di installazione viene fornito con l’estensione Catalog Service e gestisce i controlli di installazione e ambiente in modo che Catalog Service corrisponda allo stack di Commerce.

  • Per i clienti Adobe Commerce as a Cloud Service, è installata la versione più recente del programma di installazione nell’ambiente.

  • Per Adobe Commerce nell’infrastruttura cloud o nei locali, tieni il programma di installazione allineato con il metapackage Catalog Service.

Ogni volta che si utilizza Composer per aggiornare magento/catalog-service, il pacchetto del programma di installazione viene aggiornato automaticamente alla versione più recente. È inoltre possibile utilizzare Composer per aggiornare magento/catalog-service-installer separatamente quando queste note sulla versione descrivono una modifica necessaria, ad esempio il supporto per una nuova versione PHP. In questo modo gli strumenti di installazione rimangono compatibili con la versione di Catalog Service eseguita.

versione v1.0.6

Data di rilascio: 25 marzo 2026

Nuovo PHP 8.5—Garantisce la compatibilità quando Catalog Service funziona su PHP 8.5.

Documentazione correlata

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