Learn how to read and interpret your Marketplace invoices and statements.
For many cloud-based services, such as Microsoft Azure and Adobe VIP Marketplace, usage-based billing can result in multiple charge lines. When these charges are listed individually on a single invoice, the information can be difficult to read and interpret.
To simplify your billing experience, the Marketplace Platform provides the following documents:
Invoice – An invoice PDF contains subscription charges and usage recorded during the previous calendar month. Invoices are issued monthly based on a specific Marketplace agreement.
Statement – A statement Excel file contains a detailed breakdown of charges on an invoice, including individual charge lines and usage details. Statements are also issued monthly.
To learn more about these documents, continue reading or watch the video guide:
Invoice PDFs contain general invoice information, subscription details, and charges for the items within the subscription. You can access and download your invoices using the page.
We provide two types of invoices:
Compact invoice – A compact invoice is a summarized invoice issued for statements containing a large number of charges (typically 42 or more). In a compact invoice, all charges for a product or service are grouped into summarized invoice lines, and quantities are shown as 1 to represent the aggregate charge for each item.
Detailed invoice – A detailed invoice is issued for statements containing a limited number of charges (typically 41 or fewer). This type of invoice lists each charge on a separate line, allowing you to see exactly what you are being billed for, line by line. This means you don't need to refer to another statement for transaction details.
The invoice type is indicated in the Description column of your invoice PDF. For more details, see .
The invoice header contains general information, such as the creation date, your customer number, and contact details. It also includes your invoice number and addresses.
The following are key fields:
The line item details section contains all subscriptions and items for which you are billed. It contains multiple columns and may span multiple pages.
The following are key columns:
This section contains a breakdown of taxes. It shows how VAT is calculated and applied to the total amount.
This section outlines the payment terms according to your contract and the payment due date. It may also contain bank account information for electronic payments.
A statement is a detailed record of charges for each invoice.
Unlike invoice PDFs that summarize charges, statements provide a comprehensive breakdown of all charges. Statements are issued as Excel (.xlsx) files and typically contain the following tabs:
Summary – Contains objects associated with the statement (for example, agreement, licensee, and orders) with links to view them in the platform.
Charges – Contains charges and subscriptions for the billing period. You can also see items within subscriptions, their quantities, and prices. If is enabled, allocation percentage and estimated license count (ELC) details are also displayed.
Orders – Contains all orders placed during the billing period, including order type, order date, and related details.
You can download your statements from the Statements page or use the page if you cannot access your account. For details, see .
PO No. (purchase order number)
This is the Client Additional ID that you specify for the agreement. The value comes from the Details tab on the agreement details page.
If the value you specify exceeds 20 characters, only the first 16 characters are shown on the invoice, followed by 3 dots (...).
If the value is blank, a dash (—) is displayed on the invoice.
To add or update the value, see .
External document number
This is the ID of the agreement for which the invoice was issued.
The ID is assigned by the platform and can't be changed.
Your reference
Pos
Displays the line number for the item being billed.
The value starts from 10 and continues by +10 for each billing item. It means if 5 items are being billed, the POS begins from 10 and ends at 50.
No.
Displays the item number from SoftwareOne's ERP system.
Description
This is the ID of the statement linked to the invoice.
Statement IDs are assigned by the platform and can't be changed.
This is the main column listing subscriptions and items. It includes:
The invoice type and a secure URL to download the statement using the invoice and statement IDs. For more details, see Download statements.
Agreement information, including agreement ID and name, product details, and licensee details.
Subscription information (subscription ID and name). You can also view the additional client ID mapped to the subscription and the vendor ID. If no value exists, a dash is displayed.
Allocation percentage, if is enabled.
Total number of items within the subscription, but only if the subscription is active at the time of billing (for example, 'Qty 20 of ITM-XXXX-XXXX-XXXX / 65325070CA'). If the subscription is inactive, the item is shown as 'ITM-XXXX-XXXX-XXXX / 65325070CA' instead.
Start date - end date
Displays the duration of the charge.
Qty
Displays the item quantity. On compact invoices, this value is shown as 1 because charges are consolidated. For the actual item quantities, see your billing statement.
Unit price
Displays the unit price used to calculate the line amount.
VAT %
The VAT percentage applicable to the item.
Total excl. VAT
The subtotal without taxes.
Total incl. VAT
The total amount due including VAT.
Purpose
Provides a high-level summary of the charges.
Provides a full record of the charges from the vendor.
Format
Excel
Level of detail
Contains aggregated lines, such as per item, per subscription, and so on.
Can have hundreds or thousands of lines for precise usage.
Use case
Used as an official billing and record-keeping document.
Used for reconciliation, in-depth audits, and analysis.
Quantity
May displays the quantity as 1 if multiple lines are consolidated.
Each line shows the actual quantity of items.
Understand the key invoice fields and how they map to the platform.
Your Marketplace invoice includes various details that are pulled from the platform and displayed on the invoice.
This topic provides information on all such fields, helping you understand where the information comes from and how it corresponds to your invoice PDF. If you want to learn about the structure of your Marketplace invoices and statements, see the Billing invoices and Billing statements sections, respectively.
PO No.
Mapped from the Additional Client ID in your agreement details.
External Document No.
Mapped from the agreement ID.
Your Reference
Mapped from the statement ID.
Agreement
Mapped from the agreement details page.
Product
Mapped from the agreement details page.
Licensee
Mapped from the agreement details page.
Subscription
Mapped from the subscription details page.
Client ID/Vendor ID
Mapped from the Details tab on the subscription details page.
