ホールセール RTM の請求照合
請求照合
パートナー管理者は、ホールセールの請求 API を使用して、パートナーごと、顧客ごと、またはユーザーごとに使用状況を表示するカスタム請求レポートを生成できます。パートナーは、この情報を使用して、毎月の請求書の照合を行い、顧客とユーザーの使用量に応じて請求することができます。
パートナーは、subPartnerOrgId パラメータを使用して、サブパートナーのカスタム請求レポートを生成することもできます。
最小アクセス要件を満たすパートナー管理者は 4 つの API を利用できます。
請求 API |
API の目的 |
パートナー管理者のアクセス要件 |
---|---|---|
ホールセール請求レポートの作成 |
請求レポートを生成するために使用されます。 |
読み取り/書き込み |
ホールセール請求レポートを取得する |
ダウンロードのために生成された請求レポートを取得するために使用されます。 |
閲覧 |
ホールセール請求レポートのリスト |
そのパートナーに存在する請求レポートを一覧表示するために使用されます。 |
閲覧 |
ホールセール請求レポートの削除 |
既存の請求レポートを削除するために使用されます。 |
読み取り/書き込み |
データ ソース
請求レポートのデータは、Webex が各パートナーに追跡する使用消費データから取得されます。Webex は、毎日、すべてのパートナー、顧客、およびユーザーに対する前日の使用状況を追跡し、データを集約して、パートナーの月次請求書の生成に使用できるようにします。請求 API はこのデータを活用し、パートナー管理者がカスタム レポートを生成することで、パートナーはパートナー、顧客、ユーザー レベルで毎月の請求書からの使用消費を照合できます。
Webex の請求方法の詳細については、「サービス プロバイダーの請求」を参照してください。
ホールセール請求レポートの作成
1 |
[ホールセール請求レポートの作成 API] に移動します。 |
2 |
API が指定した形式で billingStartDate と billingEndDate の値を入力して、請求期間を入力します。過去 5 年間の任意の日付を入力できますが、現在の日付は入力できません。 |
3 |
レポートのタイプ を入力します。
|
4 |
[実行] をクリックしてレポートを生成します。 |
5 |
API 出力から ID をコピーします。生成された請求レポートを取得するために、この値を Get API で使用できます。 |
次に行うこと
ホールセール請求レポートを取得する
1 |
[ホールセールの請求レポートの取得] API に移動します。 |
2 |
GET 行で、ID ボタンをクリックし、レポートの一意の ID 値を入力します。 |
3 |
[実行] をクリックします。 |
4 |
API はレポートステータスを出力します。出力には tempDownloadURL パラメータが含まれます。このパラメータは、レポートをダウンロードできる URL を提供します。 |
5 |
レポートにアクセスしてダウンロードするには、tempDownloadURL をブラウザにコピーします。 |
ホールセール請求レポートのリスト
この API を使用して、パートナー組織に対して生成された請求レポートのリストを取得します。既存のすべてのレポートを一覧表示することも、請求期間や請求タイプ (パートナー、顧客、ユーザー) などの指定されたパラメータを満たすレポートに制限することもできます。
1 |
List Wholesale Billing Report API に移動 |
2 |
[クエリ パラメータ] の下で、使用する検索パラメータ (例えば、startDate、endDate、Type、sortBy on) を入力します。これらのパラメータの詳細については、API の開発者ヘルプを参照してください。 |
3 |
[実行] をクリックします。 API は、固有のレポート ID とステータス (完了、_進行中) とともにレポートのリストを出力します。
|
次に行うこと
ホールセール請求レポートの削除
この手順を使用して、レポート ID に基づいて生成された請求レポートを削除します。レポートを削除する例をいくつか示します。
-
既存の請求レポートを再生成する場合は、まず既存のレポートを削除する必要があります。既存のレポートを削除すると、その期間の新しいレポートを作成できます。レポートが失敗した場合、または進行中の場合、削除要件は存在しないことに注意してください。
-
レポートが生成され、URL が間違った人に送信された場合、レポートを削除すると、そのレポートにアクセスできなくなります。
1 |
Delete Wholesale Billing Report API に移動します。 |
2 |
レポート Id を入力します。 |
3 |
[実行] をクリックします。 |
請求レポートのフィールド
請求レポートには次のフィールドが含まれます。
フィールド |
追加情報 |
このタイプのレポートに表示されます |
---|---|---|
パートナー_名 |
パートナーの名前 |
パートナー、顧客、ユーザー |
パートナー_ORG_ID |
固有のパートナー識別子 |
パートナー、顧客、ユーザー |
サブスクリプション _ID |
固有のサブスクリプション ID |
パートナー、顧客、ユーザー |
サービス_名 |
サービス名 (共通の_エリア_CALLING、WEBEX_CALLING、WEBEX_SUITE、WEBEX_MEETINGS など) |
パートナー、顧客、ユーザー |
SKU |
サービスのための Sku |
パートナー、顧客、ユーザー |
説明 |
サービスの説明 |
パートナー、顧客、ユーザー |
消費開始__日 |
サービスの消費を開始します。以下のフィールドとともに、この値は使用期間を定義します。 |
パートナー、顧客、ユーザー |
消費終了_日_ |
サービス消費の終了。上記のフィールドとともに、この値は使用量の消費期間を定義します。 |
パートナー、顧客、ユーザー |
数量 |
パートナー、顧客ごと、またはユーザーごとの合計ユーザー使用消費量を表します(データを表示するレポートやレベルに応じて)。 計算: ユーザーごとに、1 日あたりの数量は、その日の延長に基づいて計算されます。例: 一日の使用状況 = 1 半日の使用量 = 0.5 請求期間内のすべての日の日単位の合計が合計され、その請求期間内のユーザーの合計数が表示されます。 顧客およびパートナーレベルのレポートでは、すべてのユーザーの合計が集計され、その顧客またはパートナーの合計数を提供します。 |
パートナー、顧客、ユーザー |
顧客_ORG_ID |
内部顧客一意の識別子 |
顧客、ユーザー |
顧客_外部_ID |
パートナーから提供された顧客固有識別子 |
顧客、ユーザー |
サブスクライバー_ID |
サブスクライバの一意の識別子 |
USER |
USER_ID |
サブスクライバーの Webex ユーザー ID |
USER |
ワークスペース_ID |
一意のワークスペース識別子 |
USER |
ロケーション_ID |
一意のロケーション識別子 |
顧客、ユーザー |
Webex ホールセールの請求は、パッケージのユーザーへのプロビジョニングによってトリガーされるか、パッケージの割り当てを削除して停止されます。