Get Started Get Started

Setup the simPRO Integration

The Simpro integration keeps contacts in step between Oncord and Simpro, and can turn your website's form submissions into leads in Simpro. It is for trades businesses that manage their customers and jobs in Simpro. This guide covers connecting Simpro, choosing which forms create leads and what is synchronised.

Before You Begin

  • The Simpro integration is free.
  • The integration uses Oncord's contact database. Marketing is optional and helps you send campaigns to your synced contacts. Manage your features under Dashboard > Settings > Features.
  • You need access to Simpro's API settings, to create an API application for Oncord.

What Data Is Synchronised?

From Oncord From Simpro
Contacts
  • Changing a contact's details in any part of Oncord also updates Simpro, for contacts that are linked to Simpro.
  • Deleting a contact in Oncord doesn't delete it in Simpro.
Contacts
  • All customers in Simpro are pulled into Oncord.
  • Changes to a customer's details in Simpro are reflected in Oncord.
  • Deleting a customer in Simpro doesn't remove the contact from Oncord.
  • For company customers, the company's contacts in Simpro are also pulled into Oncord, linked to the company.
Form Submissions
  • Submissions of the forms you tick in Create Leads from the Following Forms create new leads in Simpro. If the person isn't in Simpro yet, they are added as a customer.
  • The form fields appear in the lead's Description field in Simpro.
Groups
  • Creating, renaming or deleting groups in Oncord doesn't change Simpro tags.
Tags
  • Simpro tags appear in Oncord as groups, under the Simpro Tags group.
  • Simpro contacts that are tagged appear in the matching Oncord groups. Removing a tag in Simpro removes the contact from that group.

Deletions are not reflected in either system, so you may need to delete entries in both.

Contact Fields Synchronised

These contact fields are synchronised with Simpro:

  • First name and last name
  • Company name
  • Address, suburb, postcode, state and country
  • Phone (the contact's work phone in Oncord)
  • Email address
  • Mobile phone, for a company's contacts pulled from Simpro

Connect Simpro

  • Go to Dashboard > Settings > Third Party Integrations.
  • In the Simpro® Enterprise box, click Enable. The Connect to Simpro dialog opens and lists the details you need.
  • In Simpro, go to System (top right corner) > Setup > API > Applications > Add Application.
  • Create an application with Company, Name and Application Title set to Oncord, and Authentication Method set to API Key.
  • Back in Oncord, enter the hostname of your Simpro account in Simpro Host, for example xxx.simpro.co.
  • Paste the key from Simpro into API Key.
  • Click Connect to Simpro. Oncord checks the connection and opens Configure Simpro.

Configure Simpro

Oncord opens Configure Simpro as soon as you connect. To change these settings later, click Configuration in the Simpro® Enterprise box on the Third Party Integrations page.

  • Connection - Shows your Simpro Host and API Key. Click Test Connection to check them.
  • Company - Choose the Simpro company to sync with. This setting appears once the connection succeeds.
  • Create Leads from the Following Forms - Tick each form whose submissions should create leads in Simpro. Forms are listed by their ID.
  • Auto-Sync - Leave this on Disabled until you are confident the configuration is correct, then set it to Enabled.
  • Click Save Configuration.

When Does It Sync?

Automatic sync is off until you set Auto-Sync to Enabled under Configuration and click Save Configuration.

With Auto-Sync enabled, changes in Oncord normally queue a sync with Simpro about two minutes later. Timing can vary, and a sync already queued for an earlier time is not delayed by later changes. Leads from form submissions are also created at the next sync.

When there are no changes in Oncord, background sync checks Simpro approximately every six hours. You can also start a sync at any time:

  • In the Simpro® Enterprise box, click Synchronise.
  • After the first sync, choose a Sync Type: Modified Since Last Sync or All Records.
  • Click Synchronise.

Disconnect Simpro

  • Go to Dashboard > Settings > Third Party Integrations.
  • In the Simpro® Enterprise box, click Remove.
  • Confirm that you want to remove the integration.

Removing the integration deletes its configuration, any changes still waiting to sync and the links between contacts and Simpro. Your contacts and the Simpro Tags groups stay in Oncord. To use Simpro again, connect and configure it from the start.