Notas de versão do Commerce Storefront Catalog Service

Última atualização: 11 de maio de 2026

Criado para:

Admin

Essas notas de versão abordam as atualizações mais recentes do serviço de catálogo da Commerce, incluindo:

Versões do Serviço de Catálogo da Loja
- Aprimoramentos do esquema da API do Serviço de catálogo para recuperação aprimorada de dados
- Melhorias de segurança, desempenho e confiabilidade para a API do serviço de catálogo e infraestrutura subjacente.
Consulte Esquema dos Serviços de vitrine na documentação do Desenvolvedor do Commerce para obter mais informações sobre essas APIs.
Versões do metapackage do Serviço de Catálogo
- Dependências atualizadas para melhorar o desempenho, a estabilidade e a compatibilidade com outros componentes do Adobe Commerce.
Versões do Instalador do Serviço de Catálogo
- Dependências atualizadas para manter a compatibilidade entre o Serviço de catálogo e sua pilha do Commerce.

NOTE

Se o seu projeto do Commerce usa o Adobe Commerce Optimizer para fornecer dados de catálogo ao Commerce Edge Delivery Service ou a lojas headless, consulte as notas de versão do Adobe Commerce Optimizer para obter as atualizações de API mais recentes.

As atualizações são categorizadas por tipo:

Novos recursos
Correções e melhorias
Problemas conhecidos

O suporte é fornecido para a versão mais recente. As notas de versão para versões mais antigas estão incluídas para referência.

Serviço de Catálogo da Loja

Maio de 2026

Data de lançamento: 13 de maio de 2026

Ordem de classificação de categoria no GraphQL — O tipo de GraphQL CategoryView agora inclui um campo de posição, portanto, as vitrines podem exibir categorias na ordem em que os comerciantes configuram na hierarquia do catálogo.

Data de lançamento: 4 de maio de 2026

Os preços dos produtos da vitrine agora exibem o código monetário correto (por exemplo, USD) para todos os tipos de produtos. Anteriormente, alguns produtos exibiam NONE em vez da moeda esperada, resultando em preços ausentes. Esta atualização garante uma renderização de preço consistente e precisa em toda a loja.

Abril de 2026

Data de lançamento: 29 de abril de 2026

Limite imposto de no máximo 100 SKUs por solicitação para Adobe Commerce Optimizer e Adobe Commerce as a Cloud Service
clientes de acordo com limites e limites documentados.

Data de lançamento: 17 de abril de 2026

Adicionada uma nova consulta do GraphQL searchCategory que permite aos clientes pesquisar categorias por nome com resultados paginados. A consulta aceita um searchTerm necessário (mínimo de 3 caracteres) e parâmetros family, pageSize e currentPage opcionais. Os resultados incluem objetos CategoryTreeView correspondentes com metadados de categoria completa, totalCount e pageInfo para paginação.

Esta consulta está disponível somente para clientes que usam os Serviços de merchandising da Adobe Commerce Optimizer. Consulte searchCategory.

Março de 2026

Data de lançamento: 24 de março de 2026

Suporte adicionado para computar e retornar o intervalo de preços para pacotes dinâmicos.

Dezembro de 2025

Data de lançamento: 11 de dezembro de 2025

melhorias no nível do sistema e na infraestrutura para aprimorar o desempenho e a estabilidade.

Novembro de 2025

Data de lançamento: 17 de novembro de 2025

Filtragem de Atributo por Nome-A consulta do GraphQL productSearch agora oferece suporte à filtragem de atributos de produto com o campo names. Com esse filtro, é possível:

Reduzir o tamanho do payload de resposta solicitando apenas atributos específicos
Combine com o filtro roles existente para restringir por função de visibilidade e nome de atributo

Exemplos:

Filtrar somente por nomes de atributo

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

Filtrar por funções e nomes:

code language-graphql
`query { products(skus: ["SKU-001"]) { attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) { name label value roles } } }`

NOTE

