DocumentaciónCommerceGuía de Catalog Service

Notas de la versión Commerce Storefront Catalog Service

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

Creado para:

  • Administrador

Estas notas de la versión cubren las últimas actualizaciones del servicio de catálogo de Commerce, que incluyen:

  • Versiones del servicio de catálogo de tiendas

    • Mejoras en el esquema de la API del servicio de catálogo para una recuperación de datos mejorada.
    • Mejoras de seguridad, rendimiento y fiabilidad para la API del servicio de catálogo y la infraestructura subyacente.

  • Versiones de metapaquetes del servicio de catálogo

    • Dependencias actualizadas para mejorar el rendimiento, la estabilidad y la compatibilidad con otros componentes de Adobe Commerce.

Las actualizaciones se clasifican por tipo:

Nuevas nuevas características
Corrección Correcciones y mejoras
Error Problemas conocidos

Se proporciona soporte para la versión más reciente. Las notas de la versión de las versiones anteriores se incluyen como referencia.

Servicio de catálogo de tienda

Versión v1.48

19 de febrero de 2025

Nuevo : la consulta categoryTree de la API de GraphQL ahora devuelve descripciones de categorías, imágenes y metaetiquetas SEO. Esta actualización ofrece los datos que los desarrolladores de tiendas necesitan para mostrar imágenes de categorías y mejorar la optimización de los motores de búsqueda con metatítulos, descripciones y palabras clave adecuados. Solo se admite en implementaciones de Commerce que usan el modelo de datos de catálogo maquetable para tiendas sin encabezado<

Versión v1.47

12 de febrero de 2025

Nuevo El servicio API ahora admite el tipo CategoryProductView, lo que permite obtener vistas y consultas mejoradas de productos por categoría. Esta actualización permite a los desarrolladores recuperar y filtrar datos de producto de forma eficaz en función de la categoría, lo que mejora la flexibilidad y el rendimiento para casos de uso impulsados por categoría. Para obtener más información, consulte Implementar categorías en la tienda. Solo se admite en implementaciones de Commerce que usan el modelo de datos de catálogo maquetable para tiendas sin encabezado

Versión v1.46

11 de diciembre de 2025

Corrección : mejoras de infraestructura y nivel de sistema para mejorar el rendimiento y la estabilidad.

Versión v1.45

17 de noviembre de 2025

Nuevo Filtrado de atributos por nombre- La consulta de GraphQL productSearch ahora admite el filtrado de atributos de productos con el campo names. Con este filtro, puede:

  • Reduzca el tamaño de la carga útil de respuesta solicitando solo atributos específicos

  • Combinar con el filtro roles existente para reducir según el rol de visibilidad y el nombre de atributo

  • Ejemplos:

    Solo filtrar por nombres de atributo

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

    Filtrar por roles y nombres:

    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 los atributos sin filtrar, omita el argumento names o proporcione una matriz vacía.

Versión v1.44

6 de noviembre de 2025

Corrección : mejoras de infraestructura y nivel de sistema para mejorar el rendimiento y la estabilidad.

Versión v1.43

3 de noviembre de 2025

Nuevas capas de producto para la personalización de productos en varias dimensiones—Se ha agregado compatibilidad con la entrega de contenido según la configuración regional y específico del canal para implementaciones de Adobe Commerce Optimizer.

  • Servir contenido de producto diferente a segmentos de clientes diferentes

  • Aplicar personalizaciones específicas de la configuración regional sin duplicar los datos base

  • Controlar las anulaciones de nivel de campo con máscaras de capa

  • Compatibilidad con capas de contenido premium, estacionales y optimizadas para móviles

    Las capas se recuperan mediante la consulta products existente, se aplican del lado del servidor desde los encabezados de solicitud y no requieren cambios de esquema. Consulte Capa de catálogo en la Guía de Adobe Commerce Optimizer.

Corregir Los productos agrupados ahora se pueden consultar cuando el producto principal no tiene precios; los productos secundarios devuelven sus propias funciones de visibilidad.

Corrección : mejoras de infraestructura y nivel de sistema para mejorar el rendimiento y la estabilidad.

Versión v1.42

8 de septiembre de 2025

Nuevo Se ha agregado compatibilidad con precios de nivel para consultar los precios de volumen:

Para recuperar los precios de nivel:

  1. Utilice la consulta products con los SKU que desee
  2. Para SimpleProductView, obtener acceso a price.tiers
  3. Para ComplexProductView, obtenga acceso a priceRange.minimum.tiers y a priceRange.maximum.tiers
  4. Cada nivel contiene el precio de tier con descuento y quantity condiciones
  5. Definir umbrales de cantidad con gte (mayor o igual que) y lt (menor que)

