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

# Work Order Wizard 

> Create work orders directly or convert Requests and Quotes into execution-ready field service jobs

## Overview

The Work Order Wizard is used to create execution-ready Work Orders or convert existing Requests or Quotes into Work Orders.

It combines service intake context, optional commercial reference, and full execution setup in a single guided process.

Unlike the Request Wizard, a Work Order created here is immediately ready for dispatch and field execution.

***

## When to Use the Work Order Wizard

Use this wizard when:

* A Request has been qualified and is ready for execution
* A Quote has been approved and work can begin
* You want to create a Work Order directly without a Request step
* Emergency or urgent work must be dispatched immediately
* Scheduled or contract-based maintenance must be executed
* A Request needs to be converted into operational work

***

```mdx theme={null}
## Structure

Work Order
  └── Work Order Task
        ├── Service Object #1
        │     ├── Exchange Part / Equipment / Device
        │     ├── Checklist
        │     ├── Time
        │     └── Time & Material
        │
        ├── Service Object #2
        │     ├── Exchange Part / Equipment / Device
        │     ├── Checklist
        │     ├── Time
        │     └── Time & Material
        │
        ├── Material Request
        └── Service Appointment
```

## Execution

Information already filled on the Service Request or Quote will be auto filled on the Work Order Wizard.

### Step 1: Customer Information

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

Enter or select customer and location information:

### Customer Information

| Field        | Description                                                |
| ------------ | ---------------------------------------------------------- |
| **Customer** | Search and select the customer for this work order         |
| **Contact**  | Select the primary contact person at the customer location |
| **Location** | Choose the specific location where work will be performed  |

### Address Information

The system auto-populates address fields based on the selected building:

* **Street address** - Physical location of the work site
* **City** - City or municipality
* **State/Province** - State or provincial information
* **ZIP/Postal code** - Postal code for the location

### Branch Assignment

| Field      | Description                                                                                                          |
| ---------- | -------------------------------------------------------------------------------------------------------------------- |
| **Branch** | Select which company branch is responsible for this work order. This determines resource availability and reporting. |

<Note>
  The branch is typically pre-selected based on your user account, but can be changed if you manage multiple branches.
</Note>

### Copy Address Feature

Click **"Copy Address"** to duplicate the building address to other address fields if needed for delivery or billing purposes.

***

## Step 2: Work Order Details

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

Add detailed work order information, scheduling, and asset assignment:

### Work Order Information

| Field                   | Description                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------- |
| **Work Order Name**     | A descriptive name for quick identification                                        |
| **Description**         | Detailed description of the work to be performed                                   |
| **Priority**            | Set priority level: **High** (urgent), **Medium** (standard), or **Low** (routine) |
| **Special Information** | Any special notes, customer requirements, or important instructions                |

### Scheduling

| Field                | Description                                                 |
| -------------------- | ----------------------------------------------------------- |
| **Planned Date**     | When the work should start                                  |
| **Planned End Date** | Expected completion date/time                               |
| **Is Fixed Date**    | Check if this date cannot be changed (customer requirement) |
| **Is Fixed Price**   | Check if this is a fixed-price work order (from quotation)  |

<Warning>
  Setting **"Is Fixed Date"** prevents schedulers from changing the appointment without customer approval.
</Warning>

### Assets Selection

This is where you select which equipment or assets will be serviced:

<Steps>
  <Step title="Click 'Add Service Object'">
    Opens a modal to search and select service object
  </Step>

  <Step title="Search by ID or Serial Number">
    Find specific equipment from the customer's service object list
  </Step>

  <Step title="Select Multiple Service Objects">
    You can select multiple servcie objects for the same work order
  </Step>

  <Step title="View Service Object Details">
    See  history, last service date, and maintenance requirements
  </Step>
</Steps>

### Additional Options

<AccordionGroup>
  <Accordion title="Products" icon="box">
    Add products if this is an installation or delivery work order. Products are different from assets - they represent new equipment to be installed or delivered.
  </Accordion>

  <Accordion title="Files & Attachments" icon="paperclip">
    Attach documents, photos, schematics, customer emails, or any relevant files. These will be available to technicians in the field.
  </Accordion>

  <Accordion title="Service Contract Link" icon="link">
    Link this work order to an existing service contract if applicable. This will apply contract terms, pricing, and SLAs.
  </Accordion>
</AccordionGroup>

***

## Step 3: Assignment

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

Assign resources, vehicles, and tool needed for this work order:

<Tip>
  The system can suggest resources based on:

  * Required skills for the assets being serviced
  * Technician availability on the planned date
  * Geographic proximity to the work location
  * Previous work history with this customer
</Tip>

### Equipment & Materials