Para recuperar todos os atributos sem filtragem, omita o argumento names ou forneça uma matriz vazia.

Data de lançamento: 6 de novembro de 2025

melhorias no nível do sistema e na infraestrutura para aprimorar o desempenho e a estabilidade.

Os produtos agrupados agora podem ser consultados quando o pai não tem preços; os produtos filho retornam suas próprias funções de visibilidade.

melhorias no nível do sistema e na infraestrutura para aprimorar o desempenho e a estabilidade.

Setembro de 2025

Data de lançamento: 8 de setembro de 2025

Suporte a preços de camada adicionado para consultar preços de volume:

Para recuperar preços de camada:

Use a consulta products com suas SKUs desejadas
Para SimpleProductView, acesse price.tiers
Para ComplexProductView, acesse priceRange.minimum.tiers e priceRange.maximum.tiers
Cada camada contém o preço com desconto de tier e quantity condições
Definir limites de quantidade com gte (maior que ou igual a) e lt (menor que)

Exemplo:

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

Preços de camada filtrados pelo preço final mínimo

A API agora retorna somente camadas cujo preço com desconto é menor que o preço final mínimo do produto. As camadas mais altas são omitidas porque o preço final mínimo seria aplicado na loja.

Aplicável a:

Produtos simples: price.tiers inclui somente camadas com tier.amount.value < price.final.amount.value (mínimo final).
Produtos complexos: priceRange.minimum.tiers e priceRange.maximum.tiers usam a mesma regra ao criar o intervalo de preços.

Data de lançamento: 2 de setembro de 2025

Tratamento de erros aprimorado para informações de preços ausentes—Quando os dados de preços ainda não são recebidos, a API retorna null para o campo de preços em vez de gerar um erro, permitindo que os clientes lidem com os dados ausentes normalmente.

melhorias no nível do sistema e na infraestrutura para aprimorar o desempenho e a estabilidade.

Julho de 2025

Data de lançamento: 30 de julho de 2025

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Data de lançamento: 24 de julho de 2025

Recuperar unidades de recomendação por ID de unidade-O novo ponto de extremidade do GraphQL recommendationsByUnitIds recupera unidades de recomendação por ID exclusiva para obter acesso mais flexível e direcionado.

unitIds é necessário (lista de recIds para busca).
Parâmetros de contexto (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) se comportam da mesma forma que na consulta de recomendações existente.

Exemplo

code language-graphql

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

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

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Data de lançamento: 15 de julho de 2025

Tipos de produto de cartão-presente. O Serviço de vitrine do catálogo agora oferece suporte a atributos de produto como objetos JSON ou matrizes, permitindo o gerenciamento flexível de tipos complexos, como cartões-presente.

Versões anteriores

Junho de 2025

Data de lançamento: 20 de junho de 2025

Configuração do catálogo de preços hierárquico — Intervalos de preços precisos para o catálogo de preços pai-filho. Os cálculos respeitam a hierarquia e as regras herdadas; reduz os erros de precificação quando vários catálogos de preços são vinculados. Somente Adobe Commerce Optimizer. Consulte Catálogos de Preços.

Chaves que não diferenciam maiúsculas de minúsculas — As pesquisas de chave em consultas agora não diferenciam maiúsculas de minúsculas, reduzindo os erros de maiúsculas e minúsculas.

Data de lançamento: 20 de junho de 2025

Eventos de E/S Públicos para a Loja de Catálogos—Foram adicionados eventos de E/S públicos para integração e observação em tempo real (CSS e EDS).

Renderização no Servidor (SSR)—Melhorias de arquitetura para oferecer suporte ao SSR para melhor desempenho, SEO e UX em catálogos grandes.

Infraestrutura e Segurança—Novas funções do AWS, integração do ServiceNow e pipelines de CI/CD para o serviço de eventos.

Formatos de evento e capacidade de observação — cargas simplificadas, monitoramento aprimorado, dados aprimorados de eventos de variantes.

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Data de lançamento: 13 de junho de 2025

