Claim valuation timeline

Heyrafiki records when each Claim fact became effective and when the system learned it. This bitemporal history separates service, report, adjudication, remittance and settlement lag, and makes an as-of financial view reproducible.

Business time

effective_at records when the underlying Care, decision or money fact took effect.

Knowledge time

recorded_at records when Heyrafiki received and persisted the fact.

Valuation time

valuation_at excludes every fact recorded after the stated cutoff.

A backdated adjustment first received on 2 August does not change what was known on 31 July. Re-run the same cutoff and the same ordered event history produces the same result.

One Claim, three clocks

The public fixture keeps policy reference and version, source authority, reason codes and bounded evidence references with every relevant transition. Person identity and clinical content remain outside the payer timeline.

Reproduce the as-of amount

For the synthetic fixture, all money is in integer KES minor units:

billed = payer_liability + patient_responsibility + adjustment
600000 = 450000 + 50000 + 100000

outstanding = payer_liability - observed_settlement
100000 = 450000 - 350000

Remittance remains payer advice. Settlement remains independent evidence of money movement. The timeline does not mark a Claim settled from an advice file alone.

Actuarial
Finance
Regulatory review
Engineering

Reconstruct reported Claim development by service, report, decision and settlement dates. Preserve zero-Claim exposure and define the cohort, valuation basis and treatment of reopened or reversed Claims before calculating a portfolio measure.

Inspect the public evidence

The synthetic valuation fixture, JSON Schema and conformance test live with the OpenAPI contract.

git clone https://github.com/heyrafiki/openapi.git
cd openapi
npm ci
npm run test:financial-controls

The check rejects future knowledge, invalid sequence, non-integer money, unbalanced adjudication and an outstanding amount that cannot be reproduced.

Actuarial boundary

This timeline supports analysis of reported Claims and reproducible outstanding observations. Portfolio reserve selection, IBNR, premium liability, capital, solvency, reinsurance and actuarial opinions remain with the insurer and its appointed actuarial authority.

The open fixture uses synthetic data. An approved Organization can test the same contract in the Sandbox, then define its production data mapping, valuation policy and control owners through the institutional review.

Continue with financial controls, the Assurance Graph and the acceptance test plan.

Payer workflows

Integration assurance

Business time

Knowledge time

Valuation time

One Claim, three clocks

Reproduce the as-of amount

Inspect the public evidence

Actuarial boundary

Business time

Knowledge time

Valuation time

​One Claim, three clocks

​Reproduce the as-of amount

​Inspect the public evidence

​Actuarial boundary

One Claim, three clocks

Reproduce the as-of amount

Inspect the public evidence

Actuarial boundary