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

# The Revenue Recognition Ledger

> See how the Revenue Recognition Ledger separates fixed fee revenue recognition from invoicing, with manual, generated, and automated entries.

With Time & Materials projects, revenue is recognized on reports and dashboards as of the date of each billable time entry. But, with Fixed Fee projects, revenue is recognized based on the fixed fee revenue recognition method set for each project. The revenue recognition method options available for fixed fee projects include:

* As Invoiced
* Manual
* Automated - Percentage of Billable Hours
* Automated - Percentage of Time & Materials Revenue
* Automated - Percentage of Services Cost

A detailed discussion of each of these methods is included in the [Fixed Fee Revenue Recognition](/projects/fixed-fee-revenue-recognition) article. The "As Invoiced" method recognizes revenue as of the Issue Date of the published invoice that includes one or more billing milestones. The other three revenue recognition methods recognize revenue based on entries in the **Revenue Recognition Ledger** in the **Accounting** section of the project's [**Settings**](/projects/project-settings) tab. The revenue recognition ledger (Figure 1) tells Ruddr when to recognize revenue and how much revenue to recognize. Note that projects using the "As Invoiced" revenue recognition method do not show this ledger.

<Frame caption="Figure 1 - Revenue Recognition Ledger">
  <img src="https://mintcdn.com/ruddr-help/7cT5RdoTFUrdIMUD/images/the-revenue-recognition-ledger-1.png?fit=max&auto=format&n=7cT5RdoTFUrdIMUD&q=85&s=8d43ac48d3ad8c165ccc3ed4afb62a83" alt="" width="1255" height="475" data-path="images/the-revenue-recognition-ledger-1.png" />
</Frame>

It is important to point out that fixed fee projects that use the revenue recognition ledger have their invoicing and revenue recognition completely separated. Invoicing is driven by the **Fixed Fee Billing Schedule** while revenue recognition is driven by the **Revenue Recognition Ledger**. This is an important concept because you may need to recognize revenue on a very different schedule than you invoice.

As an example, assume that your company sells a \$100,000 project and the contract states that 50% of the fee will be invoiced up front and 50% will be invoiced one month after the project is completed. In that scenario, you invoice the client \$50,000 today, even though you may not start the project until next month. Then, you invoice the final 50% one month after the project has been fully delivered. If you recognize the revenue as it is invoiced, your performance reports in Ruddr will show \$50,000 in two months in which your team did none of the project work. This inflates gross profit and gross margin in those two months and depresses them in the remaining months.

Note that the ledger will display the total of the ledger entries and also the **Budget Recognizable Revenue**, which is services revenue budget plus the non-billable expenses budget. It does not include billable expenses or other items to bill.

When the total of the revenue recognition ledger exceeds either the total of the fixed fee billing schedule or the budget recognizable revenue, Ruddr will display a notification warning (Figure 2) of such.

<Frame caption="Figure 2 - Ruddr Notification when Total of Revenue Recognition Ledger Exceeds Total of Fixed Fee Billing Schedule">
  <img src="https://mintcdn.com/ruddr-help/7cT5RdoTFUrdIMUD/images/the-revenue-recognition-ledger-2.png?fit=max&auto=format&n=7cT5RdoTFUrdIMUD&q=85&s=bb5e87b1be6771ae8e0604b474aa77c0" alt="" width="1255" height="475" data-path="images/the-revenue-recognition-ledger-2.png" />
</Frame>

