Error

Meaning

Resolution

There is already a bill in your QBO account with the same Bill Number.

The bill that you've created already exists in QuickBooks with the same bill number.

If you'd like this bill to push to QBO, change the Bill Number in BuildBook

The matched Product/Service in your QBO account is not set up properly for syncing. Make sure to mark this item for both purchase and sale in your QBO account.

A product/service that has a cost code on an item you've created isn't marked as both Purchase and Sell in QuickBooks.

Mark all matched products/services in QuickBooks as Purchase and Sell, and make sure an account is selected for each.

A customer with this Person’s name already exists in your QBO account.

You've attempted to push a project to QuickBooks with a duplicated customer or project name.

If you're attempting to push to a project, make sure that you've created the customer and project in QuickBooks first, then have selected that customer and project when turning on sync in BuildBook. Otherwise, leaving the customer and subcustomer fields blank in BuildBook will allow BuildBook to create the correct values for you.

The matched Product/Service in your QBO account is not set up properly for syncing. Make sure to mark this item as non-inventory.

Inventory-type products/services cannot sync with BuildBook.

Make sure all products/services matched to cost codes have the "non-inventory" type in QuickBooks.

The matched Product/Service in your QBO account is not set up properly for syncing. Make sure to mark this item for both purchase and sale in your QBO account.

A product/service that has a cost code on an item you've created isn't marked as both Purchase and Sell in QuickBooks.

Mark all matched products/services in QuickBooks as Purchase and Sell, and make sure an account is selected for each.

The vendor assigned to this transaction has been deleted. Before you can modify this transaction, you must restore [vendor name].

To push bills and expenses to an existing vendor in QuickBooks, the vendor must be marked as active.

Unarchive the affected vendor in QuickBooks, and be sure not to archive used vendors in the future.

Automated Sales Tax is not enabled for this QuickBooks company.

To push invoices to QuickBooks Online, users must have a US-based QuickBooks account with Automated Sales Tax (AST) enabled.

Turn on AST in QuickBooks Online.

Project does not have a taxable address. We will try to push this invoice again when a valid address is added.

To push invoices to QuickBooks Online, projects must have a valid address.

Enter a valid address in this format: “Street address, City, State Zip Code”

QuickBooks is not enabled for at least one project related to this expense.

QuickBooks Sync must be turned on for each project you want to sync/push to QuickBooks Online.

Go to the Manage QuickBooks page (Profile Icon > Settings > Financials > Manage QuickBooks) and turn on QuickBooks Sync for the given project.

Error

Meaning

Resolution

An item related to this object has the same name as another Customer, Vendor, or Employee in QuickBooks.

This happens when an item you've created has a vendor that matches another object in QuickBooks. All QuickBooks object names, even across types, must be unique.

Check QuickBooks for the vendor on the item you're trying to push and, if needed, rename or delete any Customers, Vendors, or Employees with the same name. Alternatively, you can rename the Vendor in BuildBook.

An item in QuickBooks related to this object has been deleted. Before you modify that object, you must restore the item.

Once a BuildBook item is pushed to QuickBooks, that QuickBooks item shouldn't be deleted. BuildBook should be the source of truth and should be where all action takes place on bills, expenses, and invoices.

This also might happen if a vendor or other associated object was made inactive in QuickBooks online.

Find the referenced item in QuickBooks and restore it.

Error 3200. Please contact Customer Support to resolve this issue.

Please reach out to customer support if you encounter this error, even if it resolves itself. This error occurs if there is a problem authenticating your QuickBooks account within BuildBook.

You may try disconnecting and reconnecting your QuickBooks account to BuildBook (as long as you select the same QuickBooks company, all of your data/connections will be maintained). However, we recommend reaching out to support for assistance.

We’ve encountered an error with our integration provider. Please contact Customer Support to resolve this issue.

Please reach out to customer support if you encounter this error, even if it resolves itself. This error occurs if there is a timing problem within BuildBook's API connection to QuickBooks.

Sometimes, refreshing the Manage QuickBooks page or visiting /settings/accounting?quickbooks_enabled will resolve this issue. However, we recommend reaching out to support for assistance.

Invoice is in draft status and cannot be synced.

Invoices in the draft status can't be pushed to QuickBooks Online.

Change the invoice status to a non-draft status in BuildBook