Work Order Import

Set the customer, job type and notes for new Fergus jobs

4 min read Work Order Import

Fergus Defaults chooses the Fergus customer that new jobs are made for, what kind of job it is and the note added to it. It only appears on a Fergus inbox. A job in Fergus needs a customer and a site, so the customer comes from here and the site from the work order.

Before you start

  • A Fergus credential has to be chosen. Without one the page says "Fergus is not connected" and the Save button is greyed out. See Fergus credentials.
  • The customer has to exist in Fergus already. Work Order Import never creates a Fergus customer.
  • Save the inbox with its parser first. The page changes with what the parser makes.

Step by step

  1. Open the inbox from Inbox, then Fergus Defaults.
  2. Search for the Customer. Type at least 3 characters.
  3. Choose the Job type, or set Draft quote valid for (days) if the parser makes quotes.
  4. Fill in the optional fields below.
  5. Click Save. The page says "Fergus defaults saved."
Field What it does
Customer The Fergus customer every job is made for, unless a condition names another.
Job type Quote, Estimate or Charge Up. Starts as Quote.
Draft quote valid for (days) Only for a parser that makes quotes. 7 to 180 days. Blank saves 30. A number outside the range is brought inside it when you save.
Title the first phase of each new job? Names the job's first phase. Hidden for a parser that makes quotes.
Phase title Appears once the tick box is on. Blank uses the job title.
Job notes - added as a note on the job Text added as a note on the job.

What the parser decides

The parser's Imports to setting decides which of these apply.

A parser that makes a job uses Customer, Job type, the phase fields and Job notes.

A parser that makes a quote creates a job of type Quote with a draft quote on it. Job type is not shown and is always Quote, whatever a condition says. Draft quote valid for (days) takes its place.

A parser that makes an enquiry uses only Job notes, which are added to the end of the enquiry's description. An enquiry has no customer, job type or phase. The page still lists them.

How it maps to Fergus

On this page In Fergus
Customer The job's customer (customerId)
Job type The job's type
Title the first phase Fergus makes a job's first phase itself. The import renames it with Phase title, or the job title when blank. If the job somehow has none, one is added.
Draft quote valid for (days) The draft quote's days valid. The quote gets one section named "Work order".
Job notes A note on the job, together with the work order's own notes and any site access note

The phase title is only used on a job the import has just created. It is not used when the work order matched an existing job.

Notes are only added when the job is created or updated. When an existing job is kept and only has files added, no note is written.

When it goes wrong

"Default Fergus customer not configured"

The inbox has no Customer, and no condition supplied one. The work order gets a Dashboard record with this error and nothing is created. A parser that makes enquiries doesn't need one. The Inbox list shows "No default customer" on the inbox until one is saved.

The customer search finds nothing

The search needs 3 characters and runs against the account's Fergus credential. A customer that exists in a different Fergus company doesn't show.

The page shows a customer ID I don't recognise

The page shows "Customer" followed by the Fergus ID when it has no saved name for the customer. Choose the customer again.

The phase or note wasn't added

A phase is added only when Fergus accepts it. The job stands if Fergus refuses, and the reason is listed on the Dashboard record. It also appears in the not processed email, if you set one under Rules.