Efficiently manage your revenue recognition process with Recurly Revenue Recognition Advanced features and rules management, ensuring accuracy and compliance.


This feature is part of our product, Recurly Revenue Recognition Advanced. [Learn more here].


  • Familiarity with Recurly's basic functionalities.
  • Access to Recurly Revenue Recognition Advanced module.
  • Necessary permissions to configure rules and holds.


  • Any changes that are made will be applied for future transactions only.
  • Once a Contract Grouping Rule is created, it cannot be deleted but can be inactivated.
  • Approved SSP data cannot be deleted.
  • Holds, once applied, can only be released based on the set criteria or manually by authorized personnel.

Key benefits

  • Streamlined revenue recognition: Simplify the revenue recognition process with clear rules and functionalities, enabling an organized and efficient workflow.
  • Contract flexibility: Define contract groupings, performance obligations, and variable considerations with ease to suit your business model.
  • Automated calculations: Reduce manual errors and save time with automated calculations for costs and variable considerations.
  • Enhanced control: Gain better control over revenue recognition through the Holds feature, ensuring accuracy and compliance.
  • Insightful analysis: Utilize the SSP Analyzer tool for comprehensive insights, aiding in informed decision-making and strategy optimization.

Rules functionalities

Contract grouping

This essential feature allows you to define specific criteria for grouping transactions into contracts, ensuring accurate and efficient revenue recognition.

How to configure contract grouping

  1. Navigate to the Rules section and select "Contract Grouping."

  2. Click on the “+” icon in the right menu to create a new grouping rule.

  1. Provide a name for the contract grouping and specify the active date.
  1. Under the "Grouping" section, click on the gray "+" button to add grouping criteria.
  1. Select the required grouping attribute(s) to define how contracts should be grouped.
  2. Specify the rolling date and the number of days for the grouping rule.

  1. Save your configuration.

How to inactivate Contract Grouping Rule

Note: Once a Contract Grouping Rule is created/configured, it cannot be deleted. However, you can choose to inactivate a grouping rule if needed.

To inactivate a grouping rule, follow these steps:

  1. Go to the Contract Grouping section and select the grouping rule tab that you want to inactivate.

  2. The current status of the grouping rule will be "active." Change the status to "inactive."

  1. Click on the Save icon to save the changes.

Points to Remember:
➔ Only the active grouping rules will be visible in the Contract Grouping section.
➔ Once a grouping rule is made inactive, it will be moved to the inactive tab for reference.

Performance obligation

In Recurly Revenue Recognition Advanced, the second step of ASC 606 / IFRS 15 compliance involves identifying and defining performance obligations. This process includes setting up recognition methods for each obligation and establishing rules for the items or transactions associated with them, ensuring accurate and consistent revenue recognition.

Adding POBs

  1. Navigate to Rules → POB.

  2. Click on the "+" button to add a new performance obligation.

  3. Enter a unique name for the performance obligation.

  4. Provide the active date for the new POB.

  5. Select the appropriate waterfall type (WF Type) from the dropdown:

    1. PointInTime: Performance obligations recognized at a point in time.
    2. OverTime: Performance obligations recognized over the contract period.
    3. OverTime Slide: Performance obligations recognized over the contract period, with a delayed release date extending revenue recognition.
    4. OverTime Condense: Performance obligations recognized based on the release date, with revenue recognition adjusted based on event timing.
    5. Manual: Revenue realized based on manual input.
  6. Choose the accounting method for the new POB from the dropdown options:

    1. Daily: Revenue recognized daily, based on the number of days in the contract.
    2. FixedMonthly: Revenue calculated in fixed amounts based on the number of months in the contract, with adjustments for start date.
    3. PartialMonthly: Revenue calculated partially for the first and last months of the contract, with equal recognition for the remaining months.
    4. Annually: Revenue calculated annually.
  7. Select the ratable method from the dropdown options:

    1. Sales Order Ratable: Revenue amortized on a prorated basis, with catch-up in the current open period.
    2. Sales Order Dates: Revenue scheduled based on the start and end dates of the sales order lines.
    3. Billing Dates: Revenue scheduled based on the start and end dates of billing/invoice.

