xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Claims

Compute what you’re owed. Decide it line by line. Settle it in the books.

Trade, scheme and warranty claims generated from the transactions that earned them — proven in simulate mode before they pay, approved per line, and settled as credit notes or replacement stock into the same ledger the partner’s invoices live in.

Request a demo
Claims — quarter-end scheme runMode liveSource scheme ledger
GENERATION RUN
Trade scheme38 created
Quantity rebate12 created
Sale return credit7 created
Already claimed41 skipped
Netting removed 4 groups that fell to zero
CLAIM LINES
Monsoon slab — 240 casesAPPROVED 216
Settles from approved figures — credit note against the distributor’s account
Settle
THE LIFECYCLE
ConfigureSimulateGenerateApproveSettleReconcile
IN DEPTH

One engine for every claim.

01 · GENERATION

A claim type is configuration, not a project

A claim generation setup names the source records, the selection rules combined with AND, OR or custom logic, a date window, how candidates group into claims, whether amounts sum into one line or map one line per record, the field mappings onto claim header and lines, and an optional netting leg. Trade scheme settlements, quantity and slab rebates, cashback, contract price differences, sale-return credits and goods-receipt shortages all run on that one engine.

VALIDATED AT SAVE
Bad configuration fails in the author’s face
Every save dry-runs the configured query against live data, so a filter that cannot resolve is refused while someone is still looking at it — not discovered during the month-end run.
Ask Sense: "Which claim setups ran last night, and what did they skip?"
Claim generation setupValidated
SourceScheme ledger
Rules(claimable AND posted) OR carry-forward
Group byPartner · branch · scheme
AggregateSum of benefit × claimable %
Net againstSale returns in period
Saved setups are dry-run against live data — a filter that cannot resolve is refused here, not at 2 a.m.
02 · SIMULATE

Proven before it pays anything

New setups start in simulate mode: a simulated run executes the whole pipeline — rules, grouping, aggregation, netting — and reports the claims it would have written, without creating anything. Finance parallel-runs a cycle against the process being retired, investigates every difference, and only then switches simulate off. Generation is idempotent by construction, so the runs after that are uneventful.

IDEMPOTENT BY KEY
Re-running is boring, on purpose
Each claim is keyed by its type, group and period, so a group that already claimed is skipped and counted as such. A failed job can simply be run again.
Ask Sense: "Show me what the simulated run would have paid this quarter"
Simulated run — nothing writtenSimulate
Groups that would claim50
Lines that would attach2,318
Netted to zero, dropped4
Already claimed, skipped41
Compare against the spreadsheet the process is replacing, then switch simulate off. No rows were created by this run.
03 · APPROVAL & SETTLEMENT

Decided line by line, settled from approved figures

Approvers set approved and rejected quantities per line, or decide a clean claim at once, and claims group into batches for review the way finance actually works — by type, region and period. Settlement then runs automatically from the approved figures: a credit note posted against the partner’s account and linked back to the claim, a part-to-part inventory adjustment where a shortage settles in replacement stock, or no document at all where a claim type only needs its settlement event.

PARTIAL BY DESIGN
Approved at 90% settles at 90%
Nothing rounds up to the claimed figure. The rejected remainder never becomes a payout, and it stays visible with its reason attached rather than disappearing into a dispute.
Ask Sense: "Which approved claims are still unsettled?"
Claim — approvalapproved 90%
LINECLAIMEDAPPROVED
Monsoon slab benefit240240
Display support6060
Damage — evidence pending300
Settlement is built from the approved column — the rejected line keeps its reason instead of vanishing
THE MECHANISM

The claim computes itself.

The invoice line earns a benefitaccrual written
The run sweeps what is unclaimedgrouped · netted
Decisions land per lineapproved · rejected
Settlement posts to the ledgercredit note linked
Nothing is reconstructed
Every claim line points at the transaction that produced it, so any figure walks back to a document in two steps instead of becoming a negotiation.
Consumed once
Source records are flagged in the same transaction that writes the claim, and each claim carries a key for its type, group and period — so a re-run skips rather than doubles.
Settled where the money already lives
The credit note posts against the same account the partner’s invoices and outstanding sit on, so a settled claim moves the number the credit check reads.
04 · CLAIMS AT A GLANCE

The capabilities, stated plainly.

Every row ships today and traces to a capability described on this page.

