설명서CommerceCatalog Service 안내서

Commerce Storefront Catalog Service 릴리스 정보

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

작성 대상:

  • 관리자

이러한 릴리스 노트는 다음을 포함한 최신 Commerce 카탈로그 서비스 업데이트를 다룹니다.

  • Storefront 카탈로그 서비스 릴리스

    • 개선된 데이터 검색을 위해 카탈로그 서비스 API 스키마 개선 사항.
    • 카탈로그 서비스 API 및 기본 인프라의 보안, 성능 및 안정성 개선.

  • 카탈로그 서비스 메타패키지 릴리스

    • 종속성을 업데이트하여 성능, 안정성 및 다른 Adobe Commerce 구성 요소와의 호환성을 개선했습니다.

업데이트는 유형별로 분류됩니다.

새 기능 개 개
수정 수정 사항 및 개선 사항
버그 알려진 문제

최신 버전에 대한 지원이 제공됩니다. 이전 버전에 대한 릴리스 노트는 참조를 위해 포함됩니다.

Storefront 카탈로그 서비스

v1.48 릴리스

2025년 2월 19일

새로 만들기 이제 GraphQL API의 categoryTree 쿼리가 범주 설명, 이미지 및 SEO 메타 태그를 반환합니다. 이 업데이트는 상점 개발자가 카테고리 이미지를 표시하고 적절한 메타 제목, 설명 및 키워드를 통해 검색 엔진 최적화를 개선하는 데 필요한 데이터를 제공합니다. 헤드리스 상점<용 ​구성 가능한 카탈로그 데이터 모델을(를) 사용하는 Commerce 구현에서만 지원됩니다.

v1.47 릴리스

2025년 2월 12일

새로 만들기 이제 API 서비스가 CategoryProductView 형식을 지원하므로 카테고리별 제품에 대한 향상된 보기 및 쿼리를 사용할 수 있습니다. 이 업데이트를 통해 개발자는 카테고리를 기반으로 제품 데이터를 효율적으로 검색 및 필터링하여 카테고리 기반 사용 사례의 유연성과 성능을 향상시킬 수 있습니다. 자세한 내용은 상점 첫 화면에서 범주 구현을 참조하십시오. Headless 상점용 ​구성 가능한 카탈로그 데이터 모델을(를) 사용하는 Commerce 구현에서만 지원됩니다.

v1.46 릴리스

2025년 12월 11일

시스템 수준 및 인프라 개선을 수정하여 성능과 안정성을 개선합니다 .

v1.45 릴리스

2025년 11월 17일

새로 만들기 이름별 특성 필터링-이제 productSearch GraphQL 쿼리에서 names 필드를 사용하여 제품 특성을 필터링할 수 있습니다. 이 필터를 사용하여 다음을 수행할 수 있습니다.

  • 특정 속성만 요청하여 응답 페이로드 크기 줄이기

  • 기존 roles 필터와 결합하여 가시성 역할 및 특성 이름으로 범위를 좁힙니다.

  • 예:

    특성 이름으로만 필터링

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

    역할과 이름을 기준으로 필터링:

    code language-graphql 
    query {
  products(skus: ["SKU-001"]) {
    attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) {
      name
      label
      value
      roles
    }
  }
}
NOTE
필터링하지 않고 모든 특성을 검색하려면 names 인수를 생략하거나 빈 배열을 제공하십시오.

v1.44 릴리스

2025년 11월 6일

시스템 수준 및 인프라 개선을 수정하여 성능과 안정성을 개선합니다 .

v1.43 릴리스

2025년 11월 3일

새로운 기능 다차원 제품 사용자 지정을 위한 제품 계층 - Adobe Commerce Optimizer 구현에 대한 로케일 인식 채널별 콘텐츠 전달에 대한 지원이 추가되었습니다.

  • 다양한 고객 세그먼트에 다양한 제품 콘텐츠 제공

  • 기본 데이터를 복제하지 않고 로케일별 사용자 지정 적용

  • 레이어 마스크로 필드 수준 무시 제어

  • 프리미엄, 시즌 및 모바일에 최적화된 콘텐츠 레이어 지원

    레이어는 기존 products 쿼리를 사용하여 검색되고, 요청 헤더에서 서버측에 적용되며, 스키마 변경이 필요하지 않습니다. Adobe Commerce Optimizer 안내서에서 카탈로그 계층​을 참조하세요.

