Usage Management Module implements the direct flow of the consumption/metering/pay-as-you-go data communication from Vendors to Providers. Usage flow is schematically illustrated with red color in the following diagram:
Usage flow is initiated by Vendors and is then used by Providers for billing/reporting to their customers. Usage flow is common in various following business scenarios like Telecommunications, Infrastructure as a Service (IaaS), Platform as a Service (Paas), Internet of Things (IoT), Managed Services and many others:
Where the following technical steps need to be supported:
Vendors report data representing how items are being consumed. This scenario is applicable to the Items of the Reservation type.
Vendors report data specifically for billing purposes. This scenario is only applicable for items with the Pay-as-you-go items type and could be used at different layers
For billing between Vendors and Providers
For billing between Providers and their direct Customers
For billing between Providers and their Resellers
For billing between Resellers and their Customers
Different aspects of the Usage Management are discussed in the following chapters of this article.
Not all Products support Usage-related scenarios, thus these capabilities need to be explicitly enabled in the Product Editor:
The following 3 capabilities define key aspects of the usage-related product scenarios:
Pay-as-you-go Support – defines that Product has pay-as-you-go component, i.e. periodically submits Usage Files to the Provider
Usage Schema – defines implemented schema is explicitly declared in the product definition. One product implements only one schema.
Dynamic Items – defines that Product reports dynamic items in the Usage File, i.e. the ones that were not pre-declared in the Product Definition
Subscription Relative Addressing
Usage data often needs to relate to different tiers in the distribution hierarchy. There are 2 possible ways of addressing in the hierarchy as schematically illustrated below:
Levels = addressing relative to the Top-level account in the system (blue in the diagram above)
Example: “Level 2” means 2 accounts below the “root” account of a given Hub.
Tiers = addressing relative to the Subscription (red in the diagram above)
Example: “Tier 1” means 1 account above the account that owns the subscription
While both technically make sense, only subscription-relative (tiers) allows vendors to not be dependent on the actual number of tiers and other specifics of the distribution channel of a given provider. Thus only subscription-relative (tiers) addressing is used by the CloudBlue Connect.
Any product definition in our ecosystem falls into 1 of the following usage reporting schemas supported by the CloudBlue Connect
Quantity – Providers bill (rate) their customers based on the item-level quantity information that they receive from their Vendors
Price Rated – Providers bill (rate) their customers based on the item-level Tier-0 (End-customer) Price Information that they receive from their Vendors
Cost Rated – Providers bill (rate) their customers based on the item-level Level-0 (Provider Cost) Price Information that they receive from their Vendors
Tiers Rated – Providers bill (rate) their customers based on the item-level Price Information that they receive from their Vendors for multiple Tiers
Usage management module implements the following workflow of interaction between Vendors and Providers:
Vendor systems are the source of Usage data in the format of the Vendor that can’t be processed by Connect yet
Normalization to Connect schema(s)
Normalized Usage File that implements Connect template and is uploaded by Vendor for processing
The processed file generated by Connect that includes additional columns as a result of processing
Provider reviews and accepts or rejects usage file
Export of records for billing either using record-level API calls or using bulk file export
Data is used by Provider to bill Customers or Resellers of their own
Storing of reconciliation data either on a record-level or using the bulk file upload
With the following state-machine of the key objects:
Usage data can only be reported by Vendors when the following conditions are in place for a given provider:
Active Program Contract
Active Distribution Contract
Active Listing for a given product in a required Marketplace
If these conditions are not met, usage reporting will not be allowed since reporting is always done in the scope of a particular distribution contract. Additionally, please note that reporting is only possible for:
Assets that are part of a given distribution contract
Asset must have items for which usage is reported
This process can be done either using the User Interface or using API, please refer to the separate article for an overview of APIs that can be used for usage reporting. In this article, we will focus on manual usage data reporting using the User Interface of the Vendor Portal.