Skip to main content

Project Configurations

Understanding Projects in Viaesys

A Project is the operational stage of work that begins after an Estimate has been approved by a customer and formally converted.

While an Estimate represents a proposal, a Project represents active, ongoing work. Projects contain the scheduling, ticketing, costing, and billing information needed to carry out, manage, and track work through completion.

At the project level, teams can manage:

Area

What It Controls

Service Groups

The services, materials, and equipment included in the work

Tickets

Individual scheduled or unscheduled job visits

Scopes

Preplanned work without fixed dates

Scheduling

When job tickets should occur

JobTrack Activity

Field user job starts, submissions, materials, and equipment usage

Contract Invoices

Billing schedules and contract invoice setup

Actual Costs

Labor, material, and equipment costs captured from completed work


Estimate vs. Project

Estimate

Project

A proposal sent to the customer

Active work after approval

Used to calculate pricing, quantities, and visits

Used to schedule, complete, cost, and bill work

Contains estimated labor, materials, equipment, and contract pricing

Contains tickets, scopes, actual job data, invoices, and project-level costs

Must be approved before conversion

Created after an approved estimate is converted

Key idea: Estimates help you sell the work. Projects help you execute and track the work.


Converting an Estimate to a Project

Prerequisites

Before converting an estimate into a project, make sure the following conditions are met:

  1. The estimate must be in an Approved status, or in a custom status where Convert to Project is enabled.

  2. The project start and end dates should be reviewed and confirmed before conversion.

Note: By default, only the Approved estimate status allows conversion to a project. Each organization can customize its estimate status list by adding, renaming, archiving, or configuring statuses that permit conversion.


Initiating the Conversion

Once the estimate is in an approved status, the Convert to Project button becomes available.

Clicking Convert to Project opens a configuration dialog where you can review and confirm important project settings before the project is created.


Conversion Settings

Project Dates

Review and confirm the project start date and end date.

These dates determine the active window for the project and are especially important for automatic project association.

Important: Project dates control whether jobs started from the field can automatically link to the project.


Tax Codes

You can optionally assign:

Tax Code Field

Purpose

Default Tax Code

Applies the standard tax code to the project

Exempt Tax Code

Used when certain items or customers are tax exempt

If your organization does not use tax codes, these fields can be ignored.


Scheduling Options

For each service group in the estimate, choose how the system should create work items.

Option

What It Does

Best Used For

Do Not Schedule

No tickets or scopes are created automatically

Work that will be configured manually later

Tickets

Creates individual job tickets based on the estimated number of visits

Regular recurring work with fixed or expected visits

Scope

Creates a reusable scope instead of individual tickets

Seasonal, unpredictable, or unscheduled work


Tickets vs. Scopes

Tickets

Scopes

Represent individual job visits

Represent planned work without fixed dates

Can be scheduled on specific dates

Have a set number of visits but no set schedule

Field users can complete them in JobTrack once scheduled and assigned

Can later be converted into tickets

Best for recurring or date-based work

Best for flexible or seasonal work

Example:
Use Tickets for recurring lawn maintenance.


Use Scopes for spring cleanup, fall cleanup, or snow and ice removal where exact dates may depend on weather or site conditions.


Assigning Users

If you already know which field user will perform the work, you can assign them during conversion.

You can also assign users later at the individual ticket level.


Contract Invoices

If the estimate includes a contract, you can set up the billing schedule during conversion.

Field

Description

Total Contract Amount

Pulled automatically from the estimate

Number of Invoices

Number of billing installments

Billing Frequency

Monthly, bi-monthly, weekly, or bi-weekly

Start Date

First billing date

Contract Service

Optional QuickBooks service code for accounting integration

Example

If a six-month seasonal contract is billed monthly, you may enter:

Setting

Example

Number of Invoices

6

Billing Frequency

Monthly

Start Date

May 1

The system will automatically generate the billing date series.

Note: Billing dates are independent of project dates.
A project may end on October 31 while billing continues into November or later. This is similar to completing work and invoicing the customer the following week.


Quantity Adjustment Factors

When estimating, quantities are often set on the higher side to avoid underestimating material or labor needs.

The adjustment factor allows the system to scale down estimated quantities when creating the project. This gives a more realistic cost picture while keeping the original proposal figure intact.

Example

