請求照合

パートナー管理者は、ホールセールの請求 API を使用して、パートナーごと、顧客ごと、またはユーザーごとに使用状況を表示するカスタム請求レポートを生成できます。パートナーは、この情報を使用して、毎月の請求書の照合を行い、顧客とユーザーの使用量に応じて請求することができます。

パートナーは、subPartnerOrgId パラメータを使用して、サブパートナーのカスタム請求レポートを生成することもできます。

最小アクセス要件を満たすパートナー管理者は 4 つの API を利用できます。

請求 API

API の目的

パートナー管理者のアクセス要件

ホールセール請求レポートの作成

請求レポートを生成するために使用されます。

読み取り/書き込み

ホールセール請求レポートを取得する

ダウンロードのために生成された請求レポートを取得するために使用されます。

閲覧

ホールセール請求レポートのリスト

そのパートナーに存在する請求レポートを一覧表示するために使用されます。

閲覧

ホールセール請求レポートの削除

既存の請求レポートを削除するために使用されます。

読み取り/書き込み

データ ソース

請求レポートのデータは、Webex が各パートナーに追跡する使用消費データから取得されます。Webex は、毎日、すべてのパートナー、顧客、およびユーザーに対する前日の使用状況を追跡し、データを集約して、パートナーの月次請求書の生成に使用できるようにします。請求 API はこのデータを活用し、パートナー管理者がカスタム レポートを生成することで、パートナーはパートナー、顧客、ユーザー レベルで毎月の請求書からの使用消費を照合できます。

Webex の請求方法の詳細については、「サービス プロバイダーの請求」を参照してください。

ホールセール請求レポートの作成

この手順を使用して、請求を調整するために使用できるカスタム請求レポートを生成します。
1

[ホールセール請求レポートの作成 API] に移動します。

2

API が指定した形式で billingStartDatebillingEndDate の値を入力して、請求期間を入力します。過去 5 年間の任意の日付を入力できますが、現在の日付は入力できません。

3

レポートのタイプ を入力します。

  • [パートナー(これがデフォルト)]:パートナー レベルで使用消費量を表示します。
  • 顧客—パートナーの下の顧客組織のレベルに内訳された総使用消費量を表示します。
  • [ユーザー(USER)]:パートナー下の顧客組織とサブスクリバのレベルに分類された総使用量を表示します。
4

[実行] をクリックしてレポートを生成します。

5

API 出力から ID をコピーします。生成された請求レポートを取得するために、この値を Get API で使用できます。

次に行うこと

[ホールセール請求レポートを取得する] に移動して、レポートのコピーをダウンロードします。

ホールセール請求レポートを取得する

請求レポートが生成されたら、この API を使用して特定の請求レポートを取得します。レポートは、GET 要求が完了してから 30 分間、ダウンロード可能な URL に出力されます。
1

[ホールセールの請求レポートの取得] API に移動します。

2

GET 行で、ID ボタンをクリックし、レポートの一意の ID 値を入力します。

3

[実行] をクリックします。

4

API はレポートステータスを出力します。出力には tempDownloadURL パラメータが含まれます。このパラメータは、レポートをダウンロードできる URL を提供します。

5

レポートにアクセスしてダウンロードするには、tempDownloadURL をブラウザにコピーします。

ホールセール請求レポートのリスト

この API を使用して、パートナー組織に対して生成された請求レポートのリストを取得します。既存のすべてのレポートを一覧表示することも、請求期間や請求タイプ (パートナー、顧客、ユーザー) などの指定されたパラメータを満たすレポートに制限することもできます。

オプションのパラメータを入力すると、API は入力したパラメータと完全に一致するレポートのみを返します。たとえば、請求期間を入力した場合、その特定の請求期間を使用するレポートのみが返されます。期間内に存在し、日付と正確に一致しないレポートは返されません。
1

List Wholesale Billing Report API に移動

2

[クエリ パラメータ] の下で、使用する検索パラメータ (例えば、startDate、endDate、Type、sortBy on) を入力します。これらのパラメータの詳細については、API の開発者ヘルプを参照してください。

3

[実行] をクリックします。

API は、固有のレポート ID とステータス (完了、_進行中) とともにレポートのリストを出力します。

次に行うこと

ダウンロードするレポートの 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 ホールセールの請求は、パッケージのユーザーへのプロビジョニングによってトリガーされるか、パッケージの割り当てを削除して停止されます。