1. Home
  2. Analyze
  3. Creating Chargebacks
  1. Home
  2. Setup
  3. Creating Chargebacks

Creating Chargebacks

What are Chargebacks?

Chargebacks in PyraCloud allow users to take existing cloud consumption and distribute the cost across their organization. Users can pull cloud consumption spend for direct and indirect agreements, define chargeback based on organizational structure and create single or multiple internal chargeback invoice documents.

This is one if the last steps to achieving full end-to-end Cloud Management. Chargebacks offers the following benefits:

  • Users can create invoices, split invoices by provider and then charge the respective business unit or department for the cloud services they are using.
  • Users have the ability to view, manage and send internal invoices.
  • Users no longer need to manage this process manually in a spreadsheet.

Setup Requirements

Chargebacks depends on the Consumption Module and Custom Groups Module in PyraCloud. Only the Consumption Module is mandatory. It is possible to generate a summary document and split by Tenants & Subscriptions without further configuration. Custom distribution of costs across separate documents requires “Custom Group” being configured and resources properly assigned.

Accessing Chargebacks in PyraCloud is done by clicking on Analyze > Chargebacks.

Figure 1 – Navigating to Chargeback Manager

Clicking on Chargebacks will open the main Chargebacks page which has two tabs “Chargebacks” and “Settings” as well as three buttons on the top left where you can “View Scheduled Reports”, “Add New Schedule” or “Add New Chargebacks”.

Figure 2 – Chargeback Main Page

Access Levels

Chargebacks has two access levels:

  • User Level: Users with this access level will only be able to see the Chargebacks tab. The Add New Chargebacks page will not be available to users who have “User Level Access”. User Level Access is for users who need to view chargebacks but do not have permission to create chargebacks. These users can then access the document details in order to analyze the charges using PyraCloud’s Consumption module. This will give users the detailed information of the relevant chargeback
  • Admin Level: Users with this access level will be able to see both the Chargeback tab as well as the Add New Chargebacks tab. Admins can view, create, modify and delete chargebacks.

Note: If you need to get your access level changed, please contact your SoftwareONE Account Team.

Document Management

Issuing Documents in Recurring Manner

  1. (Optional) Configure Custom Groups or Tenants & Subscriptions (Consumption module documentation).
  2. Set bill-to details on Settings page
  3. Configure scheduled report
  4. Adjust generated document in Chargeback section.
  5. Send documents to recipient.
  6. Generate summary report of issued documents

Issue One-Time Document

  1. (Optional) Configure Custom Groups or Tenants & Subscriptions (Consumption module documentation).
  2. Generate document by hand using Setup page
  3. Adjust generated documents (Chargebacks section).
  4. Send documents to recipient.

Document Corrections

  1. Open generated document in Chargebacks by clicking on the line item in the Chargabacks tab section.
  2. Apply additional charges/discounts, change currency, bill-to and other properties. If document has been sent then new version will be created.
  3. Send corrected document to recipient.


Chargeback Tab

In the Chargeback tab, users can see all chargeback invoices including specific details about that invoice as outlined below:

Document NameName of the document
Chargeback No. This is unique number for generated chargeback invoice. Column hidden by default.
ProvidersPublisher list taken into consideration for document
Bill ToCompany name which paying department belongs to
EmailRecipient’s email. Column hidden by default.
Document DateDate of document generation
AmountAmount of this Chargeback i.e. Total of all line items
Billing/Usage periodConsumption filter – start/end date or list of billing periods – it has been generated for
Status Status of the chargeback invoice.
Possible values: “Generating”, “Generated”, ”Sent”, “Failed”.

Note: As of now, this module supports Azure EA, Azure CSP, AWS and O365.

Figure 3 – List of Chargeback Invoices Created

Invoice Details

Users can click on any row to open a detailed view of the respective chargeback invoice. The page shows all information related to the document and gives user the ability to edit.

Document view – consists of header, body and footer. On the right side “Actions”, “Activity” and “Versions” panels are available.

