How Does The Setup Process work?

  1. Review these instructions as well as the Related Articles.
  2. Complete the setup steps.
  3. Let support know that the setup has been completed.
  4. A support agent will review your system.
  5. Once your system is ready a support agent will send a link to schedule a web meeting.
  6. A support agent will join you on a web meeting to perform your 1st sync.


Overview

This article will guide you through the process of setting up QuickBooks Desktop and CoreBridge to prepare for a data sync. 


Please note:

  • If you have not Gone Live! with CoreBridge you can still perform these setup steps, however, the actual sync will not occur until you are Live and the sync requirements have been met. 
  • We recommend working with our support team for your first sync to QuickBooks. This helps ensure that all of the settings are correct which reduces the likelihood of any erroneous data being synced to QuickBooks.
  • If you are entering orders or payments in a program other than CoreBridge, we recommend not entering that data again in CoreBridge so that you don't get duplicate data in QuickBooks.
  • If you are entering payments in a program other than CoreBridge, we recommend keeping those bank deposits separate from your CoreBridge deposits.
  • If your CoreBridge system has more than one Location, data from all locations will sync to the same QuickBooks company file.

  • Once you've gone through your 1st Sync, you should not edit/update/modify/delete any records that sync from CoreBridge to QuickBooks. QuickBooks effectively becomes "look but don't touch" for any records that have synced from CoreBridge.



Table of Contents


Sync Requirements

  • QuickBooks Desktop for Windows 2014 or newer. LINK: Accounting Export Options
  • The Full Sync export method is being used.
  • QuickBooks Desktop is installed on a local computer. The software required for the sync will be installed on the same computer that QuickBooks is installed on. The sync software running on a hosted server is not supported. Your QuickBooks company file does not have to be on the same computer that QuickBooks is installed on.
  • Your system must be Live.
  • One or more Completed orders.
  • One or more payments.
  • One or more Reconciliations that contain payments. 


Related Articles


Please take a few minutes to review the articles below as they will help to provide additional details on the sync process.


E-Commerce Integration Requirements

  • CoreBridge E-Commerce: there are no special requirements
  • Pressero: Sales Tax must be synced as line items. This is a setting on the sync tool (Step 10)
  • XMPie: Sales Tax must be synced as line items. This is a setting on the sync tool (Step 10)

  • If you are using the Pressero or XMPie integration, the sales tax reports from QuickBooks will not work because tax will be recorded as line items. The CoreBridge sales tax reports will need to be used when preparing sales tax forms.


Special Characters

There are special characters that are allowed in CoreBridge that will cause the sync to fail. The special characters are allowed in Customer names and in Contact names. Since both of those need to sync to QuickBooks the sync will fail when the special characters try to sync. The special characters in CoreBridge will need to be changed to standard characters for the sync to be successful.

These are the characters that are allowed in CoreBridge but will cause the sync to fail: á, é, í, ó, ú, ñ, ü



STEP 1 – Perform a CoreBridge Reconciliation


Each Reconciliation contains the payments that will export to QuickBooks. Without Reconciliations payments will not export.


A Reconciliation should be performed at the end of each business day to capture that day's payments and to catch any payment entry errors. If wrong payment amounts are captured on the Reconciliation the wrong amounts will sync to QuickBooks. 


Please refer to these articles for instructions:



STEP 2 – Configure QuickBooks Application Settings

Follow the steps in this article to properly configure QuickBooks: QB Desktop - Application Settings for Sync


STEP 3 – Match Income & Cost of Goods Sold Accounts


NOTES


Accounts need to match between CoreBridge and QuickBooks for the sync to be successful. Account number, account name, and account hierarchy have to match exactly. 


The only accounts needed for the sync are the accounts in CoreBridge. Be sure not to add your entire Chart of Accounts to CoreBridge.


If there is an account in CoreBridge that does not exist in QuickBooks, it will be created automatically in QuickBooks during your 1st sync so there is no need to add it manually. The new account in QuickBooks will be created exactly as displayed in CoreBridge (account number, account name, hierarchy). If you want to have an account created automatically, any parent account noted in CoreBridge will need to either be created by the sync or must already exist in QuickBooks. If you prefer to add an account manually to QuickBooks, be sure it matches exactly to CoreBridge. 


