批發通路市場結算報告
帳單報告
合作夥伴可以使用以下批發計費 API 產生計費報告,以協助他們驗證使用情況和配置的準確性。批發計費 API 可透過 developer.webex.com 存取。
-
對帳-顯示每個合作夥伴、每位客戶或每個使用者的用量消耗量。合作夥伴可以使用此自訂計費報告資訊來核對每月發票,以便根據客戶和使用者的使用情況向他們收費。
-
時間點—顯示每位客戶或每位使用者目前的套餐分配狀況。時點報告提供包裹分配的即時計數。合作夥伴可以利用這些資訊來驗證配置的準確性,並確保與客戶訂單保持一致。
合作夥伴還可以使用 subPartnerOrgId 參數為子合作夥伴產生自訂計費報告。
符合最低存取要求的合作夥伴管理員可以使用四個 API。
|
計費 API |
API 的用途 |
合作夥伴管理員存取權限要求 |
|---|---|---|
|
建立批發結算報告 |
用於產生帳單報告。 |
Read/write |
|
取得批發結算報告 |
用於取得可供下載的已產生帳單報告。 |
讀取 |
|
列出批發結算報告 |
用於列出該合作夥伴現有的帳單報告。 |
讀取 |
|
刪除批發結算報告 |
用於刪除現有帳單報告。 |
Read/write |
數據來源
計費報告的數據來自 Webex 為每個合作夥伴追蹤的套餐分配和使用數據。Webex 每天匯總客戶和用戶套餐數據,以產生合作夥伴的月度發票。計費 API 使用這些數據,允許合作夥伴管理員產生自訂報告。這些報告幫助合作夥伴核對每月帳單中合作夥伴、客戶和使用者層級的使用消耗。
有關 Webex 如何向合作夥伴開立發票的更多詳細信息,請參閱 服務提供者計費。
建立批發結算報告
| 1 |
從 developer.webex.com,前往 建立批發計費報告 API。 |
| 2 |
請選擇以下任一報告類別:
如果您想要產生對帳報告,無需進行任何更改,因為預設已選擇對賬,您可以繼續執行下一步。如果要產生時間點報告,請將選擇變更為時間點。 |
| 3 |
請依 API 指定的格式輸入 billingStartDate 和 billingEndDate 。您可以輸入過去五年內的任何日期,但不能輸入目前日期。 對於時間點報告, billingStartDate 和 billingEndDate 欄位不是必要的,如果輸入則會被忽略。該報告始終反映當前的資金分配情況。 |
| 4 |
請輸入 報告 類型:
|
| 5 |
點選 運行 產生報告。 |
| 6 |
從 API 輸出複製報告 id 。您可以使用此值透過 Get API 取得產生的帳單報告。 |
下一步
前往 取得批發帳單報告 部分下載報告副本。
取得批發結算報告
產生帳單報告後,可以使用此 API 取得特定帳單報告。報告會輸出到指定的 URL,在 GET 請求完成後 30 分鐘內可供下載。
| 1 |
從 developer.webex.com,前往 取得批發計費報告 API。 |
| 2 |
輸入報告的唯一 ID值 ,然後 按一下執行。 API 輸出報告狀態。輸出結果包含 tempDownloadURL 參數,該參數提供一個 URL,您可以從中下載報告。 |
| 3 |
將 tempDownloadURL 複製到瀏覽器中以存取和下載報告。 |
列出批發結算報告
使用此 API 取得合作夥伴組織產生的帳單報告清單。您可以列出所有現有報告,或將清單限制為符合指定參數(例如您的計費週期和計費類型(合作夥伴、客戶、使用者))的報告。
如果輸入可選參數,API 將僅傳回與您指定的參數完全匹配的報告。例如,如果您指定結算週期,則只會傳回使用該特定結算週期的報表。報告雖然在規定期間內,但日期不完全匹配,因此不會返回。
| 1 |
從 developer.webex.com,前往 列出批發計費報告 API。 |
| 2 |
在 查詢參數下,輸入您想要使用的任何搜尋參數(例如,開始日期、結束日期、類型、排序依據)。 |
| 3 |
按一下 執行. API 輸出報告列表,以及唯一的報告 ID 和狀態(已完成、_進行中)。
|
下一步
記錄所有要下載的報告的 id 。前往 取得批發結算報告 下載報告。
刪除批發結算報告
使用下列步驟,根據報表 ID 刪除已產生的帳單報表。以下是一些您可能需要刪除報告的範例:
-
如果要重新產生現有的對帳帳單報告,必須先刪除現有報告。刪除現有報告後,您可以為該期間建立新報告。如果報告產生失敗或仍在進行中,則無法刪除該報告。
對於時間點報告,您無需刪除現有報告,因為系統不會重新產生這些報告。每份報告始終反映截至目前時間戳記的資料。
-
如果您將產生的報告 URL 發送給了錯誤的人,您可以刪除該報告,這樣他們就無法存取它了。
| 1 |
從 developer.webex.com,前往 刪除批發計費報告 API。 |
| 2 |
輸入 報告ID ,然後 按一下執行。 |
帳單報告字段
帳單報告包含以下欄位:
|
欄位 |
說明 |
支援的報表類型 |
支援的報表類別 |
|---|---|---|---|
|
合夥人_姓名 |
合夥人姓名 |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
合作夥伴_組織_ID |
唯一合作夥伴識別符 |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
訂閱_ID |
唯一訂閱標識符 |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
服務_名稱 |
服務名稱 (例如:_公共區域通話_、_Webex通話、_Webex套件_、 Webex 會議) |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
SKU |
服務 SKU |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
說明 |
服務描述 |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
消耗量_開始_日期 |
服務消費開始。該值與下一個欄位一起定義了使用期限。 |
合作夥伴、客戶、用戶 |
核對 |
|
消費_結束_日期 |
服務消費結束。該值與前面的欄位一起定義了使用消耗週期。 |
合作夥伴、客戶、用戶 |
核對 |
|
數量 |
表示按合作夥伴、客戶或使用者匯總的使用者使用量(取決於您查看資料的報告和等級)。 計算:系統會按比例計算每位使用者當天的每日使用量。 一整天的使用 = 1 使用半天 = 0.5 然後,它將計費週期內所有日期的每日總計相加,以計算該使用者在該計費週期內的總數量。 對於客戶和合作夥伴層級的報告,所有使用者的總數將被匯總,以提供該客戶或合作夥伴的總數。 特定時間點:客戶報告列出了每位客戶的包裹分配。每一行代表分配給特定客戶組織內的使用者或工作區的特定軟體包的總數。如果沒有分配包裹,數量顯示為「0」。 使用者報告列出了分配給使用者或工作區的軟體包。每一行都顯示數量 1,代表一個使用者或工作區及其各自的軟體包或插件。如果為使用者或工作區指派了多個軟體包或插件,則報告會顯示多個條目,每個條目都有數量。1. |
合作夥伴、客戶、用戶 |
時間點對帳 |
|
客戶_組織_ID |
內部客戶唯一識別符 |
客戶、使用者 |
時間點對帳 |
|
客戶_外部_ID |
合作夥伴提供的客戶唯一識別符 |
客戶、使用者 |
時間點對帳 |
|
訂閱者_ID |
訂閱者的唯一識別符 |
使用者 |
時間點對帳 |
|
USER_ID |
訂閱者的 Webex 使用者 ID |
使用者 |
時間點對帳 |
|
工作區_ID |
唯一工作區識別符 |
使用者 |
時間點對帳 |
|
位置_ID |
唯一位置標識符 |
客戶、使用者 |
時間點對帳 |
|
許可證_ID |
許可證識別符 此欄位僅對批發套餐可見 對於對帳報告,在引入此欄位之前分配的許可證的 License_ID 為空。 如果同一個批發套餐與不同的 LOCATION_ID 和 LICENSE_ID 組合相關聯,則帳單報告會顯示多行。 |
客戶、使用者 |
時間點對帳 |
|
報告_日期 |
報告產生的日期和時間。 |
客戶、使用者 |
時間點 |
向使用者配置套餐會觸發 Webex Wholesale 計費,而移除套餐分配則會停止計費。