Choose what the Simpro booking form asks about the site
Site Fields decides which address and contact details the form collects for the job location. Each booking needs a Simpro site, and this page controls how Formpiece names it, whether it reuses an existing one, and who is recorded as the site contact.
Before you start
- Site custom fields, the address search suggestions on the form, Include state in site search?, Include postcode in site search? and Create a duplicate site if an existing site contact email address is not the customer email address. need a Service booking form subscription. Without one the page shows "Want to use Site custom fields?" with a link to the subscriptions page.
- Site custom fields load from your Simpro company, so the form needs its company set on Form Properties.
Step by step
- Open your form from Forms. On the Settings tab, open Site Fields under Form display.
- Under Standard fields, switch on each site field the form should ask for: Name, Address, City, State, Post Code and Country.
- Tick Mandatory field on each one the customer has to fill in. The tick boxes only work once the field is switched on.
- Set up custom fields, site contacts, the default site name and the saving and search options described below.
- Click Save. The page says "Site fields updated." and the change is published.
Read only field is for auth link bookings. A read only field shows the value already held in Simpro and cannot be changed.
If the form asks for an address, the customer can type an address into Search address and pick a suggestion, which fills the address fields. Suggestions need the subscription. Without one the customer types each field.
Custom fields
Under Custom fields the page lists your Simpro site custom fields. Switch on the ones to collect, drag rows to set the order, and use Show as multiple choice on a Text field to turn it into a pick list. It works as described on Customer Fields. Click Refresh Simpro custom fields after changing a field in Simpro.
Custom fields are written to the site only for subscribers.
Site contact fields
The site contact is the person Simpro should ring about the visit when it is not the customer. The fields are First Name, Surname, Phone Number and Email Address.
Ask if someone else will be on site. adds a Yes or No question to the form. The site contact fields then belong to one answer only.
- Question is the wording. Leave it blank and the form asks "Are you the property owner?"
- When the customer answers yes, Show the site contact fields with no fields filled in. shows them empty. Show the site contact fields filled in with the customer details. fills them in from the customer's answers. Answering no hides them.
- The question only appears when at least one site contact field is switched on.
- The customer cannot move on until they have answered.
With the question off, the site contact fields are always shown. They appear under "Site Contact Details" with the line "If different to customer details."
Make site contact the Primary Contact for the site. marks the contact Formpiece creates as the site's primary contact.
Default site name
Simpro needs every site to have a name. When the form does not ask for Name, or the customer leaves it blank, Formpiece uses one of two options.
- User filled site details joins the address parts the customer filled in with commas. Use Include address in default site name?, Include city in default site name?, Include state in default site name? and Include postcode in default site name? to choose the parts.
- Default static site name uses the text in Default static site name for every site.
If Name is switched on and the customer fills it in, that is the site name.
Site saving and search
| Option | What it does |
|---|---|
| Transform site details to uppercase in Simpro. (New sites only) | Writes the site name, address, city, state, postcode and country in capitals. |
| Use abbreviated site names. (Australian sites only) | Writes the full state names Queensland, New South Wales, Victoria, Australian Capital Territory, South Australia, Western Australia, Northern Territory and Tasmania as QLD, NSW, VIC, ACT, SA, WA, NT and TAS. |
| Create a duplicate site if an existing site contact email address is not the customer email address. (Subscribers only) | When Formpiece finds an existing site, it checks that site's contacts for the customer's email address. If none match, it creates a new site instead. |
| Site address search region filter | Limits the address suggestions to one country. Clear it to search everywhere. Needs the subscription. |
| Include state in site search? and Include postcode in site search? | Add the state and postcode to the search for an existing site. Both are on by default. |
| Remove spaces in address number when unit numbers are used? | Writes a unit address as "2/14 Smith Street" in place of "2 / 14 Smith Street". |
How it maps to Simpro
| On the form | In Simpro |
|---|---|
| Name, or the default site name | The site's Name |
| Address, City, State, Post Code, Country | The site's Address (Address, City, State, PostalCode, Country) |
| Custom fields | The site's custom fields, by their Simpro field ID (subscribers only) |
| Site contact fields | A site contact: GivenName, FamilyName, Email, CellPhone and WorkPhone (both set from Phone Number) |
For a subscriber, Formpiece searches for an existing site before creating one. It matches on the address and city, plus the state and postcode when those search options are on, and tries the abbreviated state for Australian addresses. If that finds nothing, it looks for a site whose name starts with the address and city. The earliest matching site is used.
Without a subscription every booking creates a new site.
An existing site is used as it is. Its details are only updated when the booking comes from an auth link for an existing job or quote.
If the form collects no site contact, the customer's own name, email and mobile become the site contact instead, with "Customer contact details added by Formpiece" in the contact's notes. Both cases look for an existing contact on the site by email first, for subscribers, and only create one when none is found.
When it goes wrong
Every booking creates a new site
The account has no Service booking form subscription, so Formpiece does not search for an existing site. With one, a site is created when no existing site matches the address, or when the duplicate site option rules the match out.
The site was created with a placeholder name
The form did not ask for Name and no address parts were filled in. Formpiece falls back to the text in Default static site name, or to "(site for" followed by the customer name.
An auth link booking changed the site
For an existing job or quote, the booking updates the site from the form. Tick Disable site change for existing jobs or recurring jobs. on Form Properties to leave the site exactly as it is.
The site contact question isn't on the form
Ask if someone else will be on site. is off, or no site contact field is switched on. The question needs at least one of them.