카트 리소스

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

고객이 제품 목록에서 구독을 구입하려는 경우 파트너가 주문을 합니다.

카트

카트에 대해 설명합니다.

속성	종류	설명
id	string	카트를 성공적으로 만들 때 제공되는 카트 식별자입니다.
creationTimeStamp	DateTime	카트를 만든 날짜(날짜-시간 형식)입니다. 카트를 성공적으로 만들 때 적용됩니다.
lastModifiedTimeStamp	DateTime	카트가 마지막으로 업데이트된 날짜(날짜-시간 형식)입니다. 카트를 성공적으로 만들 때 적용됩니다.
expirationTimeStamp	DateTime	카트가 만료되는 날짜(날짜-시간 형식)입니다. 카트를 성공적으로 만들 때 적용됩니다.
lastModifiedUser	string	카트를 마지막으로 업데이트한 사용자입니다. 카트를 성공적으로 만들 때 적용됩니다.
lineItems	개체의 배열	CartLineItem 리소스의 배열입니다.
상태	string	카트의 상태. 가능한 값은 "활성"(업데이트/제출 가능) 및 "Ordered"(이미 제출됨)입니다.

CartLineItem

카트에 포함된 항목 하나를 나타냅니다.

속성	종류	설명
id	string	카트 품목에 대한 고유 식별자입니다. 카트를 성공적으로 만들 때 적용됩니다.
catalogItemId	string	카탈로그 항목 식별자입니다.
friendlyName	string	선택 사항. 명확하게 구분하기 위해 파트너가 정의한 항목의 이름입니다.
quantity	int	라이선스 또는 인스턴스 수입니다.
currencyCode	string	통화 코드입니다.
billingCycle	Object	현재 기간에 대해 설정된 청구 주기 형식입니다.
termDuration	string	용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다.
participants	개체 문자열 쌍 목록	구매에 대한 PartnerID on Record의 컬렉션입니다.
provisioningContext	<사전 문자열, 문자열>	구매한 항목을 프로비전할 때 사용되는 추가 컨텍스트입니다. 특정 항목에 필요한 값을 확인하려면 SKU의 provisioningVariables 속성을 참조하세요.
orderGroup	string	동일한 순서로 함께 제출할 수 있는 항목을 나타내는 그룹입니다.
addonItems	CartLineItem 개체 목록	추가 기능에 대한 카트 줄 항목의 컬렉션입니다. 이러한 항목은 루트 카트 라인 항목의 구매 결과 기본 구독에 대해 구매됩니다.
error	Object	오류가 발생한 경우 카트를 만든 후에 적용됩니다.
renewsTo	개체의 배열	RenewsTo 리소스의 배열입니다.
AttestationAccepted	부울	제안 또는 sku 조건에 대한 규약을 나타냅니다. SkuAttestationProperties 또는 OfferAttestationProperties enforceAttestation이 True인 제품 또는 sku에만 필요합니다.
promotionId	string	카트 품목에 적용할 프로모션 ID입니다.
customTermEndDate	DateTime	새 구독의 첫 번째 청구 기간 종료 날짜입니다.

가격 책정

가격 정보를 나타냅니다. 가격 금액은 과세 전에 제공됩니다.

속성	형식	필요함	설명
Listprice	double	아니요	가격 한정자가 적용되지 않은 카탈로그에 나열된 가격입니다.
discountedPrice	double	아니요	적용 가능한 모든 가격 한정자를 적용한 후의 가격입니다.
proratedPrice	double	아니요	배율이 수행된 후 할인된 가격입니다.
price	double	아니요	모든 할인이 적용되고 배후가 수행된 후 적용 가능한 청구 통화의 가격입니다.
extendedPrice	double	아니요	적용 가능한 청구 통화로 수량, 할인 및 배율이 적용된 품목의 가격입니다.

RenewsTo

카트 줄 항목에 포함된 항목 하나를 나타냅니다.

속성	형식	필요함	설명
termDuration	string	아니요	갱신 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M (1개월) 및 P1Y (1년)입니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 오류 코드를 참조 하세요.

CartError

카트를 만든 후 발생하는 오류를 나타냅니다.

속성	종류	설명
errorCode	CartErrorCode	카트 오류의 유형입니다.
errorDescription	string	지원되는 값, 기본값 또는 제한에 대한 메모를 포함하여 오류 설명입니다.
additionalInformation	AdditionalInformation	오류에 대한 추가 정보입니다.

AdditionalInformation

오류에 대한 추가 정보입니다.

속성	종류	설명
availableQuantity	int	지정된 제품 SKU에 대해 구매할 수 있는 재기본 라이선스 수입니다.
purchasedQuantity	int	구매 중인 라이선스 수입니다.

CartErrorCode

카트 오류 유형입니다.

이름	오류 코드	설명
CurrencyIsNotSupported	10000	통화는 지정된 시장에 대해 지원되지 않습니다.
CatalogItemIdIsNotValid	10001	카탈로그 항목 ID가 잘못되었습니다.
QuotaNotAvailable	10002	할당량이 부족합니다.
InventoryNotAvailable	10003	선택한 제품에 인벤토리를 사용할 수 없음
ParticipantsIsNotSupportedForPartner	10004	파트너에 대해 참가자 설정이 지원되지 않습니다.
UnableToProcessCartLineItem	10006	카트 품목을 처리할 수 없습니다.
SubscriptionIsNotValid	10007	구독이 잘못되었습니다.
SubscriptionIsNotEnabledForRI	10008	구독은 예약 구매에 사용할 수 없습니다.
SandboxLimitExceeded	10009	샌드박스 제한을 초과했습니다.
InvalidInput	10010	제네릭 입력이 잘못되었습니다.
SubscriptionNotRegistered	10011	구독이 잘못되었습니다.
AttestationNotAccepted	10012	증명은 허용되지 않았습니다.
MaxAllowedSeatsPerSubscriptionExceeded	10015	요청된 사용자 수가 제한을 초과합니다.
알 수 없음	0	기본값

CartCheckoutResult

카트 검사 아웃의 결과를 나타냅니다.

속성	종류	설명
주문	Order 개체 목록입니다.	주문 컬렉션입니다.
orderErrors	OrderError 개체 목록입니다.	주문 오류의 컬렉션입니다.

OrderError

주문이 만들어질 때 카트 검사 동안 발생하는 오류를 나타냅니다.

속성	종류	설명
orderGroupId	string	오류가 있는 주문의 주문 그룹 ID입니다.
코드	int	오류 코드입니다.
description	string	오류에 대한 설명입니다.