Turn on Geosearch and keep Simpro location data in sync
Geosearch lets a booking form use where your schedules and staff already are, to offer times based on distance and travel. Geosearch in the Simpro booking forms section turns it on for the account, keeps the Simpro data it needs up to date, and lists what has been looked up. Each form then chooses how to use it. See Form Geosearch.
Before you start
- A Geosearch enabled subscription. With no subscription the page says "Subscription required" and "Geosearch functionality is only available to Geosearch enabled plans." With a subscription that has no Geosearch, it says you will need to upgrade the Simpro booking form plan. Either way the page describes what Geosearch adds and links to the subscriptions.
- At least one booking form. Formpiece uses a form's Simpro company to create the Simpro webhook.
Step by step
Turn Geosearch on
- Open Geosearch, then Setup.
- Switch on Enable Geosearch? and click Save.
The page says "Geosearch settings updated." or "Could not update Geosearch settings." Turning it on creates a Simpro webhook in the background. Do not disable or delete it in Simpro.
Turning it on does not change any form. Each form has its own Geosearch options to switch on.
Turn Geosearch off
- Turn Geosearch off on every form first. The page lists the forms that still have it on, each linked to its Geosearch settings.
- Switch off Enable Geosearch? and click Save. The switch is locked while any form has Geosearch on.
Turning it off removes the webhook.
Check the data sync
Once Geosearch is on, Setup shows Simpro data sync status, and the tabs Setup, Locations and Usage appear.
- Simpro webhooks shows Active, Inactive, or "Simpro webhooks status has not been checked." Click Refresh Simpro webhooks to create or update the webhook again.
- Sync employees and Sync contractors send a request to refresh the location data Formpiece holds after you change employees in Simpro. Usage charges may apply.
Schedule data arrives by itself through the webhook. Employee and contractor data only updates when you click the sync buttons.
What the webhook listens for
The webhook is named "Formpiece Webhooks" in Simpro, with the description "Webhooks for Formpiece updates". It reports new jobs, job, quote, lead and activity schedules being created, updated or deleted, and employees being created, updated or deleted. Formpiece uses the schedule events to geocode the site of every scheduled visit.
If webhooks are off in Simpro, scheduled sites cannot be geocoded and there is nothing to look locations up against. The same webhook creates auth links automatically for new jobs.
Locations
Locations lists what Formpiece has looked up, under three sub tabs.
| Sub tab | What it lists |
|---|---|
| Sites | Every site that has had a geolookup. Every schedule saved in Simpro is checked for a site, and a new site or changed address gets a geolookup for its coordinates. |
| Employees | Employees who are part of a booking form, with the forms they are on. Their address is checked once. |
| Contractors | The same for contractors. |
Each row shows the Simpro ID, the address, the Geocoding date and View in Google Maps. Sites are newest first. A site or address that has already had a geolookup does not get another, so scheduling the same site again makes no new lookup. See Geosearch usage.
When it goes wrong
Simpro webhooks show Inactive
Click Refresh Simpro webhooks. If it stays inactive, check that the "Formpiece Webhooks" webhook still exists and is enabled in Simpro.
Geosearch only describes what it does
The account has no Geosearch plan, so Setup, Locations and Usage are not available.
Locations are empty for a new employee
Employee data only updates when you click Sync employees or Sync contractors.