Cash vs Percentage Rules & Accounting Profiles

This guide explains how additions and deductions are applied to driver settlements based on:

• Deduction type (Cash vs Percentage)

• Accounting profile

• Driver configuration

Important Terminology

Throughout this article, the term “deductions” is used for simplicity and consistency.

However, the logic described applies to both deductions and additions.

What This Means

• Any rule that applies to a deduction also applies to an addition

• The system behaviour (percentage vs cash, accounting profile matching, reference profile logic) is identical for both

• The only difference is financial direction:

All configuration rules, matching logic, grouping behaviour, and calculation formulas apply equally to both.

1. Overview

The system determines which deductions apply to a settlement based on:

• The deduction type (Cash vs Percentage)

• Whether the driver has a Cash Settlement Company configured

• The accounting profile of the settlement

Key Principle

• Percentage deductions are applied to all settlements

• Cash deductions are applied only to settlements whose accounting profile matches a specific reference profile

The reference profile depends on the driver configuration:

2. Deduction Types

2.1 Types and Application Scope

2.2 Override Mechanism (overrideGlobalSettings)

The overrideGlobalSettings flag on driver-level deductions allows the deduction type to be overridden.

3. Settlement Grouping Rules

3.1 How Orders Are Grouped into Settlements

3.2 Deduction Application by Accounting Profile

4. Scenario A: No Cash Settlement Company Configured

When a driver does not have a Cash Settlement Company configured:

• Cash deductions apply to settlements whose accounting profile matches the default company profile

Behavior Summary

5. Scenario B: Cash Settlement Company Configured

When a driver has a Cash Settlement Company configured:

• Cash deductions apply only to settlements matching the Cash Settlement Company’s accounting profile

Behavior Summary

? Key Difference from Scenario A

• Scenario A: Cash deductions apply to default company settlements

• Scenario B: Cash deductions apply to Cash Settlement Company settlements

6. Scenario C: Cash Settlement Company with Same Profile as Default

If the Cash Settlement Company has the same accounting profile as the default company:

• The behaviour is identical to Scenario A.

Why?

Since both companies share the same accounting profile:

• The reference profile is the same

• Cash deductions apply to the same settlements

• No behavioural change occurs

Implication Summary

✅ Conclusion: Setting a Cash Settlement Company with the same profile as the default company is a no-op for deduction purposes.

7. Calculation Formulas

7.1 Percentage Deductions

Deduction Value = Orders Subtotal × Percentage Rate

7.2 Cash Deductions

Deduction Value = Fixed Amount

(No calculation required.)

7.3 Settlement Total

Total = Orders Subtotal
      + Sum(Applicable Percentage Deductions)
      + Sum(Applicable Cash Deductions)

Where applicable, cash deductions depend on:

• No Cash Settlement Company → Accounting profile must match the default company profile

• Cash Settlement Company configured → Accounting profile must match Cash Settlement Company profile

8. Visual Summary

8.1 Scenario A – No Cash Settlement Company

Settlement A (Default Profile)
% Deductions: ✅
$ Deductions: ✅

Settlement B (Different Profile)
% Deductions: ✅
$ Deductions: ❌

Settlement C (No Profile)
% Deductions: ✅
$ Deductions: ❌

8.2 Scenario B – Cash Settlement Company Configured

Settlement A (Default Profile)
% Deductions: ✅
$ Deductions: ❌

Settlement B (Cash Settlement Profile)
% Deductions: ✅
$ Deductions: ✅

Settlement C (No Profile)
% Deductions: ✅
$ Deductions: ❌

9. Decision Flow Summary

1. Is the deduction type a percentage?

   • ✅ Yes → Apply to all settlements

   • ❌ No → Continue

2. Is the deduction type Cash?

   • Determine reference profile:

     • If Cash Settlement Company exists → Use its accounting profile

     • Otherwise → Use default company profile

3. Does the settlement accounting profile match the reference profile?

   • ✅ Yes → Apply deduction

   • ❌ No → Exclude deduction

10. API Endpoints

Final Summary

• Percentage deductions are always global.

• Cash deductions are profile-restricted.

• The reference profile depends on whether a Cash Settlement Company is configured.

• Matching accounting profiles determines eligibility.

• Identical profiles between default and cash settlement companies result in no behavioural change.