Set up Work Order Import and send your first work order
Work Order Import turns a work order that arrives by email into a record in Simpro or Fergus. You forward the email to an address Formpiece gives you, a document parser reads it, and the result is written to your account and listed on the Dashboard.
How an email becomes a record
- The email reaches an inbox. Each inbox has its own address, which ends in
@inbox.formpiece.net. Formpiece reads the first address in the To field and looks for the inbox it belongs to. An address that matches no inbox is dropped and nothing shows on the Dashboard. - The inbox checks the email. If the inbox has subject text or sender addresses set under Rules, an email that doesn't match is recorded as skipped and goes no further. It is not metered. See Inboxes.
- The parser reads it. An inbox has one document parser. A PDF parser reads every PDF attached to the email, one work order per PDF. An email parser reads the body of the email. A parser's guard rules can skip a PDF that isn't a work order. See Document parsers.
- Rules and defaults fill in the rest. What the parser read is combined with the inbox's Simpro Defaults or Fergus Defaults, its Locations (which match text in the site address to a site), its Conditions (which replace some defaults when the order number, project name or description matches) and its Rules.
- The record is written. A Simpro inbox creates a job or a quote. A Fergus inbox creates a job, a quote (a Quote job with a draft quote on it) or an enquiry. What the parser creates is chosen on the parser.
- The Dashboard shows the outcome. Every email gets a record with the Simpro or Fergus IDs it made, the fields that were read, and any errors. See Read the Dashboard.
Each inbox and each parser writes to one platform, Simpro or Fergus. You choose it when you create the inbox or parser and it can't be changed afterwards. An inbox only offers parsers for its own platform.
Before you start
- A Work Order Import subscription. Without one the Dashboard shows "A subscription is required before you can use Work Order Import." and Create Inbox and Create Document Parser are greyed out.
- A credential for the platform you import to. See Simpro credentials and Fergus credentials, or Connect Simpro and Connect Fergus.
- A real work order, as a PDF or an email, to build the parser from.
Step by step
- Open Work Order Import, then Settings. Choose the credential under Simpro Credentials or Fergus Credentials. Until you do, the Dashboard says "Connect your Simpro or Fergus integration before importing emails."
- Open Parse and click Create Document Parser. Choose the document type, the platform and what it creates, then upload your work order and set up its rules.
- Open Inbox and click Create Inbox. Choose the platform, name the inbox, set an Email alias and pick the parser. Click Save.
- Open the inbox's Simpro Defaults or Fergus Defaults and set the customer. The inbox isn't ready until you do, and its email address isn't shown on the Inbox list until then. A Fergus inbox whose parser creates enquiries needs no customer.
- Add Locations, Conditions, Response Times (Simpro only) and Rules if your work orders need them.
- Copy the address from the Inbox list and forward a work order to it.
- Open the Dashboard. The email appears within a few moments, with "Email still processing" until it finishes.
When it goes wrong
The email never shows on the Dashboard
Formpiece only reads the first address in the To field. An inbox address in Cc, Bcc or second in To isn't found. An address with the wrong alias gives the same result, and so does an archived inbox, because archiving takes its address out of use.
The record says Error
Open it and read the message on the Results tab. Read the Dashboard lists the common ones.
Changing the Simpro credential cleared my settings
The Simpro Credentials page warns that changing the credential resets all import settings, and that only one Simpro account can be connected.