How Revenue Recognition Works
When you bill a customer upfront for a service period, you don’t earn all that revenue immediately. Instead, revenue is recognized (earned) as you deliver the service over time.Revenue Recognition Timing
Subscription Revenue
Revenue is recognized evenly over the service period:
Example: $1,200 Annual Subscription Starting January 1
Usage-Based Revenue
Usage revenue is recognized when usage occurs—no deferral needed.Viewing Revenue Schedules
In the Dashboard
- Navigate to Revenue Recognition
- Select the time period
- View:
- Recognized revenue by period
- Deferred revenue balance
- Revenue by product or customer
Revenue Schedule Example
For a $1,200 annual subscription billed January 1:Deferred Revenue
Deferred revenue (also called unearned revenue) is the amount you have billed but not yet earned. It arises when the invoice is issued, not when the cash arrives, and it is drawn down as you deliver the service.Deferred Revenue Report
Open Revenue Recognition to see your deferred revenue balance:Deferred Revenue by Period
Journal Entries
Alguna automatically generates the accounting entries for revenue recognition.When Invoice Is Issued
Monthly Recognition (Each Month)
When Payment Is Received
Multi-Currency Revenue
A subscription is billed in the customer’s currency. For reporting across entities, amounts are converted using the FX rates you maintain per legal entity.How FX Is Handled
Maintain rates under Settings → Billing → FX Rates. See Multi-Currency.
Example: EUR Invoice with USD Reporting
Revenue Reports
Monthly Revenue Report
Open Revenue Insights to view:Revenue by Customer
Handling Changes
Subscription Upgrades
When a customer upgrades mid-period:- Remaining deferred revenue from old plan is adjusted
- New revenue schedule created for the upgrade
- Proration creates incremental revenue items
Cancellations
When a subscription is canceled:- Remaining deferred revenue is reversed (if refunding)
- Or recognized immediately (if no refund)
- Final journal entries are generated
Amendments
Mid-term changes create amendment revenue schedules that align with the original schedule dates.Exporting Revenue Data
Export to Accounting System
- Navigate to Settings → Integrations
- Connect QuickBooks, Xero, or NetSuite
- Revenue entries sync automatically
Manual Export
- Navigate to Revenue Recognition
- Select the period
- Click Export to download CSV
Configuration
Recognition Method
The recognition method is set per product, so a contract can mix methods across its line items.
Set it on the product, or through
revenue_allocation_method on the products API.
Product-Level Settings
Set the method per product:- Navigate to Products → [Product]
- Under Revenue Recognition:
- Set recognition method
- Set timing (service start, invoice date)
- Save
Best Practices
Monthly Close
Run revenue recognition before monthly close.
Audit Trail
All changes are tracked with full audit history.
Reconciliation
Reconcile deferred revenue to your general ledger monthly.
Multi-Currency
Lock FX rates at invoice date for consistency.
Next Steps
Accounting Integration
Sync with your accounting system.
Reports
View revenue dashboards.