Cost Pool rules | Yarken Help

Ways to add Cost Pool rules

YäRKEN supports three flexible ways to create allocation rules:

Add mapping file – Upload rules using a template.
Copy mapping from another month – Reuse existing rules.
Map manually – Create rules directly in the application.

Adding rules using a mapping file

Uploading a mapping file is the fastest way to create or update a large number of rules. This strategy involves a process of uploading a mapping file. You can use the Cost Pool Rules template available in the Data Dictionary.

Fields used in adding Cost Pool rules using mapping file

Mandatory fields

Priority - Defines the execution order of the rule, for example, 1, 2, or 3.
Filter - Specifies the criteria used to execute the rule. This field must be provided in JSON format and defines the conditions under which the rule applies. For more information on how to define filter condition in JSON, refer https://yarken.atlassian.net/wiki/x/F4CoLg.
Cost Pool - Specifies the Cost Pool to which the rule applies and where spend is allocated.
Sub Cost Pool - Specifies the Sub Cost Pool within the selected Cost Pool.

Optional fields

Rule Enabled - Controls whether the rule is active. Accepted values: TRUE (enabled) or FALSE (disabled). If this column is omitted or left blank, the rule defaults to enabled.

Prerequisites

Before uploading, ensure your file includes values in the mandatory columns:

Priority
Filter
Cost Pool
Sub Cost Pool

The Rule Enabled column is optional. Files created before this feature, without the column, will import all rules as enabled by default.

Procedure

Select the target month tile.

Make sure you are in the correct fiscal year by checking the year filter on the top-left.

Click the ellipsis (…) menu and choose Add Rules.
Select Add mapping file.
Browse or drag and drop the template file.
Review the data and click NEXT.

Note: If you have aligned to the template headers or loaded your data into the template, you should see “All required fields have been automapped successfully.”

Choose FINISH to complete the upload, or Edit Mapping to review and adjust field mappings.

After uploading the file, you can check the file status, loaded records, mapped fields, and other details under the UPLOADED FILES tab.

Copying rules from another month

If allocation logic is consistent across months, you can copy rules instead of recreating them.

When copying rules from another month, the existing rules will be deleted and new rules will be added as a full rule set.

To copy,

Select a month you want to allocate the spend and click ellipsis (…) menu.
Select Add Rules.
Choose Copy mapping from another month.

On the Copy Cost Pool Mapping popup, select the source year-month and click COPY MAPPING.

The rules from the selected month are replicated for the target month.

Note: The enabled or disabled status of each rule is preserved when copying. Disabled rules in the source month will remain disabled in the target month.

Mapping spend manually

The manual mapping involves assigning spend directly from Accounts, Cost Centers, Vendors, or any attribute to the appropriate cost pool without relying on file uploads. You can use manual mapping when you find any unmapped cost that does not fit into the predefined rules.

You can choose from predefined strategies or define custom conditions:

Map by Account, Expense Type
Map by Account, Expense Type & Cost Center
Map by Account, Expense Type, Cost Center & Vendor
Map by Vendor
Map by Any Attribute

Procedure

To map manually,

Select a month you want to allocate the spend and click ellipsis (…) menu.
Select Add Rules.
Choose Map manually. A list of predefined strategies appears.

Select a strategy that you wish to use:

Strategy Name	Based on
Map by Account, Expense Type	Account Code + Account Name + Expense Type
Map by Account, Expense Type & Cost Center	Account Code + Account Name + Expense Type + Cost Center Code + Cost Center Name
Map by Account, Expense Type, Cost Center & Vendor	Account Code + Account Name + Expense Type + Cost Center Code + Cost Center Name + Vendor Code + Vendor Name
Map by Vendor	Vendor Code + Vendor Name
Map by Any Attribute	Conditions that you set while adding rule.

Depending on your selection, follow the below steps:
1. For predefined strategies: Select the one or more rows that you wish to allocate by clicking the checkbox next to each one.
  
  You can see the allocated amount and other columns. You may use the search box or add filters to refine the items. The General Ledger Transaction can be checked by clicking on row. You can switch between different strategies by clicking on the dropdown arrow at the upper-right corner.
  1. Upon selecting row(s), a small wizard opens to the right for allocating the selected amount to the cost pool.
  2. Select the cost pool from the list and click SAVE RULES. A Rules Saved Successfully message appears.
2. For Any Attribute strategy:
  1. Click + ADD RULE from the mapping screen.
    
    A Conditions for Cost Pool popup opens.
  2. On the popup, select the table and specify other conditions.
  3. (Optional) Click + ADD CONDITION to add new table.
  4. Click SAVE. A small wizard opens to the right for allocating the selected amount to the cost pool.
  5. Select the cost pool from the list and click SAVE RULES.

A Rules Saved Successfully message appears and application redirects you to the UNALLOCATED SPEND tab, where you can continue this procedure until you fully allocate all of your spend.

Enable or disable a Cost Pool rule

You can enable or disable individual Cost Pool rules to control whether they are applied during data reloads without deleting them.

Enabled (default) - The rule is evaluated and applied during allocation processing.
Disabled - The rule is saved but skipped during processing. Previously processed data is not affected.

Procedure

Select the target month tile.
Navigate to the rules list for the selected month.
Locate the rule you want to enable or disable.
Toggle the Enabled switch to ON (enabled) or OFF (disabled).
Click SAVE to confirm the change.

Notes:

All new and existing rules are enabled by default.
Disabled rules remain visible in the rules list but are not executed during allocation.
The enabled/disabled status is preserved during copy, export, and import operations.
When importing a mapping file without the Rule Enabled column, all rules default to enabled.
Auto-created rules from Budget or Forecast cannot be disabled.

Related content

Cost Pools

Manage Cost Pool rules