Header – consists of name and date the document was generated. Bill-to address, company logo, customer number, consumption/billing period date range and field to store custom notes.

Body – lists the line items. Each line item is described with appropriate providers, total resources count and amount. Line items are further divided into sub lines, which display top Resource Types.

Resource Type – defines provider and type of resource. If the resource type is virtual machines or storage, user will also see SaaS connected resource types like “User” or “License”. Please consult Consumption Module for more details.

Footer – displays contacts, company information and exchange rates applied during currency conversion. Additionally system-wide unique Chargeback Number is visible and should be used during contact with Support in case of issues with document.

Note: Subgroups structure is only available using Custom Group split. It is not possible to display both group structure and Resource Types at the same time. It is possible to switch between Subgroups and Resource types in the Customize menu which can be found in the middle section of the document Volume column is hidden by default. It can be adjusted in Customize menu.

Figure 4 – Detailed View of an Invoice Selected

Software-as-a-Service Licenses

Office 365 licenses are classified by theirs assignment status. On chargeback document, assigned licenses are visible as “User” subline with resource count matching active users. On the other hand, unassigned license are gathered under “License” subline with resource count matching number of license type (like Office365 E3 or E5).

Figure 5 – SaaS Sublines

Additional Charges

Additional charges represents new line items added by hand to generated document. Costs associated with such line may represent various invoice corrections or items not associated with consumption data. Support fee, discounts, credits are typical examples for such charge.

Functionality is available through “Add Charge or Credit” button visible on bottom of line item list.

Figure 6 – Line Items with Add Charge or Credit button

Additional charges may be fixed or percentage based. Percentage amount is calculated based on consumption data only, therefore other lines (e.g. markup) are not taken into consideration. Negative values are calculated as discounts. Additional charges can be removed with Delete button.

Figure 7 – Additional Charges 

Subgroups Structure

Documents based on Custom Groups can display nested groups sublines. Whole purpose of sublines is to add more transparency to the cost of the line item. It is an alternative to displaying top Resource Types.

Figure 8 – Group Structure Mapping 

Subgroups are organized in tree structure. Visibility and depth of presented sublines can be selected in the Customize menu. Please note that the cost of subline is not calculated into the total cost of the document. In other words, it provides justification for line costs.

Figure 9 – Line Structure Options

Name of given subgroup (and therefore line name) can be properly adjusted on Settings page.


Generated documents often miss crucial information needed to justify the amount associated with line items. Moreover, documents often require appending internal tracking numbers. Notes address both of these needs and has the capability to store text and append it to generated PDF. The field is accessible near the top of the document.

Figure 10 – Notes


Chargeback documents are “read only” after being sent. Further edits of sent documents are treated as separate versions. New versions are marked with the date and person making the edits. All changes are collated as long as the new version is not sent to the recipient again.

Previous versions are accessible through the panel on the right hand side of the document. Previous versions cannot be changed or deleted.

Figure 11 – Versions Panel

Actions and Activity Panel

The Chargebacks page has an “Actions” panel on the right hand side, which will allow users to perform actions with selected invoice as outlined below:

  • Export with Charts as a PDF or Export as PDF
  • Analyze Consumption Report
  • Export resource data to CSV
  • Delete Chargeback. Document is permanently removed from the system
  • Activity – send document to the recipient. After sending document, status is being changed to “Sent”.
Figure 12 – Actions Panel

Note: Delete Chargeback option is only available for users with “Admin Access Level”. In most cases, it is the owner of the chargeback invoice i.e. the user who has generated the invoice. Analyze Spend Report is a drop down wherein users can select the required providers. This will redirect users to the PyraCloud Consumption Module for the selected provider.

Figure 13 – Document Status

Document Delivery

Sent documents are delivered to the recipient by email. Recipients receive a PDF with the chargeback document along with a link to the detailed report (CSV file).

The detailed file describes every line of document with Meter Name, Volume and Resource Name. Data provided in CSV files are input to calculations performed to generate the chargeback document. Attached details can be imported to external systems for reference or further analysis. Diagnosis of miscalculations is also feasible.

