Connecting QuickBooks

QuickBooks Online is connected through OAuth via Intuit — FiscoBridge never sees your QuickBooks password. Once connected, your QuickBooks invoices are automatically synced and fiscalized.

Before You Begin

You will need:

• A QuickBooks Online account. QuickBooks Desktop is not supported — the integration uses Intuit's cloud REST API.

• Admin access to the QuickBooks company you want to connect. Intuit's OAuth consent screen requires an admin to authorize third-party apps.

• A FiscoBridge account with an active integration license and a valid PFX certificate.

Setting Up the Connection

1. Go to Integrations → Integrations in the sidebar

2. Click Create Integration

3. On the New Integration page, select the QuickBooks card

4. Pick the tier and subscription to bill the connection against (if you have more than one)

5. Upload your PFX certificate when prompted

6. The QuickBooks confirmation dialog opens — review the certificate summary and click Connect

7. You'll be redirected to Intuit's authorization page

8. Sign in to your Intuit account (if not already signed in)

9. Select the QuickBooks company you want to connect

10. Click Connect (sometimes labelled Authorize)

11. You'll be redirected back to the Client Portal

Once authorized, the QuickBooks integration appears in your integrations list with status Active.

Multi-company: QuickBooks authorization is scoped to a single company ("realm") at a time. If you run several QuickBooks companies, create one FiscoBridge integration per company.

What Gets Synced

• Invoices created or updated in QuickBooks are pulled into FiscoBridge automatically

• Each sales-item line becomes an item on the fiscal invoice, preserving quantity and unit price

• Tax codes on QuickBooks invoice lines are mapped to the VSDC labels your tax authority recognises — lines with unmapped tax codes fall back to label A

• The buyer tax number is read from the QuickBooks customer record when available

• Each invoice is fiscalized — signed and reported to the tax authority

New invoices are picked up every 15 minutes by default. With Growth or Scale tiers, sync frequency improves and retry handling is more aggressive — see the Integrations Overview for tier details.

OAuth Tokens and Reconnecting

Intuit issues short-lived access tokens alongside long-lived refresh tokens. FiscoBridge refreshes the access token automatically in the background, so you normally don't need to reconnect.

However, Intuit invalidates refresh tokens if:

• You revoke FiscoBridge's access inside Apps → Connected Apps in QuickBooks

• The refresh token goes unused for an extended period (Intuit's policy, currently ~100 days)

• You change the QuickBooks company's primary email or security settings

If the refresh fails, the integration is marked inactive and a Reconnect button appears on its row (same place the Active badge was shown above).

1. Click Reconnect

2. Complete the Intuit authorization again

3. Sync resumes from where it stopped

Previously fiscalized invoices are not affected.

Common Errors

"No organisations were found for the account you authorised." The Intuit account you signed in with isn't a member of any QuickBooks company, or it doesn't have admin rights on the company you meant to connect. Sign out of Intuit, sign back in with the correct admin account, and retry.

Integration suddenly goes inactive. Usually the refresh token was revoked or expired. Reconnect from the integrations list — see above.

Invoices not appearing in FiscoBridge.

• Confirm the integration status is Active. Inactive integrations don't poll.

• Only invoices with at least one Sales Item line are processed — blank or description-only invoices are skipped.

• Check your integration license is active and hasn't exceeded its monthly invoice limit.

• Allow up to 15 minutes for the next poll cycle on the Starter tier.

Buyer tax number missing on the fiscal invoice. Open the customer in QuickBooks and make sure the tax number is set on the customer record. QuickBooks invoices don't carry the tax number directly — FiscoBridge fetches it from the linked customer at sync time.

Removing the Integration

1. Go to Integrations → Integrations

2. Click Remove next to the QuickBooks integration

3. Confirm the removal

Removing the integration stops the sync. Previously fiscalized invoices are not affected.

If you also want to revoke FiscoBridge's access on Intuit's side, open QuickBooks → Apps → Connected Apps and disconnect FiscoBridge there — otherwise Intuit keeps the grant recorded against your account.

Next Steps

• Manage integrations — View all your active connections

• Integrations Overview — Learn about other supported platforms