The short version
Why one way: the moment both sides can edit the same invoice you need a rule for who wins when your office changes an amount at 10:02 and your bookkeeper changes it in QuickBooks at 10:04, and every answer is bad. One-way push means the office runs the business in PortaPro and the bookkeeper categorizes and reconciles in QuickBooks, which is how bookkeeping already works.
---
Connecting QuickBooks
Navigate to Billing → Accounting → Accounting sync (it was under Financials before November 2026). Until an accounting software is connected the page asks Which accounting software do you use? Pick QuickBooks Online. The QuickBooks Online row reads Not connected until you connect it. Once it is connected, the page shows QuickBooks Online alone; the other three sit behind Switch accounting software.
Connecting and managing the integration is limited to organization owners and admins. Other office staff see the tab but not the Connect and Disconnect controls.
Reconnect needed appears when Intuit rejects the stored connection; tokens expire after roughly 100 days without use. Click Reconnect. Your existing mappings are kept, so nothing duplicates.
---
What syncs, and when
Every night (7:00 UTC) PortaPro pushes, in this order:
| PortaPro | QuickBooks | Rule |
|---|---|---|
| Customer | Customer | Name, email, phone, billing address. A tax-exempt customer is marked non-taxable in QuickBooks. |
| Issued invoice (open, partial, paid) | Invoice | Every line, with the invoice number, dates and taxability. Invoice-level surcharges, fees (such as a delivery fee) and discounts go across as their own lines on the Services item, so the QuickBooks total matches PortaPro's. Drafts are never pushed. |
| Settled payment (card, ACH, check, cash, custom) | Payment applied to the invoice | Applied up to what is still owed on the invoice in QuickBooks, less any cash discount the invoice earned; anything beyond that (an overpayment, or a payment on an invoice already paid there) stays as unapplied credit on the customer. |
| Invoice voided after it was pushed | Invoice voided | Voided once; a second void is never attempted. |
| Payment reversed or refunded after it was pushed | Payment voided | Reopens the invoice balance, as PortaPro does. |
| Goodwill credit, dispute credit | Credit memo | Posts to the Services income account. |
| Prepayment received | Unapplied payment | Cash on account, not a revenue reduction. |
| Credit applied to an invoice | Payment linking the credit to the invoice | Credit note and write-off included. |
| Cash discount earned (Cash Discount Program) | Credit memo applied to the invoice | One for each cash, check or bank payment that earned a discount, for that payment's share, dated the day it was paid. Card payments earn none. A reversed or refunded payment takes its credit memo off. See Cash discounts below. |
| Recorded expense (only if you turn it on) | Expense, or Check for check payments | Vendor, category lines and the first receipt attached. Off by default; see Pushing expenses below. |
Changes re-push: an edited customer or invoice goes up again the next night with its current values. Payments, credits and applications are recorded once. Money already in QuickBooks is edited there, never overwritten from PortaPro.
Not pushed, on purpose:
Partial refunds follow on their own: the refunded payment is voided in QuickBooks and the amount the customer kept goes across as a new payment on the next sync.
Hours are not part of the nightly sync. Approved time-clock hours go to QuickBooks only when someone clicks Send to QuickBooks on Timesheets. See "Sending approved hours from Timesheets" below.
---
Sync now, and pushing one invoice
---
Where revenue posts (income account mapping)
Under the connected row, Where revenue posts lists two kinds of invoice line:
Each starts on Company default, which posts through one QuickBooks item ("PortaPro Services") to your company's default Services income account. Choose an income account for a line kind and PortaPro creates a QuickBooks item for it ("PortaPro Rentals") on that account; the next push posts there. Deposits and the fees kept from them have their own settings below the list; see Deposits. Click Save mapping.
Changing an account later re-points the item. QuickBooks does not re-post history; only new lines land on the new account.
Cash discounts
Cash discounts sets where the Cash Discount Program's discounts post. The invoice goes to QuickBooks at the card price and a cash, check or bank payment pays less, so each discount a payment earns goes across as a credit memo applied to the invoice. An invoice paid in full at the cash price then reads paid in QuickBooks, as it does in PortaPro. Same as credits (the default) posts them through the "PortaPro Credits" item on your Services income account. Choose an income account and PortaPro creates a "PortaPro Cash Discounts" item on it.
---
Class tracking
If your QuickBooks company has class tracking on (Settings → Advanced → Categories, QuickBooks Plus or Advanced), a Class picker appears beside the account mapping. Choose a class and every pushed line carries it. Leave it on None to push without a class. The picker does not appear when class tracking is off, because QuickBooks would drop the class silently.
---
Sales tax
PortaPro tells QuickBooks what was actually charged: every invoice line is marked taxable or non-taxable from the tax on that line, and a customer marked tax exempt in PortaPro is marked non-taxable in QuickBooks. QuickBooks' Automated Sales Tax then computes the tax on its side.
When the QuickBooks total still differs from the PortaPro total (a rate the two systems have configured differently), the invoice is pushed and the sync log carries a warning: "QuickBooks total 382.50 differs from PortaPro total 388.24 (tax computed by QBO)". The rate table in QuickBooks is the bookkeeper's to correct; PortaPro never overrides it.
---
Reading the sync log
Recent sync activity under the integration row lists the last twenty results, newest first. Each row shows the outcome, the kind of record, the QuickBooks id where one exists, and any note.
---
Why PortaPro does not do two-way sync
Two-way sync sounds like more. In practice it is where accounting integrations go wrong, and PortaPro chose not to build it:
What PortaPro does instead is push *more* one way: voids, reversals, credit memos and prepayments, so the ledger keeps matching the business without anyone re-keying.
---
Disconnecting
Click Disconnect on the integration row. Syncing stops immediately. Nothing is deleted in QuickBooks, and the mappings are kept, so reconnecting later creates no duplicates.
---
Pushing expenses (optional)
PortaPro can push the expenses you record, including ones filed from the receipt inbox, to QuickBooks with the receipt attached. Turn it on with Push expenses to QuickBooks on Billing → Accounting → Accounting sync.
Leave it off if your bank or credit card feeds QuickBooks directly. "If your bank or credit card is connected to QuickBooks (its bank feed), leave this off: QuickBooks already gets those transactions from the bank, and pushing them from PortaPro too would record every expense twice." That is why it is off by default.
When it is on, set:
| Setting | What it does |
|---|---|
| Push expenses dated on or after | Older expenses stay out of QuickBooks |
| Paid from bank account | Where checks, cash, ACH and other expenses post |
| Paid from credit card | Where card expenses post |
| Where each category posts | The QuickBooks account for each PortaPro expense category |
Then click Save expense settings. Expenses go up on the next sync.
See Receipts and Expenses for recording expenses and filing receipts.
---
Sending approved hours from Timesheets
Team → Timesheets → Send to QuickBooks puts approved time-clock hours into QuickBooks as time entries, the timesheets QuickBooks Payroll reads when you run payroll. It shows while QuickBooks Online is connected. The same button sends to QuickBooks Desktop when that is connected instead: see QuickBooks Desktop Sync.
If QuickBooks refuses a day (a plan without time tracking, or a date inside a period you closed in QuickBooks), its message is shown next to the person and day. Full routine: Getting Hours to Payroll.
Deposits
A deposit a customer pays (a booking deposit, or a refundable cleaning or damage deposit) is their money until it is earned: applied to the final invoice, refunded, or kept as a fee. The account mapping has a Deposits setting with two choices:
| Choice | What QuickBooks shows while the deposit is held |
|---|---|
| Hold deposits in a liability account | The deposit invoice posts through a "PortaPro Customer Deposits" item on a liability account. Nothing is income yet. |
| Record deposits as income | The deposit invoice posts to an income account, as every push did before this setting existed. |
The note under the setting reads: "A deposit is the customer's money until it is applied to the final invoice, refunded or kept. Held in a liability account, it leaves that account by itself when that happens."
Which one you start on. A connection that has never sent a deposit starts on Hold deposits in a liability account. A connection that already sent a deposit to QuickBooks as income keeps Record deposits as income until you change it, so one set of books never holds deposits both ways without anyone deciding so. The choice is stored the first time a deposit goes across.
Liability account. With Hold deposits in a liability account, the Liability account picker lists your Other Current Liability accounts. Customer Deposits (added if you have none) (the default) uses your QuickBooks account named Customer Deposits, and adds one when you have none. Pick another and PortaPro checks it is one of your Other Current Liability accounts before saving. With Record deposits as income, the Income account picker sets where deposits post ("PortaPro Deposits" item, Company default unless you choose one).
Deposit fees kept (cleaning, damage). "What you keep from a refundable deposit, on its own invoice." When the office keeps part of a refundable deposit, PortaPro makes an invoice for the kept amount (for example, Cleaning fee) paid by the deposit, or by the amount charged from a card hold. A booking deposit kept on a cancelled booking (a "Cancellation fee") is the same kind of invoice. That invoice posts through a "PortaPro Deposit Fees" item on the income account you pick here. Same as services (the default) posts it through "PortaPro Services".
What happens when the deposit is earned
The liability clears itself; there is nothing to remember:
The deposit invoice is never voided while a payment is still on it in QuickBooks. If the final invoice isn't in QuickBooks yet (it is still a draft), or a move fails, the deposit invoice waits and the next sync finishes it. If QuickBooks will not re-point a payment, PortaPro voids it there and records it again on the final invoice; the sync log says so. If it will not void it either, the sync log says "Move it to the new invoice by hand in QuickBooks".
Push to QuickBooks on a deposit that was credited to its final invoice is refused: push the final invoice instead. That moves the deposit's payment onto it and voids the deposit right away.
The same moves apply to a revised invoice: a payment carried onto the revision is re-pointed in QuickBooks and the old invoice is voided after.
---