Choose the Simpro credential Work Order Import uses
Work Order Import uses one Simpro credential for the whole account. Every Simpro inbox and Simpro parser reads and writes through it. The credential itself is made under Integration Credentials, the same way as for the other Simpro products. See Connecting Simpro with Formpiece. This page only chooses which one the import uses.
Before you start
Create the credential first. The Simpro Credential list and the Create new Simpro credential button only appear once the account has at least one Simpro credential. With none, the page shows its heading and nothing to click.
Step by step
- Open Work Order Import, then Settings, then Simpro Credentials.
- Choose the credential under Simpro Credential. The page then shows its Build URL. An API key (Advanced) credential also shows API Token, and both can be edited here. A login (Simple) credential shows the Build URL read only.
- Click Test Simpro credentials. The page says "Simpro API credentials are valid!" when Simpro returns at least one company, and "Simpro API credentials are NOT valid." when it returns none.
- Click Update Simpro credentials. The page says "Simpro credentials updated".
The test uses the credential as it is stored. If you change the Build URL or API Token on this page, click Update Simpro credentials first and test afterwards.
Editing the Build URL or API Token here changes the credential itself, so every Formpiece product that uses it picks up the change.
When it goes wrong
Work orders stop with "No Simpro credential has been chosen under Settings."
The account has no credential chosen here. The email still gets a record on the Dashboard, with that message as its status. Choose one and send the work order again.
"The Simpro credential chosen under Settings was not found."
The credential was deleted from Integration Credentials after it was chosen. Choose another.
"Work Order Import has no settings. Open Settings and connect Simpro."
Nothing has ever been saved on this page for the account.
I switched to a credential for a different Simpro build
The company, customer, status, staff, tags, sites and response times saved on your inboxes are Simpro IDs from the old build. Open Simpro Defaults, Locations, Response Times and Conditions on each Simpro inbox and choose them again. See Simpro defaults.