- Documentation
- /
- Warranty
- /
- 00 — Overview
00 — Overview
R11 reference application. Built from the v0.14 Work & Supply reference pack. The demo data is fictional; terms and values are illustrative.
What Warranty & Recovery is
Warranty is deliberately separate from Work Management: Work records the failure, repair and removed component; Warranty decides whether an entitlement exists, whether the failure is eligible, whether to claim, and what was recovered. Finance (SAP AP) owns the credit memo.
The 8 models
Coverage (3) - WarrantyPolicy — a supplier's or manufacturer's warranty for a catalogue item / model. - CoverageTerm — the rule: calendar, usage, whichever first / last; months, hours; what starts the clock (installation, receipt …); excluded failure modes. - WarrantyEntitlement — one unit's cover: from when and what usage, to when and what usage.
Candidates & claims (3)
- WarrantyCandidate — a failure that might be covered: the unit, the work order, failure
mode, usage at failure (and where that number came from), eligibility and the reason.
- WarrantyClaim — the claim to the supplier: value, submission, response due, decision.
- ClaimUsageSnapshot — the claim's own copy of the exposure figures it was submitted with, per metric (the component's exposure, the unit's reading at removal and its date, whether a correction applied). Written once as the claim is submitted and never changed; if Lifecycle later revises the figures, revised_exposure shows the new one and revision_flag says revised after submission so the claim can be reviewed.
- WarrantyEvidence — what supports it: installation, usage, work history, photos, tests.
Recovery (2) - WarrantyRecovery — what the supplier gives back (credit, replacement, repair, labour …) and its state: approved → received / posted. - RepairCycle — a unit sent for repair / rebuild and its post-repair warranty.
The demo warranty
| Record | What |
|---|---|
| EHC-TX-24M | SUP-0042's transmission warranty: 24 months or 12 000 h, whichever first, from installation; contamination, misuse and impact damage excluded |
| WE-00001 | TX-793-00412, fitted 5 Nov 2024: cover to 5 Nov 2026 or 12 000 h |
| WC-00001 | its failure on WO-1001 (22 Sep 2026, 11 850 h, loss of drive) — eligible, not yet claimed |
| WE-00002 | TX-793-00388 on TRUCK-09 |
| WE-00003 | TX-793-00521, the reman unit, under SUP-0063's 12-month / 6 000 h rebuild warranty (from 9 500 h) |
python networks/work_supply/trigger.py warranty claims WC-00001 and follows the credit
through SAP AP.