The short version
---
Connecting QuickBooks Desktop
Setup takes about ten minutes. You don't need your own account with anyone else; PortaPro runs the connection.
---
Settings
Nothing is sent until you choose a Start date and an Income account for services, then click Save settings.
| Setting | What it does |
|---|---|
| Start date | Invoices dated before it stay out of QuickBooks, so history your old system already entered isn't sent twice. Use the day you moved to PortaPro. |
| Income account for services | PortaPro adds a "PortaPro Services" item on this account. Rentals & equipment use the same account unless you choose another, and then get their own "PortaPro Rentals" item. |
| Deposits | Hold deposits in a liability account or Record deposits as income. See Deposits below. |
| Deposit fees kept (cleaning, damage) | Where an amount kept from a refundable deposit posts. Same as services uses the services income account. |
| Deposit payments to | Undeposited Funds (recommended) unless you choose a bank account, so your bookkeeper still groups payments into bank deposits. |
| Cash discount account | Where an earned cash discount posts. Don't send cash discounts leaves it for you to record. |
| Credits account | Where account credits and credit notes post. Same as services uses the services income account. |
| Write-off account | Where write-offs post, usually Bad Debt. Same as services uses the services income account. |
| Tax codes and sales tax item | The codes for taxed and untaxed lines, and the sales tax item on each invoice. QuickBooks works out the tax. |
Your QuickBooks items
Under Your QuickBooks items, each of your services and each piece of equipment you've billed has its own row. Pick one of your own QuickBooks items (service, non-inventory or other charge items) and lines for it go across as that item, on that item's income account, so Sales by Item in QuickBooks reads the way it does today. Rows left on PortaPro item use the PortaPro items. Inventory items aren't offered: selling one would change QuickBooks' quantity on hand.
Classes
Under Classes, choose a QuickBooks class for each yard (a company with one location gets a single row, Every invoice and expense). Invoices, credit memos and expenses then carry their yard's class, so QuickBooks can show profit by yard. Turn class tracking on in QuickBooks first: Edit → Preferences → Accounting → Use class tracking, then add a class for each yard.
---
What syncs, and when
Every two hours through the workday while QuickBooks is open, plus Sync now on the card and Push to QuickBooks Desktop in an invoice's menu.
| PortaPro | QuickBooks Desktop |
|---|---|
| Customer | Customer, matched to one with the same name instead of duplicated. Names over 41 characters are shortened and a colon becomes a dash (QuickBooks rules). |
| Issued invoice dated on or after the start date | Invoice with every line, plus fees, surcharges and discounts as their own lines. Drafts are never sent. Edits go up again. |
| Settled payment | Receive Payment applied to its invoice, for no more than is still open there. Anything over is left as unapplied credit on the customer. |
| Earned cash discount | The discount on the payment that earned it. Since November 2026 each cash, check or bank payment earns its own share, so each carries its own share; an invoice from before that carries its whole discount on the payment that settled it. |
| Invoice voided in PortaPro | Voided in QuickBooks, after its payments are removed. Once. |
| Reversed or refunded payment | Removed in QuickBooks. What a customer kept after a partial refund goes across as its own payment. |
| Payment moved to another invoice | Removed from the old invoice and recorded on the new one. |
| Account credit | Credit memo, applied to an invoice when PortaPro applies it. A prepayment goes as an unapplied payment, applied the same way. Credits dated before your start date stay with your old books. |
| Write-off | The discount on a zero-dollar payment, posted to your write-off account (QuickBooks' own way of recording bad debt). |
| Expense (only if you turn it on) | A Check, or a Credit Card Charge when paid by card, with its vendor and category lines. |
A credit that's reversed in PortaPro, or sits on an invoice that's voided, is taken back off in QuickBooks.
Not sent: Stripe fees and payouts (Stripe takes them out of the payout, so record them from the deposit) and expense receipts (QuickBooks Desktop can't receive attachments).
Expenses
Expenses are off until you turn on Push expenses to QuickBooks on the card. If your bank or credit card already feeds QuickBooks, leave it off, or every expense is recorded twice. When it's on, choose Push expenses dated on or after, Paid from bank account, Paid from credit card and an account for each expense category. An expense in a category without an account is skipped and listed in the sync activity, never posted to a guess. Editing a sent expense updates it in QuickBooks Desktop; voiding it deletes it there.
Sales tax: each line carries the taxable or non-taxable code, and QuickBooks works out the tax from its own tax item. If its total differs from PortaPro's, the invoice still goes across and the sync log says by how much.
---
When QuickBooks is closed
If QuickBooks or the Web Connector isn't open, the sync stops and says so. Nothing is half sent: the next sync picks up where it left off.
---
Timesheet hours
Approved time-clock hours go to QuickBooks Desktop as Time Tracking entries when someone clicks Team → Timesheets → Send to QuickBooks. They are not part of the two-hourly sync. An owner or admin matches each person to a QuickBooks Desktop employee, or a vendor marked eligible for 1099, under Match people, and can pick the Pay items regular and overtime hours go on, so overtime is paid at the overtime rate when you create paychecks from time data. QuickBooks Desktop and the Web Connector need to be open while you send. Details: Getting Hours to Payroll.
---
Trying it on a sample company file first
QuickBooks Desktop comes with sample company files (File → Open or Restore Company → Open a sample file). Connect one to try the sync without touching your real books.
When you later connect a different company file, PortaPro notices before it sends anything. It clears the settings, its record of what was sent and the people matched for timesheets, and the card says "This is a different company file". Choose a start date and accounts again, and the next sync sends to the new file from the start date. Nothing in either QuickBooks file is changed or deleted.
---
QuickBooks Online and Xero
PortaPro sends to one set of books at a time. While QuickBooks Online, Xero or FreshBooks is also connected, no sync runs. Disconnect the one you are leaving.
---
Disconnecting
Disconnect stops syncing immediately. Nothing is deleted in QuickBooks, and PortaPro keeps track of what already went across, so reconnecting the same company file later doesn't duplicate anything.
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 Deposits setting has two choices:
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."
A connection that has never sent a deposit starts on Hold deposits in a liability account. Save settings saves without a liability account chosen; until you choose one (or choose Record deposits as income), deposit invoices wait, as described below. A connection that already sent a deposit to QuickBooks as income keeps Record deposits as income until you change it. Every account you pick is checked against your company file's lists when you save.
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. With an account picked here, it goes as a "PortaPro Deposit Fees" item on that income account; Same as services sends it as PortaPro Services.
What happens when the deposit is earned:
If deposits are held in a liability account and none is chosen, the settings say "Deposit invoices wait until you choose the liability account deposits are held in, under Deposits." Deposit invoices wait and the sync activity says "Choose the liability account deposits are held in, or record deposits as income, in the QuickBooks Desktop settings". Ordinary invoices keep going across.
---