Overview
A Quote represents the dynamically generated pricing and coverage details for an extended warranty plan when a user inquires about protection for a specific product variant or product category.
It serves as a core object in the warranty flow, allowing customers to view and select the most relevant protection plans at the point of sale.
🧩 How Quotes Are Generated#
Quotes can be generated in two ways:
🔹 For a Specific Product Variant#
Provides precise pricing and plan options tailored to the exact product configuration (e.g., brand, model, price).
Ideal for product detail pages or checkout flows
🔹 For a Product Category#
Returns a price range that reflects variability across products within the selected category (e.g., Televisions, Home Appliances).
Includes multiple tenure and coverage options
Helps users understand general cost and protection level
🌍 Geographic Sensitivity#
Quotes are region-aware and vary based on:
Country
Warranty pricing, tax, regulations, and coverage terms may differ by country.Province/State (within a Country)
Localized pricing or regulations may apply.
Example: California vs Texas, or Ontario vs Quebec.
📦 Quote & QuoteItem Structure#
Each quote is uniquely identified by a quoteId.
A quoteId may include multiple plan options, each represented by a unique quoteItemId.
Each quoteItemId includes:
Coverage Type – e.g., Accidental Damage, Breakdown, or both
Tenure – Duration of coverage (e.g., 12, 24, 36 months)
Price – Fixed cost (variant-level) or price range (category-level)
Deductible – Optional customer-paid portion per claim
Region – Country and, if applicable, province/state
Currency & Locale – Ensures accurate regional pricing
Terms & Conditions URL – Link to the full warranty policy
🚀 Usage#
Quotes enable both customers and merchant systems to:
Dynamically present warranty options based on user location and product context
Power product detail pages, modals, or embedded widgets with tailored protection plans
Drive upsell logic that reflects jurisdiction-specific compliance and pricing logic
