On this page
Work Order Management
From your Admin Portal, it’s easy to view, edit, create and assign work orders. In this article, you will learn how to manage all facets of Work Orders within VTS Rise
Approving Work Orders
If Property Admin/ Staff approval is configured at your property, work orders must be approved prior to being worked on by your staff.
From the Admin Portal, select Operations from the side menu, then select Work Orders.
This view will show all current and past work orders. Select the three action dots next to the work order you wish to either Approve or Decline.
If approved, this will change the status from Pending Approval to To be Started. If declined, the status will become Closed.
|To learn how staff can manage work orders, check out this article!|
Accept, Complete, Close, or Reopen a Work Order
As a Property Admin, you have the ability to Accept, Complete, Close, or Reopen work orders.
- Accept: This will assign the work order to you, as the Property Admin. This is available when a work order is in the status of To be Started.
- Complete: If Complete (an additional status step between In Progress and Closed) is part of your property's workflow, this will be an option when a work order is in the status of In Progress.
- Close: This will close the work order. This is available when a work order is in the status of In Progress or Complete.
- Reopen: If the work order is in the status of Closed, but needs to be reopened, select Reopen in the drop-down.
Select Operations from the side menu, then select Work Orders.
There are two ways to accept, complete, close, or reopen a work order.
- Select the service number of the work order you wish to edit; this will provide more details about that specific work order. Once open, select Accept, Complete, Close, or Reopen.
- Select the three dots to the far right of the work order you wish to change the status of. Select Accept, Complete, Close, or Reopen in the drop-down.
Adding Work Order Charge to Ledger
After a work order has been closed, Property Admins can add the charge to the ledger if they are utilizing VTS Rise's payment feature.
Select the work order you wish to add to the ledger. Select More in the upper corner, then Add To Ledger in the drop-down.
This will change the status from Unbilled to Billed and will add the charge to the ledger. The charge can be located under Advanced > Charges.
Marking Work Order as Billed
If a property has elected to not track work orders on the ledger using VTS Rise, they will have the option of marking the work order as billed manually.
|Note: If Do you want to track charges for Work Orders on Ledger? is enabled, this option will not be possible.|
Select the work order you wish to mark as billed. Select More in the upper corner, then Mark as Billed in the drop-down.
This will change the status from Unbilled to Billed.
Create a Work Order on Behalf of an Occupant
Select Operations located in the side menu. Select Work Orders.
Select Create Work Order. Select the type of work order you would like to create: Normal or Emergency.
Below is the workflow for creating a Normal work order. Follow the prompts to enter the work order details. Select Submit when complete.
- Tenant: Tenant requesting work order.
- Category: Select the category of the work order.
- Problem: Problems under the selected category will appear. Select the applicable problem.
- Location: Enter the location of the work order.
- Equipment Category: Select the applicable equipment category if utilizing equipment in the work order.
- Equipment: Based on the selected Equipment Category, select relevant equipment.
- Assigned To: If you are preemptively assigning the work order, select the Assignment Group or Individual Staff to assign out.
- Charge Code: Select charge code if applicable.
- Is Occupant facing?: If Yes, it will alert the selected occupant of status changes and appear in both their app and web portal. If No, it will be only visible to admins and staff.
- Select Occupant to Notify: If selected Yes above, select the occupant you wish to create on behalf of.
- Does Occupant need quote?: Select the checkbox if the occupant requires a quote.
- Does Staff have permission to enter?: Select the checkbox if staff has permission to enter the tenant space.
- Entry Note: Any notes about staff entry if applicable.
- Description: Describe the issue and what needs to be fixed for the work order.
- Upload attachments: Optional to upload images of the work order for added context to staff.
Subtenant Work Orders
When a Tenant's primary relationship is with another Tenant at the property, Subtenants can be used. Tenants can be designated as Subtenants allowing for a workflow of both requiring the Main Tenant to approve work orders as well as charging work orders to the Main Tenant.
|Check out this article on How to Add Subtenants!|
If Require main tenant to approve work orders? is enabled, work orders created by the subtenant will be put in a new Pending tenant approval status. The below image is a work order in the tenant portal submitted by a Subtenant.
Tenant Main Contacts of the main tenant with the Work Order Approver role, will be notified of the work order and are able to approve or reject the work order.
|Note: Property Admins and Staff won't be notified of or shown the created work order until it has been approved by the main tenant. If a work order is rejected by the main tenant, it will be as if property has rejected the work order. The work order will be closed and marked as rejected. The logs will record the main tenant occupant as the work order rejector.|
Once the work order has been approved by the main tenant, the normal workflow of the work order will be resumed respecting all of the work order settings and configuration.
Subtenants will be able to see their work order with the correct status.
Running a Work Order Report
Select Operations from the side menu, then select Work Orders.
To add additional data to the table, such as Created By or Closed Date, select the gear icon to the side.
Select all the additional table data you would like in the report and select Submit.
Filter your report using the Filters button at the top of the screen.
Add your custom filters and select Apply Filters.
- Tenant: If you are pulling a report on a specific tenant, you can select the tenant here.
- Status: Statuses include Pending Approval, To Be Started, In Progress, Closed, or Completed.
- Billing: Options include Billed or Unbilled.
- Type: Select if you are pulling a report for Normal work orders, Emergency work orders, or Preventive Maintenance.
- Category: If you wish to pull a report on a specific category, this can be filtered.
- Assigned To: Selecting an Assignment Group or Individual Staff will filter work orders assigned to them.
- Date Range: This will filter the report to the specified date range.
Export your report by selecting More and then selecting Export as CSV or Export as PDF.
Auto-Assigning Work Orders
Auto-assigning work orders to specific people or groups of people allows you to configure who gets a work order.
Select Operations from the side menu. Under Property Operations select Staff Assignments. Select Assignment Groups in the top navigation.
Select Add Assignment Group from the top of the screen. Create the group name and select the staff you would like to add to the group. Select Submit.
|Groups can be names of specialties such as plumbers, staff members by shift, or any other groupings of staff members you would like to assign work orders to.|
Assigning Work Order Group or Individuals to a Category
Select Operations from the side menu and select Work Order Configuration. Select Categories from the drop-down.
To edit an existing category: Select the three dots to the side of the category and select Edit Category. Under Assigned To, select the Assignment Group or Individual Staff member you would like to assign that category to.
To add an assignment when creating a new category, select Add Category at the top of the screen. Select the Assignment Group or Individual Staff you would like to assign to the new category and Submit.
Adding Staff Vacations
When you add staff vacations, work orders are re-assigned to a different staff member during that time frame.
Select Operations located in the side menu and then select Staff Management.
Locate the staff member for whom you would like to add vacation time and select the three dots to the far right of their name. Select Details.
Scroll down and select Vacations. Here you will be able to review upcoming and past vacations, as well as Add Vacation.
Enter the vacation time frame, select the backup staff member to have work orders re-routed to during the vacation time frame, and select Submit.
Work Order Configuration
Under Work Order Configuration, Property Admins can configure Custom Questions, Locations, Categories, Problems, Exceptions, and Escalation rules.
From the Admin Portal, select Operations then Work Order Configuration from the side menu. Select the drop-down to locate the feature you are looking to update.
Custom Questions can be added to collect more information on Work Orders.
To add a new Custom Question, select Custom Questions from the drop-down and then select Add Custom Questions in the upper corner.
Fill out the information about the Custom Question.
- Title: Name used for organization of custom questions.
- Categories: Select the Category or Categories the custom question will be applied to. Every time a work order is created under that category, the custom question will appear.
- Questions: Include any questions to be asked in work order creation.
- Add Question: Select if you need to add multiple questions to the selected category/categories.
- Question Text: Include the question to be asked in the work order.
- Select Type: Options for response type include Multiple Choice, Check Box, Paragraph (Text Area), Short Answer (Input), and Drop Down.
- Is Required: If this is a required question in order to create a work order, select Yes, otherwise No.
- Option Text: If the question is Multiple Choice, Check Box, or Drop Down, include options for selection. To add additional options, select the + sign under Option Text.
Select Submit when finished with the Custom Questions.
Locations help your staff get a better understanding of where work orders need to take place.
To view locations, select the drop-down from the top of the screen, and select Locations.
Select Add Location in the upper corner. Multiple locations can be added by selecting More and then Import from CSV.
|Tip: Download CSV Sample before importing the Location data.|
Selecting Add Location will open a pop-up for you to set up the location. Name the Location. Locations can be configured to be visible to selected tags.
Select Submit when complete.
Categories are used to help both your occupants and staff when creating or completing work orders. It aids in the organization of work order problems.
To view categories, select the drop-down from the top of the screen, and select Categories. All existing categories are viewable from this screen.
Select Add Category in the right corner.
A pop-up will appear. Complete the information.
- Name: Name of Work Order Category. This will be visible for occupants.
- Assigned to: This will auto-assign all work orders created under this category to a specific person or group.
- Charge Code: Include the charge code for the work order if applicable.
- Sales tax exempt: If the category should be sales tax exempt.
- Markup tax exempt: If the category should be markup tax exempt.
- Hide for Occupants: If the category should be hidden from occupants when creating a work order. If selected it will still be visible for admins and staff.
Select Submit when complete.
To view Problems, select the drop-down from the top of the screen, and select Problems. All existing problems are viewable from this screen.
To add a single problem, select Add Problem. Multiple problems can be added by selecting More and then Import from CSV.
|Tip: Download CSV Sample before importing the Problem data.|
This will open a pop-up for you to complete the Problem information.
- Name: Name of Problem. This will be visible to occupants and allow them to select their issue when creating a work order.
- Category: Problems must belong to a Category. Be sure the Category exists prior to creating a Problem.
- Hide for Occupants: If the Problem should be hidden from occupants when creating a work order. If selected it will still be visible for admins and staff.
Select Submit when complete.
Any preferential pricing for materials and labor that have been agreed upon per contract, can be set up by adding a new Exception in Work Order Configuration.
Select Exceptions in the drop-down menu.
Select Add Exception in the top right corner.
Next, select the Tenant, Exception Type, Rate, Tax, and Markup for the exception.
- Tenant: The tenant for which the exception applies.
- Exception Type: The exception type can be for either Materials or Labor.
- Rate: The new cost for either Materials or Labor.
- Tax: Any applicable Tax percentage.
- Markup: Any applicable Markup percentage.
Once the Exception Type is selected, select a Category and then the specific Material or Labor that you're applying the exception to. Enter the new rate. Finally, select Submit to save the Exception.
|To reset the rate to the original cost, select Refresh Rate.|
The exception pricing will be reflected when adding material to the work orders. Costs are automatically adjusted based on the exception price.
Exceptions for Categories
You can allow specific work order categories to be exempt from a tax or markup rate by applying an exception to the Category.
Select Categories from the dropdown menu.
Select Add Category in the top right corner.
Name your category and select the boxes for Sales tax exempt or Markup tax exempt or both, depending on which you'd like to make exempt. Finally, select Submit to apply the exception.
|Work orders created in the designated category will not be charged a Sales or Markup tax once the exception is created.|
Work Order Escalation Rules help prevent Work Orders from slipping through the cracks at a property. With Escalation Rules, you can set up notifications to notify Property Admins and Staff when a Work Order sits in a particular status for too long.
To view Escalation Rules, select the drop-down from the top of the screen, and select Escalation Rules. All existing Escalation Rules are viewable from this screen.
Select Add New Rule in the right corner.
Create the Escalation Rule. Select Submit when complete.
- Tenant: An escalation will be created for any work orders created by the selected tenant.
- Work Order Category: An escalation will be created for any work orders created for a specific work order category or group of categories.
- When a Work Order status is: The rule will apply to the status selected: Pending Approval, To be Started, or In Progress.
- For a duration of: The time at which the escalation will happen. This can be set by days or hours.
- Send an email notification to: Select who should be notified for escalation. Options include Property Managers, Individual Staff Users, Assignment Groups, and External Email Addresses.
- Send a push notification to: Push notifications can be sent to Individual Staff Users or Assignment Groups.
Work Order Equipment
Adding Work Order Equipment will be necessary for Preventive Maintenance, but can also be assigned by staff members to existing work orders.
Select Operations, then Equipment, followed by Equipment Categories.
Select Add Category from the top of the screen to add a new equipment category. (i.e HVAC)
If creating a new category, name the category and select Submit.
Add equipment to the category by selecting the three dots next to the work order category, and selecting Add Equipment. Enter the equipment information and select Submit to complete the action.
You can also add equipment by selecting Equipment from the top navigation, followed by Add Equipment. Enter the equipment information and select Submit to complete the action.
Work Order Labor
Select Operations, then select Staff Assignments and Labor Rates at the top of the screen.
Add new labor rates by selecting Add Labor Rate and entering the labor rate information. Select Submit to complete the action.
Edit an existing labor rate by selecting the three dots next to an existing labor rate and selecting Edit Labor.
Work Order Materials
If you are charging for parts and materials you will want to maintain an accurate parts and materials list for your staff to add to work orders. This also helps with keeping inventory. Once a Material is added to a work order, it will update the payment report for the work order to include the material cost.
|You can review these work orders using the Chargeable Work Orders Report under Advanced > Reports.|
Select Operations, then Materials, followed by Material Categories.
Add the material category by selecting Add Category from the top of the screen, entering the category name (i.e. Electrical), and select Submit to complete the action.
Edit an existing category by selecting the three dots next to the material category name and selecting Edit Category. This allows you to rename the category.
Add materials by selecting the three dots next to the category name and selecting Add Material. Enter the material information and select Submit to complete the action.
Materials can also be added to Material Categories by selecting Materials from the top column (next to Material Categories), followed by Add Material. Enter the material information and select Submit to complete the action.
- Category: Select the category of the material. The category must exist prior to adding new material.
- Name: Enter the name of the material.
- Unit Cost: If you are charging for material use in work orders, enter the cost per unit.
- Part Number: Include the part number for your records and inventory management.
- Manufacturer: Include the manufacturer of the material.
- Is Basic Tax Applicable?: Select Yes if basic tax is applicable.
- Is Mark Up Rate Applicable?: Select Yes if markup rate is applicable.
- Track Inventory: If you are tracking inventory, select Yes.
- Notes: Include any additional notes about the material.
Viewing Material Quantity
If you are utilizing the Track Inventory feature in Materials to keep track of material quantity, you are able to view remaining materials by selecting the three dots next to the tracked material, then selecting Open Material.
From the Material's details page, you are able to view the Inventory Quantity.
|Once a material gets low (ex. only 2 lightbulbs left and a staff member tries to add 5 lightbulbs to a work order), anyone with a Property Admin account receives an email notification that the material inventory is low or 0.|
Adding Option for Occupants to Request a Quote
With VTS Rise, you are able to add a field to ask if Occupants need a quote. This is then shown to Staff and Admins, allowing them to update the Estimate Report of the Work Order.
In the left navigation menu select Settings, then Work Orders.
Locate the setting, Quote Request and select the checkbox next to it. This will show a field to Occupants allowing them to select if they would like a quote for their work order. Select Save Changes when you are finished.
After an Occupant submits a work order requesting a quote, once accepted by the Property Admin or Staff, the Estimate Report will allow for the input of Labor and Materials.
The amounts will pull from preset pricing determined for both Labor and Material. Enter the applicable fields and select Save changes.
This will populate the Estimate Report and send the estimate to the occupant that requested the work order, allowing them to Approve or Reject the estimate.
Step 6 (Occupant approves)
If the occupant approves, the Estimate Report will be marked as Approved and you can continue with the Work Order.
Step 6 (Occupant rejects)
If the occupant rejects the Estimate Report, it will prompt you to edit and resend it for approval before continuing work.
|When using the quote workflow, a property will be unable to close a work order until the quote is approved. Property Admins and Staff can edit the work order to remove the quote and close the work order.|
|Note: There is the ability to take Estimate Reports offline and import signed copies of the report to the work order. If you are interested in this workflow for your property, please reach out to your contact at VTS Rise.|
Enhanced Billing for Work Orders
With an enhanced view of billing for work orders, you can have insight into the total amount due for Work Orders.
In the navigation menu select Settings, then Work Orders.
Under Configuration, located Enable enhanced billing workflow. Select the checkbox next to this setting.
Adding Labor and Materials will add their costs, related taxes, and applicable markup to the Payment Report of the Work Order. This totals all the costs and locks in the Amount Due, making that number trustworthy and removing the human error of manually creating the Amount Due. The breakdown of the payment report is also in the downloadable PDF that can be shared with the person creating the Work Order.
|The Payment Report Breakdown will also be visible in the Chargeable Work Orders Report.|
Reversing Work Order Charges
Once a work order is added to the ledger, Property Admins will be presented with the option to initiate a credit reversal.
This will insert a reverse of the original charge into the ledger to offset it. After a work order has been credited, it will be marked as Unbilled and can be reopened.
|VTS Rise does not handle the refund process.|
Select the closed work order you wish to reverse the charge on. Select More in the upper corner to open the drop-down. From the drop-down, select Reverse charge.
The work order is now marked as Unbilled and can be reopened.
The Credit Reversal can be seen under Advanced > Charges.
Work Order Comments
You are able to change if Users, Staff, and Property Managers can comment on work orders. Work Order Comments are public-facing, so all three parties can view comments and are notified when they are created.
To change if Work Order Comments are enabled, select Settings, then select Work Orders.
Locate Turn on comments under Configuration to find the corresponding checkbox. By having this enabled or disabled, properties are able to control if comments can be made by Staff, End Users, and Property Managers, or not.