수정 이제 상위 제품에 가격표가 없을 때 그룹화된 제품에 대해 쿼리할 수 있습니다. 하위 제품은 고유한 표시 역할을 반환합니다.

시스템 수준 및 인프라 개선을 수정하여 성능과 안정성을 개선합니다 .

v1.42 릴리스

2025년 9월 8일

새로 만들기 계층 가격 지원을 추가했습니다 볼륨 가격을 쿼리하는 데 추가했습니다.

계층 가격 검색 방법:

  1. 원하는 SKU에 products 쿼리 사용
  2. SimpleProductView​의 경우 price.tiers에 액세스
  3. ComplexProductView​의 경우 priceRange.minimum.tiers 및 priceRange.maximum.tiers에 액세스
  4. 각 계층에는 할인된 tier 가격 및 quantity 조건이 포함되어 있습니다.
  5. gte(크거나 같음)과 lt(보다 작음)을 사용하여 수량 임계값을 정의합니다.

예:

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

수정 최소 최종 가격으로 필터링된 계층 가격

이제 API는 제품의 최소 최종 가격보다 할인된 가격이 낮은 계층만 반환합니다. 대신 최소 최종 가격이 상점 앞에 적용되므로 더 높은 계층은 생략됩니다.

적용 대상:

  • 단순 제품: price.tiers에는 tier.amount.value < price.final.amount.value(최소 최종)인 계층만 포함됩니다.
  • 복잡한 제품: priceRange.minimum.tiers 및 priceRange.maximum.tiers은(는) 가격 범위를 만들 때 동일한 규칙을 사용합니다.

v1.41 릴리스

2025년 9월 2일

수정 누락된 가격 정보에 대한 오류 처리 개선—가격 데이터를 아직 받지 않은 경우 API에서 오류를 발생시키는 대신 가격 필드에 대해 null을(를) 반환하여 클라이언트가 누락된 데이터를 정상적으로 처리할 수 있습니다.

시스템 수준 및 인프라 개선을 수정하여 성능과 안정성을 개선합니다.

v1.40 릴리스

2025년 7월 30일

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.39 릴리스

2025년 7월 24일

새로 만들기 단위 ID별로 권장 사항 단위 검색-새 GraphQL 끝점 recommendationsByUnitIds은(는) 보다 유연하고 타깃팅된 액세스를 위해 고유 ID별로 권장 사항 단위를 검색합니다.

  • unitIds이(가) 필요합니다(가져올 recId 목록).

  • 컨텍스트 매개 변수(currentSku, cartSkus, userViewHistory, userPurchaseHistory, category)는 기존 권장 사항 쿼리와 동일하게 동작합니다.

  • 예

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

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.38 릴리스

2025년 7월 15일

새로운 기능 기프트 카드 제품 유형-카탈로그 상점 서비스가 이제 제품 특성을 JSON 개체 또는 배열로 지원하므로 기프트 카드와 같은 복잡한 유형을 유연하게 관리할 수 있습니다.

v1.37 릴리스

2025년 6월 20일

새로 만들기 계층 구조의 가격 장부 구성—부모-자식 가격 장부의 정확한 가격 범위입니다. 계산은 계층 및 상속된 규칙을 준수하며, 여러 가격 장부가 연결될 때 가격책정 오류를 줄입니다. Adobe Commerce Optimizer만 해당. 가격 장부를 참조하세요.

새로 만들기 대/소문자를 구분하지 않는 키—쿼리의 키 조회는 이제 대/소문자를 구분하지 않으므로 키 대/소문자에서 오류가 줄어듭니다.

v1.36 릴리스

2025년 6월 20일

새로 만들기 카탈로그 Storefront에 대한 공용 IO 이벤트—실시간 통합 및 가시성(CSS 및 EDS)을 위한 공용 IO 이벤트가 추가되었습니다.