<AccordionGroup>
  <Accordion title="Tools" icon="wrench">
    Specify which tools are required for this work order. This helps with tool allocation and ensures technicians have what they need.
  </Accordion>

  <Accordion title="Vehicles" icon="truck">
    Assign company vehicles needed for transportation or mobile service units. The system checks vehicle availability.
  </Accordion>

  <Accordion title="Parts" icon="box-open">
    Pre-assign parts that are known to be needed. This helps with parts availability checking and material requests.
  </Accordion>
</AccordionGroup>

### Notification Options

<Info>
  When you assign resources, they automatically receive notifications via:

  * Email notification
  * In-app notification
  * Mobile app push notification (if using mobile app)

  Technicians can accept or reject the assignment.
</Info>

***

## Step 4: Task/Complaint

<img src="https://mintcdn.com/fentu/U6fCSxeDS0owwc1L/images/fentu-fsm/service-apps/wizards/work-order-wizard-step5.png?fit=max&auto=format&n=U6fCSxeDS0owwc1L&q=85&s=6390540b2dbcb81e61e3187a60c61328" alt="Task and Complaint Details" width="1280" height="720" data-path="images/fentu-fsm/service-apps/wizards/work-order-wizard-step5.png" />

Define specific tasks or address complaints within this work order:

### Understanding Tasks

**Tasks** are the individual work items that technicians will complete. Each task can have:

* Its own schedule
* Assigned technicians (subset of work order resources)
* Line items (specific assets being serviced)
* Checklists
* Parts and materials
* Time tracking

### Adding Tasks

Click **"Add Task"** to create task records:

| Field            | Description                                                           |
| ---------------- | --------------------------------------------------------------------- |
| **Task Name**    | Brief name for the task (e.g., "Annual Inspection", "Replace Filter") |
| **Description**  | Detailed description of what needs to be done                         |
| **Priority**     | Task-specific priority (can differ from work order priority)          |
| **Planned Date** | When this specific task should be performed                           |
| **Status**       | Initial status (typically "Open" or "Assigned")                       |

### Task Line Items

For each task, you can add **Line Items** which represent specific service object being serviced:

<Steps>
  <Step title="Select Service Objects">
    Choose which service object(s) this task is for (from work order service objects)
  </Step>

  <Step title="Define Work">
    Specify what work will be done on this service object
  </Step>

  <Step title="Add Checklists">
    Attach maintenance checklists that must be completed
  </Step>

  <Step title="Set Warranty">
    Indicate if work is under warranty, campaign, or paid
  </Step>
</Steps>

<Note>
  Multiple tasks can exist within a single work order. This allows you to organize complex jobs with different service requirements.
</Note>

***

## Step 5: Summary

<img src="https://mintcdn.com/fentu/U6fCSxeDS0owwc1L/images/fentu-fsm/service-apps/wizards/work-order-wizard-step6.png?fit=max&auto=format&n=U6fCSxeDS0owwc1L&q=85&s=8b772687bf31bebed130d1a8c2fddd02" alt="Work Order Summary" width="1280" height="720" data-path="images/fentu-fsm/service-apps/wizards/work-order-wizard-step6.png" />

Review all information before creating the work order:

### Summary Sections

The summary page displays:

<AccordionGroup>
  <Accordion title="Work Order Details" icon="clipboard">
    * Work order type and priority
    * Customer and location
    * Scheduled dates
    * Branch assignment
  </Accordion>

  <Accordion title="Service Object" icon="barcode">
    * List of all service objects to be serviced
    * IDs and serial numbers
    * Current  status
  </Accordion>

  <Accordion title="Assignments" icon="users">
    * Assigned technicians and teams
    * Required tools and vehicles
    * Pre-assigned parts
  </Accordion>

  <Accordion title="Tasks & Complaints" icon="list-check">
    * All tasks with their details
    * Task line items and checklists
    * Complaints to be addressed
  </Accordion>

  <Accordion title="Attachments" icon="paperclip">
    * All uploaded files and documents
  </Accordion>
</AccordionGroup>

### Actions Available

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

  <Card title="Submit" icon="check-circle">
    Create the work order and send notifications
  </Card>
</CardGroup>

### After Submission

Once you click **"Submit"**, the work order is created:

<Steps>
  <Step title="Work Order Created">
    The system generates a unique work order ID (e.g., M-24-00123 for Maintenance)
  </Step>

  <Step title="Notifications Sent">
    All assigned technicians receive assignment notifications
  </Step>

  <Step title="Tasks Generated">
    Tasks become visible in the Dispatcher and technician's task list
  </Step>

  <Step title="Status Set to 'Assigned'">
    The work order enters the active workflow
  </Step>

  <Step title="Confirmation Displayed">
    You receive a success message with the work order ID, the Material Request is automatically generated
  </Step>
