Work Order Import

Create an inbox and choose its email address, platform and parser

3 min read Work Order Import

Properties is the first page of an inbox. It names the inbox, chooses the platform it imports to, sets the email address work orders are sent to, and picks the parser that reads them. An inbox has one platform and one parser.

Before you start

  • A credential has to be chosen for the platform. See Simpro credentials or Fergus credentials.
  • A parser has to exist for that platform. See Document parsers.
  • The account needs room for another inbox. Create Inbox is greyed out with "Inbox limits reached" when the plan's limit is used. See Inboxes.

Step by step

  1. Open Work Order Import, then Inbox, then Create Inbox.
  2. Under Imports to, choose Simpro or Fergus.
  3. Fill in Inbox Name - minimum 5 characters, and Notes - for internal use, not publicly displayed if you want a note.
  4. Type an Email alias and click Check alias. The page says "Email alias is available" or "Email alias is taken. Please enter a new alias."
  5. Choose the Parser. Only parsers that import to the same platform are listed.
  6. Click Save. The page says "Inbox saved."

A new inbox shows only Properties in the side menu. After the first save the other pages appear: Simpro Defaults or Fergus Defaults, Locations, Response Times (Simpro only), Conditions and Rules.

The platform is fixed

Imports to can only be chosen before the first save. After that the options are greyed out. An option is also greyed out, with "Not connected" and "Choose a credential under Settings first.", when that platform has no credential chosen.

Changing Imports to on a new inbox clears the parser, because a parser belongs to one platform too. To import the same work orders into the other platform, make a second inbox and a second parser.

Inbox type shows Email, which is the only type.

The email address

The address is the alias followed by @inbox.formpiece.net. With no alias the address is the inbox's ID, such as abc123@inbox.formpiece.net. Both work while the alias is set.

The Inbox list shows the address with a copy button, but only once the inbox is ready. That takes a parser and a customer: the Customer on Simpro Defaults, or on Fergus Defaults. A Fergus inbox whose parser makes enquiries needs no customer. Until then the row says "Parser not selected" or "No default customer" and shows no address.

Formpiece reads the first address in the To field of each email to find the inbox.

When it goes wrong

"Please select a Parser"

Save needs a parser. Create one under Parse first if the list is empty for this platform.

"Email alias is taken. Please enter in a different alias."

Another inbox, on any account, has the alias. Pick another. Saving checks it again.

Emails sent to the alias never arrive

Type the alias in lowercase. Formpiece looks the address up in lowercase and the alias is stored as you typed it, so an alias with capitals doesn't match.

I changed the alias and the old address stopped working

The old alias is no longer registered. The address made from the inbox's ID keeps working.

"Could not save inbox. Please try again."

The save failed and nothing changed.