Account Naming and Structure:

  • Special characters may cause sync errors. Some examples are $, &, and quote symbols. Please use only letters and numbers for account names. If a special character causes a sync error, the account name will need to be changed in both CoreBridge and QuickBooks for the sync to be successful.

  • The name "Shipping" should not be used as an account name. Names like "Shipping Income" or "Shipping Expense" can be used instead.

  • The name "Freight" should not be used as an account name. Names like "Freight Income" or "Freight Expense" can be used instead.

  • Accounts can have 3 levels: 
    • Parent > Child > Child
  • If your existing Income and COGS accounts that will be used in CoreBridge have more than 3 levels please adjust them accordingly in QuickBooks before matching them to CoreBridge.

  • Each account must have a unique account number and a unique name. Numbers and names cannot be the same between Income accounts and COGS accounts. If you want the sync to create an account for you in QuickBooks during the 1st sync, be sure that an account doesn't already exist in QuickBooks with the number or name of the account that will be created.


INSTRUCTIONS


Review your QuickBooks chart of accounts to check for duplicate account names. Each account in QuickBooks should have a unique name. If there is an account in CoreBridge with the same name as two or more accounts in QuickBooks with the same name, the sync may fail or may change your chart of accounts in QuickBooks to something you aren't expecting. For Example:
  • One CoreBridge Account: 4000 Banner Income
  • Two QuickBooks Accounts: 4000 Banner Income, 4500 Banner Income
  • You will need to change 4500 so that is has a unique name


3-A. Income Accounts

The QuickBooks account type needs to be "Income". Using type "Other Income" will create sync errors causing data to not export.


In CoreBridge, navigate to Accounting Module > Manage Accounts > Income Accounts tab.


  • The column headings can be used to sort accounts. If the accounts have account numbers, try clicking GL Code once or twice to put the accounts in number order. If the accounts don't have numbers, sorting by Account Name may make the matching process easier.

  • Once sorted, start with the first account in CoreBridge. Compare it to QuickBooks. Account number, account name, and account hierarchy must match between CoreBridge and QuickBooks. If the CoreBridge account matches exactly to QuickBooks move on to the next account in CoreBridge. (You don't want to start with the first account in QuickBooks because all of your accounts in QuickBooks don't need to be in CoreBridge)

  • If the CoreBridge account represents an account in QuickBooks but it doesn't match exactly, change the account in either QuickBooks or CoreBridge to get them to match. 
    • If you are a Franchisee, CoreBridge is populated with the Franchisor master Chart of Accounts so any change may need to be made in QuickBooks.
    • The goal is to get the account to match perfectly between CoreBridge and QuickBooks. Account number, account name, and account hierarchy must match.

  • If a CoreBridge account needs to be changed, click edit, make any needed changes, then click save before moving to the next account.

  • If the account being matched is a child account in QuickBooks be sure to select the parent account in CoreBridge so that the account hierarchy matches. If a parent account does not exist in CoreBridge it must be created.

  • To create a new account use this section of the page:
    • If you are a Franchisee, your accounts may be locked preventing new accounts from being created.



3-B. COGS Accounts

The QuickBooks account type needs to be "Cost of Goods Sold". Using type "Expense" will create sync errors causing data to not export.


Costs from CoreBridge do not sync but the accounts themselves will sync because they need to be used with the items that will be created in QuickBooks from your CoreBridge parts and modifiers.


In CoreBridge, navigate to Accounting Module > Manage Accounts > COGS Accounts tab.


Follow the same instructions as Income Accounts.



STEP 4 – Select an Accounting Export Option in CoreBridge


IF YOU HAVE ALREADY SYNCED

If you have already synced with a different accounting application than QuickBooks Desktop or a with a different export method, stop here and contact CoreBridge support. Changing this option after data has been synced will create erroneous data in QuickBooks if a sync is performed with the new setting.


IF YOU HAVE NEVER SYNCED

Proceed with the setup. 


If you have been in contact with a support agent this step will probably have been done for you.

  1. In CoreBridge, navigate to Accounting Module > Accounting Export.
  2. Select the following options:
    • Select Export Type: Sync with Desktop Application
    • Application Name: QuickBooks
    • Sync Type: Full Data Sync    
  3. Click the Save button. A warning dialogue may appear. Since you have never synced you can safely click OK.

