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
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.
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