カタログ項目を購入する
次のシナリオでは、パートナー センター API を使用してカタログからアイテムを購入する一般的なプロセスを示します。
探索
製品と在庫保管単位 (SKU) を選択し、次のパートナー センター API モデルを使用して可用性を確認します。
- 製品 - 購買可能な商品またはサービスのグループ化コンストラクト。 製品自体は購入可能なアイテムではありません。
- SKU - 製品で購入可能な SKU。 これらは、製品のさまざまな形状を表します。
- 可用性 - SKU を購入できる構成 (国/地域、通貨、業界セグメントなど)。
カタログからアイテムを購入するには、次の手順を実行します。
購入する製品と SKU を特定して取得します。
SKU のインベントリを確認します。 この手順は、purchasePrerequisites プロパティの InventoryCheck 値でタグ付けされた SKU にのみ必要です。
SKU の可用性を取得します。 注文を行うときは 、可用性の CatalogItemId が必要になります。 この値を取得するには、次のいずれかの API を使用します。
注文の申請
カタログ アイテムの注文を送信するには、次の操作を行います。
購入する カタログ アイテムのコレクションを保持するカート を作成します。 カートを作成すると、同じ注文でまとめて購入できる項目に基づいて、カートの品目が自動的にグループ化されます。
カートを確認してください。 カートをチェックアウトすると、Order が 作成されます。
注文の詳細を取得する
注文 ID を使用して個々の注文の詳細を取得したり、顧客の注文の一覧を取得したりできます。 注文が送信されてから顧客の注文の一覧に表示されるまでに最大 15 分の遅延があります。
注文 ID を使用して個々の注文の詳細を取得するには、「ID で注文を取得する」を参照してください。
顧客 ID を使用して顧客の注文の一覧を取得するには、顧客のすべての注文を取得するを参照してください。
カタログアイテムの注文 (1 回限りの料金) と年次または毎月の請求済み注文を個別に一覧表示できるように、請求サイクルの種類別に顧客の注文の一覧を取得するには、「顧客別の注文と請求サイクルの種類の一覧を取得する」を参照してください。
ライフサイクル管理
パートナー センターでカタログ アイテムのライフサイクルを管理する一環として、カタログアイテム の権利に関する情報を取得し、予約注文 ID を使用して予約の詳細を取得できます。 これを行う方法の例については、「権利を取得する」を参照してください。
請求書と調整
次のシナリオでは、顧客の請求書をプログラムで表示し、カタログ アイテムの 1 回限りの料金を含むアカウント残高と概要を取得する方法を示します。
残高と支払い
定期的な請求金額と 1 回限りの (カタログアイテム) 料金の両方の残高である既定の通貨タイプの現在の口座残高を取得するには、「現在の口座残高を取得する」を参照してください。
複数通貨の残高と支払い
現在の口座残高と、顧客の通貨の種類ごとに繰り返し請求と 1 回限りの料金の両方を含む請求書の概要を含む請求書の概要のコレクションを取得するには、「請求書の概要を取得する」を参照してください。
請求 書
定期的な料金と 1 回限りの料金の両方を表示する請求書のコレクションを取得するには、「請求書のコレクションを取得する」を参照してください。
1 つの請求書
請求書 ID を使用して特定の請求書を取得するには、「ID で請求書を取得する」を参照してください。
和解
特定の請求書 ID の請求書明細の詳細 (調整明細) のコレクションを取得するには、「請求書明細の取得」を参照してください。
請求書を PDF としてダウンロードする
請求書 ID を使用して PDF フォームで請求書明細書を取得するには、「請求書明細書を取得する」を参照してください。