📋 Applies to: Admin · Partner Admin
Module: Accounting > Integrations > QuickBooks Online
Provider: QuickBooks Online (Intuit) · Integration type: Two-way · Sync direction: Alvys to QBO (invoices and bills); QBO to Alvys (payment status)
Last reviewed: 2026-06 · Owner: Support team
Before connecting Alvys to QuickBooks Online, complete these account configurations in QuickBooks Online. Skipping these steps can cause sync errors, mismatched data, or a failed connection after the integration is active.
Overview
This article covers the account-level configurations required in QuickBooks Online before connecting to Alvys. Complete all five areas below. Each section describes a setting or condition that must be in place for the integration to work correctly.
QuickBooks Online Plan Types
Not all QuickBooks Online plans support the features required for the Alvys integration.
Simple Start does not include the Accounts Payable module and is not recommended for use with Alvys.
Essentials is the minimum supported plan. It includes the "Manage Bills" feature required for the Alvys integration.
Plus and Advanced are recommended. These plans support Location and Class Tracking, which enables more detailed financial reporting in QuickBooks Online.
Administrative Access
You must have Admin credentials for your QuickBooks Online account to complete the integration setup. Non-admin access does not have the permissions required to configure account settings or connect third-party integrations.
Chart of Accounts Preparation
Before connecting to Alvys, confirm that your QuickBooks Online Chart of Accounts includes the following accounts at minimum:
Accounts Receivable
Accounts Payable
Income accounts: Linehaul, Fuel Surcharge, Accessorials
Expense or Cost of Goods Sold accounts: Purchased Transportation, Driver Settlements
If any of these accounts are missing, create them in QuickBooks Online before connecting.
How to create an account in QuickBooks Online?
Navigate to the Chart of Accounts section in QuickBooks Online.
Click New.
Enter the account details: select the account Category and enter a Name.
Click Save and Close to confirm the account.
Validate Open Accounting Periods
Confirm that your accounting periods are open for the dates you plan to sync. In QuickBooks Online, navigate to Settings > Advanced > Accounting and review the Closing Date field. If a closing date is set that covers recent periods, transactions from those periods may not sync correctly.
Custom Transaction Numbers
Alvys sends its own transaction numbers when syncing invoices to QuickBooks Online. For these numbers to be preserved, Custom Transaction Numbers must be turned on in QuickBooks Online.
To enable Custom Transaction Numbers:
In QuickBooks Online, navigate to Settings > Account and Settings > Sales.
Under Sales form content, locate the Custom transaction numbers toggle.
Turn Custom transaction numbers On.
Click Save.
⚠️ If Custom transaction numbers is turned off, QuickBooks Online ignores the transaction numbers sent by Alvys and assigns its own sequential numbers instead. Turn this setting on before connecting Alvys to avoid numbering mismatches.
FAQs
Q: Which QuickBooks Online plan is the minimum requirement for the Alvys integration?
A: Essentials is the minimum supported plan. It includes the "Manage Bills" feature required for the integration. Simple Start does not include Accounts Payable and is not recommended.
Q: Why is QuickBooks Online Plus or Advanced recommended?
A: Plus and Advanced plans support Location and Class Tracking, which enables more detailed financial reporting in QuickBooks Online when syncing from Alvys.
Q: What accounts must I have in my Chart of Accounts before connecting?
A: At minimum, you need Accounts Receivable, Accounts Payable, Income accounts (Linehaul, Fuel Surcharge, Accessorials), and Expense or Cost of Goods Sold accounts (Purchased Transportation, Driver Settlements).
Q: Does the Custom Transaction Numbers setting apply to Bills as well as Sales forms?
A: No. The Custom Transaction Numbers setting only applies to Sales forms such as invoices. Bills use the Reference Number field automatically.
Q: Are custom fields in QuickBooks Online supported across all plans?
A: Custom fields are available across QuickBooks Online plans, but the number of custom fields available may vary by subscription.
Go Deeper