After completing step 1 – 6, save your changes and then your POB could look like this.

  1. In the POB configuration screen, locate the Revenue Release section.

  2. Click on the "+" button in the Revenue Release section to add a new release event.

    1. Follow these sub-steps to configure the release event:
      1. Select the desired event from the dropdown menu.
      2. Enter the percentage of revenue release applicable for this event.

Please note that these steps allow you to add multiple release events to a single POB, enabling accurate revenue recognition based on different events and their corresponding revenue release percentages.

  1. Save all changes.

Adding POB rules

To access POB Rules, there are three methods available:

Method 1

  1. Go to the Rules section in the navigation menu.

  2. Click on "Rules" under the Performance Obligation menu.

Method 2

  1. Open the desired POB.

  2. Navigate to the "Rules" tab located at the top.

Method 3

  1. Open the desired POB.

  2. Scroll down to the bottom of the page.

  3. Enter the required information in the Rules section. Note that this method provides limited functionality compared to the other methods.

Once in the Rules section, follow these steps to add POB Rules:

  1. Click on the "+" icon under the Rules section.

  2. Select the specific POB to which the rule should be assigned.

  3. Define the attribute value used for recognizing the POB. For example, select the "Item" attribute. If the desired value is not available, click on the window-shaped button and select the attribute from the window that appears, then click on "Save." In this case, we have chosen "Account Code" as the attribute for POB recognition.

  1. Once the attribute is determined, enter the corresponding value that describes the POB and adjust the active date as necessary.

  1. Click on the "Save" icon to save the rule.


  • Avoid editing the default POBs, such as "Material right" and "manual journal."
  • Multiple release events can be associated with a single POB, but the total release percentage must equal 100%.
  • POBs require an assigned rule to function properly.
  • You can change the hierarchy of POB rules by dragging and rearranging them using the drag icon.
  • Remember to save any changes made to the rules or hierarchy.
  • To delete a POB Rule, select the rule and click on the "Delete" icon. Click on the "Save" icon to confirm the deletion.

Standalone selling price

Setting up the Stand-Alone Selling Price (SSP) involves a streamlined process consisting of three key steps. Firstly, you will create the SSP by defining values, specifying pricing attributes, and configuring adjustments or discounts. Secondly, you will set the SSP Analyzer rules, establishing criteria for identifying and analyzing SSP variances, and customizing them to align with your business requirements. Lastly, you will prepare and upload the necessary data into the SSP Analyzer tool, ensuring accurate processing and analysis. By following these steps diligently, you can establish a robust SSP framework tailored to your products or services, enabling precise determination of stand-alone selling prices.

Creating the SSP

  1. Navigate to the Rules section and click on SSP Definition.
  1. Click on the "+" icon to create a new SSP.
  1. Enter a name for the SSP.
  2. Leave the Range tab blank when uploading SSP data.
  3. Select the Type of SSP as SSP or RSSP.

Note: Select SSP, if you want to define standalone selling price and select RSSP when you want to define Residual standalone selling price.

  1. Under the Books tab, choose the relevant Book for the SSP.
  2. Select the appropriate SSP value from the drop-down menu.
  3. Specify the SSP statistics as Simple Median, Simple Average, Weighted Median, or Weighted Average.
  4. Determine the SSP base as Low, Median, High, or Follow SellPrice.
  5. Under the Grouping tab, select the attribute that will define the SSP. For example, if you choose "item" as the attribute, the SSP will be based on items.
  6. Save the SSP configuration. The newly created SSP card will appear on the left side under active SSPs.
  7. To delete any SSP configured in Recurly Revenue Recognition Advanced, click on the delete icon located on the black menu bar.