Recuperar dados não armazenados em cache-Habilite o cabeçalho Magento-Is-Preview para passar dados não armazenados em cache do ponto de extremidade do catálogo para o Serviço de Pesquisa.

Opções de produtos de seleção múltipla. A API do GraphQL agora expõe se as opções de produtos permitem várias seleções (por exemplo, agrupar “escolher vários itens”).

Atualização da validação de preço na assimilação de dados para oferecer suporte a produtos sem preços.

Tratamento de erros aprimorado para preço de pacote simples no Adobe Commerce Optimizer.

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Abril de 2025

Data de lançamento: 8 de abril de 2025

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

A infraestrutura agora oferece suporte a catálogos extremamente grandes (até ~440 milhões de SKUs) sem afetar as cargas de trabalho existentes.

Março de 2025

Data de lançamento: 28 de março de 2025

Atributos sem funções não são mais indexados por padrão para o catálogo combinável, melhorando o tempo de indexação e reduzindo o armazenamento. O comportamento herdado pode ser reativado por meio de um sinalizador de recurso.

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Fevereiro de 2025

Data de lançamento: 18 de fevereiro de 2025

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Dezembro de 2024

Data de lançamento: 9 de dezembro de 2024

Versão principal: modelo de dados de catálogo combinável para frentes de loja headless, gerenciamento de cabeçalho e manipulação de dados de produto.

Modelo de Dados de Catálogo de Composição (CCDM) — Oferece suporte a clientes que usam o catálogo de composição para frentes de loja headless. Os novos endpoints aceitam a Exibição de catálogo e as IDs de política (compatíveis com versões anteriores). Detalhes e preços do produto configuráveis com paginação interna.

Gerenciamento de Cabeçalho-AC-Locale renomeado para AC-Scope-Locale para operações de API de catálogo combinável; mapeamento de cabeçalho e valores padrão especificados.

Dados e preços do produto-Suporte para modelo de dados de catálogo combinável e manipulação de preços aprimorada para produtos configuráveis.

CurrencyEnum atualizado para oferecer suporte a NONE para consultas de pesquisa de produtos, alinhado à lógica de federação.

Infraestrutura e atualizações—Melhorias no nível do sistema para segurança, desempenho e estabilidade.

As opções de pacote de produtos agora exibem apenas os produtos habilitados.

Data de lançamento: 9 de dezembro de 2024

Ordenação de imagens em consultas de produtos—As imagens de produtos no campo images do GraphQL agora seguem a exportação de catálogo sortOrder para comportamento consistente da loja e da API.

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Data de lançamento: dezembro de 2024

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Outubro de 2024

Data de lançamento: 22 de outubro de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O esquema do GraphQL agora inclui lastModifiedAt nas informações do produto para mapas de site precisos e reindexação do mecanismo de pesquisa (por exemplo, Google).

Setembro de 2024

Data de lançamento: 26 de setembro de 2024

melhorias no nível do sistema e na infraestrutura para aprimorar a segurança, o desempenho e a estabilidade.

Agosto de 2024

Data de lançamento: 22 de agosto de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

As informações do produto agora podem ser recuperadas sem os dados de substituição de produto (preços). Anteriormente, essas consultas retornavam: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Data de lançamento: 13 de agosto de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Suporte adicionado para recuperar todas as variantes por SKU de produto. Consulte a Referência da API do Serviço de Catálogo.

Maio de 2024

Data de lançamento: 23 de maio de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O sinalizador InStock para valores de opção agora respeita o status enabled de escopo da variante de produto.

Suporte adicionado para preços de produtos com até 16 dígitos e 4 casas decimais. Ressincronize a partir do painel de Gerenciamento de Dados ou da CLI para aplicar as atualizações.

Limitações conhecidas

Os seguintes recursos ainda não são compatíveis:

O tamanho máximo da carga dos atributos dinâmicos é de 9 MB.
O preço do produto do Grupo pode ser calculado com preços simples do produto.
Em uma matriz de imagens, somente a primeira imagem contém funções.

