カート リソース

  • [アーティクル]

適用対象: パートナー センター | 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 エラーの説明。