Skip to main content
Quickbooks online (EU) Accounting/Financial Export from essensys Operate

Integrating Quickbooks online with essensys Operate to Export Financial Data

Stuart avatar
Written by Stuart
Updated over a week ago

Please note: If you have signed up for Quickbooks after Nov 10 2017 we will not be able to support your export due to the AST (automated sales tax) in Quickbooks, which selects the tax automatically, based on the address set on your invoices.  This is making it impossible for us to map taxes from within Operate. 

Connecting Operate and Quickbooks online makes your bookkeeping easier. In this guide, we will go through a set of instructions that will allow you to export your Operate data directly into Quickbooks.

The following configuration is using Payment GL codes in Operate and Account Category Type Names in Quickbooks to match data. Your Operate Payment GL Codes must be identical to your Quickbooks Account Names in order for the export to integrate correctly.

You can use numeric GL codes if you like; however, this is not mandatory. If your Quickbooks Category Type Name is using text, you can copy it as-is, as a GL Code in Operate.

This guide applies to Europe based companies and covers the following: 

  • Mapping Tax Rates.

  • Configuring the "Cost of Goods Sold" Account Category Type

  • Mapping the Quickbooks Accounts and Operate Payment GL Codes Used by Payments and Journals.

  • Mapping the Quickbooks Accounts and Operate Payment GL Codes Used by Products.

  • Configuring customer payment types and terms. 

  • Running the export.

What and How is Mapped?

Below is a list of exported items from Operate and what they match to in Quickbooks. Please take note of the different terminology in the two systems, which refers to the same information.

