Goal
Connect QuickBooks Online to Debitura so you can import unpaid invoices and create collection cases from them.
Prerequisites
An active Debitura account (see Getting started with Debitura if you need to sign up)
A QuickBooks Online account with access to the company you want to connect
Permission to authorize third-party applications in your QuickBooks account
You can see a step-by-step video tutorial below:
Steps
Step 1: Open the Integrations page
Log in to your Debitura account.
Go to the Integrations page.
Select QuickBooks Online from the list of available integrations.
Click Connect to begin the authorization process.
Step 2: Authorize Debitura in QuickBooks
You will be redirected to a QuickBooks login page.
Sign in with your QuickBooks Online credentials.
If you have access to multiple QuickBooks companies, select the company you want to connect.
Review the permissions Debitura is requesting and click Connect to grant access.
You will be redirected back to Debitura. Confirm the integration is active on the Integrations page.
Debitura uses OAuth2 authentication, which means your QuickBooks credentials are never shared with Debitura. The connection uses secure tokens that refresh automatically, so you do not need to reconnect periodically.
Step 3: Import and review invoices
Go to the Bulk Import (Integration) page.
Select your QuickBooks connection from the list.
Use the date filters to control which invoices are imported. You can filter by invoice creation date or due date.
Review the imported unpaid invoices within Debitura.
Step 4: Create collection cases
Select the invoices you want to convert into debt collection cases.
Click to create cases. Debitura automatically maps QuickBooks data to case fields.
Review the case details and submit.
For more details on case creation, see How to create and submit a case.
Field mapping
Debitura automatically maps your QuickBooks invoice and customer data to case fields:
QuickBooks Field | Debitura Field |
Invoice number | Creditor reference |
Invoice date | Case date |
Due date | Case due date |
Total amount | Amount to recover |
Currency | Case currency |
Customer name | Debtor name |
Email address | Debtor email |
Billing address | Debtor address |
Phone number | Debtor phone |
Result
After completing these steps:
Your QuickBooks Online account is connected to Debitura.
You can import unpaid invoices using date filters.
Invoices can be converted into collection cases with automatic field mapping.
The connection remains active with automatic token refresh.
Notes and limitations
Unpaid invoices only: Debitura imports only unpaid invoices from QuickBooks. Paid invoices are not imported.
Date filtering: You can filter imports by invoice creation date or due date to control which invoices are fetched.
Data validation: Debitura validates that invoices have complete debtor address information, valid currency codes, and proper jurisdiction data before case creation.
No local storage: Debitura calls the QuickBooks API directly and does not store a separate copy of your invoice data.
Disconnecting QuickBooks
To disconnect, go to Integrations and remove the QuickBooks connection. Disconnecting in Debitura immediately revokes your OAuth grant at Intuit - you do not need to separately remove access from inside QuickBooks. The stored OAuth tokens are cleared from Debitura at the same time. Your QuickBooks credentials and invoice data are never stored in Debitura; only the connection tokens are held.
If you disconnect from inside QuickBooks instead (Apps > Disconnect), QuickBooks normally redirects you back to Debitura and clears the connection right away - next time you open Integrations, QuickBooks shows as not connected, with a plain Connect to QuickBooks button, just as it was before you first connected it. That redirect isn't guaranteed to fire, though: if it doesn't, Debitura detects the change the next time you open the Integrations page or the "View Cases" page for that connection and shows a Reconnect needed state instead - one click on Connect to QuickBooks restores it. Separately, a connection that stops working on its own without you disconnecting it (for example, your QuickBooks password changed or access was revoked another way) is also kept visible and flagged Reconnect needed so you don't lose track of it.
If you reconnect later, you will go through the same OAuth flow and choose a company again.
Troubleshooting
If your integration stops syncing or imports incomplete data, see the integration troubleshooting guide for common fixes including expired tokens, missing permissions, and rate limits.
Related guides
Integration options - compare native integrations, Zapier, CSV/ZIP, and API
Connect Stripe - import invoices from Stripe
Connect Zoho Books - import invoices from Zoho Books