> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sibipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Offers Overview

> Accept and manage home warranty claims through customizable offers

Offers are the core mechanism for resolving home warranty claims, providing customers with replacement products,
upgrades, or buyout options.

## Benefits

* **Operational:** Automate claim processing, standardize workflows, and reduce manual work
* **Financial:** Generate upgrade revenue while reducing processing costs
* **Customer:** Provide clear options, quick resolutions, and transparent self-service choices

## Core Concepts

<CardGroup cols={2}>
  <Card title="Replacement Product" icon="box">
    Base product covered by warranty
  </Card>

  <Card title="Buyout" icon="money-bill">
    Cash settlement option for claim resolution
  </Card>

  <Card title="Upgrade" icon="arrow-up">
    Premium product available for additional cost
  </Card>

  <Card title="Difference Payment" icon="calculator">
    Amount customer pays for upgrade (upgrade price minus covered amount)
  </Card>

  <Card title="Add-On" icon="layer-group">
    Optional services or parts (e.g. Install, Disposal, recommended parts) bundled with the replacement at offer
    creation.
  </Card>

  <Card title="Curator" icon="user-tie">
    The role that prepares an offer — chooses the replacement, attaches add-ons, and may accept on the customer's
    behalf.
  </Card>
</CardGroup>

## Offer States

<Steps>
  <Step title="Pending">Initial offer creation **Next states:** - Generating Upgrades - Ready</Step>
  <Step title="Generating Upgrades">Computing upgrade options **Next states:** - Ready</Step>
  <Step title="Ready">Prepared to send to customer **Next states:** - Awaiting Customer - Canceled</Step>

  <Step title="Awaiting Customer">
    Sent to customer **Next states:** - Order Placed - Buyout Selected - Expired - Canceled
  </Step>
</Steps>

### Terminal States

<CardGroup cols={2}>
  <Card title="Order Placed" icon="check" color="#0D9373">
    Customer selected replacement product
  </Card>

  <Card title="Buyout Selected" icon="money-bill" color="#0D9373">
    Customer chose cash settlement
  </Card>

  <Card title="Canceled" icon="xmark" color="#dc3545">
    Offer terminated
  </Card>

  <Card title="Expired" icon="clock" color="#dc3545">
    Past validity period
  </Card>
</CardGroup>

## Customer Experience

<CardGroup cols={3}>
  <Card title="Accept Replacement" icon="box-check">
    Get your covered replacement product delivered and installed at no additional cost.
  </Card>

  <Card title="Choose Buyout" icon="money-check">
    Receive a cash settlement directly to handle the replacement yourself.
  </Card>

  <Card title="Select Upgrade" icon="arrow-up-right-dots">
    Choose an upgrade product and pay the difference between your coverage and the upgrade price.
  </Card>
</CardGroup>

## Next Steps

<Steps>
  <Step title="Review Documentation">Read through API reference and authentication requirements</Step>
  <Step title="Development">Set up test environment and create sample offers</Step>
  <Step title="Testing">Test customer experience and monitor metrics</Step>
  <Step title="Production">Go live with your integration</Step>
</Steps>