# Understand your billing documents 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: {% embed url="" %} Watch this video guide explaining invoices and statements in recurring billing. {% endembed %} ### Billing invoices 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 [Invoices](/modules-and-features/billing/invoices.md) page. #### Invoice types 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 [Invoice line item details](#invoice-line-item-details). #### Invoice header 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:

Field Description

PO No. (purchase order number)

Field	Description
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 Add or update additional client ID.
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	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 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 Add or update additional client ID.

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

This is the ID of the statement linked to the invoice.

Statement IDs are assigned by the platform and can't be changed.

#### Invoice line item details 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:

Column	Description
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 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 split billing 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.

#### VAT amount specification This section contains a breakdown of taxes. It shows how VAT is calculated and applied to the total amount. #### Payment instructions 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. ### Billing statements 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 [split billing](/modules-and-features/billing/split-billing.md) 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 [Billing Statement Download](https://mystatements.platform.softwareone.com/) page if you cannot access your account. For more details, see [Download statements](/modules-and-features/billing/statements/download-statements.md). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.platform.softwareone.com/modules-and-features/billing/understand-your-billing-documents.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.