새로 만들기 SSR(서버측 렌더링)—대규모 카탈로그에서 향상된 성능, SEO 및 UX를 위해 SSR을 지원하는 아키텍처 개선.

새로 만들기 인프라 및 보안—이벤트 서비스에 대한 새 AWS 역할, ServiceNow 통합 및 CI/CD 파이프라인.

새로 만들기 이벤트 형식 및 관찰 가능성—페이로드 간소화, 모니터링 개선, 변형 이벤트 데이터 개선

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

이전 버전

v1.35 릴리스

2025년 6월 13일

새로 만들기 캐시되지 않은 데이터 검색-카탈로그 끝점에서 캐시되지 않은 데이터를 Search Service에 전달하려면 Magento-Is-Preview 헤더를 사용하도록 설정합니다.

새로 만들기 다중 선택 제품 옵션-GraphQL API는 이제 제품 옵션에서 다중 선택을 허용하는지 여부를 표시합니다(예: 번들 "여러 항목 선택").

새로 만들기 데이터 수집에 대한 가격 유효성 검사를 업데이트하여 가격 없는 제품을 지원합니다.

수정 Adobe Commerce Optimizer의 단순 번들 가격에 대한 오류 처리가 개선되었습니다.

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.34 릴리스

2025년 3월 23일

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.33 릴리스

2025년 4월 29일

시스템 수준 및 인프라 개선 사항을 수정 합니다. 인프라는 기존 워크로드에 영향을 주지 않고 매우 큰 카탈로그(최대 4억 4천만 SKU)를 지원합니다.

v1.32 릴리스

2025년 3월 28일

역할이 없는 Fix 특성은 구성 가능한 카탈로그에 대해 더 이상 기본적으로 인덱싱되지 않으므로 인덱싱 시간이 향상되고 저장소가 줄어듭니다. 기능 플래그를 통해 레거시 동작을 다시 활성화할 수 있습니다.

시스템 수준 및 인프라 개선 사항을 수정하여 보안, 성능 및 안정성을 개선합니다.

v1.31 릴리스

2025년 2월 18일

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.30 릴리스

2024년 12월 9일

주요 릴리스: 헤드리스 상점, 헤더 관리 및 제품 데이터 처리를 위한 구성 가능한 카탈로그 데이터 모델.

새로 만들기 CCDM(Composable Catalog Data Model) - 헤드리스 상점 앞면에 대해 composable 카탈로그를 사용하는 고객을 지원합니다. 새 끝점은 카탈로그 보기 및 정책 ID(이전 버전과 호환)를 수락합니다. 기본 제공 페이지 매김으로 제품 세부 사항 및 가격을 구성할 수 있습니다.

구성 가능한 카탈로그 API 작업을 위해 새 헤더 관리-AC-Locale 이름이 AC-Scope-Locale(으)로 바뀌었습니다. 헤더 매핑 및 기본값이 지정되었습니다.

새로운 기능 제품 데이터 및 가격 책정 구성 가능한 카탈로그 데이터 모델을 지원하고 구성 가능한 제품에 대한 가격 처리를 개선했습니다.

CurrencyEnum이(가) 페더레이션 논리에 맞춰 제품 검색 쿼리에 대해 NONE을(를) 지원하도록 업데이트되었습니다.

수정 인프라 및 업그레이드—보안, 성능 및 안정성을 위한 시스템 수준의 개선 사항입니다.

수정 번들 제품 옵션이 이제 사용 가능한 제품만 표시됩니다.

v1.29 릴리스

2024년 12월 9일

새로 만들기 제품 쿼리의 이미지 순서 지정—이제 일관된 상점 및 API 동작을 위해 GraphQL images 필드의 제품 이미지가 카탈로그 내보내기 sortOrder을(를) 따릅니다.

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.28 릴리스

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.27 릴리스

2024년 9월 26일

보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를 수정 합니다.

v1.26 릴리스

2024년 10월 22일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 GraphQL 스키마에는 정확한 사이트 맵 및 검색 엔진 리인덱싱을 위한 제품 정보에 lastModifiedAt이(가) 포함됩니다(예: Google).

v1.23 릴리스

2024년 8월 22일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

