Learn how to read the line items in your Partner Center reconciliation files

Appropriate roles: Billing admin | Global admin

Download reconciliation files from Partner Center to view charges for each billing period. Check charges for each customer's subscriptions and events affecting them, like adding licenses mid-term. For invoice details, see Read your bill.

Understand reconciliation file fields

Here are the reconciliation files and what they show:

Reconciliation file field Includes
Legacy license-based Costs and quantities of legacy Office and Dynamics products for a billing period
Legacy usage-based Costs and usage of legacy Azure products for a billing period
New commerce daily rated usage Daily usage and charges for new commerce (Azure plan) usage-based products for a billing period
New commerce invoice reconciliation Aggregated costs, quantities, and usage for all new commerce products for a billing period

Understand charge types in reconciliation data

Learn about the different types of charges in reconciliation data in the ChargeType attribute.

Fix formatting issues

Reconciliation line items might have formatting issues if the en-us locale isn't used.

To address the formatting issues, follow these steps:

  1. Open the reconciliation file (in .csv format) in Microsoft Excel.
  2. Select the first column in the file.
  3. Open the "Convert Text to Columns Wizard".
  4. Select Data on the ribbon, then select Text to Columns.
  5. Choose Delimited file type, then select Next.
  6. Check Comma as the delimiter (if Tab is already selected, you can leave this option selected) then select Next.
  7. Choose Date:MDY for the column data format, then select Next.
  8. Select Text for all amount columns, then select Finish.

Download reconciliation files programmatically

Reconciliation files can be large and are sometimes difficult to download from the portal. To download large reconciliation files programmatically, use Get invoice line items.

Where do I download the file asynchronously?

To enhance the download experience and improve efficiency, Partner Center downloads new commerce reconciliation files asynchronously. To download a file:

  1. Sign in to Partner Center and select Billing workspace.

  2. Go to the Billing history page and select Recurring and one-time purchases (billing currency) tab.

  3. Or, go to the Billing overview (NCE) page instead.

  4. Choose the reconciliation file you want to download. A message at the top of the page indicates that the file is being prepared and should be ready on the Reports (NCE) page soon. Processing time varies with the data volume.

  5. Monitor your download's progress in the status column.

  6. Save time and prevent duplication. Check already downloaded reports before submitting a new request.

What each status means:

  • Queued: Request is submitted
  • Processing: System is collecting data for the report
  • Completed: Report is available for download
  • Failed: An error occurred while generating the report
  • No data found: System couldn't find any data for the report

If your file exceeds the row limit in Excel

If you can't open your .csv file in Microsoft Excel, the file likely contains more rows than Excel allows. To resolve this issue, you can:

Open a reconciliation file in Excel Power Query

  1. Download the reconciliation file from Partner Center.

  2. Open a new blank workbook in Microsoft Excel.

  3. Navigate to Data tab, then select Get Data > From File > From Text/CSV, and import the .csv (Comma-Separated Values) reconciliation file.

  4. After a while, you can see a window with the file preview.

  5. In that window, select the Load dropdown menu > Load To.

    Screenshot of the File preview window, with the dropdown next to Load open, and the selection Load To inside the drop-down selected.

  6. In the Import Data dialog box, select the options as indicated in the following screenshot.

    Screenshot of the Import Data window, with two items highlighted: Only Create Connections and Add this data to the Data Model.

  7. Select OK to start the loading process. Wait until it's complete.

  8. See the file name and number of rows on the right side. Double-click this area to open the Power Query Editor.

    Screenshot of the Queries & Connections window, with a sample of a report called Test Recon Data highlighted.

  9. As you scroll down, you see that new rows are added dynamically.

    Tip

    Fix data loading problems caused by line breaks:

    • Go to the "Advanced Editor" under "Home" tab.
    • Find the Csv.Document function.
    • Update the "QuoteStyle" value to "QuoteStyle.csv."
  10. To search for specific line item, use the filter option as shown in the screenshot. Additionally, aggregate line items or perform calculations with the "Group By" or "Statistics" features.

    Screenshot of Excel Power Query Editor, with two highlighted items, Group By and Statistics.

  11. For instance, to find the number of billable days in the charge cycle, use the Custom Column feature to calculate the duration between the charge start and end dates. Power Query also provides a range of features for different computations.

    Screenshot of Excel Power Query Editor. In the menu bar, Add Column is highlighted.

  12. After applying the required filters in the Power Query, transfer the data to Excel by following these steps.

    Screenshot of Excel Power Query Editor. In the spreadsheet, the CreditReasonCode drop-down is open. The menu item: Copy Entire Table is highlighted.

