批发渠道市场结算报告
账单报告
合作伙伴可以使用以下批发计费 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 计费,而移除套餐分配则会停止计费。