> ## Documentation Index
> Fetch the complete documentation index at: https://alguna.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# The Revenue Object

> The versioned commercial agreement every Alguna product reads from: amendments, usage, entitlements, invoices, payments, and history on one record.

The revenue object is the versioned commercial relationship between you and a customer: the agreement, its amendments, the usage metered against it, the entitlements it grants, the invoices it produces, the payments against them, and the history of all of it. It is the record [every stage of the chain](https://alguna.com/docs/concepts/how-alguna-works.md) reads from. Read this page when you want to understand why an amendment in Alguna changes billing, entitlements, and revenue recognition at once without touching an invoice that was issued under earlier terms.

A company's revenue systems all depend on the same commercial agreement, but each usually holds its own version. Sales has the quote, finance has the invoice, engineering has the usage and the entitlements. Every change then becomes an exception someone carries across systems: a renegotiated commitment that billing hasn't heard about, a credit that collections keeps pursuing, an expansion the customer can't use until someone works out how to quote and bill it. Alguna removes the translation. The activated quote becomes the billing schedule, the subscription is the contract the rep quoted, and the invoice, revenue schedule, and customer portal read from the same record.

***

## Why it is versioned

Commercial relationships change mid-term, and the changes don't all apply to the same activity. An amendment changes the terms for the activity it covers; an invoice already issued keeps the terms it was issued under. Treating every action as if it happened under the latest agreement would re-bill the past; treating the agreement as fixed would block the change.

Each [subscription](https://alguna.com/docs/subscriptions/overview-subscriptions.md) in Alguna therefore carries [versions](https://alguna.com/docs/subscriptions/versioning.md) with effective dates. Usage is rated against the version in force when it occurred. Entitlements update on the effective date of the version that grants them. Revenue schedules derive from the agreement and its amendments. A receivable stays attached to the terms and approved adjustments that apply to it, even while a later amendment waits for approval.

## One change, six teams

A customer on a \$120k annual usage commitment adds a product and raises the commitment midway through the term. Usage keeps accruing, and an earlier invoice is still unpaid. One commercial decision creates six connected pieces of work:

| Team or workflow | What needs to happen | What Alguna does |
| - | - | - |
| Sales | Agree the expansion and approve any exceptions | Prepares the [amendment](https://alguna.com/docs/subscriptions/amendments.md) and shows its consequences before it is committed |
| Product access | Give the customer the additional product | Updates [entitlements](https://alguna.com/docs/entitlements/overview.md) on the approved effective date |
| Usage and billing | Apply the correct rates and commitment to consumption | Rates [usage](https://alguna.com/docs/billable-metrics/send-usage.md) against the applicable version and calculates the charges |
| Finance | Account for the amendment's effect on revenue | Derives the [recognition schedule](https://alguna.com/docs/revenue/recognition.md) from the agreement and its amendments |
| Collections | Collect the earlier unpaid invoice | Keeps the receivable connected to its own terms and approved adjustments in [Collections](https://alguna.com/docs/collections/overview.md) |
| Renewals | Prepare the next commercial proposal | Drafts the renewal from the account's current terms and usage history |

These activities overlap in time. The revenue object connects them without forcing every action onto the same version of the agreement: effective dates, calculation logic, and approvals decide which terms apply to each.

## What reads from it

| Product | What it reads |
| - | - |
| [Quotes](https://alguna.com/docs/quotes/create-quotes.md) | The catalog, price books, and the account's current terms; an activated quote becomes the subscription |
| [Subscriptions](https://alguna.com/docs/subscriptions/overview-subscriptions.md) | The versioned agreement itself, including amendments and contract terms |
| [Usage metering](https://alguna.com/docs/billable-metrics/define-metrics.md) | Commitments, credits, and overage rates of the version in force |
| [Entitlements](https://alguna.com/docs/entitlements/overview.md) | Product access granted by the version in force |
| [Invoices](https://alguna.com/docs/invoices/invoicing-config.md) | Rated usage, recurring charges, credits, and tax under the applicable terms |
| [Collections](https://alguna.com/docs/collections/overview.md) | The receivable, its terms, approved adjustments, and conversation history |
| [Revenue recognition](https://alguna.com/docs/revenue/recognition.md) | The agreement and its amendments, producing the schedule |
| [Revenue Assurance](https://alguna.com/docs/revenue/assurance.md) | Usage against coverage, to find what was used but not sold or billed |
| Agents and the [MCP server](https://alguna.com/docs/ai/mcp.md) | The same record, under the authority and permissions you set |

## Agents on the record

Alguna's agents operate on the revenue object rather than on a copy. They start in draft mode when deployed; you expand their authority as you gain confidence, and quotes, credit notes, CRM updates, and signature envelopes remain subject to approval. Proposed changes show their consequences and are checked against your limits, and every action carries an audit history. The same holds for an external assistant connected through the MCP server: an employee's assistant requesting a quote, or a customer's accounts-payable agent investigating an invoice, acts under the same terms and permissions.

## Where it lives

The revenue object is not a single API resource. It is the set of linked records the public API exposes as accounts, subscriptions and their versions, usage events, entitlements, invoices, and payments, held together by Alguna. See the [API reference](https://alguna.com/docs/api-reference/v2/overview.md) for each resource and [How Alguna Works](https://alguna.com/docs/concepts/how-alguna-works.md) for how they chain.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.