The links to the detailed files expire after 5 days from the time the message is received. Regeneration of links is possible by sending documents once again – using the “Send” button in Chargeback Manager.

Adding New Chargebacks

Click on the “Add New Chargebacks” button as shown below:

Figure 14 – Add New Chargebacks

This will open the New Chargebacks page. There is an intro paragraph explaining what chargebacks are that can be hidden by clicking on the [x].

Figure 15 – New Chargebacks Page


The first section is “Providers”. This represents list of all available and supported provider groups.

Figure 16 – Providers List

Admins needs to select all of the providers they want to create chargeback invoice for. By selecting a provider, the system fetches consumption data for every tenant that is enabled under that provider.

Note: PyraCloud currently supports five providers (AWS, Azure EA, Azure, CSP, Office 365 and Adobe). This section will only show those provider which the customer has subscriptions with, and are supported by PyraCloud. Customers must be migrated to the new consumption module as the data is pulled from this module. Customers using the Old Azure EA Module must first upgrade to the new consumption module. Your Account Team can help you with this request. At least one provider has to be selected to create a chargeback invoice

Once providers have been selected, click on “Done” to navigate to the next section “Date Range”.

Date Range

The “Date Range” section allows Admin to narrow down the date range of consumption data. The date range is specified in two modes:

  • Usage Dates – described with start/end dates
  • Billing Period – list of periods connected to bill cycles
Figure 17 – Date Range

Once the date range has been selected, click on “Done” to navigate to the next section “Create”.

Note: Start and End usage dates are inclusive i.e. consumption would be fetched for these dates as well. Billing Periods are available only for Azure EA and Azure CSP.


Newly selected consumption spend (by selecting providers and date range) may be optionally divided in two ways:

  • Using Custom Group structure
  • Using Tenants & Subscriptions hierarchy

Split by Custom Groups

The Custom Groups section shows group structure as defined in PyraCloud Custom Groups. This allows Admins to select departments/groups they would like chargebacks for.

Figure 18 – Custom Groups Split

Selecting each group allows Admins to split chargeback invoices for selected groups. If none of the groups are selected, one global chargeback invoice is created for complete consumption of selected providers.

Costs displayed against each group is the estimated consumption by that group. Consumption for all ungrouped resources is reflected as “Untracked” in this section.

Click on “Done” to navigate to the next section “Review Chargeback”

Note: Invoice will be created for first selected group. Lines will correspond to closest selected groups under document group. Consumption will show only for selected groups in the invoice.

Figure 19 – Document Generation

Split by Tenants & Subscriptions

Tenants & Subscriptions are the foundation of the Consumption module. Chargebacks use the existing structure to create documents. No further configuration is required. Convention based approach is applied: every Tenant is documented with lines derived from its Subscriptions.

Note: Document/line options can be set on Settings page. Scheduled generation is supported. Please consult Original Document subsection in Reporting section.

Figure 20 – Tenants & Subscriptions Hierarchy

Review Chargeback

Review Chargeback is the last section that summarizes the selections Admin user has made and provides the following capabilities to Admins:

  • Admins can preview the document that will be generated
  • Admins can edit the Bill To details
  • Admins can change the name of the document i.e. chargeback invoice – This allows users to name the invoice appropriately within the organization
Figure 21 – Review Chargeback

Selecting “Preview” will open a preview of the invoice so that Admins can see how it will be displayed on chargeback tab.

Note: There will be no costs displayed on the preview tab because the document is not yet generated, however costs will be available once the document has been generated.

Selecting “Edit Bill To” will allow Admin to edit the Bill-To details if required. Admins can change the address and contact details for the chargeback.

Figure 22 – Edit Bill-To Details

Create Chargebacks