Open a reconciliation file in Power BI

To open a reconciliation file in Power BI:

  1. Download the reconciliation file as you normally would.
  2. Download, install, and open an instance of Microsoft Power BI.
  3. Select Get data on the Power BI Home tab.
  4. Choose Text/CSV from the list of Common data sources.
  5. Open your reconciliation file when prompted.

Negative amount displayed

Some reconciliation line items show negative charges for the following reasons:

  • You changed your subscription by canceling, upgrading, or altering licenses.
  • You received credit for a service level agreement (SLA) violation, moving to Azure platform, or price adjustments.

Understand these negative amounts using the ChargeType attribute in the reconciliation line items.

How is the total cost calculated for new commerce license-based purchases?

To calculate costs, always use the EffectiveUnitPrice, not the UnitPrice. The EffectiveUnitPrice depends on these factors:

  • Discounts like promotions or tiered pricing, and adjustments like partner earned credit.
  • The number of days you pay for, which is counted from when a billing event occurs until the end of the charge cycle.

The subscription's UnitPrice remains the same during the billing term. A change in the price might appear in the reconciliation data, but it doesn't affect the cost.

Use EffectiveUnitPrice to confirm the cost and invoice your customers.

Why does my invoice reconciliation data show a recurring charge for a product for which there are no daily charges?

For some products, like Azure savings plans or reservations, you pay a fixed price monthly, annually, or one time for limited units. We don't charge you for daily usage of these products until you go over the limit. You only see the recurring charges on your invoice reconciliation line items.

Here's what you need to know:

  • The fixed price you agreed to pay for the product is still due every month, even if you don't use it. This fixed price is the recurring charge on your invoice reconciliation line item.
  • You pay no extra charges until you exceed the limit.
  • You pay extra at a pay-as-you-go rate for any usage over the limit you agreed to.

You see recurring charges for Azure savings plans or reservations on your invoice data even if you don't use them. You need to pay extra charges at pay-as-you-go rate for any usage beyond the agreed limit.

To check the costs, see how an Azure reservation or savings plan linked to an Azure subscription.

How do you find the Azure subscription ID for a product?

To find out your Azure subscription ID for each Azure resource, follow these steps:

Tip

To distinguish products bought with different or same Azure subscriptions, use resource groups or tags. By doing so, you can tell which subscription is used for each product, even if they share a name.

Pay-as-you-go product

  • To identify your Azure subscription, link the SubscriptionId on your invoice reconciliation line item with the SubscriptionId on your daily rated usage line item. The EntitlementId of the same line of your daily rated usage is your Azure subscription ID.

Azure reservation

  • Link theReservationOrderId of your invoice reconciliation and the AdditionalInfo of the daily rated usage line item. The EntitlementId of the same line of your daily rated usage is your Azure subscription ID.

Azure savings plan

  • Link the ReservationOrderId of your invoice reconciliation line item to the BenefitOrderId of the daily rated usage line item. The EntitlementId of the same line of your daily rated usage is your Azure subscription ID.

How do you find Azure credits in the invoice reconciliation and daily rated usage files?

Azure credits only cover Microsoft Azure products, with some exceptions. To find out how much credit a customer has, check the invoice reconciliation and daily rated usage data.

Invoice reconciliation

  • Subtotal and Total show a negative amount for credit line items.
  • Use customerCredit as the ChargeType for credit line items. The CreditReasonCode indicates the credit type, such as "Azure Credit".
  • To reconcile credits, group transactions by these fields: ProductId, SKUId, AvailabilityId, OrderDate, and either CustomerName or CustomerId. Add up the Total to get the credit amount.
  • Charge and credit line items should have the same BillableQuantity.

