Complete guide to charge types
Introduction
The Platform uses a streamlined set of charge types to represent various billing events across different vendors. This article provides a comprehensive reference for understanding all charge types used on the platform, how vendor-specific charge types are mapped to platform charge types, and when each charge type appears on invoices. Whether you're reviewing invoices, reconciling billing data, or managing subscriptions, understanding charge types is essential for accurate financial tracking and reporting.
In this article:
Overview
The Platform uses a streamlined set of charge types to represent various billing events. This article explains:
- The primary charge types used in the platform
- How vendor-specific charge types map to platform charge types
- When and how each charge type appears on invoices
Primary Charge Types
The Platform supports six main charge types:
- Purchase Fee - Initial cycle fee after subscription purchase
- Cycle Fee - Recurring fee during each new billing cycle
- Correction - Adjustments including pro-rated charges, cancellations, discounts, and refunds
- Usage Fee - Consumption-based charges
- One-Time Fee - Fee for one-time purchases
- Item Fee - Charge type for license-based subscriptions that are not prepaid
Purchase Fee
Definition: The initial charge generated when a subscription is first purchased, representing a prorated cost for the first billing period.
When it appears:
- Generated in the next invoice after the subscription start date
- Only appears once per subscription (at initial purchase)
Example: If a subscription starts on January 15 with monthly billing, the Purchase Fee represents the prorated charges for January 15-February 14.
Cycle Fee
Definition: Periodic charges for a subscription during regular billing cycles.
When it appears:
- Generated at the beginning of each billing cycle if the subscription is active
- For monthly subscriptions: appears monthly
- For annual subscriptions: appears yearly
Example: A subscription with 10 licenses and a monthly cycle will generate a Cycle Fee on each billing date for the next month's service.
Correction
Definition: Adjustments to previous charges based on subscription changes.
When it appears:
- When license quantity changes during a billing period
- When a subscription is suspended or reactivated
- When discounts are applied or removed
- When refunds are processed
Key characteristics:
- The quantity for a correction is always 1
- Unit Price = Total Price for corrections
Example: If 5 licenses are added mid-cycle, a positive correction appears on the next invoice for the prorated cost of those 5 licenses for the partial period they were active.
Usage Fee
Definition: Charges based on actual consumption of resources or services.
When it appears:
- At the end of a billing cycle for consumption-based subscriptions
- Reflects actual usage during the previous period
Key characteristics:
- The quantity is always 1
- Unit Price = Total Price for usage fees
- Aggregates all consumption data for the billing period
Example: Azure services used throughout January will appear as a Usage Fee on the February invoice.
One-Time Fee
Definition: A single charge for a non-recurring purchase.
When it appears:
- On the next billing date after a one-time purchase
Example: Software with a perpetual license purchased on March 15 will appear with a One-Time Fee on the April invoice.
Item Fee
Definition: Charge type used for license-based subscriptions that are not prepaid (similar to Cycle Fee but for prepaid license-based subscriptions).
When it appears:
- For specific license models with prepaid characteristics
Charge Type Mapping
Microsoft Charge Types
The Platform aggregates approximately 25 different Microsoft charge types into the 6 main platform charge types. The following table shows this mapping:
| Platform | Microsoft | MS Explanation | Subscription Type |
|---|---|---|---|
| Correction | Offset a line item | Partial or whole refund to a line item, including taxes | Credits |
| Correction | One Time Refund | Undocumented by Microsoft, but available in reconciliation file | N/A |
| Correction | Activation Fee | Amount charged when customer uses subscription after purchase | License-based charges |
| Correction | Cancel fee | Prorated charges refunded when licenses are changed | License-based charges |
| Correction | Cancel instance prorate | Prorated charges canceled for suspended subscriptions | License-based charges |
| CycleFee | Cycle fee | Periodic charges for a subscription | License-based charges |
| Correction | Cycle instance prorate | Prorated charges when licenses are changed | License-based charges |
| Correction | Prorate fees when cancel | Prorated refund for unused portion upon cancellation | License-based charges |
| Correction | Prorate fees when convert away from current offering | Prorated charges after converting from monthly to annual | License-based charges |
| Correction | Prorate fees when convert to a new offering | Prorated charges after converting to new subscription | License-based charges |
| PurchaseFee | Prorate fees when purchase | Initial charge for new subscription | License-based charges |
| CycleFee | Prorate fee when renew | Prorated fees upon subscription renewal | License-based charges |
| Correction | Renew fee | Charge for renewing a subscription | License-based charges |
| Correction | Prorate fees when activate | Prorated fees upon activation | License-based charges |
| OneTimeFee | New | Used for new one-time purchases | One-Time charges |
| Correction | addQuantity | Refund of original purchase and new quantity after increase | One-Time charges |
| Correction | removeQuantity | Refund of original purchase and new quantity after decrease | One-Time charges |
| Correction | Cancel | Used when subscription is canceled | One-Time charges |
| Correction | Convert | Used when license is upgraded without quantity change | One-Time charges |
| UsageFee | Assess usage fee when cancel | Usage fee upon cancellation for unpaid usage | Usage Charges |
| UsageFee | Assess usage fee for current cycle | Usage fee for the current billing period | Usage Charges |
| Correction | Activation discount | Discount applied when subscription activated | Usage-based discounts |
| Correction | Cycle discount | Discount applied on periodic charges | Usage-based discounts |
| Correction | Renew discount | Discount applied when subscription renewed | Usage-based discounts |
| Correction | Cancel discount | Charges applied when discounts are canceled | Usage-based discounts |
Adobe Charge Types
Adobe uses a different set of charge types. The Platform displays these charge types as received from Adobe:
| Adobe Charge Type | Adobe Order Reason | Platform Representation |
|---|---|---|
| INVOICE | ADD SEATS | Displayed as received from Adobe |
| INVOICE | RENEWAL | Displayed as received from Adobe |
| RETURN | N/A | Used for 'return' orders; Adobe doesn't provide a reason |
Charge Aggregation Process
The Platform performs charge aggregation to simplify the billing experience:
- Data Collection: Platform retrieves vendor charges with original charge types
- Mapping: Each vendor charge type is mapped to one of the platform's six charge types
- Aggregation: Similar charges may be combined based on configuration
- Presentation: Charges appear on invoices using the platform's standardized charge types
Benefits of Charge Aggregation
- Simplified Invoices: Reduces complexity for customers
- Consistent Experience: Provides uniform terminology across vendors
- Easier Reconciliation: Standardizes charge types for accounting purposes
Leran more here: Charge Aggregation in the Platform
Summary
The Platform uses six primary charge types—Purchase Fee, Cycle Fee, Correction, Usage Fee, One-Time Fee, and Item Fee—to standardize billing across multiple vendors. Each charge type serves a specific purpose, from initial subscription purchases to recurring billing cycles, prorated adjustments, and usage-based charges. The platform aggregates vendor-specific charge types from Microsoft, Adobe, and other vendors into these standardized types, simplifying invoices and providing a consistent billing experience. Understanding when each charge type appears and how vendor charges are mapped is essential for accurate financial tracking and reconciliation.
Add comment
Please sign in to leave a comment.