Quickbooks Integration with Gas Engineer Software

QuickBooks Integration with Gas Engineer Software

Table of Contents:

  1. Getting Started
  2. Subscribe to the Integration
  3. Authenticate GES with QuickBooks
  4. Choosing your Bank for Payments
  5. Troubleshooting
  6. FAQ

Getting Started

The following guide will walk you through the integration with QuickBooks and assumes you already have a working account with them. If you haven't done so already then it is advised you do this first before going ahead. It is also highly recommended that you add your bank account to your accounts package before enabling the integration. You will be asked to select the account where you want payments to go when you setup and authenticate GES with QuickBooks.

The integration is a paid add-on that you can cancel it at any time should you wish.

GES can sync your customers, invoices, and payments.

Before enabling your integration, you should know that if any of your customers in Gas Engineer Software already exist on your accounting package then there may be some additional steps to follow to get up and running - please see the troubleshooting below.

If you already have existing data on your accounting package then please contact us and we can speak about the best options available to ensure the smoothest setup.

Keep in mind that it is not currently possible to prevent the duplication of any existing invoices that may already exist on your accounting package. If some of your existing invoices in Gas Engineer Software have already been manually created under your accounting package, you could end up with duplicates in your accounts package in some circumstances.

If you have yet to add any data to your accounting package then the above does not apply to you.

Subscribe to the Integration

You will first need to subscribe to the integration by heading to the Gas Engineer Subscription Details. You will need to upgrade to the Growth Plan if you are not already. The growth plan includes the Accounts Integration.

Authenticate GES with QuickBooks

  • Tick the two options for syncing both Customers and Invoices.
  • Click "Save Changes".
  • Click Authenticate.
  • Login to QuickBooks (if not already).
  • Click Connect to give access to GES.

Choosing your Bank for Payments

The next step is to select which bank account you wish invoice payments from GES to be linked to. Select the appropriate bank from the drop down menu and click the Save button.

If you have not added your bank account yet, it is highly recommended that you do so now, before Authenticating. If there is no bank account, a dummy one will be created for payments. If payments get made to this account, you can only move them from it individually to another bank account at a later date. This is avoidable if you add your bank first.

After this step has been completed your GES account will then be linked with your accounting software. The status indicator on your Integration Settings page should now indicate that the link is now active.

The tick boxes will change the behavior of the integration. If, for example, the Sync customers option is checked then any new customers you create will automatically be synced to your accounting package.

Alternatively if the 'Sync invoices' option is also checked, then both your customers and invoices will automatically be synced to your accounting package.


If any issues occur while the integration is active, they will be logged on your integration settings page. Typically these errors will be thrown back by the service itself and not by Gas Engineer Software, and unfortunately at times these messages can be vague.

Gas Engineer Software will often provide you links to the record in question that was being synced when the fault occurred but the below will walk you through what each message might possibly mean.

If you're still unsure of the fault then please don't hesitate to give us a call on 0207 129 7058 or send us an email, and we will be more than happy to assist.


Message Description
The name supplied already exists This is indicating that the customer name is already on your QuickBooks database. You will need to manually alter the display name of the contact within Quickbooks to allow GES to create the customer.
Once the customer has synced over to QB, you can then change the display name back to the original. You'll need to ensure that the display names match as this will prompt you to merge the two contacts. You'll only need to do this the once.
The customer you have specified has been deleted. The invoice that you are trying to edit is linked to a customer that has been deleted.

It is possible to restore your deleted customers
Invalid Reference Id The invoice that you are trying to sync has had the customer archived within GES. You will need to restore them to continue.
Business Validation Error This occurs when a deleted QB customer has been edited in GES. It is not possible to edit a customer after they have been deleted.

It is possible to restore your deleted customers
Stale Object Error This error occurs ff there are multiple users editing a single record, or a single customer at the same time. Through normal use of our software, this won't be an issue.
Duplicate Document Number Error An invoice that GES has attempted to sync to QB shares an invoice number with an existing record that is already in QB. You will need to adjust your invoice numbering from your GES Settings to ensure that the invoice numbers are unique

Linking Existing Customers

It may be necessary to make the customers display name unique prior to syncing your existing data (for example adding 2019 to the end of their name) for the initial sync to go through. This will then enable Quickbooks to create the new contact, rather than generating an duplicate contact error. You can then merge the two contacts in QuickBooks by the changing the customers display name to match each other. You will be asked if you would like to merge the contacts.

Doing this will keep the existing invoices of both under one. The key is to merge the existing QuickBooks contact to the newly synced/created GES contact. This is because invoices for this contact will be linked to the GES version of this contact.

Frequently Asked Questions

  • How do I disconnect from QuickBooks and stop the integration?

Give us a call on 0207 129 7058 and we can do so for you. Or you can log into the web portal, go to your subscription settings, and remove it from there.

  • How can I sync my historical or older invoices?

The only way to sync older records is to open the individually on the web portal, and then quickly edit and re-issue the invoice. This will update the invoices timestamp, and sync it ove immediately. This is the same for contacts/customers. Any edits to a contact not already in QuickBooks, will sync that contact over immediately.

  • When and how does data sync occur? Is it manual, automatic, on login, in real-time? Are there any settings related to synchronising?

Syncing occurs usually straight away, but there can be delays depending on connection congestion etc. The sync is automatic - if you issue an invoice, it will automatically sync the invoice and the customer. There are only 2 settings for the synchronization once you have setup and authenticated; sync customers, and sync invoices. You must have sync customers enabled before invoices can be synced as well.

  • I am getting an error in the Integrations Settings page, what do they mean?

Have a peek at the chart of common errors returned by QuickBooks if you see any errors.

  • Duplicate Contacts when Syncing

If you find that you have created a duplicate contact in the syncing process, you can merge the two contacts together in QuickBooks, and keep the existing invoices of both under one. The key is to merge the existing QuickBooks contact to the newly synced/created GES contact. This is because invoices for this contact will be linked to the GES version of this contact. You can always undo this process as well.

How to Edit Your Gas Engineer Software Subscription

results for ""

    No results matching ""