Please Note: 

  • If there are Operate products with the same name, they will all match to a single Quickbooks item.

  • Operate’s products are exported to Quickbooks as non-inventory items (Non-inventory items are a subcategory of Quickbooks' products).

  • Invoices and Credit notes are mapped from Operate by document number.

  • Payments and Journals are mapped by ‘Memo’ where Quickbooks stores Operate’s transaction ID (This should not be modified).

1. Map Your Tax Rates

First, please ensure that your tax rates are configured between Quickbooks and Operate.

In Quickbooks, select Taxes from the menu. If you have not yet set up any taxes, you should see the following screen, where you can start setting up your VAT: :

Next, you can start adding your tax rates. In Quickbooks, go to the Taxes section and click New

Select Tax Rate then configure your tax. For example, we will match the zero tax rate, using 'Non Taxable' as a name.

To match this tax with Operate, go to the Operate Settings > General > Organizations > Taxes.

And edit the tax rate you need to match. 

Paste the Tax Name from Quickbooks into the Tax Code field and save.

You will also need to set up the tax rates that apply to Operate Products. You can do this by going to Space > Products, then either mass updating a list view or editing individual products. 

Please make sure that taxes are added to Products before these are used on Operate licences. The tax will not apply if it is set up after adding the Product to the Licence, therefore your invoices will not include tax upon export.

Please follow the same process to also map the other taxes you want exported to Quickbooks.

2. Configure your "Cost of Goods Sold" Account Category Type

The Quickbooks Online Export requires that a Cost of Goods Sold account category type exist under Accounting > Chart of Accounts. This is needed in order for the export to work. In Quickbooks, go to Accounting > Chart of Accounts, in the main menu on the left.

Under the Type column, look for Cost of Goods Sold

This category should be in Quickbooks by default, but if you are unable to see a category type called Cost of Goods Sold you will need to create it by clicking New at the top of the chart.

3. Map the Quickbooks Accounts and Operate Payment GL Codes Used by Payments and Journals

Go to Operate’s Settings > General > Organizations > Payment GL Codes.

This is what your list of GL Codes may look like: 

For each GL Code in the list, create a Cash at Bank and in Hand type account in Quickbooks with Name = Payment GL Code. For example, we have 'Deferred Income, GL Code:  CL-310-' within Operate. We will need to take 'CL-310-' and copy it over to Quickbooks. (Your GL codes may not be using 'code' type strings, but could be added as a description of what they represent (E.g.: You may have 'Deferred income' both as a GL Code name and description in Operate, for example. You can add the same text as the Name of the new Quickbooks account you create. To do this, go to your Chart of Accounts, click New, then add the new account under the 'Bank' Category Type, as shown below:  

RELATED ERROR: If by any chance this is not correctly configured, Operate will display the following error message: “Related GL code xxxx(id:x)) has not been exported to quick books as 'bank' type account”

-----------------------------

IMPORTANT: EXPORTING PAYMENTS

Please be aware that Operate uses a hardcoded Payment GL Code called 'Bank'. This is due to the fact that when your customers pay using your Portal, all such payments are automatically sent to this code. This GL Code may be updated, but not deleted; otherwise it can cause your export to fail.

Since Quickbooks is limited to one GL Code for payments (e.g. Undeposited Funds), you may not be able to use multiple GL codes to account for different types of payments; even though Operate provides this possibility. In this case, it is recommended to use the 'Bank' GL code to map your payments to Quickbooks. The default code is CA-275; however, you can update it to the one you prefer, BEFORE running your export. Once updating the GL Code, your history should update as well. 

-----------------------------

4.  Map the Quickbooks Accounts and Operate Payment GL Codes Used by Products

Each product you have in Operate will need to be assigned a Payment GL Code that will determine where the income goes in your accounting. This Payment GL Code will need to be added to Quickbooks as an Income type account so that the two systems match them during export. 

You may for example send your product sales funds to the 'Other Income' GL Code - CA-275- in our case. (This again can be a description the code as above).  

In Operate, go to Space > Products and add a GL Code to each of the products you want exported to Quickbooks. You can use one GL code for all of your products or several codes - one per product category. You can easily update several products at a time using the quick update option at the top of the list. List views make this easier.

In Quickbooks, create an Income type account, with Name = Operate Payment GL Code, as shown below (in our example, it will be Name =  CA-275- for the Other incomeaccount): 

Do this for ALL of the product GL Codes that you want to export to Quickbooks. 

RELATED ERROR: If Product GL Codes are not configured, the following error will be displayed by Operate: Income type account with name: 'xxxx\ does not exist in Quickbooks.

____________________

Note: Using sub-accounts

If you are using sub-accounts, you can export them from Operate. To do so, simply add a sub-account to QuickBooks and use the name of this sub-account as the name of the GL code in Operate. This will allow your invoices to be exported correctly in the accounts tree.
____________________

5. Configure Your Customers / Accounts

Quickbooks describes a company you invoice for services as a Customer. Operate describes it as an Account. Certain fields on the customer/account records must be mapped to reduce any errors occurring during the export.

Exporting customers may fail because there are missing payment methods or payment terms which can be found in the errors log as shown below

Map Operate Account IDs and Quickbooks Companies

Your Operate Accounts are called Customers in Quickbooks and they need to match between the two systems so that your transactions are well assigned to the appropriate customer. 

Operate assigns an Account ID to each Account, which corresponds to the Company in Quickbooks. 

To match Accounts and Customers, the Account ID and Company need to be identical in both systems, therefore Operate will export this field to Quickbooks. However, you do need to check whether all of your Operate Accounts have an Account IO and add one for those that don't. You can this under Member > Accounts and use a list view of the Accounts created this month to do so (or look at all of your Accounts when running your first export).

When mapping your accounts between both platforms its important to ensure that the account name is no more than 50 characters.

Map Customer Payment Types

In Operate, go to the Settings > General > Customize > Accounts.

Select Standard Fields as highlighted above, then scroll to Standard Payment Typeand click into it. 

You will find a list of active payment types.    

Next, make sure that your Operate Accounts have a payment type assigned. You can do so under Member > Accounts, where you can either mass update or edit individual accounts and add the payment type. 

For each payment type, go to Quickbooks and click on the gear icon at the top right. Under 'Lists' select 'All Lists'.

Select Payment Methods from your lists, then add all payment methods that exist in Operate but don't exist in Quickbooks.  You can do so by clicking New at the top right.

Enter the name of your payment method, check the box if it involves a credit card payment, then save it.

Please also make sure that the payment method names match between Operate and Quickbooks, to prevent any errors.  You can edit existing methods by clicking the arrow in the Actions menu next to your list item: 

Map Customer Payment Terms

Customer payment terms also need to match between your Quickbooks and Operate accounts.

Go to Operate’s Settings > General > Customize > Accounts > Standard Fields

Select Standard Payment Term

Now ensure that your Operate Accounts have a payment term assigned. You can do so under Member > Accounts, where you can either mass update or edit individual accounts and add the payment term. 

For each payment type, go to Quickbooks and click on the gear icon at the top right. Under 'Lists' select 'All Lists'.

Select 'Terms' from your lists and add any term that exist in Operate but not in Quickbooks. Your goal is to match the list of terms between both systems here as well.  You can add new terms by clicking New, on the top right hand side of your screen.

You can edit existing terms by clicking the arrow in the Actions menu then Edit, or by simply double clicking.

6. Run Your Export

In Operate, go to Invoicing > Quickbooks Export. Select your organization, then click Export.  If you do not see this option, go to Settings > Integrations and install the Quickbooks Export app. 

Next, select whether you need to export booked or un-booked transactions.

  • Export un-booked transactions - These transactions would not have been exported.Export booked transactions - WARNING: These transactions may already be exported. Exporting booked transactions may lead to duplicates in your financial accounts. The only time when you should export booked invoices is when you are importing into a new, blank database. 

Next, select what range of transactions you would like to export:

  • All Transactions - Export all transactions 

  • Last Month's - Export last month's transactions

  • This Month's - Export this month's transactions 

  • Choose Transactions - Choose which transactions you would like to export 

Click Export. 

When you run this export, you will need to connect your Operate and Quickbooks accounts, therefore you will be asked to authorize this connection before the export goes through. 

Confirm that you want to run the export. It is recommended you backup your accounting system where possible before exporting. 

Wait for your export to go through, then check that it has run correctly. If there are any errors, please check that all of the above steps have been taken - make changes as needed then choose to export booked transactions. Only select the transactions that have failed and re-export them.

Did this answer your question?