DocumentaçãoCommerceGuia do Catalog Service

Notas de versão do Commerce Storefront Catalog Service

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

Criado para:

  • Administrador

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 de dados aprimorada.
    • Melhorias de segurança, desempenho e confiabilidade para a API do serviço de catálogo e infraestrutura subjacente.

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

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

Novos Novos recursos
Correção correções e melhorias
Bug 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

versão v1.48

19 de fevereiro de 2025

Novo A consulta categoryTree na API do GraphQL agora retorna descrições de categoria, imagens e metatags de SEO. Esta atualização fornece os dados que os desenvolvedores da loja precisam para exibir imagens de categoria e melhorar a otimização do mecanismo de pesquisa com metatítulos, descrições e palavras-chave adequados. Somente suportado em implementações Commerce usando o modelo de dados de catálogo combinável para frentes de loja headless<

versão v1.47

12 de fevereiro de 2025

Novo O serviço de API agora oferece suporte ao tipo CategoryProductView, permitindo exibições e consultas aprimoradas para produtos por categoria. Essa atualização permite que os desenvolvedores recuperem e filtrem com eficiência os dados do produto com base na categoria, melhorando a flexibilidade e o desempenho para casos de uso orientados por categoria. Para obter detalhes, consulte Implementar categorias na loja. Só há suporte em implementações Commerce usando o modelo de dados de catálogo combinável para frentes de loja headless

versão v1.46

11 de dezembro de 2025

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

versão v1.45

17 de novembro de 2025

Novo Filtragem de Atributo por Nome-A consulta do GraphQL productSearch agora oferece suporte à filtragem de atributos de produto com o campo names. Com este filtro, você pode:

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

versão v1.44

6 de novembro de 2025

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

versão v1.43

3 de novembro de 2025

Novo Camadas de Produto para personalização de produto multidimensional—Adicionou suporte para entrega de conteúdo específico de canal e com reconhecimento de localidade para implementações do Adobe Commerce Optimizer.

  • Atender conteúdo de produto diferente a segmentos de clientes diferentes

  • Aplicar personalizações específicas de localidade sem duplicar dados básicos

  • Controlar substituições em nível de campo com máscaras de camada

  • Suporte a camadas de conteúdo premium, sazonais e otimizadas para dispositivos móveis

    As camadas são recuperadas usando a consulta products existente, são aplicadas no lado do servidor a partir de cabeçalhos de solicitação e não exigem alterações de esquema. Consulte Camada do catálogo no Guia do Adobe Commerce Optimizer.

Correção 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.

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

versão v1.42

8 de setembro de 2025

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

Para recuperar preços de camada:

  1. Use a consulta products com suas SKUs desejadas
  2. Para SimpleProductView, acesse price.tiers
  3. Para ComplexProductView, acesse priceRange.minimum.tiers e priceRange.maximum.tiers
  4. Cada camada contém o preço com desconto de tier e quantity condições
  5. 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 }
          }
        }
      }
    }
  }
}

Correção 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.

versão v1.41

2 de setembro de 2025

Correção 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.

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

Versão v1.40

30 de julho de 2025

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

versão v1.39

24 de julho de 2025

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

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

versão v1.38

15 de julho de 2025

Novos 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ão v1.37

20 de junho de 2025

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

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

versão v1.36

20 de junho de 2025

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

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

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

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

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

Versões anteriores

versão v1.35

13 de junho de 2025

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

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

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

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

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

versão v1.34

23 de março de 2025

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

versão v1.33

29 de abril de 2025

Correção melhorias no nível do sistema e na infraestrutura. A infraestrutura agora é compatível com catálogos extremamente grandes (até ~440 milhões de SKUs) sem afetar as cargas de trabalho existentes.

versão v1.32

28 de março de 2025

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

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

versão v1.31

18 de fevereiro de 2025

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

versão v1.30

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.

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

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

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

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

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

versão v1.29

9 de dezembro de 2024

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

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

versão v1.28

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

versão v1.27

26 de setembro de 2024

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

versão v1.26

22 de outubro de 2024

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

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

versão v1.23

22 de agosto de 2024

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

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

versão v1.22

13 de agosto de 2024

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

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

versão v1.19

23 de maio de 2024

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

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

Correção 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.

versão v1.18

11 de abril, 2024

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

Novo Suporte adicionado para o PHP 8.3.

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

versão v1.17

22 de fevereiro de 2024

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

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

versão v1.16

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 Novos agora têm suporte da API de Serviço de Catálogo.
Correção 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:

versão v1.13

12 de outubro de 2023

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

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

versão v1.12

19 de setembro de 2023

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

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

versão v1.11

18 de julho de 2023

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

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

versão v1.10

27 de junho de 2023

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

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

versão v1.7

12 de abril de 2023

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

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

versão v1.6

28 de março de 2023

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

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

versão v1.5

6 de março de 2023

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

Novo Adicionado categories funcionalidade GraphQL.
Correção Desempenho e escalabilidade da API aprimorados.

versão v1.4

7 de fevereiro de 2023

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

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

versão v1.3

17 de janeiro de 2023

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

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

versão v1.1

18 de novembro de 2022

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

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

versão v1.0

4 de outubro de 2022

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

Novo Suporte para produtos agrupados e agrupados.
Novo 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 Fix agora está mais estável e melhorou o desempenho.

Versão 0.3 - Beta+

12 de setembro de 2022

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

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

Versão do Beta

9 de agosto de 2022

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

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

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 no local, a Adobe recomenda o uso do Composer para atualizar o metapackage do Serviço de catálogo nos ambientes de nuvem na versão mais recente.

Versão v3.3.0

14 de outubro de 2025

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

Nova 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.
ea
Novo Versão e metadados atualizados para a versão 3.3.0.

Versão v3.2.0

12 de abril de 2024

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

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

Versão v3.1.0

26 de janeiro de 2024

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

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

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

Documentação relacionada

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