</Steps>

***

## Work Order ID Format

Work orders are automatically numbered based on their type:

The format is: `{Type}-{Year}-{Sequential Number}`

***

## Next Steps After Creation

After creating a work order, you can:

<CardGroup cols={2}>
  <Card title="View in Dispatcher" icon="calendar" href="/service-apps/dispatcher">
    See the work order on the dispatch board for scheduling and management
  </Card>

  <Card title="Manage Tasks" icon="list-check" href="/work-orders/tasks">
    Monitor task progress and technician updates
  </Card>

  <Card title="Review Material Request" icon="box" href="/work-orders/material-requests">
    Request additional parts from the warehouse
  </Card>
</CardGroup>

***

## Tips and Best Practices

<AccordionGroup>
  <Accordion title="Prepare Customer Information First" icon="user-check">
    Ensure customers, contacts, buildings, and assets are set up in the system before starting the wizard. This makes work order creation much faster.
  </Accordion>

  <Accordion title="Use Service Contracts When Possible" icon="file-contract">
    Link work orders to service contracts to automatically apply terms, pricing, and SLAs. This ensures consistency and reduces errors.
  </Accordion>

  <Accordion title="Be Specific with Task Descriptions" icon="file-lines">
    Clear, detailed task descriptions help technicians prepare properly and reduce callbacks. Include reference numbers, part codes, or specific procedures.
  </Accordion>

  <Accordion title="Assign Based on Skills" icon="award">
    Check asset requirements and assign technicians with matching skills. The system can help suggest qualified resources.
  </Accordion>

  <Accordion title="Attach Reference Documents" icon="file-pdf">
    Include schematics, manuals, previous service reports, or customer emails. Technicians can access these in the field.
  </Accordion>

  <Accordion title="Communicate Special Requirements" icon="comment">
    Use the "Special Information" field for important details like site access instructions, safety requirements, or customer preferences.
  </Accordion>

  <Accordion title="Set Realistic Dates" icon="calendar-check">
    Consider technician availability, travel time, and work complexity when setting planned dates. Check the Dispatcher view before committing to dates.
  </Accordion>

  <Accordion title="Review Before Submitting" icon="magnifying-glass">
    The summary step is your last chance to catch errors. Review all sections carefully before clicking Submit.
  </Accordion>
</AccordionGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="What's the difference between a Work Order and a Service Request?" icon="question">
    A **Work Order** is a confirmed job ready for execution. A **Service Request** is a preliminary record that captures customer needs but requires conversion to a work order before work can begin. Use the Work Order Wizard when you're ready to dispatch immediately.
  </Accordion>

  <Accordion title="Can I edit a work order after creation?" icon="pen">
    Yes! Navigate to the Work Orders list, find your work order, and click to edit. You can modify most fields, reassign resources, add tasks, or update details before work begins.
  </Accordion>

  <Accordion title="Do I have to assign resources immediately?" icon="user-plus">
    No, you can create a work order without assignments and assign resources later via the Dispatcher. However, assigning during creation sends immediate notifications and reserves technician time.
  </Accordion>

  <Accordion title="Can I assign multiple technicians to one task?" icon="users">
    Yes! Tasks support multiple resource assignments. This is useful for complex jobs requiring different specialties or when work requires a team.
  </Accordion>

  <Accordion title="What happens if a technician rejects the assignment?" icon="user-xmark">
    You'll receive a notification, and the task status updates to show the rejection. You can then reassign to a different technician or discuss scheduling with the original assignee.
  </Accordion>

  <Accordion title="Can I create recurring work orders?" icon="rotate">
    Recurring work orders are best created via Service Contracts with scheduled maintenance. The contract automatically generates work order drafts that can be converted.
  </Accordion>

  <Accordion title="How do I handle emergency work orders?" icon="siren">
    Set priority to "High", mark as "Fixed Date" if time-critical, and assign available technicians immediately. You can also use fast-track workflows if configured.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Service Request Wizard" icon="square-plus" href="/service-apps/wizards/service-request-wizard">
    Create service requests that can be converted to work orders later
  </Card>

  <Card title="Dispatcher" icon="calendar-days" href="/service-apps/dispatcher">
    Schedule and manage work orders and tasks
  </Card>

  <Card title="Work Order Statuses" icon="traffic-light" href="/work-orders/work-orders">
    Understand the work order lifecycle and status changes
  </Card>

  <Card title="Task Management" icon="list-check" href="/work-orders/tasks">
    Learn how to manage and track tasks within work orders
  </Card>
</CardGroup>

```text theme={null}
```