Use a API Mesh e a API principal do GraphQL para:

Preço Mínimo Anunciado
Nível de preços
Pacote de produtos com preços fixos

Para obter detalhes e exemplos, consulte Serviço de Catálogo e API Mesh.

Abril de 2024

Data de lançamento: 11 de abril de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Suporte adicionado para o PHP 8.3.

As consultas de products e refineProduct agora retornam dados de opções personalizáveis para produtos simples e complexos.

Fevereiro de 2024

Data de lançamento: 22 de fevereiro de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O Data Management Dashboard agora está disponível para fluxos de dados (Product Recommendations, Live Search, Catalog Service). Requer catalog-service metapackage v3.1.0+.

Data de lançamento: 13 de fevereiro de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Os vídeos de produtos agora têm suporte da API de Serviço de Catálogo.
As opções indisponíveis agora são mostradas no widget PDP.

Limitações conhecidas

Estes recursos ainda não são compatíveis:

O tamanho máximo da carga dos atributos dinâmicos é de 9 MB.
Preço de produto de grupo. Esse valor pode ser calculado com preços simples do produto.
Em uma matriz de imagens, somente a primeira imagem contém funções.

Use a API Mesh e a API principal do GraphQL para:

Preço Mínimo Anunciado
Nível de preços

Outubro de 2023

Data de lançamento: 12 de outubro de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O Serviço de Catálogo oferece suporte ao sinalizador inStock para variantes de produtos.
Os campos urlKey e externalId foram adicionados ao esquema do GraphQL.
Produtos e cartões-presente baixáveis agora têm suporte.

Setembro de 2023

Data de lançamento: 19 de setembro de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O Serviço de catálogo agora usa a indexação de preços SaaS.
Esta versão contém correções de erros e melhorias no lado do serviço.

Julho de 2023

Data de lançamento: 18 de julho de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O Serviço de Catálogo agora dá suporte à consulta do GraphQL recommendations para Recomendações de Produto.

Junho de 2023

Data de lançamento: 27 de junho de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

A API de Serviço de Catálogo agora dá suporte a related products.

Abril de 2023

Data de lançamento: 12 de abril de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

O Serviço de Catálogo agora limpa as variantes de produtos excluídas.
melhorias na escalabilidade e no desempenho da infraestrutura.

Março de 2023

Data de lançamento: 28 de março de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Amostras adicionadas à consulta products.
Adicionou a capacidade de obter entityId usando a API Mesh.

Data de lançamento: 6 de março de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Adicionado categories funcionalidade GraphQL.
Desempenho e escalabilidade da API aprimorados.

Fevereiro de 2023

Data de lançamento: 7 de fevereiro de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.x e mais recentes

metapackage de serviço de catálogo publicado para simplificar as etapas de instalação.
aprimoramentos de desempenho e escalabilidade da API.

Janeiro de 2023

Data de lançamento: 17 de janeiro de 2023

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.x e mais recentes

Simplificou e melhorou a experiência de integração.
Novos pontos de extremidade de sandbox do cliente estão disponíveis para teste de pré-produção.
Suporte adicionado para produtos virtuais.
aprimoramentos de desempenho e escalabilidade da API.

Novembro de 2022

Data de lançamento: 18 de novembro de 2022

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.x e mais recentes

O Serviço de Catálogo agora oferece suporte à API Mesh da Adobe.
Aprimoramento da escalabilidade da API e desempenho geral.

Outubro de 2022

Data de lançamento: 4 de outubro de 2022

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.x e mais recentes

Suporte para produtos agrupados e agrupados.
substituições de visibilidade B2B adicionadas. Agora os produtos podem ser pesquisados e adicionados ao carrinho para grupos específicos de clientes.
O serviço agora está mais estável e melhorou o desempenho.

Setembro de 2022

Data de lançamento: 12 de setembro de 2022

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.x e mais recentes

