Choose what the Simpro booking form asks about the customer
Customer Fields decides which details the form collects about the person booking. The answers go onto the Simpro customer the booking creates or finds. The same page controls the live lookup on the form, customer groups, customer custom fields and how an existing customer is treated.
Before you start
- Customer groups and customer custom fields need a Service booking form subscription. Without one the page shows "Want to use Customer custom fields?" with a link to the subscriptions page, those two sections are greyed out, and Save leaves them unchanged.
- Update details when an existing customer is found and Ignore email checks for existing customers are marked "Subscribers only". Without a subscription they have nothing to act on, because Formpiece only searches Simpro for an existing customer by email or company name for subscribers.
- Customer groups and 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 Customer Fields under Form display.
- Under Standard fields, Customer location fields and Customer postal fields, switch on each field the form should ask for.
- Tick Mandatory field on each one the customer has to fill in. The tick boxes only work once the field is switched on.
- Choose the lookup, company display and saving options described below.
- Click Save. The page says "Customer fields updated." and the change is published.
The standard fields are First Name, Surname, Company Name, ABN, Phone Number, Mobile / Cell Phone and Email Address. The location and postal sections each offer Address, City, State and Post Code.
Read only field is for auth link bookings. When the customer arrives through an auth link for an existing job or quote, a read only field shows the value already held in Simpro and cannot be changed.
Company or individual
Simpro holds a company and an individual differently, so the form decides which to create. A booking that includes a Company Name creates a company customer. A booking without one creates an individual.
Choose how the form asks:
- Hide company fields unless customer selects "I am making a booking for a company". The default. The company fields only appear after the customer switches that on.
- Show company fields upfront. The form opens with a Customer type choice of Individual and Company, and the company fields are available straight away.
Either way the company fields only appear when Company Name or ABN is switched on.
Live customer lookup
Live customer lookup checks Simpro for an existing customer while the customer fills in the form. It searches by the email address, phone number or mobile number they have typed, once the required customer fields are complete, so switch on at least one of those three fields.
| Option | What it does |
|---|---|
| Enable customer lookup on data entry. | If Simpro has a customer whose phone or email matches what was typed exactly, the booking uses that customer instead of creating a new one. When that customer has sites, the form says "Looks like you've used our services before. Welcome back." |
| Show suggested sites on existing customers. | Shows the customer's existing Simpro sites on the site step under "Since you're a returning customer, please select your address:". Picking one books against that site and that customer. Enter in a new address below carries on as a new address. |
When more than one Simpro customer matches, the first one returned by Simpro is used.
Customer groups
Customer groups ask the customer which Simpro customer group they belong to.
- Switch on Show the customer group field on the booking form.
- Set Field name. Leave it blank and the form uses "Customer group".
- Tick Mandatory field. The customer has to pick a group before they can book. if you want to force an answer.
- Switch on each group the customer can choose from. Selecting none hides the field.
The groups are read from Simpro. If none exist the list says "No customer groups available."
Custom fields
Under Custom fields the page lists your Simpro customer custom fields. Switch on the ones to collect. Each field has Mandatory field and Read only field, and you can drag a row to set the order the form asks them in.
The form shows each field according to its Simpro type: Text, List, Date, Numeric or Hyperlink.
A Text field also offers Show as multiple choice. Switch it on to let the customer pick from a list you type in Options (one per line). Choose Dropdown or Tick boxes under Style, how the picks are written to Simpro under Written to Simpro as, and a limit under Most picks allowed (blank for any number). Simpro still receives one line of text. If an option contains the separator you chose, the page warns you to pick another separator or reword it.
If you change a custom field in Simpro, click Refresh Simpro custom fields so the form picks up the new options. The button appears when a saved field has options.
Customer saving
| Option | What it does |
|---|---|
| Transform customer details to uppercase in Simpro. (New customers only) | Writes the name and address lines in capitals. This also applies to the names on any site contact the booking creates. |
| Update details when an existing customer is found. Only used when Ignore email checks are turned off. (Subscribers only) | Overwrites the matched Simpro customer with what the customer typed. |
| Ignore email checks for existing customers. A new customer will be created for each new booking. (Subscribers only) | Skips the search for an existing customer, so every booking makes a new customer. |
Without a subscription Formpiece does not search Simpro for an existing customer by email or company name, so a booking creates a new customer unless live customer lookup matched one.
How it maps to Simpro
| On the form | In Simpro |
|---|---|
| Company Name | The company customer's CompanyName |
| ABN | The company customer's EIN |
| First Name, Surname (individual) | The individual customer's GivenName and FamilyName |
| Phone Number, Email Address | The customer's Phone and Email |
| Mobile / Cell Phone (individual) | The customer's CellPhone. When there is no phone number it is also used as the Phone. |
| First Name, Surname, email, phone and mobile (company) | A contact on the company customer |
| Customer location fields | The customer's Address. If none are collected or filled in, the site address is used. |
| Customer postal fields | The customer's BillingAddress |
| Customer group | The customer's Profile, CustomerGroup. Only a group the form still offers is written. |
| Custom fields | The customer's custom fields, by their Simpro field ID (subscribers only) |
Simpro needs a name to create a customer. When the form does not collect one, Formpiece fills in a placeholder. A missing surname becomes "(Surname added by Formpiece)", and a missing first name or company name becomes "(Customer for ...)" followed by the site address. A company contact with no first name is created as "(First Name added by Formpiece)".
For a company customer, Formpiece looks up a contact on that customer by email address. A match is updated, and no match creates a new contact.
For subscribers, an existing customer is found by company name first (company bookings), then by email address. Matched customers are left alone unless Update details when an existing customer is found is ticked. Custom fields are written to the matched or new customer either way.
When it goes wrong
Every booking creates a new Simpro customer
The account has no Service booking form subscription, or Ignore email checks for existing customers is ticked. Both skip the search for an existing customer. Live customer lookup can still match one.
The customer's details didn't update on an existing customer
Update details when an existing customer is found is off, or the account has no subscription. An auth link booking updates the customer from the form unless Disable customer change for existing jobs or recurring jobs is ticked on Form Properties, which leaves the customer exactly as it is.
The group field isn't on the form
Show the customer group field on the booking form. is off, no group is switched on, or the account has no subscription. Republish the form after changing it.
The customer group didn't change in Simpro
Formpiece sets the group on a matched customer without changing anything else, even when Update details when an existing customer is found is off. If that write fails, the booking carries on and the error is recorded against the booking.