This is the Trade module of QuantumOS Route. It manages the promotional schemes a brand runs through its distributors and retailers, and the claims those schemes produce. A scheme is a versioned set of slabs with a scope, an effective window and an optional budget. It is simulated, reviewed, approved by someone other than its author and published. Claims are built from the claimant's verified sales invoices, never typed in, then approved by someone other than the submitter and settled against a credit note or payment reference. The workspace has four tabs: Overview, Schemes, Claims and Scheme ROI.
01
Schemes with slabs, stacking and versions
Built and testedEligibility, slabs, stacking rules and published versions that cannot be edited.
The scheme calculations run on tested rules shared across the product, and they power the Schemes tab and claim building. The calculations and the API support limiting a scheme by product, buyer, channel type or territory, several slabs triggered by a minimum quantity or a minimum value, and stackable or exclusive schemes with an exclusion list. The workspace form is narrower: it creates a single-slab percentage-discount scheme with an optional product scope, an effective window, an optional budget and a stackable flag. It is marked built and tested rather than available because it is not recorded as deployed on its own; the claims and ROI features that use it are.
- Benefit types supported: percentage discount, fixed discount, free product. The workspace form offers percentage discount only
- Through the API a scheme can have up to 50 slabs, each triggered by a minimum quantity or value, and can be limited by product, buyer, channel type and territory
- A published version cannot be edited; a change is a new version with the same name that replaces the old one
Where to find it: Trade workspace, Schemes tab
02
Benefits worked out from real invoices
Built and testedScheme benefits are calculated from Channel sales invoices, not from typed amounts.
The benefit calculation runs over a claimant's sales invoices dated inside the scheme window. It is marked built and tested; the workspace exposes it through simulation and claim building rather than as a separate screen.
- Only sales invoices in the scheme's effective window are considered
- Each source document can back one claim line per scheme and claimant
Where to find it: Trade workspace, Schemes and Claims tabs
03
Scheme simulation before publication
Built and testedTry a hypothetical sales document against the published schemes and see what applies and what is suppressed.
The Schemes tab simulates a document for a chosen buyer. You enter a product, a quantity and a unit price, and the workspace runs the published schemes through the stacking rules and shows which benefits apply and which schemes are suppressed. The API accepts up to 200 lines and an optional date; the form offers one line.
- One line in the workspace form; up to 200 lines through the API
- Shows applied benefits and suppressed schemes separately
- Read-only: it saves nothing
Where to find it: Trade workspace, Schemes tab
04
Claims, approval and settlement
AvailableBuild a claim from verified invoices, approve or reject it, and settle it with a credit-note or payment reference.
Building a claim reads the claimant's sales invoices in the scheme window, calculates the benefits and stores the claim with its lines and an approval trail that only grows. Documents already claimed under the same scheme are skipped, so nothing is claimed twice. The submitter cannot approve their own claim. Settlement records the kind (credit note or payment) and a document number; it does not post accounting entries.
- Claims are built only from published schemes
- Approval and rejection are recorded in a trail that cannot be edited, with who and when
- Settlement needs a kind and a document number of up to 120 characters
- A published scheme cannot be cancelled while it has open or settled claims
Where to find it: Trade workspace, Claims tab
05
Scheme utilisation and claim ageing
AvailableBudget against settled, pending and rejected claim value, with the age of the oldest open claim.
The Scheme ROI tab reports, for each scheme and in total, the budget, settled spend, pending liability, rejected value, open-claim counts and the age of the oldest open claim. It does not estimate extra sales, because that needs a baseline of what would have sold without the scheme, and this report deliberately does not fake one.
- Budget used is settled value divided by the budget, when a budget is set
- Rejected value is shown to help review leakage
- No sales-lift estimates
Where to find it: Trade workspace, Scheme ROI tab