STEP 5 – Invoice Prefix & Numbering Format


If your QuickBooks does not have customer invoices, skip this step and proceed to Step 6.


NOTE

If your QuickBooks has customer invoices this step must be completed so that CoreBridge invoices will have different numbers than QuickBooks. If invoice numbers are the same between CoreBridge and QuickBooks the CoreBridge invoices will fail to sync.


INSTRUCTIONS

Confirm that the the CoreBridge invoice prefix and starting number will not create orders in CoreBridge that will have the same numbers as invoices in QuickBooks.


  • In QuickBooks
    • Report Center > Customers & Receivables > Transaction List by Customer
      • Select a date range that will show your most recent invoices. 
      • Export the report to Excel and sort by Num. This will display the prefix as well as the last number used.

  • In CoreBridge view your Invoice Prefix setting: Management Module > Locations > (select a location) > Location & Company
    • Make any needed change then click Save Changes.    


  • In CoreBridge view your invoice numbering: Management Module > Global Settings > Pricing Settings
    • Make any needed change then click Save Settings.




STEP 6 – Review Employee Names


If your QuickBooks does not have Employees skip this step and proceed to Step 7.


NOTES

If your QuickBooks has Employees this step must be completed so that there are no conflicting records. If you have sold to an Employee, that Employee may have a Customer account in CoreBridge.


If there is an Employee in QuickBooks with the same name as a Customer in CoreBridge the Customer will fail to sync which will also cause invoices to not sync.


INSTRUCTIONS

Compare your Employee list from QuickBooks against Customers in CoreBridge. If there is a match, the name will need to be changed in either CoreBridge or in QuickBooks so that there isn't a match.



STEP 7 – Review Customer Names


If your QuickBooks does not have customers skip this step and proceed to Step 8.


NOTES

If your QuickBooks has customers we highly recommend completing this step. If a customer exists in both QuickBooks and CoreBridge but the names do not match each other exactly, the sync will create a new customer in QuickBooks from the customer record in CoreBridge. All new transactions will sync to the new customer record. That will leave QuickBooks with duplicate customers:

  1. The original customer with the transactions that were recorded in QuickBooks
  2. The new customer with only the transactions from CoreBridge


INSTRUCTIONS

Compare all customers between CoreBridge and QuickBooks to be sure that the name is the same in both systems. (This includes spaces, dashes, and any other character)



STEP 8 – Review Vendor Names


If your QuickBooks does not have vendors skip this step and proceed to Step 9.

If your CoreBridge subscription does not include the Purchasing Module skip this step and proceed to Step 9.


NOTES

If your QuickBooks has vendors we highly recommend completing this step. Vendors from the Purchasing Module will sync to QuickBooks. If a vendor exists in both QuickBooks and CoreBridge but the names do not match each other exactly, the sync will create a new vendor in QuickBooks from the vendor record in CoreBridge. All new transactions will sync to the new vendor record. That will leave QuickBooks with duplicate vendors:

  1. The original vendor with the purchase orders that were recorded in QuickBooks.
  2. The new vendor with only the purchase orders from CoreBridge.


INSTRUCTIONS

Compare all vendors between CoreBridge and QuickBooks to be sure that the name is the same in both systems. (This includes spaces, dashes, and any other character)



STEP 9 – Review Items


If your QuickBooks does not have items skip this step and proceed to Step 10.


NOTES

If your QuickBooks has items we highly recommend completing this step. Part and modifiers from CoreBridge will sync to QuickBooks as items. The items will be used for Invoices and Purchase Orders. If an item exists in both QuickBooks and CoreBridge but the names do not match each other exactly, the sync will create a new item in QuickBooks from the part or modifier record in CoreBridge. All new transactions will use the new item record. That will leave QuickBooks with duplicate items:

  1. The original item with the transactions that were recorded in QuickBooks.
  2. The new item with only the transactions from CoreBridge.

In addition to the names needing to match, the Type needs to match as well:

  • Inventory
  • Non-Inventory
  • Service

If the names match but the type doesn't match, the sync will attempt to update the item type in QuickBooks so that it matches CoreBridge. If there is activity on the item in QuickBooks that prevents the type from being changed, the sync will fail. That will result in the item not syncing and all transactions that use that item will also fail.