Configuring the SSP Analyzer

  1. Navigate to the Rules section and click on SSP Analyzer, or click on SSP Analyzer at the top of the SSP page. In case of multiple SSP definitions, go to the required SSP card and click on SSP Analyzer.
  1. On the SSP Analyzer page, click on the “+” icon to create a new SSP Analyzer.

  1. Provide a unique name for the SSP Analyzer.
  2. Select the appropriate Analyzer Type: Rules or Analysis. Choose "Rules" if you are uploading SSP data.
  3. Define the active dates, including the start and end date (if applicable), for the SSP data.
  4. Once you have configured the SSP Analyzer, click the Save icon to save your changes.
  1. The Flow Status will be displayed as "New" once the configuration is saved.

Preparing and uploading SSP data

  1. Ensure that the information in the table corresponds to the selections made for the SSP configuration, maintaining consistency with the chosen value type (e.g., amount or percentage).

  2. To upload the SSP data, click on the Upload icon.

  3. In the SSP upload window, select the SSP file that needs to be uploaded and click Open.

  4. After the SSP file is uploaded, click on the Save icon.

  5. The uploaded SSP data will be displayed under the Rules section in SSP Analyzer.

  6. To approve the uploaded SSP data, click on the Approve icon. Note that approved data cannot be deleted.

  7. The flow status will change to Approved once the SSP data is approved.

  8. The SSP data will appear on the SSP Analyzer screen as shown below:

  9. After the SSP data is approved, it can be downloaded by clicking on the Download icon.


  • If the SSP data needs to be deleted, it can only be done before approving it. Click on the Delete icon to remove the data. Once approved, the data cannot be deleted.
  • If the approved SSP data will not be used, specify an end date so that the data will not be utilized beyond that date.
  • Recurly Revenue Recognition Advanced allows you to provide validity for the uploaded SSP data by specifying the start and end dates for the approved data.

Variable considerations

In Recurly Revenue Recognition Advanced, the setup for automatically applying variable consideration (VC) estimates to transaction lines is done on the Variable Considerations page. Variable considerations refer to charges associated with discounts, rebates, and refunds that are determined by factors unrelated to the cost of producing goods or services. These amounts can be estimated using historical data and various calculations.

How to configure Variable Considerations

  1. Go to Rules → Variable Considerations.

  2. Click on the "+" button to create a new VC template.

  3. Name the VC template.

  4. Specify the VC type, which is used to group VC of similar types (e.g., favorable VC).

  5. Ensure that the VC-related accounts in your ERP system are accurately reflected:

    1. Accrual Account: A liability account used for VC accrual.
    2. Contra Account: A revenue account for VC revenue.
    3. Clearing Account: A clearing account associated with VC.
  6. Define the timing for VC accrual.

  7. Enter the active dates for the VC.

  8. To inactivate a VC, toggle its status to "Inactive."

  9. To activate a VC needed, toggle its status to "Active."

  10. Click the "+" button in the rules section to assign VC rates or amounts to be applied on items.

  11. For each VC rule, you can provide active dates for the VC items.

  12. To remove VC rules or items, simply delete them.

Below is an example of a VC template:

Uploading files to VC

When working with Variable Considerations (VC) in Recurly Revenue Recognition Advanced, there are two options for importing data:

  1. Integrating Invoices from Recurly: If VC is applicable, you can integrate invoices from the Recurly platform into Recurly Revenue Recognition Advanced.
  2. Loading a Sales Order File: Alternatively, you can load a sales order file into the system for which VC is applicable.

Once the data is collected and available in the system, Recurly Revenue Recognition Advanced automatically calculates VC based on the configured rules. The calculated VC amounts will be visible in the system, as shown in the provided screenshot.

With Recurly Revenue Recognition Advanced, VC estimates are automatically applied to transactions based on the VC rules defined during the setup process, streamlining the calculation and application of VC amounts.

In the revenue workbench of Recurly Revenue Recognition Advanced, you have the flexibility to manually modify the application of variable consideration. To do this, simply right-click on the specific item you wish to change while in the VC tab. The options available for adjustment can be seen in the provided image.

