Incentives & billingBilling
Accelerated file download for Unbilled usage and reconciliation files
Published
Reading time4 min read
SourceMicrosoft Learn
On this page9 sections
Effective May 15th 2026, all unbilled usage and reconciliation files will be delivered in .CSV.GZIP format to enable faster and more efficient downloads.
- Impacted audience
- All partners downloading Unbilled usage and reconciliation files through Partner Center
Why this change
- Performance improvement: For high volume partners (5M+ records), download times have dropped from over 6 hours to 6 minutes – a 98.33% improvement. For all partners, download times have improved from over 3 hours to 2 minutes – a 98.89% improvement.
- Aligned experience: Download attributes in the UX now match those available via the API, ensuring consistency across both interfaces.
- File splitting for large Invoices: Invoices containing over 1.5 million records will be divided into multiple .CSV.GZIP files.
- Enhanced visibility: A new Number of files column has been added to the table on the Reports (NCE) page to indicate the total count of files associated with each invoice.
- Data integrity: Invoice data isn't ordered; therefore, the sequence in which files are downloaded doesn't affect the accuracy or completeness of the data.
What's changing
The following attributes will be updated to support higher precision:
Unbilled reconciliation updates
| Attribute | Current | Update |
|---|---|---|
| UnitPrice | Decimal(38, 2) | Decimal(38, 26) |
| EffectiveUnitPrice | Decimal(38, 2) | Decimal(38, 26) |
| Quantity | Decimal(38, 2) | Decimal(38, 18) |
| Subtotal | Decimal(38, 2) | Decimal(38, 20) |
| TaxTotal | Decimal(38, 2) | Decimal(38, 20) |
| Total | Decimal(38, 2) | Decimal(38, 20) |
| PCToBCExchangeRate | Decimal(38, 2) | Decimal(38, 26) |
| BillableQuantity | Decimal(38, 2) | Decimal(38, 18) |
| ResellerMpnId | ResellerMpnId | Tier2MpnId |
| ProductCategory | Not present | String (New) |
Unbilled usage updates
| Attribute | Current | Update |
|---|---|---|
| UnitPrice | Decimal(38, 2) | Decimal(38, 32) |
| USDPreTaxTotal | Decimal(38, 2) | Decimal(38, 20) |
| BillingPreTaxTotal | Decimal(38, 2) | Decimal(38, 20) |
| PricingPreTaxTotal | Decimal(38, 2) | Decimal(38, 20) |
| PCToUSDExchangeRate | Decimal(38, 2) | Decimal(38, 32) |
| PCToBCExchangeRate | Decimal(38, 2) | Decimal(38, 32) |
| EffectiveUnitPrice | Decimal(38, 2) | Decimal(38, 32) |
| RateOfPALDiscount | Decimal(38, 2) | Decimal(38, 32) |
| RateOfCredit | Decimal(38, 2) | Decimal(38, 32) |
| Quantity | Decimal(38, 2) | Decimal(38, 18) |
| InvoiceNumber | Existing | Removed |
User experience
What’s not changing
- No changes to Unbilled usage and recon APIs.
- Billing logic and charge calculations remain unchanged.
- Invoice totals and financial outcomes aren't impacted.
- Pricing rules, discount eligibility, credits, billing cadence, and invoice generation are unchanged.
- Access methods, and download workflows remain the same.
Partner action required
Partners should:
- Update downstream systems to support higher‑precision decimal values.
- Update references from ResellerMpnId to Tier2MpnId in Unbilled Recon files.
- Consume the new ProductCategory attribute if applicable.
- Validate parsing logic to prevent truncation or rounding.
File consolidation and troubleshooting
- File consolidation: For guidance on merging multiple .CSV files, refer to Recommended method for consolidating multiple CSV reconciliation files.
- Troubleshoot excel issues: If you see data encoding issues when you open the file in excel, go to Fixing CSV encoding issues in excel.
- Troubleshooting downloads: If you encounter issues while downloading files, see Address download issues.
Next steps
Get answers to your questions at:
- Where do I download the file asynchronously?
- Invoice reconciliation file attributes
- Daily rated usage file attributes