Integrations and Add-Ons

QuickBooks Integration

Vilulia's QuickBooks integration connects your QuickBooks Online account so that the case complainant is synced as a QuickBooks customer and a settlement invoice is created in QuickBooks. Invoice creation is started by a mediator or admin from within Vilulia, not automatically on finalization. Payment status is tracked within Vilulia. There is one QuickBooks connection per Vilulia organization.

What you'll learn

How to connect QuickBooks Online to Vilulia
What syncs automatically and what requires a user action
How the circuit breaker handles QuickBooks API failures
Connection limits to be aware of

Setup steps

Go to Settings → Integrations and click Connect QuickBooks.
You are redirected to Intuit. Sign in to your QuickBooks Online account.
Select the QuickBooks company you want to connect to Vilulia, then click Connect. Vilulia requests the Accounting scope (full read/write access to create customers and invoices).
You are returned to Vilulia. Your QuickBooks company name is saved and the connection is active.

What syncs automatically

The case complainant is synced to QuickBooks as a Customer when an invoice is created, if not already synced. Other parties are synced only when a mediator or admin syncs them individually.
When a mediator or admin creates an invoice for a settlement, the invoice is pushed to QuickBooks.
Access tokens expire in 1 hour; Vilulia refreshes them automatically before expiry.

Manual steps required

You must initiate invoice creation from within Vilulia. QuickBooks does not receive data automatically without a user-triggered action.

Circuit breaker behavior

If the QuickBooks API fails 5 consecutive times, Vilulia temporarily stops sending requests to QuickBooks for 60 seconds. During this window, QuickBooks sync actions fail gracefully — no data is lost, but syncing is paused. After 60 seconds, Vilulia retries. After 2 consecutive successful requests, the circuit resets to normal operation.

Can't find what you're looking for? Contact Support