Any changes made to the variable consideration will be accurately reflected in the Revenue Workbench. If there are any adjustments or updates needed for the variable consideration, they can be performed through VC true-up or by initiating clearance to release the updated information.


  • The transaction price displayed in the Revenue Workbench reflects the price after the adjustments for variable consideration.
  • The revenue to date shown in the Revenue Workbench is the cumulative sum of revenue, allocations, and favorable variable considerations scheduled for the respective period.
  • The Revenue Workbench provides visibility into the waterfall analysis for variable consideration, showcasing the breakdown and impact of variable consideration on revenue recognition.
  • The VC Accrual represents either the amount calculated by the system or the liability that will be cleared once the actuals are incorporated into the process.


Recurly Revenue Recognition Advanced includes functionality to account for costs. There are two options for managing costs within the system: manual loading of costs or automated calculation based on predefined formulas. The Rules page, specifically the Cost section, is used to define the Cost Type and Cost Rules.

How to configure a cost type

  1. Navigate to Rules and select Cost from the menu.
  1. Enter the 'Cost Type' to specify the type of cost you are defining.
  2. Determine the cost treatment based on the following options:
    1. Point in time: Recognize the cost in the month it is incurred.
    2. Follow Revenue: Recognize the cost according to the revenue recognition pattern over the contract period.
  3. Set the cost keys by clicking on the field and selecting the appropriate options from the pop-up menu. Note that selecting cost keys is optional.
  4. If you need the Recurly Revenue Recognition Advanced tool to calculate the cost amount, use the "Formula on" feature. Type "Line.SellPrice" (case sensitive) to apply cost rules based on a percentage of the sell price.
  5. Specify a unique account number for the debit account ('Dr account number') and the credit account ('Cr account number'). These account numbers will be compared with the Sales Order number.
  6. If your incremental cost needs to be amortized and capitalized, activate the "Cost Capitalize" option.
  7. Finally, click on the Save icon to save your cost configuration.

To add rules to the cost configuration in order to apply the cost formula to specific contract lines, such as the item "Macbook," follow these steps:

  1. Under the cost rules section, click on the "+" button to add a new cost rule.
  2. Select the book for which the cost should be applied. This ensures that the cost rule is associated with the correct book.
  3. In the "Item" column, enter the name "Macbook" to specify that this cost rule should be applied to contract lines related to the item "Macbook."
  4. In the "Value" column, enter the percentage of the sell price that should be treated as cost for the specified item.
  5. Click on the save button to save the cost rule.

Note: If your cost calculation is based on any other attribute other than “item”, go to the mapper and select the required fields.

Calculation of cost using a cost file

  1. Prepare a Cost file that includes the necessary columns reflecting the cost attributes defined in the system. Ensure that the cost type specified in the file matches the cost type already defined in the system.

  2. Navigate to the Transactions page in Recurly Revenue Recognition Advanced.

  3. Click on the "Upload" icon to upload the Cost file.

  4. Choose the Cost file from your local system by clicking on "Browse" or "Choose File" and select the appropriate file.

  5. Once the file is selected, click on "Open" to initiate the upload process.

  6. The system will process the uploaded Cost file and calculate the cost based on the configuration specified in the Cost Rules. It will apply the calculated cost to the respective contract lines, even if the cost is not explicitly assigned to the item or POB in the contract.

By utilizing the Cost file upload functionality, you can streamline the process of calculating costs based on predefined rules and attributes, enabling accurate cost allocation in your revenue recognition calculations.


In Recurly Revenue Recognition Advanced, the Holds feature allows for holding revenue recognition based on specific conditions set by management.

There are two types of holds available: Contract Level hold and Element Level hold.

Contract Level Hold:

  • A Contract Level hold applies to the entire contract.
  • It prevents revenue recognition for the contract until the hold condition is met.
  • The hold condition could be a specific event, date, or any other criteria defined by the management.
  • Once the hold condition is satisfied, revenue recognition for the contract can proceed.