CapabilityxMatix Claims
Claim types defined by configurationSetups, no code
Selection rules with AND, OR and custom logicYes
Save-time dry run of the configured queryYes
Simulate mode — a run that writes nothingDefault on new setups
Idempotent generation keyed by type, group and periodYes
Netting a second source per groupYes
Scheduled run groups, and an on-demand actionBoth
Line-level approved and rejected quantitiesYes
Partial approval settles partiallyYes
Settlement documentCredit note, stock adjustment, or none
Credit note applied to open invoicesConfigurable, oldest first
Claim batches with rolled-up approved totalsYes
Warranty, free service and accident-job claims from job cardsYes
Supplier-side shortage, damage and expiry claimsYes
Partner sees their own claims and statusPortal, read-only
Submission into a principal’s own claim systemIntegration flow
ReconciliationFlag, action and register
FEATURE HIGHLIGHTS

Everything in Claims.

Claim generation setups
A claim type without a project.
Source, rules, date window, grouping, aggregation and mappings are configuration — so the claim type your commercial team invents next year does not need a release.
Simulate mode
Proven before it pays.
A simulated run executes the whole pipeline and reports the claims it would have written, creating nothing. It is how a configuration earns its way into production.
Idempotent runs
Re-running is uneventful.
Claims are keyed by type, group and period and consumed sources are flagged in the same transaction, so a repeated or restarted run skips what exists.
Netting
Returns subtracted inside the claim.
A second source is subtracted per group before the claim is written, and groups that fall to zero produce nothing — so a return never arrives later as a surprise adjustment.
Line-level decisions
Partial approval, partial settlement.
Approved and rejected quantities are set per line, with approve-all and reject-all for clean claims. Settlement is built from the approved column only.
Settlement documents
Money, or replacement stock.
A linked credit note against the partner’s account, a part-to-part inventory adjustment where a shortage settles in stock, or settlement switched off entirely for a claim type.
Service-contract claims
Warranty, free service and accident jobs.
The contract’s posting treatment decides per line who pays, so one job can bill the customer for consumables and claim the principal or insurer for covered work.
Supplier-side claims
Shortage caught at the gate.
Shortages recorded on the goods receipt and expiry or damage returns become claims on the supplier, carrying the receipt, item and batch that prove them.
Claim batches
Reviewed the way finance works.
Claims group into batches by type, region or period, with the same decision controls and rolled-up approved totals.
Scheme accrual to credit note
The trade loop, closed.
Benefits accrue as documents post, the run sweeps the accruals into claims, and approval posts a credit note into the ledger the distributor’s invoices already live on.
05 · COMMON QUESTIONS

The questions evaluators ask.

Do we need a developer to add a new claim type?

No. A claim type is a generation setup: you name the source records, the rules that select them, how they group, what is summed or mapped, and what happens after approval. The engine that runs it is the same one every other claim type uses, which is why adding one is configuration work for an administrator rather than a development quote.

How do we know a new claim configuration is right before it pays anyone?

Two gates. Saving a setup dry-runs its query against live data, so anything that cannot resolve fails immediately. Then simulate mode runs the whole pipeline and reports the claims it would have written — groups, lines and amounts — without creating a thing, which is what lets finance parallel-run a full cycle against the process being replaced and compare before switching over.

What happens when a claim is only partly approved?

It settles partially. Approvers set approved and rejected quantities per line, and the settlement document is built from the approved figures only, so a claim approved at 60% produces a 60% credit note. The rejected remainder never becomes a payout and keeps its reason attached.

Can partners raise their claims from the portal?

Partners see and track their claims on the portal — status from generation through approval to settlement, plus their accrued, claimable and already-claimed scheme money, scoped by record security to their own records. Raising is deliberately not a portal action, because the commercial claims are computed from the transactions that earned them rather than typed from memory; damage and freight claims start from the goods receipt or despatch that captured the evidence.

How does a claim reach the principal’s own claim system?

Through an integration flow configured for that principal. Claim and batch documents, their lines and their evidence keys are all queryable, and every principal expects a different submission format, so the transport is configured per relationship rather than assumed by the product.

RELATED RESOURCES
Related product
Explore xMatix Rewards →
Related architecture
Explore the xMatix platform →
Documentation
Trade claims documentation →
Related reading
Anatomy of a self-settling claim →
xMatix Sense · On This Data

Ask the claims file a question.

Senseacting as Priya Nair · audited
Which approved claims are still unsettled?
Nine claims are approved and not yet settled, worth 4,86,000 across six distributors — seven waiting on this week’s settlement run and two on a claim type whose settlement is switched off by configuration. The oldest has been approved for eleven days.
Answered from the same claim records the finance team works in — and only the ones this user may read
BUILT ON THE PLATFORM
Add fields without codeChange forms in the studioAutomate approvalsPromote changes with undo
Explore the platform →
RELATEDRewards →Service →Sales →

See xMatix on your business.

A 30-minute demo, tailored to your industry.

Request a demo