Integrations

QuickBooks Integration

Bills, expenses and vendors created in QuickBooks from the documents, without the typing.

Overhead view of a woman at a laptop spreadsheet with printed bills, a calculator and an envelope

What moves

What flows between QuickBooks and PTAS AI

Documents and master data come in. Bills, vendors, attachments and status go out. QuickBooks stays the ledger; the typing stops.

QuickBooks Online

Vendor, Bill, Purchase, PurchaseOrder, BillPayment

The documents

Supplier bills, receipts, statements, delivery notes

Your coding rules

Chart of accounts, classes, locations, approval limits

PTAS AI

Bills created, not typed

One Bill or Purchase per document, lines coded, the PDF linked, written only after approval.

Payment status back in the queue

BillPayment and Bill changes arrive by webhook, so FinSuite knows what was paid without anyone checking.

A trail on both sides

The QuickBooks transaction Id sits on the invoice record in FinSuite; the invoice image sits on the Bill.

QuickBooks is a planning example here, not a packaged connector. Whether your file is QuickBooks Online or Desktop, which objects we write and who approves what are confirmed during assessment.

How FinSuite posts to a ledger

Integration methods

How QuickBooks can be connected

Four ways in, and QuickBooks Online makes the first choice easy. Desktop is a different conversation.

Native

What QuickBooks does itself

QuickBooks Online has its own receipt and bill capture for simple cases. It does not run your approval rules or match a bill to a purchase order. We do not list an app on the QuickBooks app store, and nothing on this page is a packaged connector.

API

QuickBooks Online Accounting API

REST over HTTPS, authorised by your QuickBooks admin through OAuth 2.0. Vendor, Bill, Purchase, PurchaseOrder, BillPayment and Attachable are the objects we read and write. This is what we would propose for almost every QuickBooks Online company.

File

QuickBooks Desktop

Desktop takes transactions through the QuickBooks Desktop SDK (qbXML over the Web Connector) or IIF import files. We treat both as file integration: batches on a schedule and a reconciliation report, rather than a live link.

Custom

Several company files, or several systems

Groups with four or five company files, or a QuickBooks that is one of three systems in the flow, usually need orchestration on top of the API: one queue, one approval policy, one authorisation per company file.

Our default for QuickBooks Online is API integration: the Accounting API for reads and writes, and Intuit webhooks for change notifications on Bill, Vendor and BillPayment, so payment status reaches FinSuite without polling. Intuit withdrew QuickBooks Online from India in 2023, so the companies we see on it are usually the overseas entities of an Indian group, or businesses run from the US, UK, Canada or Australia with tax handled by that edition. Rate limits apply per company file and the sync is sized to stay inside them.

What we would not automate. A Bill does not get created until the vendor exists, the coding passed validation and someone with the right limit approved it. Anything else waits in the review queue, because in QuickBooks a Bill affects payables the instant it is written, and undoing it later is slower than deciding first.

Field mapping

Where each finance object lands in QuickBooks Online

The mapping is agreed before build and kept per company file. This is the starting point we bring to the assessment.

Finance objectIn QuickBooks Online
Vendor Vendor: DisplayName, terms, default expense account, tax registration where the edition holds it. We match on bank details and registration number before a new vendor is created, not on name alone.
Purchase order PurchaseOrder, available on the Plus and Advanced plans. Matched line by line and referenced from the Bill. Where you do not raise POs in QuickBooks, the PO stays in FinSuite.
Goods receipt There is no GRN object in QuickBooks Online. A delivery note read by DocPro gives FinSuite the third leg of the match, and the note is attached to the Bill as evidence.
Invoice Bill with item-based or account-based expense lines, Class and Location on each line, the PDF linked through Attachable. Due date and terms come from the vendor unless the document says otherwise.
Tax TaxCode per line and TxnTaxDetail on the Bill. Sales tax, VAT or GST follows the edition you run. We validate the document against it and hold mismatches for review rather than overwrite the code.
Payment status BillPayment and the Balance on the Bill, read back by webhook when QuickBooks changes them, or on a schedule where webhooks are not enabled for the company file.

The entry, on both sides · Illustrative example

FinSuiteValidated
VendorV-2041
Ledger5210
DimensionPlant 2
Net / tax₹ 2,29,000 / 41,220
Your ERPSystem of record
Creditor2041
GL account5210
Cost centrePLANT2
Document4500091827Posted
Linked both ways The ERP document carries a link back to the invoice image it came from.

Field mapping is yours to define. Entries are validated against it before they reach the ERP, not rejected by it afterwards.

Security of the connection

What protects the link to your company file

Four controls, each one visible to your admin. None of them depends on trusting us.

OAuth 2.0, granted by your admin

Your QuickBooks admin authorises the connection on Intuit's consent screen and can revoke it there. We hold no QuickBooks password. Tokens are stored encrypted and refreshed on Intuit's schedule.

Accounting scope and nothing else

The app asks for the accounting scope only: no payments scope, no payroll. The scope is reviewed at assessment against what the workflow needs.

Signed webhooks, verified

Every webhook from Intuit carries a signature computed with the verifier token. We check it before a payload is trusted. Unsigned or mismatched calls are dropped and logged.

Writes you can audit

Each Bill or Vendor we create records who approved it, which document it came from and the Id QuickBooks returned. A sandbox company first; production after you have seen the entries.

FAQ

Questions QuickBooks teams ask

Do you work with QuickBooks Desktop, or only Online?

Both, but differently. QuickBooks Online has the REST API and webhooks, so the link can be live. Desktop talks through the Desktop SDK and the Web Connector, or takes IIF files, and we plan it as a scheduled batch with a reconciliation report. If you are on Desktop Enterprise for inventory, tell us early; the batch is designed around the stock postings.

Will bills show up in QuickBooks before they are approved?

No. A Bill is a posted transaction in QuickBooks Online the moment it is created; there is no draft state. FinSuite holds the document until approval, then writes it. If you would rather approve inside QuickBooks Online Advanced using its workflow feature, we create the Bill first and leave approval there. One place approves, never both.

We have four company files. Does that need four integrations?

One integration, four authorisations. Each company file is authorised separately by its admin, and each has its own vendor list and chart of accounts, so the mapping is kept per file. The queue is shared, with the company as a dimension, so one team can work all four.

Is this an app on the QuickBooks app store?

No. The connection is registered as an app on a developer account and authorised privately for your company file. We do not claim a marketplace listing or a partnership with Intuit, and we would rather build it to your file than ship something generic.

Next step

Bring a month of bills and your chart of accounts

An assessment starts with your real documents and a sandbox company file. Nothing touches production until you have seen the entries.