QuickBooks Integration

This guide explains how to connect QuickBooks to Supervity, what data is available after connection, how operators can use QuickBooks data and actions within workflows, and how to remove the integration when needed.

---

Overview

The Supervity QuickBooks integration allows your workspace to securely connect QuickBooks Online as a governed platform capability.

Once connected, operators and workflows can use QuickBooks data and actions to manage invoicing, record payments, sync customer and vendor records, update expense ledgers, orchestrate purchase orders, and track accounting structures.

With the QuickBooks integration, Supervity can:

• Manage customer accounts
• Manage vendor profiles
• Synchronize products and services
• Orchestrate billing invoices
• Manage supplier bills
• Document payment records
• Structure supplier logistics
• Track expenditures
• Review account parameters

All QuickBooks access is governed through Supervity's security, permissions, and audit controls.

---

Prerequisites

Before connecting QuickBooks, ensure you have:

• An active Supervity workspace
• An active QuickBooks Online account
• Permission to authorize third-party applications on your QuickBooks Online account

---

Adding the QuickBooks Integration

Follow these steps to connect QuickBooks to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.

Step 1: Open Integrations

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.

This opens the Integrations page, where all available integrations are listed. Connected integrations and available integrations can both be managed from this page.

Step 2: Select QuickBooks

1. Locate QuickBooks in the available integrations list.
2. Click Connect.

Step 3: Authorize Access

1. You will be redirected to Intuit's secure authorization page.
2. Review the requested permissions and click Connect (or Allow) to grant Supervity access to your QuickBooks.

Supervity uses QuickBooks's standard OAuth 2.0 authorization flow. Your QuickBooks credentials are never shared with or stored by Supervity.

Step 4: Complete Connection

After authorization, you will be redirected back to Supervity.

The QuickBooks integration will appear as Connected on the Integrations page. Your workspace can now securely access QuickBooks capabilities according to the permissions granted.

Having trouble? See the Troubleshooting section for step-by-step help with common setup issues.

---

How QuickBooks Works in Supervity

After connection, QuickBooks becomes available as a governed platform tool.

Operators can use QuickBooks capabilities when planning and executing tasks, while workflows can automate actions using QuickBooks data.

Common use cases include:

• Generating draft invoices from CRM deal closures
• Syncing billing details with customer support accounts
• Auto-creating purchase orders based on inventory thresholds
• Recording incoming payments and updating account states
• Compiling monthly expense summaries and synchronizing ledgers

---

Using QuickBooks in Operators

Connected QuickBooks capabilities become available to operators automatically. Operators determine when QuickBooks data or actions are required to complete a task and execute accordingly, while remaining governed by workspace permissions, security controls, and approval policies.

What Operators Can Do with QuickBooks

Operators can perform the following actions using QuickBooks:

• List, retrieve details, create, and update customers and vendors
• List, retrieve details, create, and update items
• List, retrieve details, create, update, send, and void invoices
• List, retrieve details, create, and update supplier bills
• Record customer payments and retrieve payment details
• List, retrieve details, create, and update purchase orders
• List, retrieve details, and create expenses
• Retrieve charts of accounts and get company profile metadata

Typical Operator Use Cases

---

Features & Prerequisites

For each QuickBooks capability available in Supervity, the following describes the use case and the prerequisites required before use.

List Customers

Use Case: Get the list of customers defined in QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity

Get Customer

Use Case: Retrieve details of a specific customer account.

Prerequisites:

• QuickBooks connected to Supervity

Create Customer

Use Case: Add a new customer account to QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity

Update Customer

Use Case: Modify an existing customer's contact or billing details.

Prerequisites:

• QuickBooks connected to Supervity

List Vendors

Use Case: Get the list of vendors defined in QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity

Get Vendor

Use Case: Retrieve details of a specific vendor profile.

Prerequisites:

• QuickBooks connected to Supervity

Create Vendor

Use Case: Add a new vendor account to QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity

Update Vendor

Use Case: Modify an existing vendor's contact details.

Prerequisites:

• QuickBooks connected to Supervity

List Items

Use Case: Get the list of products and services defined in QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity

Get Item

Use Case: Retrieve details of a specific product or service item.

Prerequisites:

• QuickBooks connected to Supervity

Create Item

Use Case: Add a new product or service item to the inventory list.

Prerequisites:

• QuickBooks connected to Supervity

Update Item

Use Case: Modify details of an existing product or service item.

Prerequisites:

• QuickBooks connected to Supervity

List Invoices

Use Case: Get the list of billing invoices.

Prerequisites:

