Skip to main content

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/decision
  • POST /assets/external
  • GET /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.