カート リソース

適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター

パートナーは、顧客がオファーの一覧からサブスクリプションを購入する場合に注文を行います。

カート

カートについて説明します。

プロパティ	タイプ	内容
id	string	カートの作成が成功したときに提供されるカート識別子。
creationTimeStamp	DateTime	日付と時刻の形式で、カートが作成された日付。 カートの作成が成功した場合に適用されます。
lastModifiedTimeStamp	DateTime	カートが最後に更新された日付を日時形式で指定します。 カートの作成が成功した場合に適用されます。
expirationTimeStamp	DateTime	日付と時刻の形式で、カートの有効期限が切れる日付。 カートの正常な作成時に適用されます。
lastModifiedUser	string	カートを最後に更新したユーザー。 カートの正常な作成時に適用されます。
lineItems	オブジェクトの配列	CartLineItem リソースの配列。
status	string	カートの状態。 指定できる値は、"Active" (更新/送信可能) と "Ordered" (既に送信済み) です。

CartLineItem

カートに含まれる 1 つの項目を表します。

プロパティ	タイプ	内容
id	string	カートの品目の一意識別子。 カートの正常な作成時に適用されます。
catalogItemId	string	カタログ アイテム識別子。
friendlyName	string	省略可能。 あいまいさを解消するためにパートナーによって定義された項目のフレンドリ名。
quantity	int	ライセンスまたはインスタンスの数。
currencyCode	string	通貨コード。
billingCycle	オブジェクト	現在の期間に設定支払いサイクルの種類。
termDuration	string	期間の ISO 8601 表現。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。
participants	オブジェクト文字列ペアの一覧	購入時のレコード上の PartnerID のコレクション。
provisioningContext	ディクショナリ<文字列、文字列>	購入したアイテムをプロビジョニングするときに使用される追加のコンテキスト。 特定の項目に必要な値を決定するには、SKU の provisioningVariables プロパティを参照してください。
Ordergroup	string	同じ順序で一緒に送信できるアイテムを示すグループ。
addonItems	CartLineItem オブジェクトの一覧	アドオンのカートの品目のコレクション。 これらの項目は、ルート カートの品目の購入の結果として得られる基本サブスクリプションに対して購入されます。
エラー	オブジェクト	エラーが発生した場合にカートが作成された後に適用されます。
renewsTo	オブジェクトの配列	RenewsTo リソースの配列。
AttestationAccepted	[bool]	オファーまたは SKU の条件に対する契約を示します。 SkuAttestationProperties または OfferAttestationProperties enforceAttestation が True のオファーまたは SKU にのみ必要です。
promotionId	string	カートの品目に適用される予定のプロモーション ID。
customTermEndDate	DateTime	新しいサブスクリプションの最初の請求期間の終了日。

価格

価格の詳細を表します。 価格額は課税前に提供されます。

プロパティ	タイプ	Required	説明
listPrice	倍精度浮動小数点	いいえ	価格修飾子が適用されていないカタログに記載されている価格。
discountedPrice	倍精度浮動小数点	いいえ	適用されるすべての価格修飾子を適用した後の価格。
proratedPrice	倍精度浮動小数点	いいえ	割り当て後の割引価格。
price	倍精度浮動小数点	いいえ	すべての割引が適用され、割り当てが実行された後の、該当する請求通貨での価格。
extendedPrice	倍精度浮動小数点	いいえ	数量、割引、および日割り計算が適用された品目の価格 (該当する請求通貨)。

RenewsTo

カートの品目に含まれる 1 つの項目を表します。

プロパティ	タイプ	Required	説明
termDuration	string	いいえ	更新期間の ISO 8601 表現。 現在サポートされている値は、 P1M (1 か月) と P1Y (1 年) です。

応答の成功とエラーのコード

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターのエラー コードを参照してください。

CartError

カートの作成後に発生するエラーを表します。

プロパティ	タイプ	説明
errorCode	CartErrorCode	カート エラーの種類。
errorDescription	string	サポートされている値、既定値、または制限に関する注意事項を含むエラーの説明。
additionalInformation	AdditionalInformation	エラーの追加情報。

AdditionalInformation

エラーに関する追加情報。

プロパティ	タイプ	説明
availableQuantity	int	特定の製品 SKU に対して購入できる再メインライセンスの数。
purchasedQuantity	int	購入するライセンスの数。

CartErrorCode

カート エラーの種類。

名前	ErrorCode	説明
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	要求されたシート数が制限を超えています。
Unknown	0	規定値

CartCheckoutResult

カートのチェックアウトの結果を表します。

プロパティ	タイプ	説明
順序	Order オブジェクトの一覧。	注文のコレクション。
orderErrors	OrderError オブジェクトの一覧。	注文エラーのコレクション。

OrderError

注文の作成時にカートのチェックアウト中に発生するエラーを表します。

プロパティ	タイプ	説明
orderGroupId	string	エラーが発生した注文の注文グループ ID。
code	int	エラー コード。
description	string	エラーの説明。