INSTRUCTIONS

Compare all items in QuickBooks to parts and modifiers in CoreBridge. The following information should be the same in both QuickBooks and CoreBridge:

  • Name (This includes spaces, dashes, and any other character)
  • Type
  • Income account
  • COGS account (If the item in QuickBooks has inventory transactions, and the sync tries to change the account in QuickBooks, the item may fail if QuickBooks does not allow the change to be made. This happens because QuickBooks isn't allowing the beginning balance to change. If that happens the name will need to be changed in QuickBooks so that the sync can create a new item).


STEP 10 – Download and install the QuickBooks Desktop Sync Tool

Follow the steps in this article to download and install the software required for the sync: QB Desktop - Sync Tool Installation


The software must be installed on the same computer that QuickBooks installed on.


If Windows does not have the required component installed that the software will need, you will be prompted to download and install it from a Microsoft website. This may require a computer restart.


NOTE:  Once the software has been downloaded and installed the settings do not need to be configured at this point. The settings will be configured during your 1st Sync web meeting.


If you are using the Pressero or XMPie integration:

Sales Tax must be synced as line items. There is a setting on the sync tool that needs to be selected and there are records that will need to be created in QuickBooks to use this option.


Please refer to this article: Sync Tax Agency Liabilities as Line Items

If you are setting up the sync tool on your own please follow the steps in the article before performing a sync.


STEP 11 – Accounts Receivable Account in QuickBooks

On the Desktop Sync Tool, an Accounts Receivable account needs to be set for each CoreBridge location. Even though a different A/R account can be used for each location we recommend using the same account for all locations because there are times that multiple A/R accounts will cause the sync to fail. 


INSTRUCTIONS

    In QuickBooks, confirm that any A/R account to be used is set as follows:

  • The account must be a parent account
  • The account type must be Accounts Receivable

STEP 12 – Other Accounts in QuickBooks

  1. These accounts need to exist in QuickBooks. If they don't exist please create them. If they do exist be sure that the account type is correct.
    ACCOUNT
    ACCOUNT TYPE
    A bank account where payments are deposited
    Bank
    A petty cash account to reconcile your cash drawer
    Bank


  2. This account needs to exist in QuickBooks. If it exists please be sure that the name and type match as noted. If it doesn't exist the sync will create it.
    ACCOUNT NAME
    ACCOUNT TYPE
    Bad Debt
    Expense (not Other Expense)


  3. If these accounts don't exist the sync will create them. There is no need to create them by hand. The account number noted will be used if the sync creates the account.
    ACCOUNT
    NOTES
    NUMBER
    Undeposited Funds
    This is needed in order to record deposits
    00001
    Inventory Asset
    Other Current Asset account associated with inventory items
    00002
    Customer Refunds
    Account associated with refunds
    00003
    Retail Sales
    Fallback income account is an income account cannot be found
    00004
    Cost of Goods Sold
    Fallback income account is an income account cannot be found
    00005
    In-Store Credit
    Expense account associated with In-Store credit
    000089
    Bad Debt
    Expense account associated with bad debt payments
    000087


STEP 13 – Notify Support That All Setup Steps Have Been Completed


Once the entire setup has been completed, notify support by replying back to your "sync setup" ticket. 


The agent assigned to your ticket will review your system to ensure that you have a successful First Sync. If any issues are found during the review that will cause the sync to fail, the agent will let you know what the issues are so that they can be fixed. Once the review is successful the agent will send a scheduling link that you will use to arrange your First Sync meeting. 


The 1st Sync to QuickBooks Desktop will be performed with a CoreBridge Support specialist on the scheduled meeting.


We recommend not performing a first sync on your own. 


Meeting Requirements:

  • Create a backup of your QuickBooks company file.
  • Join the meeting on the same computer that QuickBooks is installed on.
  • QuickBooks must be open in single-user mode.
  • QuickBooks must be logged into with an Admin account.
  • QuickBooks cannot have Accountant's Copy restrictions.
  • QuickBooks cannot have a closing date after your Go Live date.
  • Since Tax Groups are reviewed on a sync meeting we recommend that the user signed in to CoreBridge has access to the Management Module.


During the 1st Sync Meeting we will:

  • Perform the 1st Sync with you.
  • Help to correct any sync errors that may come up.