账单对账

合作伙伴管理员可以使用批发计费 API 生成自定义计费报告,显示每个合作伙伴、每个客户或每个用户级别的使用情况。合作伙伴可以使用这些信息来核对他们的月度发票,以便他们可以根据客户和用户的使用情况向他们收费。

合作伙伴还可以使用 subPartnerOrgId 参数为子合作伙伴生成自定义账单报告。

满足最低访问要求的合作伙伴管理员可以使用四个 API。

计费 API

API 的用途

合作伙伴管理员访问要求

创建批发账单报告

用于生成帐单报告。

读 / 写

获取批发账单报告

用于获取生成的账单报告以供下载。

阅读

列出批发账单报告

用于列出该合作伙伴现有的帐单报告。

阅读

删除批发账单报告

用于删除现有的帐单报告。

读 / 写

数据源

计费报告的数据取自 Webex 为每个合作伙伴跟踪的使用情况消费数据。每天,Webex 都会跟踪所有合作伙伴、客户和用户的前一天使用情况,并汇总数据,以便生成合作伙伴的月度发票。计费 API 利用这些数据,让合作伙伴管理员生成自定义报告,以便合作伙伴可以根据合作伙伴、客户和用户级别的月度发票核对使用情况。

有关 Webex 如何向合作伙伴开具发票的更多详细信息,请参阅 服务提供商计费

创建批发账单报告

使用此过程生成可用于核对账单的自定义账单报告。
1

转到创建批发账单报告 API。

2

通过以 API 指定的格式输入 billingStartDatebillingEndDate 的值来输入计费周期。您可以输入过去五年内的任何日期,但不能输入当天。

3

输入报告的 类型 :

  • 合作伙伴(这是默认值)—显示合作伙伴级别的使用情况。
  • 客户——显示按合作伙伴下的客户组织级别细分的总使用量。
  • 用户——显示按客户组织和合作伙伴下属订阅者级别细分的总使用情况。
4

单击 运行 以生成报告。

5

从 API 输出中复制报告 id 。您可以将此值与 Get API 一起使用以获取生成的账单报告。

下一步

前往 获取批发账单报告 下载报告副本。

获取批发账单报告

一旦生成了账单报告,就可以使用此API获取具体的账单报告。报告将输出到一个 URL,在 GET 请求完成后 30 分钟内可从该 URL 下载。
1

转到获取批发账单报告 API。

2

GET 行中,单击 id 按钮并输入报告的唯一 id 值。

3

单击 运行.

4

API输出报告状态。输出包括 tempDownloadURL 参数,该参数提供了可从中下载报告的 URL。

5

tempDownloadURL 复制到浏览器中以访问和下载报告。

列出批发账单报告

使用此 API 获取合作伙伴组织生成的账单报告列表。您可以列出所有现有报告,或将列表限制为符合指定参数(例如计费周期和计费类型(合作伙伴、客户、用户))的报告。

如果您输入可选参数,API 仅返回与您输入的参数完全匹配的报告。例如,如果您输入一个结算周期,则只会返回使用该特定结算周期的报告 - 不会返回属于该周期但日期不完全匹配的报告。
1

前往列表批发账单报告 API

2

查询参数下,输入您想要使用的任何搜索参数(例如,startDate、endDate、Type、sortBy)。有关这些参数的更多详细信息,请参阅 API 上的开发人员帮助。

3

单击 运行.

API 输出报告列表以及唯一的报告 id 和状态(COMPLETED、IN_PROGRESS)。

下一步

记录您想要下载的任何报告的 id 。前往 获取批发账单报告 下载该报告。

删除批发账单报告

使用此过程根据报告 ID 删除生成的计费报告。您可能想要删除报告的一些示例包括:

  • 如果您想重新生成现有的帐单报告,您必须先删除现有的报告。删除现有报告后,您可以为该期间创建新报告。请注意,如果报告失败或正在进行中,则不存在删除要求。

  • 如果生成了报告并且您将 URL 发送给了错误的人员,您可以删除该报告,他们将无法访问它。

1

转到删除批发账单报告 API。

2

输入报告 Id

3

单击 运行.

账单报告字段

账单报告包含以下字段:

字段

附加信息

出现在以下类型的报告中

合伙人_姓名

合伙人姓名

合作伙伴、客户、用户

合作伙伴_组织_ID

唯一合作伙伴标识符

合作伙伴、客户、用户

订阅_ID

唯一订阅标识符

合作伙伴、客户、用户

服务_名称

服务名称

(例如,COMMON_AREA_CALLING、WEBEX_CALLING、WEBEX_SUITE、WEBEX_MEETINGS)

合作伙伴、客户、用户

SKU

服务SKU

合作伙伴、客户、用户

描述

服务描述

合作伙伴、客户、用户

消费_开始_日期

开始服务消费。该值与以下字段一起定义使用期限。

合作伙伴、客户、用户

消费_结束_日期

服务消费结束。该值与前面的字段一起定义了使用消耗周期。

合作伙伴、客户、用户

数量

表示每个合作伙伴、每个客户或每个用户的汇总用户使用量(取决于您查看数据的报告和级别)。

计算:

他们按比例计算每个用户当天的每日数量。

全天使用 = 1

使用半天 = 0.5

它们将计费周期内所有日期的每日总量相加,以计算该计费周期内该用户的总数量。

对于客户和合作伙伴级别的报告,所有用户的总数被汇总以提供该客户或合作伙伴的总数量。

合作伙伴、客户、用户

客户_组织_ID

内部客户唯一标识符

客户、用户

客户_外部_ID

合作伙伴提供的客户唯一标识符

客户、用户

订阅者_ID

订阅者的唯一标识符

用户

USER_ID

订阅者的 Webex 用户 ID

用户

工作区_ID

唯一工作区标识符

用户

位置_ID

唯一位置标识符

客户、用户

许可证_ID

许可证标识符

此字段仅对批发包裹可见。对于引入此字段之前分配的许可证,License_ID 为空白。

账单报告可能会显示同一批发包裹的多行,每行代表一个唯一的 package/license ID 组合。

如果存在 LICENSE_ID 字段,则每行代表一个唯一的 package/location/license ID 组合。

客户、用户

向用户配置套餐会触发 Webex Wholesale 计费,而删除套餐分配则会停止计费。