> ## 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.

# Service Request Wizard

> Create service requests step-by-step with our guided wizard

## Overview

The Creation Wizard is a combined setup flow that merges the Request Wizard and Work Order Wizard into a single guided process. It allows users to enter all relevant customer and service information once and decide how the record should be processed.

During creation, the user can choose one of the following outcomes:

* Create a **Request only**
* Create a **Request and a Quote**
* Create a **Request and a Work Order**

This enables flexible handling of service intake, commercial evaluation, and execution from a single entry point.

### **Behaviour Rules**

* If **Request + Quote** is selected, the Request status is automatically set to **Quote**
* If **Request + Work Order** is selected, the Request is automatically **closed**
* If only a Request is created, it remains open for further processing or later conversion

<Note>
  A **Service Request** is not yet a work order. It's a preliminary record that captures customer needs and can be converted into a work order when ready.
</Note>

## When to Use the Service Request Wizard

Use this wizard when:

* A customer calls or emails with a service inquiry
* You need to log a customer complaint
* You want to document a service need before scheduling
* You need to create a quote before proceeding
* You need approval before creating a full work order

## The Step Process

<Steps>
  <Step title="Customer Information" stepNumber={1}>
    Select the customer and location details
  </Step>

  <Step title="Overview" stepNumber={2}>
    Add service request details, dates, and priority
  </Step>

  <Step title="Details per task" stepNumber={3}>
    Add specific details or tasks to be performed
  </Step>

  <Step title="Summary" stepNumber={4}>
    Review and decide what shall happen after creation
  </Step>
</Steps>

***

## Step 1: Customer Information

<img src="https://mintcdn.com/fentu/C3pzkSBx7BqIrzJP/images/fentu-fsm/service-apps/wizards/service-request-wizard-step2.png?fit=max&auto=format&n=C3pzkSBx7BqIrzJP&q=85&s=98a562f520e2f60564a2ed6ea672b5b8" alt="Customer Information" width="1280" height="720" data-path="images/fentu-fsm/service-apps/wizards/service-request-wizard-step2.png" />

Enter or select customer and location information:

### Standard Fields

| Field                | Description                                          |
| -------------------- | ---------------------------------------------------- |
| **Customer**         | Search and select the customer requesting service    |
| **Contact**          | Select the primary contact person for this request   |
| **Location**         | Choose the customer location where service is needed |
| **Location Contact** | Create or select the contact onsite                  |

### Address Information

The wizard will auto-populate address fields based on the selected location. You can also manually enter:

* Street address
* City
* State/Province
* ZIP/Postal code

<Note>
  If the customer, contact or location is not in the system yet, you'll need to create them first using the "new" function within the Wizard.
</Note>

### Copy Address Feature

Click the **"Copy Address"** button to duplicate the building address if needed.

***

## Step 2: Overview

<img src="https://mintcdn.com/fentu/C3pzkSBx7BqIrzJP/images/fentu-fsm/service-apps/wizards/service-request-wizard-step3.png?fit=max&auto=format&n=C3pzkSBx7BqIrzJP&q=85&s=ec25fb243377dcd58b4d8606ec827631" alt="Service Request Details" width="1280" height="720" data-path="images/fentu-fsm/service-apps/wizards/service-request-wizard-step3.png" />

Add service request details and scheduling information:

### Service Information

| Field           | Description                                |
| --------------- | ------------------------------------------ |
| **Description** | Detailed description of the service needed |
| **Priority**    | Set priority level (High, Medium, Low)     |

### Scheduling

| Field                | Description                          |
| -------------------- | ------------------------------------ |
| **Planned Date**     | When the service should be performed |
| **Planned End Date** | Expected completion date/time        |
| **Is Fixed Date**    | Check if the date cannot be changed  |

### Service Object and Resources

In this step, you can also add:

<AccordionGroup>
  <Accordion title="Service Object" icon="barcode">
    Add equipment or assets that need servicing. You can select multiple service objects from the customer's  list.
  </Accordion>

  <Accordion title="Products" icon="box">
    Add products if this is an installation or delivery request.
  </Accordion>

  <Accordion title="Files" icon="file">
    Attach any relevant documents, photos, or files to the service request.
  </Accordion>
</AccordionGroup>

<Warning>
  At least one asset should be added before proceeding. If no assets are added, you'll receive a confirmation prompt asking if you want to continue without assets.
</Warning>

***

## Step 3: Complaint

<img src="https://mintcdn.com/fentu/C3pzkSBx7BqIrzJP/images/fentu-fsm/service-apps/wizards/service-request-wizard-step4.png?fit=max&auto=format&n=C3pzkSBx7BqIrzJP&q=85&s=a2971a266f7a36b963a1a762a8fed4da" alt="Task/Complaint Details" width="1280" height="720" data-path="images/fentu-fsm/service-apps/wizards/service-request-wizard-step4.png" />

