프로모션 리소스

적용 대상

• 파트너 센터

적절한 역할

• 관리 에이전트

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

새 상거래 구독의 트랜잭션에 적용되는 프로모션 리소스에 대해 설명합니다.

프로모션

자격 조건이 충족되는 경우 제품 SKU를 구매할 때 적용되는 할인입니다.

속성	Type	설명
id	string	승격 식별자입니다.
name	string	프로모션의 이름입니다.
description	string	프로모션에 대한 설명입니다.
startDate	string	프로모션을 적용할 수 있는 시작 날짜입니다.
endDate	string	프로모션을 적용할 수 있는 종료 날짜입니다.
requiredProducts	requiredProducts 목록	제품, SKU 세부 정보 및 가격 책정 정책은 프로모션에 적용할 수 있습니다.
속성	속성 목록	승격을 자동으로 적용할 수 있는지 여부를 포함하여 승격에 대한 속성입니다.

RequiredProducts

제품, SKU 세부 정보 및 가격 책정 정책은 프로모션에 적용할 수 있습니다.

속성	Type	설명
productId	string	프로모션을 사용할 수 있는 제품의 식별자입니다.
skuId	string	프로모션을 사용할 수 있는 SKU의 식별자입니다.
용어	용어	기간 및 프로모션 청구 주기 포함하는 용어를 사용할 수 있습니다.
pricingPolicies	pricingPolicies 목록	프로모션 할인 유형 및 값을 정의하는 정책 목록입니다.

용어

프로모션을 구매할 수 있는 용어를 나타냅니다.

속성	Type	설명
duration	string	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
billingCycle	string	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 알 수 없음이 포함될 수 있습니다.

PricingPolicies

프로모션 할인 유형 및 값을 설명합니다.

속성	Type	설명
type	string	할인이 백분율 또는 정액 할인을 기반으로 하는지를 설명합니다.
value	string	적용되는 할인 금액을 정의합니다.

속성

승격의 속성입니다.

속성	Type	설명
isAutoApplicable	bool	승격이 자동으로 적용되는지 또는 파트너가 전달해야 하는지 여부를 나타냅니다.

PromotionEligibilitiesRequestItem

트랜잭션 및 프로모션의 자격을 나타내는 속성입니다.

속성	Type	설명
id	int	프로모션 자격 항목 식별자입니다.
catalogItemId	string	승격이 적용되는 카탈로그 항목 식별자입니다. 제품 ID, SKU ID 및 가용성 ID를 포함합니다.
quantity	int	라이선스 또는 인스턴스 수입니다.
termDuration	string	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
billingCycle	string	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 알 수 없음이 포함될 수 있습니다.
promotionID	string	승격 식별자입니다.

PromotionEligibilities

제품, SKU 및 해당 프로모션 자격 목록입니다.

속성	Type	설명
id	int	프로모션 자격 항목 식별자입니다.
catalogItemId	string	승격이 적용되는 카탈로그 항목 식별자입니다. 제품 ID, SKU ID 및 가용성 ID를 포함합니다.
quantity	int	라이선스 또는 인스턴스 수입니다.
termDuration	string	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
billingCycle	string	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 Unknown이 포함될 수 있습니다.
자격	PromotionEligibilities 목록	프로모션 자격 결과 목록을 나타냅니다.

PromotionEligibility

제품, SKU 및 해당 프로모션 자격 목록입니다.

속성	Type	설명
promotionId	string	승격 식별자입니다.
isEligible	bool	프로모션이 지정된 자격 요청 항목에 적합한지 설명합니다.
오류	PromotionEligibilityErrors 목록	프로모션 자격 요청 항목이 적합하지 않은 이유를 설명하는 오류입니다.

PromotionEligibilityError

프로모션 자격 요청 항목이 적합하지 않은 이유를 설명합니다.

속성	Type	설명
type	string	프로모션 자격 오류 유형에는 InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously 또는 Term이 포함될 수 있습니다.
description	string	프로모션이 지정된 자격 요청 항목에 적합한지 설명합니다.

RedemptionLimitPromotionEligibilityError

상환 한도를 초과한 이유에 대한 세부 정보를 포함합니다.

속성	Type	설명
maxPromotionRedemptionCount	int	프로모션을 획득할 수 있는 최대 횟수입니다.
remainingPromotionRedemptionCount	int	프로모션을 획득할 수 있는 남은 횟수입니다.

SeatCountPromotionEligibilityError

좌석 수 제한을 초과한 이유에 대한 세부 정보를 포함합니다. 모든 값은 null을 허용합니다.

속성	Type	설명
minimumRequiredSeats	int	프로모션에서 지원하는 최소 라이선스입니다.
maximumRequiredSeats	int	프로모션에서 지원하는 최대 라이선스입니다.
availableSeats	int	파트너가 지정된 프로모션을 위해 획득할 수 있는 라이선스의 나머지 수입니다.

TermPromotionEligibilityError

프로모션 용어가 허용되지 않은 이유에 대한 세부 정보를 포함합니다.

속성	Type	설명
eligibleTerms	PromotionTerm	프로모션이 지원하는 적격 조건입니다.

PromotionTerm

좌석 수 제한을 초과한 이유에 대한 세부 정보를 포함합니다.

속성	Type	설명
billingCycle	string	프로모션이 청구에 적용되는 빈도를 설명합니다. 값에는 월별, 연간, OneTime 또는 Unknown이 포함될 수 있습니다.
duration	string	구매되는 기간입니다.