• QuickBooks connected to Supervity

Get Invoice

Use Case: Retrieve details of a specific billing invoice.

Prerequisites:

• QuickBooks connected to Supervity

Create Invoice

Use Case: Create a new billing invoice.

Prerequisites:

• QuickBooks connected to Supervity
• Existing products, services, or customers configured in QuickBooks

Update Invoice

Use Case: Modify the parameters of an existing invoice draft.

Prerequisites:

• QuickBooks connected to Supervity

Send Invoice

Use Case: Email a configured invoice to a customer's registered email address.

Prerequisites:

• QuickBooks connected to Supervity
• Invoice must exist and have a valid customer email address

Void Invoice

Use Case: Void an active invoice to cancel outstanding receivables.

Prerequisites:

• QuickBooks connected to Supervity

List Bills

Use Case: Get the list of supplier bills.

Prerequisites:

• QuickBooks connected to Supervity

Get Bill

Use Case: Retrieve details of a specific supplier bill.

Prerequisites:

• QuickBooks connected to Supervity

Create Bill

Use Case: Create a new supplier bill in QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity
• Corresponding vendor profile defined in QuickBooks

Update Bill

Use Case: Modify parameters of an existing supplier bill.

Prerequisites:

• QuickBooks connected to Supervity

Record Payment

Use Case: Record a received customer payment and apply it to invoices.

Prerequisites:

• QuickBooks connected to Supervity
• A corresponding invoice or account structure defined in QuickBooks

Get Payment

Use Case: Retrieve details of a specific customer payment transaction.

Prerequisites:

• QuickBooks connected to Supervity

List Purchase Orders

Use Case: Get the list of purchase orders.

Prerequisites:

• QuickBooks connected to Supervity

Get Purchase Order

Use Case: Retrieve details of a specific purchase order.

Prerequisites:

• QuickBooks connected to Supervity

Create Purchase Order

Use Case: Create a new purchase order in QuickBooks.

Prerequisites:

• QuickBooks connected to Supervity
• Corresponding vendor profile configured in QuickBooks

Update Purchase Order

Use Case: Modify parameters of an existing purchase order.

Prerequisites:

• QuickBooks connected to Supervity

List Expenses

Use Case: Get the list of recorded company expenses.

Prerequisites:

• QuickBooks connected to Supervity

Get Expense

Use Case: Retrieve details of a specific expense transaction.

Prerequisites:

• QuickBooks connected to Supervity

Create Expense

Use Case: Log a new expense transaction.

Prerequisites:

• QuickBooks connected to Supervity

List Accounts

Use Case: Get the chart of accounts and current balances.

Prerequisites:

• QuickBooks connected to Supervity

Get Company

Use Case: Retrieve details and metadata of the connected company profile.

Prerequisites:

• QuickBooks connected to Supervity

---

Permissions Requested

Supervity only requests the permissions required for enabled QuickBooks capabilities.

Depending on the features used in your workspace, permissions may include:

Supervity follows least-privilege principles and only accesses data necessary to provide requested functionality.

---

Authentication & Security

The QuickBooks integration uses OAuth 2.0 authentication.

Security controls include:

• Encrypted credential storage (AES-256)
• Scoped access policies
• Token refresh and rotation support
• Immediate revocation capabilities
• Workspace-level governance controls
• Complete audit logging
• TLS 1.3 for all connection pipelines

All QuickBooks access remains subject to Supervity security policies and role-based permissions.

---

Managing the Integration

View Connection Status

From the left navigation bar, click the Integrations icon.

For QuickBooks you can view:

• Connection status
• Connected company file details
• Last usage information
• Associated workflows and operators

Reconnect QuickBooks

If QuickBooks authorization expires: Open the Integrations page from the left navigation bar. Select QuickBooks. Click Reconnect. Complete authorization again through the Intuit portal.

Existing workflows and operators do not need to be recreated.

Removing the QuickBooks Integration

You can remove the QuickBooks connection from your Supervity workspace at any time directly from within the Supervity platform.

Steps to Remove

Log in to Supervity. From the left navigation bar, click the Integrations icon. Locate and select QuickBooks from the integrations list. Click Disconnect. Confirm the action when prompted.

Implications of Removal

Once removed:

• Supervity immediately loses all access to your QuickBooks account and data
• No new QuickBooks data will be read or processed after removal
• All active QuickBooks connections within your Supervity workspace are terminated
• Scheduled or active workflows that depend on QuickBooks will stop executing
• QuickBooks-dependent workflow steps will fail safely with clear error messages
• Existing workflow definitions within Supervity are not deleted — only the active connection is terminated
• Historical execution logs remain available for auditing purposes