Add specific complaints or tasks that need to be addressed:

### Adding Complaints

Click **"Add Complaint"** to create individual complaint records. For each complaint, you can specify:

| Field              | Description                                    |
| ------------------ | ---------------------------------------------- |
| **Name**           | Brief name/title for the complaint             |
| **Description**    | Detailed description of the issue              |
| **Service Object** | Which service object this complaint relates to |
| **Parts**          | Parts that may be needed to resolve this       |
| **Resources**      | Technicians or teams to assign                 |
| **Checklists**     | Quality or inspection checklists to use        |

<Tip>
  You can add multiple complaints to a single service request. This is useful when a customer has several issues to address.
</Tip>

### Validation

Each complaint must have:

* A unique name (cannot be empty)

***

## Step 4: Summary

<img src="https://mintcdn.com/fentu/C3pzkSBx7BqIrzJP/images/fentu-fsm/service-apps/wizards/service-request-wizard-step5.png?fit=max&auto=format&n=C3pzkSBx7BqIrzJP&q=85&s=ff5392d52680fcb38e9e3f000ae96202" alt="Service Request Summary" width="1280" height="720" data-path="images/fentu-fsm/service-apps/wizards/service-request-wizard-step5.png" />

Review all information before submitting:

### What You'll See

* Service request type
* Customer and contact information
* Location and address
* Planned dates and priority
* List of assets
* All complaints and tasks
* Attached files

### Actions Available

<CardGroup cols={3}>
  <Card title="Previous" icon="arrow-left">
    Go back to edit any step
  </Card>

  <Card title="Submit" icon="check">
    Create the service request
  </Card>

  <Card title="Cancel" icon="xmark">
    Discard and return to list
  </Card>
</CardGroup>

### After Submission

Once you click **"Submit"**, the service request will be created and saved. You'll see:

<Steps>
  <Step title="Success Message">
    A confirmation that the service request was created successfully
  </Step>

  <Step title="Service Request ID">
    The system assigns a unique ID to the service request
  </Step>

  <Step title="Next Actions">
    Options to convert to work order or view the service request list
  </Step>
</Steps>

***

## Tips and Best Practices

<AccordionGroup>
  <Accordion title="Complete Customer Information First" icon="user">
    Make sure the customer, contacts, and buildings are set up in the system before starting the wizard. This saves time and ensures accurate data.
  </Accordion>

  <Accordion title="Add Service Objects Early" icon="barcode">
    Adding service object in Step 2 makes it easier to link complaints to specific service objects in Step 3.
  </Accordion>

  <Accordion title="Be Specific with Complaints" icon="clipboard-list">
    Write clear, detailed descriptions for each complaint. This helps technicians understand the issue before arriving on-site.
  </Accordion>

  <Accordion title="Attach Photos" icon="camera">
    If the customer sends photos of the issue, attach them in Step 3. Visual documentation helps with diagnosis and planning.
  </Accordion>

  <Accordion title="Set Realistic Dates" icon="calendar">
    Coordinate with the customer on dates before setting them as "Fixed Date" to avoid scheduling conflicts.
  </Accordion>
</AccordionGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="What's the difference between a Service Request and a Work Order?" icon="question">
    A **Service Request** is a preliminary record that captures customer needs. A **Work Order** is a confirmed job that's scheduled and assigned to technicians. Service requests must be converted to work orders before work can begin.
  </Accordion>

  <Accordion title="Can I edit a service request after submission?" icon="pen">
    Yes! Navigate to the Service Requests list, find your request, and click to edit. You can modify information before converting it to a work order.
  </Accordion>

  <Accordion title="Do I have to add complaints in the wizard?" icon="exclamation-triangle">
    No, complaints are optional. However, adding them provides more detail for technicians and helps with planning parts and resources.
  </Accordion>

  <Accordion title="What happens if I don't add any service objects?" icon="box-open">
    You'll receive a warning prompt. You can choose to continue without service objects, but it's recommended to add them for better tracking and service history.
  </Accordion>

  <Accordion title="Can I create multiple service requests at once?" icon="copy">
    The wizard creates one service request at a time. For bulk creation, you may want to use the Import feature under System Administration.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Work Order Wizard" icon="wand-magic-sparkles" href="/service-apps/wizards/work-order-wizard">
    Create work orders or convert Service Requests
  </Card>

  <Card title="Customer Management" icon="users" href="/customers/overview">
    Learn how to manage customer, contact and relted records
  </Card>

  <Card title="Service Object Management" icon="barcode" href="/customers/assets">
    Understand  tracking and maintenance
  </Card>

  <Card title="Service Requests List" icon="list" href="/service-management/service-requests">
    View and manage all service requests
  </Card>
</CardGroup>