수정 이제 제품 재정의(가격) 데이터 없이 제품 정보를 검색할 수 있습니다. 이전에는 다음 쿼리가 반환되었습니다. The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

v1.22 릴리스

2024년 8월 13일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 제품 SKU별로 모든 변형을 검색할 수 있는 지원이 추가되었습니다. 카탈로그 서비스 API 참조를 참조하세요.

v1.19 릴리스

2024년 5월 23일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

수정 옵션 값에 대한 InStock 플래그는 이제 제품 변형의 범위 enabled 상태를 따릅니다.

수정 최대 16자리 및 소수점 4자리까지 제품 가격에 대한 지원이 추가되었습니다. 업데이트를 적용하려면 데이터 관리 대시보드 또는 CLI에서 다시 동기화하십시오.

알려진 제한 사항

다음 기능은 아직 지원되지 않습니다.

  • 동적 특성 페이로드의 최대 크기는 9MB입니다.
  • 그룹 제품 가격은 간단한 제품 가격으로 계산할 수 있습니다.
  • 이미지 배열에서는 첫 번째 이미지만 역할을 포함합니다.

API Mesh 및 핵심 GraphQL API를 사용하여 다음을 수행할 수 있습니다.

  • 최소 광고 가격
  • 계층 가격
  • 고정 가격으로 묶음 제품

자세한 내용과 예제는 카탈로그 서비스 및 API Mesh를 참조하세요.

v1.18 릴리스

2024년 4월 11일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 에서 PHP 8.3에 대한 지원을 추가했습니다.

새로 만들기 products 및 refineProduct 쿼리가 이제 단순 제품과 복합 제품 모두에 대해 사용자 지정 가능한 옵션 데이터를 반환합니다.

v1.17 릴리스

2024년 2월 22일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 이제 Data Management Dashboard을(를) 데이터 스트림(제품 권장 사항, 실시간 검색, 카탈로그 서비스)에 사용할 수 있습니다. catalog-service개의 메타패키지 v3.1.0+가 필요합니다.

v1.16 릴리스

2024년 2월 13일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 제품 비디오는 이제 카탈로그 서비스 API에서 지원됩니다.
수정 재고 부족 옵션이 이제 PDP 위젯에 표시됩니다.

알려진 제한 사항

다음 기능은 아직 지원되지 않습니다.

  • 동적 특성 페이로드의 최대 크기는 9MB입니다.
  • 그룹 제품 가격. 이 값은 간단한 제품 가격으로 계산할 수 있다.
  • 이미지 배열에서는 첫 번째 이미지만 역할을 포함합니다.

API Mesh 및 핵심 GraphQL API를 사용하여 다음을 수행할 수 있습니다.

v1.13 릴리스

2023년 10월 12일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 카탈로그 서비스는 제품 변형에 대해 inStock 플래그를 지원합니다.
새로 만들기 urlKey 및 externalId 필드가 GraphQL 스키마에 추가되었습니다.
새로운 다운로드 가능한 제품 및 기프트 카드가 지원됩니다.

v1.12 릴리스

2023년 9월 19일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 카탈로그 서비스가 이제 SaaS 가격 인덱싱를 사용합니다.
수정 이 릴리스에는 서비스 측의 버그 수정 및 개선 사항이 포함되어 있습니다.

v1.11 릴리스

2023년 7월 18일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 카탈로그 서비스가 이제 제품 권장 사항에 대한 recommendations GraphQL 쿼리를 지원합니다.

v1.10 릴리스

2023년 6월 27일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 이제 카탈로그 서비스 API가 related products을(를) 지원합니다.

v1.7 릴리스

2023년 4월 12일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 카탈로그 서비스가 삭제된 제품 변형을 정리합니다.
인프라 확장성 및 성능 개선 사항을 수정 합니다.

v1.6 릴리스

2023년 3월 28일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 products 쿼리에 견본을 추가했습니다.
새로 만들기 에서 entityIdAPI Mesh를 사용하여 ​을(를) 가져오는 기능을 추가했습니다.

v1.5 릴리스

2023년 3월 6일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 에 categories GraphQL 기능이 추가되었습니다.
수정 향상된 성능 및 API 확장성.

