6. Warranty & Asset Tracking
Purpose — The serial-numbered asset registry: warranty registration after delivery, "My Products," the serial lifecycle, claims, and the decisioning engine that says free-vs-paid at point of service. This is the spine the whole continuous-record principle hangs on.
Personas served
Customer, Technician, Service head, Dealer, Finance admin.
Key capabilities
- Warranty registration after delivery — by serial / QR / invoice; customer "My Products" view.
- IDs — internal UUID v7 + human-friendly short ID (
nanoid, base32, no ambiguous chars) for warranty cards / My Products (notes #10). - Serial lifecycle —
manufactured → dispatched → sold → registered → in-service → claim → EOL. - Warranty lookup / status — customer + agent.
- Claim workflow — customer/dealer/service raise → approval → repair/replace → cost recovery.
- Decisioning engine — given asset + date + coverage (warranty / extended / AMC), decide free vs paid and route to FSM.
- Extended warranty — upsellable product (sold via commerce).
- External assets — register non-our-brand units for cross-vendor paid service (FSM).
- Defect/failure analytics — which models fail, MTBF, batch recalls → BI.
Data owned
Mongo (Warranty): Asset (serial, owner, product ref, coverage, history[]), WarrantyRegistration, WarrantyClaim, ExternalAsset. Money for paid repairs → Finance (PG). See warranty-assets.
Events
- Emits:
warranty.registered,claim.created,claim.approved,claim.rejected,asset.eol. - Consumes:
serial.assigned(create asset),order.delivered(eligibility),installation.completed(start coverage),visit.completed(history).
APIs
POST /warranty/register(serial|qr|invoice),GET /warranty/lookup?serial=GET /me/products(customer assets),POST /warranty/claims,POST /warranty/claims/:id/decisionPOST /assets/externalGET /warranty/decision?assetId=&issue=→{ covered: bool, basis: 'warranty|extended|amc|none', payable }
Tenant-config knobs
Warranty period defaults per product family; extended-warranty SKUs; coverage rules; short-ID format; recall workflow toggle.
Dependencies
Orders (serials), FSM, Finance, CRM.
Open questions
- Warranty start = delivery vs installation/commissioning? (default: commissioning for installed goods, delivery otherwise — confirm per tenant.)
- Pro-rata vs full replacement policy per product family.