Element Level Hold:

  • An Element Level hold applies to individual revenue elements within a contract.
  • It allows for holding revenue recognition for specific elements until the hold condition is met.
  • Each revenue element can have its own hold condition.
  • The hold condition could be based on the fulfillment of certain criteria or the occurrence of specific events.
  • Once the hold condition for an element is satisfied, revenue recognition for that particular element can proceed.

The Holds feature in Recurly Revenue Recognition Advanced provides flexibility in managing revenue recognition by allowing for temporary holds based on defined conditions. It ensures that revenue recognition aligns with the requirements and policies set by management, providing accurate and compliant financial reporting.

How to apply holds

  1. Navigation: Go to Rules → Holds
  1. Name: Enter a name for the hold, such as "Delivery Hold."
  2. Apply on: Select whether the hold should be applied at the Contract level or Element level.
  3. Release on: Select an event based on which the hold can be released. Note that this option is inactive for a contract level hold.
  4. Books: Select the books to which the hold configuration should apply. You can select all or specific books.
  5. Expiry Date: Choose the date on which the hold will expire and will no longer be applied.
  6. Days: Enter the number of days after which the hold will no longer apply.
  7. Active Dates: Specify the date or period during which you want the hold to be active.
  8. Release Hold: Choose one of the following options:
    1. Active: When the release hold is active, revenue cannot be scheduled and revenue will not be transferred to the general ledger even if you try to release revenue manually.
    2. Inactive: When the release hold is inactive, you can schedule revenue and revenue will be transferred to the general ledger when you try to release revenue manually.
  9. Criteria: This section allows you to define criteria for applying the hold to a contract or element. It includes the following columns:
    1. Field type: Specify the field type, such as "All" or a specific field.
    2. Field: Choose the field on which the hold criteria will be based.
    3. Operator: Select the operator to define the comparison, such as "=", "<", ">", etc.
    4. Value: Enter the value against which the field will be compared, such as "Damaged" (text) or a specific number.

Applying and releasing holds (functional scenarios)

  1. Create a hold at the contract level by filling in the mandatory fields and selecting a criteria based on which the hold will apply. For example, set the criteria as "quantity equal to greater than 5."

  2. Upload the sales order (SO) file that satisfies the hold criteria.

  3. Open the contract in the revenue workbench.

  4. Go to the "Hold" tab in the contract view.

  5. Right-click on each order line that needs to have the hold released.

  6. A dialog box titled "Release Line Hold" will appear.

  7. Click on the dialog box to release the hold on the selected order line.

  8. The released hold will be reflected in the waterfall view, showing the updated revenue recognition.

  9. It's also possible to configure holds at the element level, providing more flexibility in managing revenue recognition.

  10. If holds are configured at the element level, you can follow the same process to release them manually.

Applying hold on element level manually

  1. Go to the "Rules" function and click on "Hold."

  2. Select "Element Level" from the drop-down list.

  3. Choose "Apply on" as "Element Level" for Line Hold.

  4. Click on the Save icon to save the configuration.

Now, to apply the hold on an element level manually:

  1. Upload a contract that does not satisfy the element level hold criteria.

  2. Go to the Revenue Workbench and open the contract.

  3. Navigate to the "Hold" tab in the Revenue Workbench. At this point, no hold will be applied.

  4. Once the hold screen appears, right-click on the order line that needs to have the hold applied.

  5. A dialogue box titled "Apply Line Hold" will appear.

  6. Click on "Apply Line Hold," and another dialogue box will appear.

  7. Choose a predefined hold from the options and add comments explaining why the hold is being applied. Note that you can apply the hold even if it does not satisfy the criteria set for the hold.

  8. Click on the appropriate buttons to confirm and save the applied hold.


  • In the "Hold" tab of the Revenue Workbench, you can see the information about when and who applied the line hold.
  • Holds can also be applied to partial revenue. For example, if 50% of the revenue for a contract has been released, you can apply a hold on the remaining 50% and release it at a later time. The same process mentioned above can be used to apply holds on partial revenue in the Revenue Workbench manually.