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

# Complaints

> Manage warranty claims and campaign work

## Overview

Complaints in Fentu FSM are warranty claims and manufacturer campaign work attached to service requests (Cases). They track warranty repairs, equipment recalls, manufacturer-mandated updates, and other work where costs are covered by manufacturers or held for customer decision.

<img src="https://mintcdn.com/fentu/U6fCSxeDS0owwc1L/images/fentu-fsm/service-management/complaints-list.png?fit=max&auto=format&n=U6fCSxeDS0owwc1L&q=85&s=72947fc6ae1b18faa0a18d277c2dfe0d" alt="Complaints List View" width="1280" height="720" data-path="images/fentu-fsm/service-management/complaints-list.png" />

<Note>
  Despite the name "Complaints," this module handles warranty work and campaigns, not customer service complaints. It tracks work where you're repairing equipment under manufacturer warranty or performing manufacturer-mandated recalls and updates.
</Note>

## When to Use Complaints

Create complaint records when you need to:

* Process warranty repairs covered by manufacturers
* Perform manufacturer recall or campaign work
* Track equipment warranty claims
* Handle work held pending customer decision (interest hold)
* Document warranty parts and labor
* Generate warranty claims to manufacturers
* Link warranty work to service requests

***

## Complaint Types

Fentu FSM supports four types of complaints:

| Type                   | When to Use                                                                        | Who Pays                   |
| ---------------------- | ---------------------------------------------------------------------------------- | -------------------------- |
| **Warranty**           | Repairs covered under manufacturer warranty                                        | Manufacturer               |
| **Campaign**           | Manufacturer recalls, safety updates, or mandated modifications                    | Manufacturer               |
| **Equipment Warranty** | Equipment-specific warranty claims (extended warranty, equipment protection plans) | Warranty provider          |
| **Interest Hold**      | Work requiring customer decision or approval before proceeding                     | Pending (customer decides) |

<Warning>
  "Complaint" is a technical term in FSM software for warranty/campaign work. It does NOT refer to customer service complaints or dissatisfaction issues.
</Warning>

***

## Complaints List View

### Key Features

<AccordionGroup>
  <Accordion title="Case Linkage" icon="link">
    Every complaint links to a Case (service request). The case is the customer-facing service request; the complaint is the underlying warranty claim.
  </Accordion>

  <Accordion title="Warranty Type Indicators" icon="shield-check">
    Quickly see whether work is warranty, campaign, equipment warranty, or interest hold.
  </Accordion>

  <Accordion title="Status Tracking" icon="circle-check">
    Track complaint status: Open (pending work), Quoted (estimated), or Closed (completed).
  </Accordion>

  <Accordion title="Job Numbers" icon="hashtag">
    Each complaint gets a unique job number for tracking warranty claims with manufacturers.
  </Accordion>
</AccordionGroup>

### List Columns

| Column            | Description                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------- |
| **Case**          | Service request this complaint is attached to (click to view case details)                  |
| **Name**          | Descriptive name: "Warranty Repair - Machine Compressor" or "Campaign Work - Safety Recall" |
| **Planned Date**  | When warranty work is scheduled                                                             |
| **Description**   | What's being repaired under warranty or campaign                                            |
| **Job Number**    | Unique identifier for warranty claim (WR-001, CP-002, etc.)                                 |
| **Customer**      | Which customer's equipment is being serviced                                                |
| **Warranty Type** | Warranty, Campaign, Equipment Warranty, or Interest Hold                                    |
| **Status**        | Open, Quoted, or Closed                                                                     |
| **Actions**       | View details, edit, attach assets/parts, close complaint                                    |

***

## Creating a Complaint

Complaints are typically created from service requests when you identify warranty-covered work:

