Accounting: Invoice export
QuickBooks Online integration: export invoices from InvoiceQuickly
On the Business plan ($19/month), an owner or admin connects one QuickBooks Online company through Intuit's own sign-in, chooses an income account, a product or service item and a tax code for each tax rate the invoices use, and then exports the invoices they pick: up to 25 at a time from the Accounting page, or one at a time with Export to QuickBooks on an invoice. Each export creates the client as a QuickBooks customer if needed, then the invoice with its number, dates, lines, discount and tax. Exporting the same invoice again updates it. InvoiceQuickly never emails the invoice, never charges your client and never records payments in QuickBooks, and nothing changes in QuickBooks until you choose Export.
How it works
Connecting QuickBooks Online to InvoiceQuickly, step by step
Step 1: Connect QuickBooks Online as an owner or admin
On Business, open Integrations, then Accounting, and choose Connect QuickBooks. You sign in on Intuit's page and approve access for one company. InvoiceQuickly receives an OAuth 2.0 grant for the QuickBooks accounting scope, never your QuickBooks password, and stores the connection tokens encrypted. Team members without the owner or admin role cannot connect, map or export.
Step 2: Choose the income account, item and tax codes
Set up mapping lists the active income accounts in your company. Pick one, then a Service or Non-inventory item that posts to it, or let InvoiceQuickly create a service item called InvoiceQuickly services for that account. Then choose a QuickBooks tax code for each tax rate that appears on your invoices. Every choice is checked against QuickBooks' current lists before it is saved.
Step 3: Select the invoices to export
The Accounting page lists your 50 most recent invoices, leaving out estimates and cancelled invoices, with each one's state in QuickBooks. Tick up to 25 and choose Export. Each invoice is sent on its own, so one refusal does not stop the others. For a single invoice, open it and choose Export to QuickBooks from its actions menu.
Step 4: Read the result on each invoice
Each row shows Exported, Updated, or the reason QuickBooks or InvoiceQuickly refused it. If QuickBooks calculates a different total, for example because automated sales tax recalculated from the customer's address, the result shows both totals. QuickBooks has no draft invoices, so an InvoiceQuickly draft arrives as an open invoice.
Step 5: Export again to update, and record payments in QuickBooks
Exporting an invoice again replaces the customer, number, invoice date, lines, discount and tax in QuickBooks, plus the due date, note and message when they are set. Class, location, terms, shipping, custom fields, email status and online payment settings stay as they are in QuickBooks. An invoice that already has a payment in QuickBooks is left unchanged. Payments your clients make, including through Stripe or PayPal links, are recorded in QuickBooks by you with Receive payment.
Why connect it
What connecting QuickBooks Online gives you
What you get
- Each exported invoice keeps its InvoiceQuickly number, dates, line descriptions, quantities, rates, discount and tax in QuickBooks, instead of being retyped
- The client becomes a QuickBooks customer with email, phone and billing address on the first export, and that customer is reused afterwards
- Lines post to the income account and item you chose, and tax uses the code you mapped for each rate, so nothing lands on a default account
- An export history of the latest 50 results, with QuickBooks' own message when an export is refused
- A safe retry: after a timeout, InvoiceQuickly looks for the invoice in QuickBooks before creating it again, so a lost response does not leave a duplicate
Best for
- Freelancers and small businesses who invoice in InvoiceQuickly and keep their books, or have a bookkeeper keep them, in QuickBooks Online
- Owners who want each sales invoice in QuickBooks with its real lines and tax instead of a monthly summary entry
- Bookkeepers who prefer to choose which invoices reach the ledger and see a per-invoice result
- Not a fit if you need payments to flow into QuickBooks, invoices to arrive with no one choosing Export, or QuickBooks Desktop: this connection covers QuickBooks Online invoices and customers only
Reference
What InvoiceQuickly sends to QuickBooks Online
Field names on the right are QuickBooks Online's. Only the invoices you export are sent, and only these fields.
| InvoiceQuickly | QuickBooks Online | Notes |
|---|---|---|
| Client company name, or name if there is no company | Customer display name | Followed by the first 8 characters of the client's ID in brackets, because QuickBooks needs display names to be unique. A client billed in a second currency gets a separate customer with the currency added. |
| Client company, email, phone and address | Company name, email, phone and billing address | Sent when the customer is created. A customer that was already exported is reused as it is. |
| Invoice number | Invoice number | Sent as it is, for example INV-0042. QuickBooks keeps it only when Custom transaction numbers is on, so invoices are exported only then. QuickBooks allows at most 21 characters, so longer numbers are refused. |
| Issue date and due date | Invoice date and due date | The due date is only sent when the invoice has one. |
| Currency | Currency | Sent when multicurrency is on in QuickBooks. With multicurrency off, only invoices in the company's home currency can be exported. |
| Each line: description, quantity, unit price, amount | One line on your mapped item | Every line uses the single item chosen in the mapping, in the order shown on the invoice. |
| Discount | Percentage discount line | Tax is applied after the discount, as InvoiceQuickly calculates it. |
| Tax rate | The tax code you mapped for that rate | US companies: lines are marked TAX or NON and the invoice uses the sales tax code you chose. Other countries: each line carries the mapped tax code, tax exclusive. |
| Notes | Private note | Internal to QuickBooks. |
| Terms | Message on the invoice | Shown to the customer if you send the invoice from QuickBooks. |
| Online card, ACH and PayPal payment options | Turned off on new invoices | The email status is left as not set, so QuickBooks neither emails nor collects on an exported invoice. |
| Payments, payment links, status, PDF and branding | Not sent | Record payments in QuickBooks yourself. |
Scroll sideways to see every column.
Reference
When an export is refused, and what to do
| Situation | What InvoiceQuickly does | What to do |
|---|---|---|
| Mapping not saved yet | Refuses every export | Choose the income account, item and tax codes under Set up mapping. |
| Custom transaction numbers is off in QuickBooks | Refuses every new invoice export, because QuickBooks would replace the invoice number; clients still export | Turn it on in QuickBooks under Settings, Account and settings, Sales, Sales form content, then export again. |
| The invoice's tax rate has no tax code | Refuses that invoice and names the rate | Edit the mapping and choose a tax code for the rate. |
| The invoice has tax but sales tax is off in QuickBooks | Refuses that invoice | Turn on sales tax in QuickBooks, then map the rate. |
| The invoice currency is not the home currency and multicurrency is off | Refuses that invoice; the checkbox is disabled | Turn on multicurrency in QuickBooks (it cannot be turned off again) or export home-currency invoices only. |
| The QuickBooks invoice already has a payment or deposit | Leaves it unchanged | Make any change in QuickBooks. |
| Estimate, credit note or cancelled invoice | Not offered or refused | Only invoices are exported. |
| No lines, or no client | Refuses that invoice | Add a line or a client to the invoice. |
| An earlier export was not confirmed and QuickBooks has more than one invoice with that number | Stops instead of guessing | Delete or renumber the extra invoice in QuickBooks, then export again. |
| QuickBooks refuses the change, for example in a closed period | Shows QuickBooks' message | Fix it in QuickBooks, then export again. |
Scroll sideways to see every column.
Setup
Setting it up
You need the InvoiceQuickly Business plan ($19/month or $190/year) and the owner or admin role in your InvoiceQuickly organization. Prepare QuickBooks Online first. Turn on Custom transaction numbers under Settings, Account and settings, Sales, Sales form content, so each invoice keeps its InvoiceQuickly number; while it is off, InvoiceQuickly refuses to export new invoices, because QuickBooks would number them itself and a retried export could create a duplicate. If you charge tax, turn on sales tax and set up the tax codes you charge, because an invoice with tax cannot be exported to a company with sales tax off. If you invoice in more than one currency, decide whether to turn on multicurrency; QuickBooks does not let you turn it off later, and without it only home-currency invoices export. Then connect from Integrations, Accounting, approve access on Intuit's page and choose the mapping. If you have no suitable item, the mapping form can create a service item called InvoiceQuickly services for the income account you picked. Export one invoice first and compare QuickBooks' total with the invoice in InvoiceQuickly; when they match, export the rest. Connecting a different QuickBooks company later clears the mapping, while the export history of each company is kept.
Good practice
Best practices
Export once the invoice is final
- You can export a draft, but QuickBooks has no drafts, so it arrives as an open invoice. Exporting after the invoice is sent avoids updates, and once a payment is applied in QuickBooks, InvoiceQuickly will not change that invoice.
Do not send the invoice again from QuickBooks
- Your client already has the invoice and its payment link from InvoiceQuickly. Exported invoices have QuickBooks' online payment options off and are not emailed; leave it that way so the client does not get a second invoice with the same number.
Record payments where the money is reconciled
- Payments recorded in InvoiceQuickly, including Stripe and PayPal link payments, are not sent. In QuickBooks, use + Create, Receive payment against the exported invoice, and match Stripe or PayPal payouts with a Bank Deposit that books the processor fee.
Map every tax rate before a batch
- The mapping form lists each tax rate found on your invoices and warns about rates still unmapped. Map them all first, so a 25-invoice batch does not stop on one rate.
Troubleshooting
Common issues
"Turn on Custom transaction numbers in QuickBooks before exporting"
- QuickBooks is set to number invoices itself, so it could give the exported invoice a different number, and InvoiceQuickly could not find it again after a lost response. In QuickBooks, open Settings, Account and settings, Sales, turn on Custom transaction numbers under Sales form content and save, then export again. InvoiceQuickly checks this setting before each new invoice and never changes it for you.
"Choose the QuickBooks tax code for the 8.25% rate before exporting"
- The invoice uses a tax rate that has no tax code in the mapping. Choose Edit mapping, pick the QuickBooks tax code for that rate and save, then export the invoice again.
"Invoice INV-0042 already has payments in QuickBooks, so InvoiceQuickly won't change it"
- A payment or deposit is applied to that invoice in QuickBooks, so its lines and total are what the payment was matched against. Make any correction in QuickBooks, or issue a credit note in InvoiceQuickly and enter the credit in QuickBooks.
The row says Not confirmed by QuickBooks
- The connection timed out or the response was lost, so InvoiceQuickly cannot tell whether QuickBooks created the invoice. Export it again: InvoiceQuickly first searches QuickBooks for that invoice number and customer and updates the match instead of creating a second invoice. If it finds more than one, it stops and asks you to remove the extra one.
QuickBooks' total differs from InvoiceQuickly's
- The result names both totals. In a US company with automated sales tax, QuickBooks can recalculate tax from the customer's address. Elsewhere, check that the mapped tax code has the same percentage as the invoice. Correct the invoice in QuickBooks if needed.
The card says Reconnect needed
- QuickBooks no longer accepts the saved connection, for example after access was removed in QuickBooks or the refresh token expired. Choose Reconnect QuickBooks and approve access again for the same company; the mapping and history stay.
Scope
What the QuickBooks Online connection does not do
- It never sends invoices: nothing is emailed to your client by InvoiceQuickly or QuickBooks, and online payment options are turned off on exported invoices.
- It never charges your client and never records, matches or syncs payments in either direction.
- It is one-way and manual. Invoices go to QuickBooks only when you choose Export, and payments, edits and statuses in QuickBooks are not copied back into InvoiceQuickly.
- The Accounting page offers your 50 most recent invoices, up to 25 per export; older invoices are exported one at a time from the invoice page.
- Estimates, credit notes and cancelled invoices are not exported. Every line uses one item and one income account.
- One QuickBooks Online company per InvoiceQuickly organization. QuickBooks Desktop is not supported.
- Business plan only. After a downgrade, owners and admins can still see the connection and history and disconnect, but cannot export.
Questions
QuickBooks Online and InvoiceQuickly: questions
Does InvoiceQuickly integrate with QuickBooks Online?
Yes, on the Business plan. An owner or admin connects a QuickBooks Online company, chooses the account, item and tax mapping, and exports selected invoices and their clients. It is a manual export of invoices you pick, not a payment or bank connection.
Will QuickBooks email the invoice to my client?
No. InvoiceQuickly creates exported invoices with QuickBooks' online card, ACH and PayPal payment options off and the email status not set. Your client receives the invoice from InvoiceQuickly only, unless you send it from QuickBooks yourself.
Are payments synced between InvoiceQuickly and QuickBooks?
No. Payments are not sent to QuickBooks and nothing is read back. Record each payment in QuickBooks with Receive payment, and mark payments in InvoiceQuickly as you do today.
What happens if I change an invoice after exporting it?
Export it again and InvoiceQuickly updates the same QuickBooks invoice: customer, number, date, lines, discount and tax, plus due date, note and message when set. QuickBooks-only fields such as class, location and custom fields are kept. If a payment is already applied in QuickBooks, the invoice is left unchanged.
What if I am on Pro or use other accounting software?
Use the invoice CSV. On Pro, the CSV button on the Invoices page downloads every document with 13 columns, including number, client, dates, currency, subtotal, tax, discount and total. QuickBooks' own invoice import takes up to 100 invoices per file and is not available once sales tax is set up in a US company.
Who can connect and export?
Owners and admins of the InvoiceQuickly organization. Members cannot see the Accounting page actions or the Export to QuickBooks button.
What happens when I disconnect QuickBooks?
An owner or admin chooses Disconnect on the Accounting page. InvoiceQuickly asks QuickBooks to revoke its access and deletes the saved sign-in. The customers and invoices already exported stay in QuickBooks, and the export history stays in InvoiceQuickly. If QuickBooks does not confirm the revocation, remove InvoiceQuickly from the connected apps in QuickBooks as well.
Sources
Official documentation
The QuickBooks Online steps on this page follow these official pages. Menus and plan limits change, so check them before you rely on a detail.
- Intuit Developer: QuickBooks Online Accounting API, Invoice (checked 2026-10-29)
- Intuit Developer: QuickBooks Online Accounting API, Customer (checked 2026-10-29)
- Intuit Developer: Set up OAuth 2.0 (checked 2026-10-29)
- Intuit Developer: Automated sales tax for US locales (checked 2026-10-29)
- Intuit: Record invoice payments in QuickBooks Online (checked 2026-10-29)
- Intuit: Import multiple invoices at once (US) (checked 2026-10-29)
Create your first invoice
The QuickBooks Online connection needs Business: $19/month or $190/year, with everything in Pro plus QuickBooks Online and Xero export and work imports from Clockify, Toggl Track, Harvest and ClickUp. Want to try invoicing first? The Free plan covers 5 invoices in total with PDF download.
Start with BusinessLast verified: October 2026