SOFAR
Sign in

End-to-end warranty management

Sofar Warranty

Owns every Sofar unit's warranty lifecycle: registration, claim intake, extended-warranty purchase windows, regional warranty rules (DACH vs rest-of-EU), and automatic voiding when telemetry rules break. Plugs into Sofar CSP for case-driven warranty checks.

In build

What this module handles

  • Warranty registration — installer or end-customer registers a Sofar unit by serial number.
  • Claim intake — RMA / repair claims start here before they spawn CSP cases.
  • Extended-warranty purchase — the 6-month cliff after standard warranty expiry, the 5-year vs 10-year tiers, the regional DE/AT/CH carve-outs.
  • Telemetry-rule enforcement — auto-void on missed cell-firmware updates per the PowerMagic V2 warranty terms (cloud connection is a precondition, not opt-in).
  • Regional rules engine — Battery 80% SOH for DE/AT/CH vs 70% rest-of-EU; Poland 24/12-month extension windows; UK/IE 5+5 labour-vs-parts split.

Data model

WarrantyRecord
orgId, serialNumber, productId, customerId, registeredAt, tier (STANDARD / EXTENDED_5Y / EXTENDED_10Y / GOODWILL), expiresAt, voidedAt, voidReason
WarrantyClaim
warrantyRecordId, cspCaseId?, kind (REPAIR / REPLACE / REFUND), status, decidedById?
WarrantyPolicy
productFamily, region (EU / DE-AT-CH / PL / UK-IE / …), termYears, sohGuarantee, throughputCap, extensionWindow
WarrantyEvent
warrantyRecordId, actorId, event, fromValue, toValue, detail JSON

API surface

GET /api/warranty/:serialNumberPOST /api/warranty/registerPATCH /api/warranty/:idPOST /api/warranty/:id/claimPOST /api/warranty/:id/purchase-extensionPOST /api/warranty/:id/voidGET /api/warranty/policies

Workflow gates

  • Cloud connection precondition — if a unit is offline and misses a cell firmware update, the cell warranty is voided. (PowerMagic V2 Warranty §5.5.19.)
  • 6-month extension cliff— extended-warranty purchase blocked once standard warranty has <6 months remaining. (§2.4.)
  • SLA windows — PowerMagic 8×5 09:00–17:00 weekdays, travel time excluded from on-site SLA. (§5.4 + §6.1.)

Integrates with

  • Sofar CSP — case-driven warranty lookups + claim status sync.
  • Sofar Products — cross-reference SKU + product family for policy matching.
  • Sofar CLOUD — telemetry feed for cloud-connection rule enforcement.
  • Sofar Customers — customer-of-record + site address for registration.
  • Landray OA — corporate-side warranty exception approvals.

Integrates with

Sofar CSPSofar CustomersSofar ProductsSofar CLOUDLandray OA