Ejemplo:

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

Corregir Precios de nivel filtrados por precio mínimo final

La API ahora devuelve solo niveles cuyo precio con descuento sea menor que el precio final mínimo del producto. Se omiten los niveles más altos porque el precio final mínimo se aplicaría en la tienda.

Se aplica a:

  • Productos simples: price.tiers solo incluye niveles con tier.amount.value < price.final.amount.value (mínimo final).
  • Productos complejos: priceRange.minimum.tiers y priceRange.maximum.tiers usan la misma regla al generar el rango de precios.

Versión v1.41

2 de septiembre de 2025

Corrección Se ha mejorado la administración de errores para la información de precios que falta: cuando los datos de precios aún no se han recibido, la API devuelve null para el campo de precios en lugar de generar un error, lo que permite a los clientes gestionar correctamente los datos que faltan.

Corrección : mejoras de infraestructura y nivel de sistema para mejorar el rendimiento y la estabilidad.

Versión v1.40

30 de julio de 2025

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.39

24 de julio de 2025

Nuevo Recuperar unidades de recomendación por id. de unidad-El nuevo extremo de GraphQL recommendationsByUnitIds recupera unidades de recomendación por su id. único para un acceso más flexible y con objetivo.

  • Se requiere unitIds (lista de recIds que recuperar).

  • Los parámetros de contexto (currentSku, cartSkus, userViewHistory, userPurchaseHistory, category) se comportan igual que en la consulta de recomendaciones existente.

  • Ejemplo

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

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.38

15 de julio de 2025

Nuevo Tipos de productos de tarjetas de regalo: el servicio de tienda de catálogos ahora admite atributos de productos como objetos o matrices JSON, lo que permite una administración flexible de tipos complejos como tarjetas de regalo.

Versión v1.37

20 de junio de 2025

Nuevo Configuración jerárquica del libro de precios: intervalos de precios precisos para libros de precios principal-secundario. Los cálculos respetan la jerarquía y las reglas heredadas; reduce los errores de asignación de precios cuando se vinculan varios libros de precios. Solo Adobe Commerce Optimizer. Ver Libros de precios.

Nuevas claves que no distinguen entre mayúsculas y minúsculas: las búsquedas de claves en las consultas ahora no distinguen entre mayúsculas y minúsculas, lo que reduce los errores de mayúsculas y minúsculas.

Versión v1.36

20 de junio de 2025

Nuevos eventos de E/S públicos para la tienda de catálogos: se agregaron eventos de E/S públicos para la integración y la observabilidad en tiempo real (CSS y EDS).

Nuevo Procesamiento del lado del servidor (SSR): mejoras arquitectónicas para admitir SSR y mejorar el rendimiento, SEO y UX en catálogos grandes.

Nueva infraestructura y seguridad—Nuevas funciones de AWS, integración de ServiceNow y canalizaciones de CI/CD para el servicio de eventos.

Nuevos formatos y observabilidad de eventos: cargas útiles optimizadas, supervisión mejorada y datos de eventos de variante mejorados.

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versiones anteriores

Versión v1.35

13 de junio de 2025

Nuevo Recuperar datos sin caché-Habilite el encabezado Magento-Is-Preview para pasar datos sin caché del extremo del catálogo al servicio de búsqueda.

Nuevo Opciones de productos de selección múltiple: la API de GraphQL ahora indica si las opciones de productos permiten selecciones múltiples (por ejemplo, el paquete "elegir varios elementos").

Nuevo Se actualizó la validación de precios en la ingesta de datos para admitir productos sin precios.

Corrección Se mejoró la administración de errores para los precios de paquetes simples en Adobe Commerce Optimizer.

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.34

23 de marzo de 2025

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.33

29 de abril de 2025

Corregir mejoras de infraestructura y de nivel de sistema. La infraestructura ahora admite catálogos extremadamente grandes (hasta ~440 millones de SKU) sin afectar a las cargas de trabajo existentes.

Versión v1.32

28 de marzo de 2025

Corregir Los atributos sin funciones ya no se indizan de forma predeterminada para el catálogo maquetable, lo que mejora el tiempo de indización y reduce el almacenamiento. El comportamiento heredado se puede volver a habilitar mediante un indicador de funcionalidad.

Solucionar mejoras en la infraestructura y el nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.31

18 de febrero de 2025

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.30

9 de diciembre de 2024

