Skip to main content

QuickBooks Online specifications and data flow examples

Tips on getting started with QuickBooks and BuildTools sync, data flow examples, best practices.

Hector Borrego avatar
Written by Hector Borrego
Updated over 6 months ago

Mapping and data flow specifications

Mappings

*how these are named in BuildTools vs QuickBooks Online

BuildTools

QuickBooks Online

Cost categories

Products & services / Items

Companies

Vendors

Projects

Customers

Purchase Orders

Purchase Orders

Invoices

Bills

Expenses

Expenses

Checks (within Expenses module)

Checks

Sync direction

*preferred method is BuildTools to QuickBooks

What syncs

BuildTools ---> QBO

QBO ---> BuildTools

Cost categories

Yes, automatically

Yes, once per hour

Companies

Yes, automatically

Yes, once per hour

Projects

Yes, automatically

Yes, manually (see below screenshot)

Purchase Orders

Yes, automatically

Yes, once per hour

Invoices

Yes, automatically

Yes, once per hour

Expenses

No

Yes, once per hour

Checks

No

Yes, once per hour

Getting QuickBooks Online ready to start syncing with BuildTools

-Make sure you're an administrator in QuickBooks Online

-The sync uses the Products and Services list to sync with BuildTools cost codes, this can be found by going to the QuickBooks settings page

-Enable Purchase Orders in QuickBooks if you plan on syncing POs. This can be found under settings--->Account and settings--->Expenses
Note: Purchase orders are only available on Plus and Advanced versions of QuickBooks Online
Also note: we recommend letting BuildTools manage your POs, in which case there may not be a need to have these sync

Data Flow Examples - Creating new items

Below are examples of the data we can currently sync

Projects


Recommended method. Create your projects in BuildTools first and these will sync to QuickBooks Online as shown below

If your QuickBooks is set to customers and jobs then BuildTools will give you the option of creating the new project tied to an existing customer
*if customer is not listed follow this article on how to create the customer in QB first: article

Alternate method. Create the project in QuickBooks Online and pull into BuildTools as shown here. All new projects will come to BuildTools when this button is clicked.

Cost Codes

Recommended method. Create your cost codes in BuildTools, these are then sent to the Products and Services list in QuickBooks online. Below are the fields that sync over, also notice that the default income and expense accounts are automatically filled

To learn more about why BuildTools references QuickBooks default accounts check out this article

Alternate method. Create the item in QuickBooks Online and then choose to import into BuildTools as shown here

Companies


Recommended method. Create companies in BuildTools first, these will sync as vendors to QuickBooks online. Only the company name is synced.

Alternate method. Create the vendor in QuickBooks Online and then tell BuildTools to import them in

Invoices/Bills

Recommended method. Create all new bills in BuildTools first. These bills sync over to QuickBooks tied to their mapped project/customer and to the corresponding item details. Once paid the payment will sync back to BuildTools

Payment reflected back in BuildTools

Alternate method. Create the bill in QuickBooks Online and wait an hour to be synced to BuildTools, or click on the PULL button as shown below to import into BuildTools

Purchase Orders

Recommended method. Create new POs in BuildTools, these will sync to the corresponding vendor in QuickBooks, also tied to the mapped project/customer and item details

Alternate method. Create the PO in QuickBooks Online and allow 1 hour for it to sync back to BuildTools, or click on PULL as shown below

Expenses

Recommended method. Expenses can only be created in QuickBooks and will sync to BuildTools, they'll show as expense type within the Invoice module. Make sure expenses are created using item details and not category details

Checks

Recommended method. Checks can only be created in QuickBooks. They'll sync to BuildTools as type Check. Make sure checks are created using item details and not category details

Data Flow Examples - Edits

Below are examples of data already in sync and we now proceed to edit their information

Projects

In this example I changed the project name and project address, both of these synced and updated those details in QB Online

Cost Codes

I now proceed to edit a cost category by changing the numeric code in BuildTools from 105 to 106, this then changes the code in QB Online

Companies

If we edit a company name, address, phone, website, and email address, they all sync back to QB Online

Invoices/Bills

If we edit the bill number, date, amount, and memo those details will sync back to QB Online
Note: if the bill has already been paid these details cannot be edited

Purchase Orders

The PO was updated with a new cost code, new amount, and line item description in BuildTools and these synced back to QB Online

Expenses

These cannot be edited in BuildTools, they can only be edited in QB Online. Fields that can be synced back are expense number, amount, cost code, and memo

Checks

These cannot be edited in BuildTools, they can only be edited in QB Online. Fields that can be synced back are check number, amount, cost code, and memo

Coming Soon

-Credit card credits

FAQs

Q: Can BuildTools sync with Classes in QuickBooks?

A: Classes are an additional method of tracking expenses in QuickBooks, BuildTools does not sync with the class field at this time

Q: Can BuildTools sync QuickBooks expenses?

A: Yes, expense type transactions can sync from QuickBooks into BuildTools

Q: Are bill payments synced back to BuildTools?

A: Yes, bills that have been created in BuildTools and later paid in QuickBooks can have their payment sync back and mark the bill as paid in BuildTools

Q: Can deleted items sync?

A: No, we never sync deletions. For example, if a bill is deleted in QBO then BuildTools will display a trash icon next to that bill, you'd then have to decide if you'd also like to delete from BuildTools

Q: If a bill is linked to a PO in BuildTools will it also sync as linked?

A: No, at this time they sync separately without being linked

Q: During initial sync, will historical data or data for jobs in progress sync?

A: We sync from the moment we complete the setup going forward, this means only new data will sync, such as new bills or new POs. There is however an exception to this rule, any invoice/PO/expense/check that is edited in QBO will be considered new and can sync back to BuildTools

Did this answer your question?