에 적용: 파트너 센터 | 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터
고객이 제품 목록에서 구독을 구입하려는 경우 파트너가 주문을 합니다.
카트
카트에 대해 설명합니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 아이디 | 문자열 | 카트를 성공적으로 만들 때 제공되는 카트 식별자입니다. |
| 생성시간스탬프 | 날짜시간 | 카트를 만든 날짜(날짜-시간 형식)입니다. 카트를 성공적으로 만들 때 적용됩니다. |
| 마지막 수정 시간표시 | 날짜시간 | 카트가 마지막으로 업데이트된 날짜(날짜-시간 형식)입니다. 카트를 성공적으로 만들 때 적용됩니다. |
| 만료 타임스탬프 | 날짜시간 | 카트가 만료되는 날짜(날짜-시간 형식)입니다. 카트를 성공적으로 만들 때 적용됩니다. |
| 최종수정사용자 | 문자열 | 카트를 마지막으로 업데이트한 사용자입니다. 카트를 성공적으로 만들 때 적용됩니다. |
| lineItems | 객체 배열 | CartLineItem 리소스의 배열입니다. |
| 상태 | 문자열 | 카트의 상태입니다. 가능한 값은 "활성"(업데이트/제출 가능) 및 "Ordered"(이미 제출됨)입니다. |
장바구니 항목
카트에 포함된 항목 하나를 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 아이디 | 문자열 | 카트 라인 아이템의 고유 식별자입니다. 카트를 성공적으로 만들 때 적용됩니다. |
| 카탈로그 항목 ID | 문자열 | 카탈로그 항목 식별자입니다. |
| 사용자 친화적 이름 | 문자열 | 선택적. 명확하게 구분하기 위해 파트너가 정의한 항목의 이름입니다. |
| 양 | int | 라이선스 또는 인스턴스 수입니다. |
| 통화 코드 | 문자열 | 통화 코드입니다. |
| billingCycle | 객체 | 현재 기간에 대해 설정된 청구 주기의 유형입니다. |
| 기간 지속 | 문자열 | 용어의 지속 시간에 대한 ISO 8601 표현입니다. 현재 지원되는 값은 P1M(1개월), P1Y(1년) 및 P3Y(3년)입니다. |
| 참가자 | 개체 문자열 쌍 목록 | 구매 시 기록된 PartnerID에 대한 문자열 모음입니다. |
| 프로비저닝 컨텍스트 | 사전<문자열, 문자열> | 구매한 항목을 프로비전할 때 사용되는 추가 컨텍스트입니다. 특정 항목에 필요한 값을 확인하려면 SKU의 provisioningVariables 속성을 참조하세요. |
| 주문 그룹 | 문자열 | 동일한 순서로 함께 제출할 수 있는 항목을 나타내는 그룹입니다. |
| 추가 항목 | CartLineItem 개체 목록 | 추가 기능에 대한 카트 줄 항목의 컬렉션입니다. 이러한 항목은 루트 카트 라인 항목의 구매 결과로 생성되는 기본 구독에 대해 구매됩니다. |
| 오류 | 객체 | 오류가 발생한 경우 카트를 만든 후에 적용됩니다. |
| renewsTo | 객체 배열 | RenewsTo 리소스의 배열입니다. |
| 인증 승인 | bool | 제안 또는 상품 코드 조건에 대한 동의를 나타냅니다. SkuAttestationProperties 또는 OfferAttestationProperties에서 enforceAttestation이 True인 오퍼 또는 sku에만 필요합니다. |
| promotionId | 문자열 | 카트 품목에 적용할 프로모션 ID입니다. |
| 사용자 지정 기간 종료일 | 날짜시간 | 새 구독의 첫 번째 청구 기간 종료 날짜입니다. |
Participants
고객의 구독을 관리하는 배포자의 재판매인을 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 거래_재판매업자 | 문자열 | 고객을 관리하는 재판매인의 파트너 ID입니다. |
| 추가 거래 재판매자 | 문자열 | 트랜잭션 또는 고객 관리에 관련된 다른 파트너의 추가 파트너 ID입니다. 이 속성은 EU/EFTA 시장에서 운영되는 배포자에만 적용됩니다. |
가격
가격 정보를 나타냅니다. 가격 금액은 과세 전에 제공됩니다.
| 재산 | 유형 | 필수 | 설명 |
|---|---|---|---|
| listPrice | 두 배 | 아니요 | 가격 한정자가 적용되지 않은 카탈로그에 나열된 가격입니다. |
| 할인된 가격 | 두 배 | 아니요 | 적용 가능한 모든 가격 한정자를 적용한 후의 가격입니다. |
| 비례 배분된 가격 | 두 배 | 아니요 | 비례 배분이 수행된 후 할인된 가격입니다. |
| 가격 | 두 배 | 아니요 | 모든 할인이 적용되고 배율이 수행된 후 적용 가능한 청구 통화의 가격입니다. |
| 확장 가격 | 두 배 | 아니요 | 적용 가능한 청구 통화로 수량, 할인 및 배율이 적용된 품목의 가격입니다. |
RenewsTo
카트 줄 항목에 포함된 항목 하나를 나타냅니다.
| 재산 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 기간 지속 | 문자열 | 아니요 | 갱신 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M (1개월) 및 P1Y(1년). |
ScheduledNextTermInstructions
이 표에서는 NCE(새 상거래 환경) 라이선스 기반 평가판 제품 갱신에 대한 scheduledNextTermInstructions 속성을 설명합니다. 값이 지정되지 않은 경우 평가판은 유료 구독으로 갱신되고 연간 기간, 월별 청구 및 25개의 라이선스로 갱신됩니다.
| 재산 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 제품 | 배열 | 아니요 | 평가판 구독이 갱신되는 제안과 유료 구독의 기간 및 청구 빈도를 지정하는 배열입니다. |
| 양 | int | 아니요 | 평가판 제안이 갱신된 후 해당 유료 구독에 있는 라이선스 수량입니다. |
제품
이 표에서는 NCE 라이선스 기반 평가판 제품 갱신에 대한 productTerm 속성을 설명합니다. 이 배열에 값이 지정되지 않은 경우 평가판은 연간 기간 및 월별 청구를 통해 유료 구독으로 갱신됩니다.
| 재산 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 제품 ID | 문자열 | 아니요 | 평가판이 갱신되어 유료 구독으로 전환될 때 이를 나타내는 형식으로 구성된 GUID입니다. |
| skuId | 문자열 | 아니요 | 평가판이 유료 구독으로 갱신될 때 이를 나타내는 SKU 형식의 GUID입니다. |
| availabilityId | 문자열 | 아니요 | 평가판이 갱신되는 유료 구독의 가용성을 나타내는 형식의 GUID입니다. |
| billingCycle | 문자열 | 아니요 | 평가판 제안이 갱신된 후 적용되는 유료 구독의 청구 주기입니다. |
| 기간 지속 | 문자열 | 아니요 | 평가판 제품이 갱신되면 해당 유료 구독이 가지고 있는 기간입니다. |
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽습니다. 전체 목록은 파트너 센터 오류 코드참조하세요.
CartError
카트를 만든 후 발생하는 오류를 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 오류 코드 | CartErrorCode | 카트 오류의 유형입니다. |
| 오류 설명 | 문자열 | 지원되는 값, 기본값 또는 제한에 대한 메모를 포함하여 오류 설명입니다. |
| 추가 정보 | 추가정보 | 오류에 대한 자세한 정보입니다. |
추가 정보
오류에 대한 추가 정보입니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 사용 가능 수량 | int | 지정된 제품 SKU에 대해 구매할 수 있는 남은 라이선스 수입니다. |
| 구매한수량 | int | 구매 중인 라이선스 수입니다. |
장바구니 오류 코드
카트 오류 유형입니다.
| 이름 | 오류 코드 | 설명 |
|---|---|---|
| 지원되지 않는 통화 | 10,000 | 통화는 지정된 시장에 대해 지원되지 않습니다. |
| 카탈로그 항목 ID가 유효하지 않습니다. | 10001 | 카탈로그 항목 ID가 잘못되었습니다. |
| QuotaNotAvailable | 10002 | 할당량이 부족합니다. |
| 재고 없음 | 10003 | 선택한 제품에 인벤토리를 사용할 수 없음 |
| 파트너에 대해 참가자를 지원하지 않습니다. | 10004 | 파트너에 대해 참가자 설정이 지원되지 않습니다. |
| 장바구니 품목 처리 불가 | 10006 | 카트 품목을 처리할 수 없습니다. |
| 구독이 유효하지 않음 | 10007 | 구독이 유효하지 않습니다. |
| 해당 구독은 RI에 대해 활성화되지 않았습니다. | 10008 | 구독은 예약 구매에 사용할 수 없습니다. |
| 샌드박스 제한 초과 | 10009 | 샌드박스 제한을 초과했습니다. |
| 잘못된 입력 | 10010 | 제네릭 입력이 잘못되었습니다. |
| 구독이 등록되지 않음 | 10011 | 구독이 유효하지 않습니다. |
| 인증이 수락되지 않음 | 10012 | 증명은 허용되지 않았습니다. |
| 최대 허용 좌석 수 한도 초과 | 10015 | 요청된 좌석 수가 제한을 초과합니다. |
| 알려지지 않은 | 0 | 기본값 |
장바구니 결제 결과
카트 체크 아웃의 결과를 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 주문 | Order 개체 목록입니다. | 주문 모음. |
| 주문 오류 | OrderError 개체 목록입니다. | 주문 오류의 컬렉션입니다. |
주문 오류
주문이 만들어질 때 카트 체크 아웃 중에 발생하는 오류를 나타냅니다.
| 재산 | 유형 | 설명 |
|---|---|---|
| 주문 그룹 ID | 문자열 | 오류가 있는 주문의 주문 그룹 ID입니다. |
| 코드 | int | 오류 코드입니다. |
| 묘사 | 문자열 | 오류에 대한 설명입니다. |