適用対象: パートナー センター |21Vianet が運営するパートナー センター |Microsoft Cloud for US Government のパートナー センター
パートナーは、顧客がオファーの一覧からサブスクリプションを購入する場合に注文を行います。
Cart
カートについて説明します。
| プロパティ | タイプ | Description |
|---|---|---|
| id | 文字列 | カートの作成が成功したときに提供されるカート識別子。 |
| 作成タイムスタンプ | DateTime | 日付と時刻の形式で、カートが作成された日付。 カートの作成が成功した場合に適用されます。 |
| lastModifiedTimeStamp | DateTime | カートが最後に更新された日付を日時形式で指定します。 カートの作成が成功した場合に適用されます。 |
| expirationTimeStamp | DateTime | 日付と時刻の形式で、カートの有効期限が切れる日付。 カートの正常な作成時に適用されます。 |
| lastModifiedUser | 文字列 | カートを最後に更新したユーザー。 カートの正常な作成時に適用されます。 |
| lineItems | オブジェクトの配列 | CartLineItem リソースの配列。 |
| 状態 | 文字列 | カートの状態。 指定できる値は、"Active" (更新/送信可能) と "Ordered" (既に送信済み) です。 |
CartLineItem
カートに含まれる 1 つの項目を表します。
| プロパティ | タイプ | Description |
|---|---|---|
| id | 文字列 | カートの品目の一意識別子。 カートの正常な作成時に適用されます。 |
| catalogItemId | 文字列 | カタログ アイテム識別子。 |
| フレンドリーネーム | 文字列 | Optional. あいまいさを解消するためにパートナーによって定義された項目のフレンドリ名。 |
| 量 | 整数 (int) | ライセンスまたはインスタンスの数。 |
| 通貨コード | 文字列 | 通貨コード。 |
| billingCycle | Object | 現在の期間に設定支払いサイクルの種類。 |
| termDuration | 文字列 | 用語の期間を ISO 8601 で表したもの。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。 |
| participants | オブジェクト文字列ペアの一覧 | 購入に関する記録されている PartnerID の文字列のコレクション。 |
| provisioningContext | Dictionary<string、string> | 購入したアイテムをプロビジョニングするときに使用される追加のコンテキスト。 特定の項目に必要な値を決定するには、SKU の provisioningVariables プロパティを参照してください。 |
| orderGroup | 文字列 | 同じ順序で一緒に送信できるアイテムを示すグループ。 |
| addonItems | CartLineItem オブジェクトの一覧 | アドオンのカートの品目のコレクション。 これらの項目は、ルート カートの品目の購入に起因する基本サブスクリプションに対して購入されます。 |
| エラー | Object | エラーが発生した場合にカートが作成された後に適用されます。 |
| renewsTo | オブジェクトの配列 | RenewsTo リソースの配列。 |
| AttestationAccepted | ブール (bool) | オファーまたは SKU の条件に対する契約を示します。 SkuAttestationProperties または OfferAttestationProperties enforceAttestation が True のオファーまたは SKU にのみ必要です。 |
| promotionId | 文字列 | カートの品目に適用される予定のプロモーション ID。 |
| customTermEndDate | DateTime | 新しいサブスクリプションの最初の請求期間の終了日。 |
参加者
顧客のサブスクリプションを管理しているディストリビューターのリセラーを表します。
| プロパティ | タイプ | Description |
|---|---|---|
| transaction_reseller | 文字列 | 顧客を管理するリセラーのパートナー ID。 |
| additional_transaction_reseller | 文字列 | トランザクションまたは顧客の管理に関与する他のパートナーの追加パートナー ID。 このプロパティは、 EU/EFTA市場で事業を行うディストリビューターにのみ適用されます。 |
Pricing
価格の詳細を表します。 価格額は課税前に提供されます。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| listPrice | ダブル | いいえ | 価格修飾子が適用されていないカタログに記載されている価格。 |
| 割引価格 | ダブル | いいえ | 適用されるすべての価格修飾子を適用した後の価格。 |
| 比例配分された価格 | ダブル | いいえ | 按分後の割引価格。 |
| 価格 | ダブル | いいえ | すべての割引が適用され、日割り計算が実行された後の、該当する請求通貨での価格。 |
| 合計価格 | ダブル | いいえ | 数量、割引、および按分が適用された品目の価格は、該当する請求通貨で表されます。 |
RenewsTo
カートの品目に含まれる 1 つの項目を表します。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| termDuration | 文字列 | いいえ | 更新期間の ISO 8601 表現。 現在サポートされている値は 、P1M (1 か月) と P1Y (1 年) です。 |
ScheduledNextTermInstructions
次の表では、新しいコマース エクスペリエンス (NCE) ライセンスに基づく試用版オファーの更新のための scheduledNextTermInstructions プロパティについて説明します。 値が指定されていない場合、試用版は有料サブスクリプションに更新され、年間期間、月単位の課金、25 個のライセンスに更新されます。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| 製品 | アレイ | いいえ | 試用版サブスクリプションが更新されるオファーと、有料サブスクリプションの期間と請求頻度を指定する配列。 |
| 量 | 整数 (int) | いいえ | 試用版オファーが更新されると、対応する有料サブスクリプションに含まれるライセンス数量。 |
Product
この表では、NCE ライセンスベースの試用版オファーの更新に関する productTerm プロパティについて説明します。 この配列に値が指定されていない場合、試用版は年次期間と月単位の請求で有料サブスクリプションに更新されます。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| productId | 文字列 | いいえ | 試用版が更新される有料サブスクリプションの製品を表現するためにフォーマットされた GUID。 |
| skuId | 文字列 | いいえ | 試用版が更新される有料サブスクリプションの SKU を表す形式の GUID。 |
| availabilityId | 文字列 | いいえ | 試用版が更新される有料サブスクリプションの可用性を示すようにフォーマットされた GUID。 |
| billingCycle | 文字列 | いいえ | 試用版オファーが更新されると、対応する有料サブスクリプションが持つ課金頻度。 |
| termDuration | 文字列 | いいえ | 試用版オファーが更新された後に適用される、対応する有料サブスクリプションの期間。 |
応答の成功とエラー コード
各応答には、成功または失敗とより多くのデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、追加のパラメーターを読み取ります。 完全な一覧については、「パートナー センターのエラー コード 参照してください。
CartError
カートの作成後に発生するエラーを表します。
| プロパティ | タイプ | Description |
|---|---|---|
| エラーコード | CartErrorCode | カート エラーの種類。 |
| エラー説明 | 文字列 | サポートされている値、既定値、または制限に関する注意事項を含むエラーの説明。 |
| 追加情報 | 追加情報 | エラーの詳細。 |
追加情報
エラーに関する追加情報。
| プロパティ | タイプ | Description |
|---|---|---|
| 在庫数 | 整数 (int) | 特定の製品 SKU に対して購入できる残りのライセンスの数。 |
| 購入数量 | 整数 (int) | 購入するライセンスの数。 |
カートエラーコード (CartErrorCode)
カート エラーの種類。
| 名前 | ErrorCode | Description |
|---|---|---|
| 通貨はサポートされていません | 10000 | 特定の市場では通貨はサポートされていません |
| カタログアイテムIDが無効です | 10001 | カタログ アイテム ID が無効です |
| QuotaNotAvailable | 10002 | 使用可能なクォータが不足しています |
| 在庫がありません | 10003 | 選択したオファーでインベントリを使用できない |
| ParticipantsIsNotSupportedForPartner（パートナーに対して参加者はサポートされていません） | 10004 | パートナーの参加者の設定はサポートされていません |
| カート行アイテムを処理できません | 10006 | カートの品目を処理できません。 |
| サブスクリプションが無効です | 10007 | サブスクリプションが無効です。 |
| サブスクリプションはRIのために有効化されていません | 10008 | サブスクリプションは予約購入に対して有効になっていません。 |
| サンドボックス制限超過 | 10009 | サンドボックスの制限を超えています。 |
| 無効な入力 | 10010 | ジェネリック入力が無効です。 |
| サブスクリプションが登録されていません | 10011 | サブスクリプションが無効です。 |
| 証明書が受け入れられていません | 10012 | 証明書は受け入れられませんでした。 |
| サブスクリプションごとの許可された最大シート数を超えました | 10015 | 要求されたシート数が制限を超えています。 |
| Unknown | 0 | 既定値 |
カートチェックアウト結果
カートのチェックアウトの結果を表します。
| プロパティ | タイプ | Description |
|---|---|---|
| 順序 | Order オブジェクトの一覧。 | 注文のコレクション。 |
| 注文エラー | OrderError オブジェクトの一覧。 | オーダーエラーの収集 |
OrderError
注文の作成時にカートのチェックアウト中に発生するエラーを表します。
| プロパティ | タイプ | Description |
|---|---|---|
| orderGroupId（注文グループID） | 文字列 | エラーが発生した注文の注文グループ ID。 |
| コード | 整数 (int) | エラー コード。 |
| 説明 | 文字列 | エラーの説明。 |