Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt

Use this file to discover all available pages before exploring further.

QuickBooks is a US accounting software developed by Intuit.

Prerequisites

You need to have a valid QuickBooks account and admin rights on Hyperline.

Setup

1

In Hyperline, navigate to the Settings > Integrations page

2

Click Connect on the QuickBooks card

3

Authenticate on QuickBooks

If you are not already logged into QuickBooks, enter your QuickBooks credentials to proceed.
4

That's it!

Your Hyperline account is ready to send invoices and credit notes.

Reconciling data

Customers

To link an existing QuickBooks customer to a Hyperline customer, navigate to the customer details page, click the “Edit” button in the “Integrations” section, and enter the QuickBooks customer ID. For bulk operations during initial setup, contact our support team or use this API endpoint.

Products

You can map your QuickBooks products (items) to your Hyperline product catalog. For each product in Hyperline, go to the Accounting section and enter the corresponding QuickBooks item name in the “Product code” field. When specified, Hyperline automatically attaches each invoice line item to the corresponding item in QuickBooks.

Taxes

When pushing an invoice with taxable line items, QuickBooks requires a tax code to be associated with each line. You can provide it in two ways:
  • At the product level: Define a specific tax code on each product in Hyperline (Catalog → Products → Accounting → Tax code). This code is used when the product appears on an invoice.
  • At the invoicing entity level: Configure tax codes on the default tax rates of the invoicing entity, in Settings > Invoicing entities > Taxes. Hyperline resolves the right tax code based on the invoice’s tax rate before pushing it to QuickBooks. See Default tax rates for details.
As a fallback, you can set a Default tax code in Settings > Integrations > QuickBooks. It is used whenever a taxable line item has no resolved tax code.
For US QuickBooks accounts, only the built-in TAX and NON tax codes are supported on line items. The Default tax code is still required to push invoices with non-zero tax, as QuickBooks uses it to override the computed sales tax.

Synchronization

When you connect your QuickBooks account, Hyperline automatically sends invoices with their complete details (including line item details).
By default, only invoices and customers created after the connection date will sync. If you need to push older data to QuickBooks, please contact our support team.

Customers

Hyperline supports 2 modes of synchronization for customers:
  • no synchronization: customers are not synchronized with QuickBooks.
  • from Hyperline to QuickBooks: customers created in Hyperline are automatically created in QuickBooks with their details.

Payments

Hyperline supports 3 modes of synchronization for payments:
  • no synchronization: payments are not synchronized with QuickBooks.
  • from Hyperline to QuickBooks: payments created in Hyperline are automatically created in QuickBooks and associated to the corresponding invoice.
  • from QuickBooks to Hyperline: payments created in QuickBooks are automatically created in Hyperline, and the status of the invoice is updated accordingly.
Synchronization occurs within 5 minutes.

Troubleshooting

If you encounter any issues with the integration (missing data, failed entity synchronization, etc.), we recommend checking the Hyperline issues page for more details: Settings > Integrations > QuickBooks > View issues.

Common issues

Invoice has taxable line items but no product tax code defined and no default tax code ref provided This error is raised when Hyperline tries to push an invoice with taxable line items but cannot resolve a tax code for at least one line, and no Default tax code is configured on the integration. To fix it, set a tax code on the affected product(s), set tax codes on the default tax rates in Settings > Invoicing entities > Taxes, or set a Default tax code in Settings > Integrations > QuickBooks. See the Taxes section for details.