Daily rated usage

  • To filter the line items, use the customer tenant ID, the CreditType, and 100 as the CrditPercentage value.
  • To find the credit amount, sum up the BillingPreTaxTotal.

Note

You can't see some Azure credits in the daily rated usage data. Check the invoice reconciliation data for the credit information.

How do you reconcile telco pay-as-you-go charges?

Follow these steps to track your telco product charges on a daily and monthly basis:

  • Daily rated usage reconciliation: Check your daily charges under BillingPreTaxTotal and your call minutes in "NumMin" under AdditionalInfo.

Note

Quantity in the daily rated usage data doesn't show exact call minutes.

CustomerName ProductId SkuId ProductName UsageDate ChargeType UnitPrice Quantity UnitType BillingPreTaxTotal BillingCurrency AdditionalInfo EffectiveUnitPrice
Constoso CFQ7TTC0JL2N 1 Microsoft 365 International Calling Plan - Outbound US 9/17/2021 New 1 0.1524 Per Call 0.15 USD { "NumMin": 0.2} 0.984251969
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/18/2021 New 1 6.6275 Per Call 6.623381835 USD { "NumMin": 24.1} 0.999378625
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/21/2021 New 1 2.97 Per Call 2.968154515 USD { "NumMin": 10.8} 0.999378625
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/22/2021 New 1 0.0585 Per Call 0.05846365 USD { "NumMin": 0.3} 0.999378625
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/23/2021 New 1 0.4485 Per Call 0.447924684 USD { "NumMin": 2.3} 0.998717244
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/24/2021 New 1 0.0975 Per Call 0.097374931 USD { "NumMin": 0.5} 0.998717244
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/29/2021 New 1 0.156 Per Call 0.15579989 USD { "NumMin": 0.8} 0.998717244
Constoso CFQ7TTC0JL2S 1 Microsoft 365 International Calling Plan - Outbound US 9/29/2021 New 1 0.2114 Per Call 0.211128825 USD { "NumMin": 1.4} 0.998717244
Constoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US 9/30/2021 New 1 0.178 Per Call 0.177771669 USD { "NumMin": 8.9} 0.998717244
Total 10.89 49.3
  • Invoice reconciliation: Check your total call minutes and costs per call, look at BillableQuantity and Subtotal.
CustomerName ProductId SkuId ProductName ChargeType UnitPrice Quantity Subtotal TaxTotal Total Currency ChargeStartDate ChargeEndDate EffectiveUnitPrice BillableQuantity
Contoso CFQ7TTC0JL2N 1 Microsoft 365 International Calling Plan - Outbound US new 0.381 1 0.36 0 0.36 USD 9/1/2021 9/30/2021 0.225 1.6
Contoso CFQ7TTC0JL2S 1 Microsoft 365 Audio Conferencing - Outbound US new 0.352836167 1 10.53 0 10.53 USD 9/1/2021 9/30/2021 0.220755 47.7
Total 10.89 49.3

If you exceed your free talk time, you pay for each extra minute. To reconcile the charges and call minutes between your daily usage and monthly invoice, use the ProductId and SkuId.

Check charges and minutes by call type: domestic, international, or toll-free. The bill shows total call minutes and total amount before tax. The subtotal equals the sum of BillingPreTaxTotal, and BillableQuantity equals the sum of "NumMin."

How to find tiered pricing in the reconciliation data

Tiered pricing depends on your usage tier. Find the tiered pricing in your reconciliation data by looking at these fields:

  • The UnitPrice in the line item shows the unit price for the first tier in the price list.

  • The EffectiveUnitPrice in the line item reflects your usage tier's unit price from the price list. Adjustments like partner earned credit may change the final price.

  • The PriceAdjustmentDescription indicates the discount percentage for your usage tier and other adjustments that affect the final price.

  • See the final cost in individual line items based on your usage tier.

What do different prefixes for Reservation Order ID mean?

The prefix indicates where you bought your Azure reservations.

  1. PCTest: From Partner Center for testing
  2. RIOderId: From Partner Center for production
  3. No prefix: From Microsoft Cost Management