Disconnecting QuickBooks does not delete workflow definitions, operators, or previously generated outputs.

How Your Data Is Handled After Removal

Data Handling on Removal:

• Supervity immediately loses access to your QuickBooks account upon removal
• No new QuickBooks invoice, transaction, or customer data will be collected or processed after disconnection
• Temporary files processed during workflow execution are deleted after execution completes
• QuickBooks access tokens and all account-related data are permanently deleted from Supervity's platform within 15 minutes of disconnection — no background access continues after removal

---

Auditing & Observability

All QuickBooks activity performed through Supervity is logged.

Audit records include:

• Which operator requested access
• Which workflow executed the action
• Timestamp of execution
• Success or failure status
• Relevant inputs and outputs (sensitive values are redacted)

This supports compliance, troubleshooting, governance, and operational visibility.

---

Troubleshooting

If you encounter issues at any stage, refer to the steps below. For issues not covered here, contact the Supervity support team.

Authorization Failed During Setup

Likely Cause: Incorrect QuickBooks account used, or corporate tenant policies restricting third-party applications.

Resolution:

1. Ensure you are signed in to the correct QuickBooks Online company account as an administrator.
2. Return to Supervity → Integrations → QuickBooks and click Connect to retry.
3. If the issue persists, contact your IT administrator.

---

Transaction Sync Failed

Likely Cause: Missing reference accounts, items, or mismatched tax settings in QuickBooks.

Resolution:

1. Ensure that any line items, tax codes, or accounts referenced in the workflow exist exactly in QuickBooks.
2. Check that the QuickBooks company configuration supports the transaction type.
3. Review the execution logs in Supervity for specific error codes returned by QuickBooks.

---

Connection Expired or Token Invalid

Likely Cause: QuickBooks security policies may force token expiration or revocation.

Resolution:

1. Go to Integrations → QuickBooks → Reconnect.
2. Complete the QuickBooks authorization flow again.
3. Existing workflows do not need to be reconfigured after reconnection.

---

Workflow Cannot Access QuickBooks

Likely Cause: QuickBooks may have been disconnected, or workspace governance policies may restrict access.

Resolution:

1. Confirm QuickBooks is still connected under the Integrations page.
2. Verify the workflow has permission to use QuickBooks within your workspace governance settings.
3. Check that workspace policies allow QuickBooks execution for the relevant operators or workflows.

---

Frequently Asked Questions

Q: Can I connect multiple QuickBooks companies to Supervity?

Yes. Each connected company file is authenticated independently. You can configure and connect multiple QuickBooks companies in your workspace settings.

---

Q: Does Supervity store my QuickBooks password?

No. Authentication is handled completely via standard OAuth 2.0. Supervity only receives and stores securely encrypted access tokens.

---

Q: What QuickBooks version is supported?

The integration supports QuickBooks Online (Simple Start, Essentials, Plus, Advanced, and Developer Sandboxes). QuickBooks Desktop is not supported by this integration.

---

Q: Will I need to reconfigure my workflows after reconnecting QuickBooks?

No. If you reconnect QuickBooks due to token expiry, existing workflows and operators will continue working without reconfiguration.

---

Q: What happens to my workflows if I disconnect or remove QuickBooks?

Workflow definitions are not deleted when QuickBooks is disconnected or removed. However, any workflow steps that depend on QuickBooks will fail safely with clear error messages until QuickBooks is reconnected.

---

Q: How do I authorize the Supervity QuickBooks integration?

Log in to Supervity at Supervity, navigate to the Integrations page from the left navigation bar, locate QuickBooks, and click Connect. You will be redirected to QuickBooks's authorization page where you can review and approve the requested permissions. After authorization, you will be redirected back to Supervity automatically. See the Adding the QuickBooks Integration section above for full step-by-step instructions.

---

Q: Who do I contact if I have an issue with the integration?

Contact the Supervity support team. See the Support section below for full contact details, support hours, and SLA information.

---

Support

If you need assistance with the QuickBooks integration, visit the Support page.

Support Hours

• Monday to Friday, 9:00 AM – 6:00 PM IST
• Requests submitted outside business hours will be addressed on the next business day

First Response SLA

• All support requests receive an initial response within 24 business hours

Contact Information

When Contacting Support, Please Provide

• Workspace name
• Connected company file details
• Relevant workflow or operator information
• Error messages or screenshots when available

This helps the support team investigate and resolve issues more quickly.

---

Related Documentation

• Integrations Overview
• OAuth2
• Security & Privacy
• Supervity Website