Work Order Import

Choose the Fergus credential Work Order Import uses

2 min read Work Order Import

Work Order Import uses one Fergus credential for the whole account, and every Fergus inbox uses it. The choice is kept with the Work Order Import settings. Fergus Booking Forms keep their own choice, so changing one does not change the other. The credential itself is made under Integrations, as described in Connecting Fergus with Formpiece.

Before you start

Create a Fergus credential first, either by logging in to Fergus (Simple) or with a Personal Access Token (Advanced). With none, the page says "No Fergus credential yet" and offers Create Fergus credential. When Fergus is not enabled on the account it says "Fergus is not available yet" and there is no button.

Step by step

  1. Open Work Order Import, then Settings, then Fergus Credentials.
  2. Choose the credential under Fergus Credential. A login credential also shows Connected as with the Fergus user's name and email.
  3. Click Test Fergus credentials. Formpiece asks Fergus who the credential belongs to. The page says "Fergus API credentials are valid!" or "Fergus API credentials are NOT valid."
  4. Click Update Fergus credential. The page says "Fergus credential updated".

Create new Fergus credential opens the credential form. When you come back, the new credential is in the list.

What changes when you swap or clear it

Clearing Fergus Credential and clicking Update Fergus credential saves no credential. Nothing checks the inboxes first. Each Fergus inbox then fails with "No Fergus credential has been chosen under Settings." and the email still gets a record on the Dashboard.

Swapping to a credential for a different Fergus company leaves the customer saved on Fergus Defaults, the sites on Locations and the customers on Conditions pointing at IDs that belong to the old company. Open each Fergus inbox and choose them again. See Fergus defaults.

A new inbox can only import to Fergus while a credential is chosen. Without one, the Fergus option on the inbox's Imports to setting is disabled and says "Not connected". See Inbox properties.

When it goes wrong

The credential lapsed

A credential from a login is renewed by the import when its token has lapsed. If Fergus refuses the renewal, the Dashboard record carries the reason from the credential. Reconnect it from Integrations. See Connecting Fergus with Formpiece.

"Your Fergus settings could not be loaded."

The page could not read the account's settings. Reload it.

"Could not update the Fergus credential."

The save failed. Nothing was changed.

The Update Fergus credential button is greyed out

There are no Fergus credentials on the account to choose from.