imagens de variantes: imagens de produtos retornadas com base nas opções selecionadas.
Funções de preço: somente membros de grupos de clientes específicos podem ver os preços do produto.
Estabilidade e desempenho do serviço aprimorados.
Atualizações são recebidas quando os produtos são excluídos do catálogo.

Agosto de 2022

Data de lançamento: 9 de agosto de 2022

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.x e mais recentes

As consultas products e refineProduct retornam os seguintes dados:

Atributos de produto predefinidos (sistema).
Atributos dinâmicos do produto e filtrá-los por função (página de exibição do produto/página da lista de produtos).
Opções de produto.
Imagens de produto e filtrá-las por função (PDP/PLP).
Um preço específico para produtos simples e faixas de preço para produtos configuráveis.
Preços de grupo e faixas de preços do cliente. Eles retornam um preço padrão de fallback para os compradores sem um grupo de clientes.
Tipos de produto que usam preços específicos do cliente B2B.

Metappackage do Serviço de Catálogo

Atualizações no metapackage PHP do Serviço de Catálogo (magento/catalog-service).

Para clientes do Adobe Commerce as a Cloud Service, a versão mais recente é instalada em seu ambiente.
Para o Adobe Commerce na nuvem ou no local, a Adobe recomenda usar o Composer para atualizar o metapackage do Serviço de catálogo nos seus ambientes de nuvem na versão mais recente.

Versão v3.3.0

Data de lançamento: 14 de outubro de 2025

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Atualização de serviços de dados—magento/data-services dependência atualizada para ^8.0.0. Verifique o ambiente e o uso personalizado da API dos serviços de dados para obter compatibilidade com a versão 8.x antes de atualizar.

Versão e metadados atualizados para a versão 3.3.0.

Versão v3.2.0

Data de lançamento: 12 de abril de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Versão e metadados atualizados para 3.2.0. Nenhuma outra alteração de dependência.

Versão v3.1.0

Data de lançamento: 26 de janeiro de 2024

[Com suporte]{class="badge informative" title="Compatível"} Adobe Commerce versões 2.4.4 e mais recentes

Adição de novas dependências de pacote:

Exportador de dados de permissão de categoria (magento/module-category-permission-data-exporter) para exportar dados de permissão de categoria usados pelo serviço de catálogo.
Administrador de Sincronização de Catálogo magento/module-catalog-sync-admin para interface do usuário do Administrador e configuração relacionada à sincronização de catálogo.

Versão e metadados atualizados para a versão 3.1.0.

Instalador do Serviço de Catálogo

O instalador é fornecido com a extensão do Serviço de catálogo e lida com verificações de instalação e ambiente para que o Serviço de catálogo corresponda à sua pilha do Commerce.

Para clientes do Adobe Commerce as a Cloud Service, a versão mais recente do instalador está instalada em seu ambiente.
Para Adobe Commerce na infraestrutura de nuvem ou no local, mantenha o instalador alinhado ao metapackage do Serviço de Catálogo.

Sempre que você usa o Composer para atualizar o magento/catalog-service, o pacote do instalador é atualizado automaticamente para a versão mais recente. Você também pode usar o Composer para atualizar o magento/catalog-service-installer separadamente quando essas notas de versão descreverem uma alteração necessária, por exemplo, suporte para uma nova versão do PHP. Dessa forma, sua ferramenta de instalação permanece compatível com a versão do Serviço de catálogo executada.

versão v1.0.6

Data de lançamento: 25 de março de 2026

PHP 8.5—Garante a compatibilidade quando o Serviço de Catálogo opera no PHP 8.5.

Documentação relacionada

Para projetos implantados no **Adobe Commerce na nuvem, no local ou Adobe Commerce as a Cloud Service, consulte a seguinte documentação:
Para projetos que usam o Adobe Commerce Optimizer ou o Adobe Commerce Optimizer Connector, consulte a seguinte documentação:

recommendation-more-help

commerce-help-catalog-service