<Steps>
  <Step title="Receive Service Request">
    Customer reports an issue through a Case (service request).
  </Step>

  <Step title="Diagnose Issue">
    Technician determines the problem and checks warranty coverage.
  </Step>

  <Step title="Create Complaint from Case">
    If work is covered by warranty or is a campaign, create a complaint attached to the case.
  </Step>

  <Step title="Select Complaint Type">
    Choose: Warranty, Campaign, Equipment Warranty, or Interest Hold.
  </Step>

  <Step title="Enter Complaint Details">
    Name, description, planned date, job number.
  </Step>

  <Step title="Link Assets">
    Attach the equipment being repaired under warranty.
  </Step>

  <Step title="Add Resources">
    Assign technicians to perform warranty work.
  </Step>

  <Step title="Link Parts">
    Add warranty parts being replaced.
  </Step>

  <Step title="Attach Checklists">
    Include manufacturer-required inspection checklists or procedures.
  </Step>

  <Step title="Save">
    Complaint is linked to case and ready for scheduling.
  </Step>
</Steps>

***

## Complaint Detail View

<img src="https://mintcdn.com/fentu/U6fCSxeDS0owwc1L/images/fentu-fsm/service-management/complaint-detail.png?fit=max&auto=format&n=U6fCSxeDS0owwc1L&q=85&s=5564987e8631e552790b89e2a59061d6" alt="Complaint Detail View" width="1280" height="720" data-path="images/fentu-fsm/service-management/complaint-detail.png" />

The complaint detail/edit page provides comprehensive tools for managing warranty claims:

### Detail View Sections

<AccordionGroup>
  <Accordion title="Complaint Information" icon="file">
    Core details including:

    * **Case** - Service request this complaint is attached to
    * **Name** - Descriptive name for the warranty claim
    * **Planned Date** - When work is scheduled
    * **Description** - Detailed explanation of the warranty issue
    * **Job Number** - Reference number for warranty claim
    * **Customer** - Which customer's equipment
    * **Warranty Type** - Warranty, Campaign, Equipment Warranty, or Interest Hold
    * **Status** - Open, Quoted, or Closed
  </Accordion>

  <Accordion title="Assets" icon="barcode">
    Equipment being repaired under warranty:

    * Asset name and type
    * Serial number
    * Warranty coverage details
    * Installation date (to verify warranty period)

    **Why this matters:** Need to prove equipment is under warranty. Serial numbers and purchase dates are essential for manufacturer warranty claims.
  </Accordion>

  <Accordion title="Resources (Technicians)" icon="user-gear">
    Technicians performing warranty work:

    * Technician name
    * Role in complaint resolution
    * Time spent (for warranty labor claims)

    **Labor Claims:** Track technician hours to submit labor reimbursement claims to manufacturers.
  </Accordion>

  <Accordion title="Parts" icon="wrench">
    Warranty parts being replaced:

    * Part number and description
    * Quantity
    * Asset the part belongs to
    * Whether part is warranty-covered

    **Parts Claims:** Document failed parts for warranty reimbursement from manufacturers. Keep failed parts for manufacturer inspection if required.
  </Accordion>

  <Accordion title="Checklists" icon="list-check">
    Manufacturer-required inspection procedures:

    * Pre-repair checklists
    * Post-repair verification
    * Campaign completion documentation
    * Safety inspection forms

    **Compliance:** Manufacturers often require specific procedures be followed and documented for warranty coverage.
  </Accordion>

  <Accordion title="Files/Attachments" icon="file">
    Supporting documentation:

    * Photos of failed parts
    * Warranty certificates
    * Purchase receipts
    * Manufacturer campaign bulletins
    * Inspection reports

    **Claim Support:** Documentation proves warranty coverage and supports reimbursement claims.
  </Accordion>
</AccordionGroup>

***

## Complaint Fields

### Basic Information

| Field            | Description                                                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------------------- |
| **Case**         | Service request this complaint is attached to. Required. Links to the Case (service request) module.          |
| **Name**         | Descriptive name for warranty claim. Be specific: "Warranty Repair - Compressor Failure" not just "Warranty". |
| **Planned Date** | When warranty work will be performed.                                                                         |
| **Description**  | Detailed explanation of what failed, symptoms, diagnosis, and what warranty covers.                           |
| **Job Number**   | Unique reference number. Used for tracking with manufacturers (WR-001, CP-002, EW-003, etc.).                 |
| **Customer**     | Which customer owns the equipment. Auto-populated from case.                                                  |