Versión principal: modelo de datos de catálogo maquetable para tiendas sin encabezado, administración de encabezados y administración de datos de productos.

Nuevo Modelo de datos de catálogo maquetable (CCDM): admite clientes que usen el catálogo maquetable para tiendas sin encabezado. Los nuevos extremos aceptan la vista de catálogo y los ID de directiva (compatible con versiones anteriores). Detalles y precios configurables del producto con paginación integrada.

Nuevo Administración de encabezado-AC-Locale cambió el nombre a AC-Scope-Locale para operaciones de API de catálogo maquetable; se especificaron la asignación de encabezado y los valores predeterminados.

Nuevo Datos y precios del producto: compatibilidad con el modelo de datos del catálogo maquetable y con la gestión de precios mejorada para los productos configurables.

CurrencyEnum se actualizó para admitir NONE para las consultas de búsqueda de productos, alineándose con la lógica de federación.

Corregir Infraestructura y actualizaciones: mejoras de nivel de sistema para la seguridad, el rendimiento y la estabilidad.

Corregir Las opciones del paquete de productos ahora solo muestran los productos habilitados.

Versión v1.29

9 de diciembre de 2024

Nuevo orden de imágenes en consultas de productos: las imágenes de productos en el campo de GraphQL images ahora siguen la exportación de catálogos sortOrder para un comportamiento coherente de tienda y API.

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.28

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.27

26 de septiembre de 2024

Solucionar mejoras de infraestructura y nivel de sistema para mejorar la seguridad, el rendimiento y la estabilidad.

Versión v1.26

22 de octubre de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

El esquema Nuevo de GraphQL ahora incluye lastModifiedAt en la información del producto para obtener mapas del sitio y reindexación de motores de búsqueda precisos (por ejemplo, Google).

Versión v1.23

22 de agosto de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Corrección : ahora se puede recuperar la información del producto sin los datos de invalidación (precios) del producto. Anteriormente, estas consultas arrojaban: The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

Versión v1.22

13 de agosto de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo se agregó soporte para recuperar todas las variantes por SKU del producto. Consulte la Referencia de API del servicio de catálogo.

Versión v1.19

23 de mayo de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Corrección El indicador InStock de los valores de opción ahora respeta el estado enabled de ámbito de la variante del producto.

Corrección Se ha agregado compatibilidad con precios de productos con hasta 16 dígitos y 4 decimales. Resincronice desde el panel de administración de datos o CLI para aplicar las actualizaciones.

Limitaciones conocidas

Las siguientes funciones aún no son compatibles:

  • El tamaño máximo de la carga útil de atributos dinámicos es 9 MB.
  • El precio del producto del grupo se puede calcular con precios de productos simples.
  • En una matriz de imágenes, solo la primera imagen contiene funciones.

Utilice API Mesh y la API principal de GraphQL para lo siguiente:

  • Precio Mínimo Anunciado
  • Precios de nivel
  • Paquete de productos con precios fijos

Para obtener detalles y ejemplos, consulte Servicio de catálogo y malla de API.

Versión v1.18

11 de abril de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo agregó compatibilidad con PHP 8.3.

Nuevas Las consultas products y refineProduct ahora devuelven datos de opciones personalizables para productos simples y complejos.

Versión v1.17

22 de febrero de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo Data Management Dashboard ya está disponible para las secuencias de datos (Recomendaciones de productos, Live Search, Servicio de catálogo). Requiere catalog-service metapackage v3.1.0+.

Versión v1.16

13 de febrero de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

La API del servicio de catálogo admite ahora nuevos vídeos de producto.
Corregir Las opciones sin existencias ahora se muestran en el widget PDP.

Limitaciones conocidas

Estas funciones aún no son compatibles:

  • El tamaño máximo de la carga útil de atributos dinámicos es 9 MB.
  • Precio del producto del grupo. Este valor se puede calcular con precios de productos simples.
  • En una matriz de imágenes, solo la primera imagen contiene funciones.

Utilice API Mesh y la API principal de GraphQL para lo siguiente:

Versión v1.13

12 de octubre de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

El servicio de catálogo New admite el indicador inStock para las variantes de producto.
Nuevo Los campos urlKey y externalId se han agregado al esquema de GraphQL.
Ahora se admiten nuevos productos descargables y tarjetas regalo.

Versión v1.12

19 de septiembre de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

El servicio de catálogo New ahora usa indización de precios SaaS.
Corrección Esta versión contiene correcciones de errores y mejoras en el servicio.

Versión v1.11