If the estimate includes 75 bags of mulch per visit, but the team realistically expects to use fewer, the adjustment factor can reduce the quantity in the project without changing the original estimate presented to the customer.

Use this when:
You want the estimate to remain customer-facing and conservative, but want project costs to better reflect expected usage.


Project Structure After Conversion

After conversion, the project is organized into service groups.

Service Groups

Service groups contain the services, materials, and equipment that were defined in the original estimate.

If a field user adds materials or equipment during a job that were not originally included in the estimate, those items are automatically added to the project’s service group configuration.


Actions

Actions determine whether a service group will be managed through Tickets, Scopes, or both.

In the project view, each service group has an action represented by the blue gear icon. Services must be actioned in order to turn them into tickets or scopes.

Action Type

Result

Ticketed

Creates job tickets for individual visits

Scoped

Creates a scope for planned but unscheduled work

Both

Allows the service to support both workflows

Best practice: Although a service can support both tickets and scopes, it is usually better to choose the primary method that best matches the workflow.


Tickets

Tickets represent individual job visits.

After conversion, tickets may be created automatically, but they are initially unscheduled unless scheduling has been configured. Tickets must be scheduled before field users can see and act on them in JobTrack.

Key Ticket Properties

Ticket Property

Source

Estimated Hours

Copied from the estimate labor quantity

Estimated Man-Hours

Copied from the same estimate field

Materials

Pre-populated from the estimate

Equipment

Pre-populated from the estimate

Note: Because estimates do not have separate fields for “estimated hours” and “estimated man-hours,” both are set to the same value when tickets are created.

Example

If a visit requires 3 crew members working 4 hours each:

Field

Value

Estimated Duration

4 hours

Estimated Man-Hours

12 man-hours

Users can manually adjust estimated hours on individual tickets after conversion to better reflect crew size and job duration.


Scopes

Scopes are preplanned on a site but do not have scheduled dates.

Unlike tickets, scopes do not represent a specific job visit on a specific day. Instead, they represent a set number of visits or planned work that can be converted into tickets later.

Scopes can be converted to individual tickets at any time from the project view. Tickets can also be converted back into scopes if needed.


Scheduling Tickets

Accessing the Schedule Tool

To schedule tickets:

  1. From the portal, go to Scheduling.

  2. Open the Scheduling Calendar.

  3. Click the calendar icon on the right-hand side.

  4. Select the project you want to manage.

From the project scheduling view, click the three dots beside the service group.

You can then choose:

Option

Description

Schedule Unplanned Jobs

Schedules only jobs that do not currently have a planned date

Schedule All Jobs

Includes jobs whether or not they already have a planned date


Planned vs. Unplanned Jobs

Job Type

Description

Planned Job

Has a planned date assigned

Unplanned Job

Does not have a planned date assigned

On the scheduling board, planned jobs are marked with the letter P and show an associated date.


Scheduling Options

Weekly Scheduling

Use weekly scheduling when tickets should recur every week or on specific weeks.

Options include:

Option

Example

Specific day of the week

Every Wednesday

Multiple days per week

Monday and Thursday

Specific weeks of the month

First and third week only

Month exclusions

Skip June entirely


Monthly Scheduling

Use monthly scheduling when tickets should occur once per month.

Options include:

Option

Example

Week of the month

First week, second week, last week

Day of the week

First Monday, last Friday


Time Slots

Each day has 24 scheduling slots. A slot indicates the approximate time of day for the visit.

Some organizations may use exact time scheduling instead. In that case, users will see a time-of-day picker instead of slots.

Note: The time slot or exact time setting is controlled at the organization level.


Previewing the Schedule

Before confirming the schedule, use Preview to review the full list of scheduled dates.

This helps verify:

  • The correct days are selected.

  • The correct weeks are included.

  • Excluded months are skipped.

  • No unintended dates are created.

Important: The scheduler does not automatically account for holidays. Holidays must be manually excluded or adjusted.


JobTrack — Field User Experience

Ticket Visibility

Field users see assigned tickets in the JobTrack app under Jobs.

By default, users can see tickets for:

Visibility Window

Default Setting

Yesterday

Visible

Today

Visible

Tomorrow

Visible

This date range is an organization-wide setting. It can be configured to show only today or extended to show more days before or after the current date.