### Warranty Information

| Field                 | Description                                                                                                                                                                                                                                                             |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Warranty Type**     | Select type:<br />• **Warranty** - Standard manufacturer warranty<br />• **Campaign** - Manufacturer recall or mandated update<br />• **Equipment Warranty** - Extended warranty or equipment protection plan<br />• **Interest Hold** - Work pending customer decision |
| **Is Under Warranty** | Checkbox confirming warranty coverage verified.                                                                                                                                                                                                                         |
| **Status**            | Current state:<br />• **Open** - Complaint created, work pending<br />• **Quoted** - Estimate provided (if any customer portion)<br />• **Closed** - Work completed, claim submitted                                                                                    |

### Record Information

| Field             | Description                                    |
| ----------------- | ---------------------------------------------- |
| **Record Owner**  | Who's responsible for managing this complaint. |
| **Created By/At** | Who created the complaint and when.            |
| **Updated By/At** | Last modification details.                     |

***

## Understanding Complaint Types

### Warranty

Standard manufacturer warranty covering defects in materials or workmanship:

**Example Scenarios:**

* Compressor fails within warranty period
* Control board defect under manufacturer warranty
* Motor bearing failure covered by warranty

**Process:**

1. Verify equipment is within warranty period
2. Diagnose failure (must be covered defect, not abuse/neglect)
3. Create complaint and document issue
4. Obtain warranty parts from manufacturer
5. Complete repair and submit warranty claim
6. Get reimbursed for labor and parts

**Documentation Needed:**

* Serial number and purchase date
* Photos of failed part
* Diagnostic notes proving defect (not abuse)
* Repair completion documentation

### Campaign

Manufacturer-mandated recalls, safety updates, or modifications:

**Example Scenarios:**

* Safety recall for elevator components
* Manufacturer update to fix known issue
* Mandatory software update
* Product improvement campaign

**Process:**

1. Manufacturer issues campaign bulletin
2. Identify affected equipment at customers
3. Create complaints for all affected units
4. Schedule campaign work with customers
5. Complete modifications per manufacturer specs
6. Submit completion documentation to manufacturer
7. Get reimbursed per campaign terms

**Documentation Needed:**

* Campaign bulletin from manufacturer
* Before photos
* After photos
* Completion checklist
* Customer sign-off

### Equipment Warranty

Extended warranties or equipment protection plans beyond manufacturer warranty:

**Example Scenarios:**

* Extended warranty purchased with equipment
* Third-party equipment protection plan
* Service contract with equipment coverage

**Process:**

1. Verify coverage with warranty provider
2. Obtain claim authorization number
3. Create complaint and document issue
4. Complete repair
5. Submit claim to warranty provider
6. Get reimbursed per contract terms

**Documentation Needed:**

* Warranty contract or policy number
* Authorization/claim number from provider
* Detailed repair description
* Parts receipts
* Labor hours

### Interest Hold

Work identified but held pending customer decision or approval:

**Example Scenarios:**

* Repair not covered by warranty, awaiting customer approval
* Found additional issue during warranty work
* Customer requested delay for budget reasons
* Pending parts availability or customer scheduling

**Process:**

1. Identify issue during service call
2. Create interest hold complaint
3. Provide quote to customer if not covered
4. Wait for customer decision
5. Convert to work order when approved or close if declined

**Documentation Needed:**

* Quote for customer approval
* Customer communication log
* Reason for hold

***

## Linking Complaints to Cases

The Case → Complaint relationship is fundamental:

**Case (Service Request):**

* Customer-facing record of the service request
* "My compressor isn't working"
* Tracks customer communication and satisfaction

**Complaint (Warranty Claim):**

* Internal record of warranty work
* "Compressor failure under warranty"
* Tracks warranty claim with manufacturer

**Why Separate:**

* Customer sees Case status ("we're working on it")
* You see Complaint details (warranty claim process)
* Keeps warranty admin separate from customer communication
* One case may generate multiple complaints (found multiple warranty issues)

***

## Complaint Actions