18 de julio de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

El servicio de catálogo New admite ahora la consulta de GraphQL recommendations para Product Recommendations.

Versión v1.10

27 de junio de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo : la API del servicio de catálogo ahora admite related products.

Versión v1.7

12 de abril de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

El servicio de catálogo New ahora limpia las variantes de producto eliminadas.
Corregir mejoras de rendimiento y escalabilidad de la infraestructura.

Versión v1.6

28 de marzo de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo agregó muestras a la consulta products.
Nuevo agregó la capacidad para obtener entityId mediante API Mesh.

Versión v1.5

6 de marzo de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo agregó la funcionalidad de GraphQL categories.
Corrección : rendimiento y escalabilidad de API mejorados.

Versión v1.4

7 de febrero de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.x y posteriores

Nuevo paquete de servicio de catálogo publicado para simplificar los pasos de instalación.
Corrección de escalabilidad y mejoras de rendimiento de API.

Versión v1.3

17 de enero de 2023

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.x y posteriores

Nuevo ha simplificado y mejorado la experiencia de incorporación.
Nuevos nuevos extremos de zona protegida del cliente disponibles para pruebas previas a la producción.
Se ha agregado compatibilidad con New para productos virtuales.
Corrección de escalabilidad y mejoras de rendimiento de API.

Versión v1.1

18 de noviembre de 2022

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.x y posteriores

El servicio de catálogo New ahora es compatible con la malla de API de Adobe.
Corrección : se mejoró la escalabilidad de la API y el rendimiento general.

Versión v1.0

4 de octubre de 2022

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.x y posteriores

Nuevo soporte para productos agrupados y agrupados.
Nuevo agregó invalidaciones de visibilidad B2B. Ahora se pueden buscar productos y se pueden agregar al carro de compras para grupos de clientes específicos.
El servicio Fix es ahora más estable y ha mejorado el rendimiento.

Versión 0.3: Beta+

12 de septiembre de 2022

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.x y posteriores

Nuevas imágenes de variante: las imágenes de producto devueltas se basan en las opciones seleccionadas.
Nuevos roles de precio: solo los miembros de grupos de clientes específicos pueden ver los precios de los productos.
Corrección Se mejoró la estabilidad y el rendimiento del servicio.
Se reciben nuevas actualizaciones cuando los productos se eliminan del catálogo.

Versión de Beta

9 de agosto de 2022

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.x y posteriores

Nuevo Las consultas products y refineProduct devuelven los siguientes datos:

  • Atributos de producto predefinidos (del sistema).
  • Atributos de producto dinámicos y filtrarlos por función (página de visualización de producto/página de lista de productos).
  • Opciones de producto.
  • Imágenes de productos y filtrarlas por función (PDP/PLP).
  • Un precio específico para productos simples y rangos de precios para productos configurables.
  • Precios de grupo de clientes e intervalos de precios. Devuelven un precio predeterminado alternativo para los compradores sin grupo de clientes.
  • Tipos de productos que utilizan precios específicos del cliente B2B.

Actualizaciones al metapaquete PHP del servicio de catálogo (magento/catalog-service).

  • Para los clientes de Adobe Commerce as a Cloud Service, la versión más reciente está instalada en su entorno.

  • Para Adobe Commerce en la nube local, Adobe recomienda utilizar Composer para actualizar el metapaquete del servicio de catálogo en los entornos de nube en la última versión.

Versión 3.3.0

14 de octubre de 2025

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nueva actualización de servicios de datos—magento/data-services dependencia actualizada a ^8.0.0. Compruebe el uso de la API de servicios de datos personalizados y del entorno para la compatibilidad con 8.x antes de actualizar.
ea
Nuevo Se actualizaron la versión y los metadatos de la versión 3.3.0.

Versión 3.2.0

12 de abril de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nueva versión y metadatos actualizados para 3.2.0. No hay otros cambios de dependencia.

Versión 3.1.0

26 de enero de 2024

[Compatible]{class="badge informative" title="Admitido"} versiones de Adobe Commerce 2.4.4 y posteriores

Nuevo agregó nuevas dependencias de paquete:

  • Exportador de datos de permisos de categoría (magento/module-category-permission-data-exporter) para exportar datos de permisos de categoría usados por el servicio de catálogo.
  • Administrador de sincronización de catálogos magento/module-catalog-sync-admin para la interfaz de usuario de administración y la configuración relacionada con la sincronización de catálogos.

Nuevo Se actualizaron la versión y los metadatos de la versión 3.1.0.

Documentación relacionada

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