v1.4 릴리스

2023년 2월 7일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상

새로 만들기 카탈로그 서비스 메타패키지를 게시하여 설치 단계를 간소화했습니다.
API 확장성 및 성능 개선 사항을 수정 합니다.

v1.3 릴리스

2023년 1월 17일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상

새로 만들기 온보딩 환경을 간소화하고 개선했습니다.
새 새 고객 샌드박스 끝점을 프로덕션 전 테스트에 사용할 수 있습니다.
가상 제품에 대한 새 지원이 추가되었습니다.
API 확장성 및 성능 개선 사항을 수정 합니다.

v1.1 릴리스

2022년 11월 18일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상

새 카탈로그 서비스가 이제 Adobe의 API Mesh를 지원합니다.
수정 향상된 API 확장성 및 전체 성능.

v1.0 릴리스

2022년 10월 4일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상

번들 및 그룹화된 제품에 대한 새로운 지원
새로 만들기 에서 B2B 가시성 재정의를 추가했습니다. 이제 제품을 검색할 수 있으며 특정 고객 그룹을 위해 장바구니에 추가할 수 있습니다.
수정 서비스가 이제 안정적이며 성능이 향상되었습니다.

0.3 릴리스 - Beta+

2022년 9월 12일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상

새 변형 이미지: 선택한 옵션에 따라 제품 이미지가 반환되었습니다.
새로 만들기 가격 역할: 특정 고객 그룹의 구성원만 제품 가격을 볼 수 있습니다.
수정 서비스의 안정성과 성능이 개선되었습니다.
카탈로그에서 제품이 삭제되면 새 업데이트가 수신됩니다.

Beta 릴리스

2022년 8월 9일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상

새로 만들기 products 및 refineProduct 쿼리가 다음 데이터를 반환합니다.

  • 사전 정의된(시스템) 제품 속성.
  • 동적 제품 속성을 확인하고 역할별로 필터링합니다(제품 표시 페이지/제품 목록 페이지).
  • 제품 옵션.
  • 제품 이미지를 만들고 역할(PDP/PLP)별로 필터링합니다.
  • 간단한 제품에 대한 특정 가격 및 구성 가능한 제품에 대한 가격 범위입니다.
  • 고객 그룹 가격 및 가격 범위. 고객 그룹이 없는 쇼핑객에 대해 대체 기본 가격을 반환합니다.
  • B2B 고객별 가격을 사용하는 제품 유형입니다.

카탈로그 서비스 메타패키지

카탈로그 서비스 PHP 메타패키지(magento/catalog-service)를 업데이트합니다.

  • Adobe Commerce as a Cloud Service 고객의 경우 최신 버전이 환경에 설치됩니다.

  • Adobe Commerce 온 클라우드 온-프레미스의 경우 Adobe은 Composer를 사용하여 클라우드 환경의 카탈로그 서비스 메타패키지를 최신 릴리스로 업그레이드할 것을 권장합니다.

v3.3.0 릴리스

2025년 10월 14일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 데이터 서비스 업그레이드—magento/data-services 종속성이 ^8.0.0으로 업데이트되었습니다. 업그레이드하기 전에 8.x 호환성에 대한 환경 및 사용자 지정 데이터 서비스 API 사용을 확인하십시오.
ea
새로 만들기 3.3.0 릴리스에 대한 버전 및 메타데이터를 업데이트했습니다.

v3.2.0 릴리스

2024년 4월 12일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새 버전 및 메타데이터가 3.2.0용으로 업데이트되었습니다. 다른 종속성 변경 사항은 없습니다.

v3.1.0 릴리스

2024년 1월 26일

[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상

새로 만들기 새 패키지 종속성 추가:

  • 카탈로그 서비스에서 사용하는 범주 권한 데이터를 내보내기 위한 범주 권한 데이터 내보내기(magento/module-category-permission-data-exporter).
  • 카탈로그 동기화와 관련된 관리 UI 및 구성에 대한 카탈로그 동기화 관리자 magento/module-catalog-sync-admin.

새로 만들기 버전 및 3.1.0 릴리스의 메타데이터를 업데이트했습니다.

관련 설명서

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