<CardGroup cols={2}>
  <Card title="View/Edit Details" icon="pen">
    Update complaint information, status, planned date, or description.
  </Card>

  <Card title="Add Assets" icon="barcode">
    Link equipment being repaired under warranty claim.
  </Card>

  <Card title="Assign Technicians" icon="user">
    Add resources (technicians) performing warranty work.
  </Card>

  <Card title="Add Parts" icon="wrench">
    Document warranty parts being replaced.
  </Card>

  <Card title="Attach Checklists" icon="list-check">
    Link manufacturer-required inspection procedures.
  </Card>

  <Card title="Upload Documentation" icon="file">
    Add photos, receipts, campaign bulletins, or warranty certificates.
  </Card>

  <Card title="Update Status" icon="circle-check">
    Move complaint through workflow: Open → Quoted → Closed.
  </Card>

  <Card title="View Linked Case" icon="arrow-right">
    Jump to the parent service request (case).
  </Card>
</CardGroup>

***

## Tips and Best Practices

<AccordionGroup>
  <Accordion title="Verify Warranty Before Creating Complaint" icon="shield-check">
    Check warranty coverage BEFORE creating complaint:

    * Is equipment within warranty period?
    * Is the issue a covered defect?
    * Are there any warranty exclusions?
    * Do you have proof of purchase?

    Creating warranty complaints for non-covered work wastes time and creates rejected claims.
  </Accordion>

  <Accordion title="Document Everything" icon="camera">
    Warranty claims live or die on documentation:

    * Photos of failed parts (multiple angles)
    * Serial number and model number photos
    * Diagnostic test results
    * Before and after photos
    * Customer sign-off

    More documentation = higher claim approval rate.
  </Accordion>

  <Accordion title="Track Warranty Parts Separately" icon="box">
    Keep warranty parts separate from regular inventory:

    * Use different part numbers or stock locations
    * Track warranty part costs separately
    * Store failed parts for manufacturer inspection
    * Don't throw away failed parts until claim is approved

    Manufacturers often require failed parts be returned or available for inspection.
  </Accordion>

  <Accordion title="Standardize Job Numbers" icon="hashtag">
    Use consistent job number format:

    * WR-#### for Warranty Repairs
    * CP-#### for Campaign work
    * EW-#### for Equipment Warranty
    * IH-#### for Interest Hold

    Standardized numbering makes tracking and reporting easier.
  </Accordion>

  <Accordion title="Submit Claims Promptly" icon="clock">
    Don't delay warranty claim submissions:

    * Submit within manufacturer timeframes (usually 30-90 days)
    * Late claims get rejected
    * Track submission deadlines
    * Follow up on pending claims

    Prompt submission maximizes reimbursement.
  </Accordion>

  <Accordion title="Know Manufacturer Requirements" icon="book">
    Each manufacturer has specific requirements:

    * Pre-authorization needed?
    * What documentation required?
    * How to obtain warranty parts?
    * Labor rate and time limits?
    * Where to submit claims?

    Keep manufacturer warranty guides accessible to technicians.
  </Accordion>

  <Accordion title="Track Warranty Claim Success Rate" icon="percent">
    Monitor warranty claim metrics:

    * Approval rate (target: 90%+)
    * Average reimbursement amount
    * Time to payment
    * Rejection reasons

    Low approval rates indicate documentation or process problems.
  </Accordion>

  <Accordion title="Use Interest Hold Strategically" icon="pause">
    Interest hold is for genuine holds, not procrastination:

    * Customer needs time to decide
    * Waiting for customer budget approval
    * Parts availability issue
    * Customer scheduling conflict

    Don't use interest hold for internal delays.
  </Accordion>
</AccordionGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="Why are warranty claims called 'Complaints'?" icon="question">
    "Complaint" is industry terminology in FSM software for warranty claims and manufacturer campaign work. The term comes from manufacturing where "complaints" refer to product defects reported back to manufacturers.

    This is NOT the same as customer service complaints or dissatisfaction issues.
  </Accordion>

  <Accordion title="Do I create a complaint for every warranty repair?" icon="question">
    **Yes**, if you're submitting a warranty claim to a manufacturer. Creating complaints allows you to:

    * Track warranty work separately from regular work
    * Document parts and labor for reimbursement
    * Monitor warranty claim success rates
    * Generate warranty reports

    If you're NOT claiming reimbursement (goodwill warranty work you're absorbing), you may skip creating a complaint and just note it in the work order.
  </Accordion>

  <Accordion title="What's the relationship between Cases and Complaints?" icon="question">
    **Case (Service Request)** = Customer-facing service request ("My equipment is broken")
    **Complaint** = Internal warranty claim attached to the case ("Compressor failure covered by warranty")

    One case can have multiple complaints if multiple warranty issues are found. Example:

    * **Case:** "Machine not working"
    * **Complaint 1:** Warranty - Compressor failure
    * **Complaint 2:** Warranty - Control board defect
  </Accordion>

  <Accordion title="How do I know if work qualifies for warranty?" icon="question">
    Check these criteria:

    1. **Within Warranty Period** - Check purchase date and warranty length
    2. **Covered Defect** - Failure due to defect, not abuse/neglect/wear
    3. **Proper Installation** - Equipment installed per manufacturer specs
    4. **Proper Maintenance** - Regular maintenance performed as required
    5. **No Unauthorized Modifications** - No changes that void warranty

    When in doubt, contact manufacturer warranty department before creating complaint.
  </Accordion>

  <Accordion title="What's a Campaign complaint?" icon="question">
    **Campaign** is manufacturer-initiated work:

    * Safety recalls
    * Product improvements for known issues
    * Mandatory updates or modifications
    * Field service bulletins

    Manufacturers contact you or customers directly about campaigns. You create campaign complaints to track completion and get reimbursed for campaign work.
  </Accordion>

  <Accordion title="How do I handle parts costs for warranty work?" icon="question">
    **Typical process:**

    1. **Contact manufacturer** for warranty parts
    2. Manufacturer ships parts at no charge (or credits your account)
    3. You use parts to complete repair
    4. Link parts to complaint
    5. Submit complaint with part documentation
    6. Get reimbursed for labor

    **If you must purchase parts:**

    * Keep receipts
    * Document why you couldn't get from manufacturer (emergency, not available, etc.)
    * Submit for reimbursement with claim
    * Approval not guaranteed if you didn't follow manufacturer process
  </Accordion>

  <Accordion title="What if warranty claim gets rejected?" icon="question">
    **Common rejection reasons:**

    * Insufficient documentation
    * Equipment out of warranty
    * Failure due to abuse/neglect (not defect)
    * Improper installation voided warranty
    * Claim submitted too late
    * Required pre-authorization not obtained

    **If rejected:**

    * Understand reason
    * Appeal if you believe rejection is wrong (provide additional documentation)
    * If upheld, charge customer for work (convert to regular billable work)
    * Learn from rejection to improve future claims
  </Accordion>

  <Accordion title="How do Interest Hold complaints work?" icon="question">
    **Interest Hold** is a holding status:

    **Scenario:** During warranty repair, you find additional non-warranty issue requiring \$500 in parts.

    **Process:**

    1. Create Interest Hold complaint for additional work
    2. Provide quote to customer
    3. Customer decides: approve, deny, or defer
    4. If approved: convert to work order and complete
    5. If denied: close interest hold, do warranty work only
    6. If deferred: keep open until customer ready

    **Why separate complaint?** Keeps warranty claim clean and documents that you identified additional work needing customer approval.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Service Requests" icon="bell" href="/service-management/service-requests">
    Complaints are created from service requests (Cases).
  </Card>

  <Card title="Work Orders" icon="clipboard-list" href="/work-orders/work-orders">
    Complaint work generates work orders for technician completion.
  </Card>

  <Card title="Assets" icon="barcode" href="/customers/assets">
    Link assets to complaints for warranty tracking.
  </Card>

  <Card title="Parts Inventory" icon="wrench" href="/inventory/parts">
    Track warranty parts separately in inventory.
  </Card>
</CardGroup>