Entries on the revenue recognition ledger can be added [manually](#manually-adding-revenue-recognition-ledger-entries) or can be [generated](#01JC1QMYC16M5Q8T7R54QRKTA7) by Ruddr.

### Manually Adding Revenue Recognition Ledger Entries

Revenue recognition ledger entries can be created manually by clicking either the **+** button or the **Add Multiple** button at the top-right of the ledger. The **+** button will bring up a window that will allow you to create a single entry in the ledger (Figure 3). This is generally optimal when the revenue recognition will not follow a consistent pattern from month-to-month.

<Frame caption="Figure 3 - Add Revenue Recognition Entry">
  <img src="https://mintcdn.com/ruddr-help/vCJou40J1DwO4-mD/images/the-revenue-recognition-ledger-3.png?fit=max&auto=format&n=vCJou40J1DwO4-mD&q=85&s=a43b821f3c1a88d3805600394fffc6c5" alt="" width="853" height="860" data-path="images/the-revenue-recognition-ledger-3.png" />
</Frame>

Note that revenue recognition entries can be positive or negative. If you had previously recognized too much revenue on a project and did not want to adjust past revenue recognition entries, you could create a negative revenue recognition entry for the current month.

In cases where the project will recognize the same amount of revenue over a number of months, the **Add Multiple** button will allow you to easily create many monthly revenue recognition entries with a single action. For projects that span several years, this bulk action can save a tremendous amount of time.

<Frame caption="Figure 4 - Add Multiple Revenue Recognition Entries">
  <img src="https://mintcdn.com/ruddr-help/vCJou40J1DwO4-mD/images/the-revenue-recognition-ledger-4.png?fit=max&auto=format&n=vCJou40J1DwO4-mD&q=85&s=7c8e4e6d4bdafb322c010659fa3e5b1a" alt="" width="674" height="331" data-path="images/the-revenue-recognition-ledger-4.png" />
</Frame>

### Generating Revenue Recognition Ledger Entries

Ruddr can automatically generate past and future revenue recognition ledger entries via the **Generate** button at the top-right of the ledger. The Generate button is only enabled once the project's budget can back a schedule; hovering over a disabled button will explain what is missing (for example, the project must use a budget or must have a services revenue budget). The Generate button evaluates project actuals through the previous day and forecasted values from today forward to create revenue recognition entries. The button brings up the **Generate Revenue Recognition** window which captures four important pieces of information:

* The method Ruddr should use to calculate revenue recognition entries
* The interval that entries should be created on (weekly or monthly)
* The start date for when the process should create revenue recognition ledger entries
* The date through which Ruddr should rely on actual hours

<Frame caption="Figure 5 - The Generate Revenue Recognition Window">
  <img src="https://mintcdn.com/ruddr-help/vCJou40J1DwO4-mD/images/the-revenue-recognition-ledger-5.png?fit=max&auto=format&n=vCJou40J1DwO4-mD&q=85&s=dc91a5932be8a18b65f839644686c59d" alt="" width="674" height="536" data-path="images/the-revenue-recognition-ledger-5.png" />
</Frame>

For detailed information on how the **Percentage of Billable Hours, Percentage of Time & Materials Revenue**, and **Percentage of Services Cost** methods calculate revenue recognition ledger entries, see the the [Fixed Fee Revenue Recognition](/projects/fixed-fee-revenue-recognition) article.

The Generate button will create revenue recognition entries through the end of the resource allocations for the project. Thus, the ledger could contain many months of future revenue recognition entries. Those future entries are used on reports and dashboards that display forecasted services revenue.

### Automated Revenue Recognition

While calculating revenue recognition manually or via the Generate button is often desirable, Ruddr also provides three automated revenue recognition methods. These methods are **Automated - Percentage of Billable Hours**, **Automated - Percentage of Services Cost**, and **Automated - Percentage of Time & Materials Revenue**.

With these methods, Ruddr performs automated revenue recognition either once per week or once per month. Ruddr will analyze the project's actuals and forecast and then make the appropriate entry in the revenue recognition ledger. For more on automated revenue recognition methods, see the [Fixed Fee Revenue Recognition](/projects/fixed-fee-revenue-recognition) article.

### Completing a Fixed Fee Project

When a fixed fee project that uses the revenue recognition ledger is set to Completed, Ruddr will check to see if there is any remaining services revenue budget to be recognized. If there is, Ruddr will ask the user if it should recognize that remaining revenue. If the user confirms, a final revenue recognition row will be added to the revenue recognition ledger (Figure 6).

<Frame caption="Figure 6 - The Revenue Recognition Ledger with Generated Entries">
  <img src="https://mintcdn.com/ruddr-help/7cT5RdoTFUrdIMUD/images/the-revenue-recognition-ledger-6.png?fit=max&auto=format&n=7cT5RdoTFUrdIMUD&q=85&s=5d81d9fefa4f2d60a1143c5ed700a3d5" alt="" width="1255" height="635" data-path="images/the-revenue-recognition-ledger-6.png" />
</Frame>


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