Why yesterday is visible:
The one-day-before grace period allows field users to complete a ticket that was deferred from the previous day without the office needing to manually reschedule it.


Site Visibility

Whether a field user can see all sites or only assigned sites is controlled by role-level permissions. Some organizations restrict site visibility to reduce errors and maintain tighter workflow control.

Contact a Viaesys representative if your organization needs to adjust this configuration.


Starting and Submitting a Job

When a field user opens a ticket in JobTrack, they can view:

  • Estimated hours and man-hours for the visit.

  • Site information.

  • Site documents.

  • Expected materials.

  • Expected equipment.

  • To begin work, the field user taps Start Job.

  • Once started, the ticket appears on the scheduling board in orange, indicating that the job is in progress.

  • When the work is complete, the field user submits the job.


Materials and Equipment in JobTrack

Materials and equipment configured on the ticket are automatically populated when the job is started.

Field users can:

Action

Description

Enter quantities used

Record actual material or equipment usage

Remove unused items

Remove items not used during the job, if enabled by role

Add new materials or equipment

Add items not originally listed, depending on role permissions


Restricting Materials and Equipment

Two role-level permissions control whether field users can add items outside the pre-configured list.

Permission

Effect

Restrict Materials

Users can only use materials already configured on the ticket

Restrict Equipment

Users can only use equipment already configured on the ticket

If these restrictions are enabled, field users cannot add materials or equipment outside the ticket’s predefined list.

If restrictions are not enabled, any new material or equipment added during the job is automatically added to the project’s service group configuration for future reference.

Best practice: If using material or equipment restrictions, make sure all expected items are configured before field users go out to the site.


Automatic Project Association

Jobs do not always need to originate from a pre-created ticket or scope.

A field user can start work manually by selecting a Site and tapping Start. The app then displays a list of available services for the field user to choose from.

When this happens, the system attempts to automatically associate the job with an active project.


How Automatic Project Association Works

The system looks for a project where:

Requirement

Description

Matching Service

The selected service is configured in a service group on the project

Active Project

The project is not disabled

Valid Date Range

The current date falls within the project start and end dates

If a matching active project is found, the job is automatically associated with that project.

Any new materials or equipment used during the job are also added to the project’s configuration.


Common Use Cases

1. Correcting a Missed Ticket

A job was completed, but the ticket was never created.

If the service, site, and project dates match, the system can still link the job to the correct project automatically.

2. Starting Work Before Full Setup

An organization may create a project and add services before tickets or scopes are fully scheduled.

Field users can begin work immediately, and the system will associate jobs with the active project as work is submitted.

Workflow benefit: Field teams can start work as soon as services are added to a project. The system organizes incoming job data and builds the project’s operational history without waiting for every ticket or scope to be manually scheduled first.


Tips and Best Practices

Best Practice

Why It Matters

Review project dates before conversion

Dates control automatic project association

Use scopes for seasonal or unpredictable work

Scopes are flexible and do not require fixed dates

Use tickets for recurring scheduled visits

Tickets are best for work with known schedules

Choose one primary action type when possible

Reduces confusion between tickets and scopes

Adjust estimated hours after conversion

Helps reflect realistic crew sizes and visit durations

Use scheduling preview before confirming

Helps catch skipped weeks, wrong dates, or month exclusions

Configure expected materials and equipment before dispatch

Especially important if restrictions are enabled

Use automatic project association for faster onboarding

Lets field teams start work while project setup continues


Recommended Workflow

For most organizations, the recommended project workflow is:

  1. Create and approve the estimate.

  2. Confirm project start and end dates.

  3. Convert the estimate to a project.

  4. Review service groups.

  5. Choose ticket or scope actions.

  6. Configure contract invoices if needed.

  7. Assign users where known.

  8. Schedule tickets or prepare scopes.

  9. Field users complete work in JobTrack.

  10. Review actual labor, material, equipment, and billing information at the project level.


Summary

Projects are where approved work becomes operational in Viaesys.

They connect the estimate, service groups, tickets, scopes, field activity, materials, equipment, costs, and billing into one active workspace.

Use Tickets when work needs to be scheduled as individual visits. Use Scopes when work is planned but does not yet have fixed dates. Use automatic project association to allow field users to begin work quickly while still keeping jobs linked to the correct active project.

Did this answer your question?