批发市场路线的账单核对
账单对账
合作伙伴管理员可以使用批发计费 API 生成自定义计费报告,显示每个合作伙伴、每个客户或每个用户级别的使用情况。合作伙伴可以使用这些信息来核对他们的月度发票,以便他们可以根据客户和用户的使用情况向他们收费。
合作伙伴还可以使用 subPartnerOrgId 参数为子合作伙伴生成自定义账单报告。
满足最低访问要求的合作伙伴管理员可以使用四个 API。
计费 API |
API 的用途 |
合作伙伴管理员访问要求 |
---|---|---|
创建批发账单报告 |
用于生成帐单报告。 |
读 / 写 |
获取批发账单报告 |
用于获取生成的账单报告以供下载。 |
阅读 |
列出批发账单报告 |
用于列出该合作伙伴现有的帐单报告。 |
阅读 |
删除批发账单报告 |
用于删除现有的帐单报告。 |
读 / 写 |
数据源
计费报告的数据取自 Webex 为每个合作伙伴跟踪的使用情况消费数据。每天,Webex 都会跟踪所有合作伙伴、客户和用户的前一天使用情况,并汇总数据,以便生成合作伙伴的月度发票。计费 API 利用这些数据,让合作伙伴管理员生成自定义报告,以便合作伙伴可以根据合作伙伴、客户和用户级别的月度发票核对使用情况。
有关 Webex 如何向合作伙伴开具发票的更多详细信息,请参阅 服务提供商计费。
创建批发账单报告
1 |
转到创建批发账单报告 API。 |
2 |
通过以 API 指定的格式输入 billingStartDate 和 billingEndDate 的值来输入计费周期。您可以输入过去五年内的任何日期,但不能输入当天。 |
3 |
输入报告的 类型 :
|
4 |
单击 运行 以生成报告。 |
5 |
从 API 输出中复制报告 id 。您可以将此值与 Get API 一起使用以获取生成的账单报告。 |
下一步
获取批发账单报告
1 |
转到获取批发账单报告 API。 |
2 |
在 GET 行中,单击 id 按钮并输入报告的唯一 id 值。 |
3 |
单击 运行. |
4 |
API输出报告状态。输出包括 tempDownloadURL 参数,该参数提供了可从中下载报告的 URL。 |
5 |
将 tempDownloadURL 复制到浏览器中以访问和下载报告。 |
列出批发账单报告
使用此 API 获取合作伙伴组织生成的账单报告列表。您可以列出所有现有报告,或将列表限制为符合指定参数(例如计费周期和计费类型(合作伙伴、客户、用户))的报告。
1 |
前往列表批发账单报告 API |
2 |
在 查询参数下,输入您想要使用的任何搜索参数(例如,startDate、endDate、Type、sortBy)。有关这些参数的更多详细信息,请参阅 API 上的开发人员帮助。 |
3 |
单击 运行. API 输出报告列表以及唯一的报告 id 和状态(COMPLETED、IN_PROGRESS)。
|
下一步
删除批发账单报告
使用此过程根据报告 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 计费,而删除套餐分配则会停止计费。