Skip to main content

Celonis Product Documentation

Validating KPIs for the object-centric Accounts Receivable Starter Kit

In the Accounts Receivable Starter Kit’s Knowledge Model, check that all the KPIs (key performance indicators) contain the correct business logic for your organization.

The main Knowledge Model for the Accounts Receivable Starter Kit is called “Knowledge Model”, and it's in the package's Knowledge Models folder. Work with this Knowledge Model to validate and change KPIs. The Starter Kit’s Knowledge Model points to the base Knowledge Model stored in the Celonis Marketplace, which you can’t update directly. Changes that you make to the PQL formulas, KPI names, or formatting in the Starter Kit’s Knowledge Model override the base Knowledge Model.

Each KPI in a Knowledge Model contains a PQL (Process Query Language) formula. Some KPIs are reused inside other KPIs as nested formulas. When you adjust the business logic in a single formula, and save it, the change is simultaneously reflected in all the KPIs that reuse the formula.

You work with Knowledge Models in Studio, and any changes you make are applied when you publish a new version of the Starter Kit. You’ll need Analyst permissions on Studio and the Knowledge Model to modify any of the KPIs and their calculations. If you need training, check out the training track “Build Knowledge Models and Views” on the Celonis Academy.

Here’s how to work with the KPIs in the Starter Kit’s Knowledge Model:

  1. In the Celonis navigation menu, select Studio.

  2. Find the Accounts Receivable Starter Kit (object-centric) in your Studio space navigation.

  3. Expand the package’s structure using the arrow.

  4. Go to the Knowledge Models folder and select “Knowledge Model”.

  5. Select the KPIs section of the Knowledge Model.

  6. You can sort and search the KPIs using their name or ID. The prefix to the ID shows what type of component they are. At the end of these instructions, we’ve noted the most important KPIs to check.

  7. To see and edit the full PQL formula and other settings for a KPI, click its row to open an editor. The editor automatically validates any changes that you make in the PQL formula.

  8. If you want a fuller-featured PQL editor that lets you select from the tables and columns in your data, click on the pen icon next to the PQL formula.

  9. If you need to disable a KPI or formula, click the three vertical dots at the top of the editor, and select Disable Scope, then click Disable to confirm. When you do this, the object can't be accessed or used anywhere in the package, including by other apps that depend on it.

  10. If you update the business logic for a KPI or the variables it uses, update the documentation for business users to reflect your changes. You can find the built-in documentation for your Starter Kit's KPIs in your Studio space navigation. It's in the folder Documentation > KPI Documentation.

  11. When you’ve made changes to the KPIs, use the Publish Package button at the top of the screen in your Studio space to publish a new version of the Accounts Receivable Starter Kit.

SK_AR_KM.png

For the Accounts Receivable Starter Kit, you can manage the settings for most of the important KPIs using the Validation Cockpit and the Settings view. Here are the important KPIs that you can only manage in the Knowledge Model.

KPI name

KPI ID

# Invoice Items

KPI_INVOICE_ITEM_COUNT

Total Invoice Value

KPI_INVOICE_ITEM_SUM_TOTAL_VALUE

Days Sales Outstanding (direct)

KPI_INVOICE_CALC_DAYS_SALES_OUTSTANDING_DIRECT

Best Possible DSO (direct)

KPI_INVOICE_CALC_OPTIMAL_DAYS_SALES_OUTSTANDING_DIRECT

# Invoices w. Master Data Payment Terms

KPI_INVOICE_COUNT_MASTER_DATA_PAYMENT_TERMS

Payment terms mismatch (%)

KPI_INVOICE_RATE_PAYMENT_TERMS_MISMATCH

Paid on time rate (%)

KPI_INVOICE_CALC_PAID_ON_TIME_RATE

Paid late rate (%)

KPI_INVOICE_CALC_PAID_LATE_RATE

Cash Discount Utilization (%)

KPI_INVOICE_RATE_CASH_DISCOUNT_UTILIZATION

Unearned Cash Discount

KPI_INVOICE_SUM_TOTAL_UNEARNED_CASH_DISCOUNT

Touchless Collection Rate (%)

KPI_INVOICE_AVG_TOUCHLESS_COLLECTION_RATE

Automation Rate (%)

KPI_ACTIVITY_AUTOMATION_RATE