Once all the selections are made and the preview looks good, Admins can go ahead and create the chargeback documents by clicking on “Finish & Create [n] Chargebacks” (where [n] is the number of Chargebacks as shown below

Figure 23 – Finish and Create Chargebacks

Admins will be taken to the “Chargeback” page where they can see the invoices being generated. This is shown in the right hand “Status” column as “Generating”.

Figure 24 – Invoices Currently Generating

Once the invoices are ready, the status will be changed to “Generated”.

Figure 25 – Generated Invoices

Once the invoices are generated, all the actions explained in the Chargeaback section of this document can be performed.


Invoice documents are issued many times throughout the year. Manually adjusting documents every time is unreasonable. Common information like bill-to details, margin or contact information are typically recurring for given document series. They can be bound to single group or subscription. Settings page persist and allows editing most of information stored in document header.

Settings can be attached to either Custom Group, Tenant or Subscription. All levels stores the same set of settings. Stored settings are used twofold: as default values for manual generation (Setup) and base data during scheduled generation (Reporting).

Settings tab is divided into left pane and right pane.

The Left pane represents the tree structure of either Custom Groups or Tenants & Subscriptions. Clicking on a tree element selects particular entity and form is filled with appropriate data (by default form is empty).

The Right pane holds a set of information used during document generation. Data filled in the form are auto-saved.

Figure 26 – Custom Group Settings


Chargebacks supports rich reporting capabilities. Reports allow ad-hoc and scheduled export of data. Granularity of report extends from basic overview to resource level details. It is also possible to generate new documents with selected cadence.

Where to Find Reports

If you are in Chargebacks, you have the option to “View Schedule Reports” Or “Add New Schedule” by clicking on the buttons on the top right.

Figure 27 – Navigating to Reports from Chargebacks

You can also navigate to the main reports page by clicking on “Analyze” in the main navigation menu and then selecting “Reports” as shown below:

Figure 28 – Navigating to Reports from Main Menu

This will take you to the “Quick Reports” page. From here you can click on the dropdown under “Chargeback Manager” and select the report you want.

Figure 29 – Quick Reports Page and Chargeback Manager Dropdown

Chargeback Report Types

Chargeback module supports four report types:

  • All Chargebacks Detailed
  • All Chargeback Overview
  • Chargeback Detail
  • Original Document
  • Provider Based Overview

The top four reports gather data about existing Chargeback documents. The last one, Original Document, creates new documents and sends them to configured email address.

All Chargeback Detailed

This is an enriched version of the overview report with detailed line information. Each row of the report stands for a single line in the document. Line cost, currency, list of providers and resource count is available.

All Chargeback Overview

This report summarize basic information about all documents generated within target date range. Each row represents a single document. Apart from the header information like document name, bill-to details; total amount and currency are present.

Chargeback Detail

This is detailed report for a chargeback line information. Each row of the report stands for a single line in the document. Line cost, currency, list of providers and resource count is available.

Provider Based

Report focuses on provider’s shares analysis. Line information are split across all contributing providers. Further aggregation of data may answer questions regarding each provider cost across all selected documents, trends in provider’s shares, etc.

Original Document

Report enables scheduled generation of documents – in contrast to analysis of existing documents that previous types focus on. Outcome of running report is set of new documents, which can further be adjusted in Chargeback module (Additional Cost, etc.). Rich configuration options of the report in cooperation with Settings allow achieving functionality similar to manual generation..

Figure 30 – Original Document Configuration

Scheduled Generation

Scheduled reports enable periodic reporting with automatic delivery capabilities. Scheduled report definition represents “future report form” which will be filled with appropriate data. Both data set and time or running the report can be customized to meet business requirements.

Reports are gathered under the “Scheduled” Tab.

Figure 31 –  Scheduled Reports

New Scheduled Report

To create a new Scheduled Report click on “Add New Schedule” in the top right hand corner of the Chargebacks page.

Figure 32 – New Scheduled Report Button

This will open the Schedule Report page where you can follow the steps and fill in the required information for your report.

Figure 33 – New Scheduled Report Page
Updated on October 12, 2021

Was this article helpful?

Related Articles