How to use DROIDSYNC.

From the download to your first posted day, step by step, with the exact button names and a real screenshot beside each step. Select any screenshot to see it full size.

Windows 10 / 11PAR / Brink portal loginQuickBooks Desktop or QuickBooks Online
Guide 1

Install DROIDSYNC

One download for QuickBooks Desktop and QuickBooks Online. The installer sets up everything DROIDSYNC needs in its own folder on this PC, then opens the app.

What setup does
  1. INSTALL DROIDSYNC - CLICK ME FIRST
  2. Step 1 of 3: Installing components
  3. Step 2 of 3: Downloading the automation browser
  4. Step 3 of 3: Creating shortcuts and opening the app
Then, the first time the app opens
  1. Terms of Service
  2. Agree
  3. First-time setup

The first install can take 5–10 minutes; most of that is the browser component.

The installer's three steps, in order.
  1. Download the free beta and unzip it.
  2. In the DROIDSYNC folder, double-click INSTALL DROIDSYNC - CLICK ME FIRST. If this PC doesn't have Python yet, the installer downloads it from python.org for you.
  3. Leave the setup window open while it works through its three steps. Downloading the automation browser (about 150 MB) is the long part; then it makes the shortcuts and opens the app.

Steps 1–3 happen in your web browser, File Explorer and the installer window, before DROIDSYNC opens — so there is no app screen to show. The card above lists the installer's three steps.

  1. The Terms of Service come first. Read them, tick I have read and agree to these terms and press Agree. Nothing runs until you do; Quit closes the app.
The Terms of Service: tick the box, then Agree.
  1. First-time setup opens. The line along the bottom names its four pages: Your POS & books, Connect your POS, Your stores and Look, email — done. Guides 2 and 3 walk through the first three.
First-time setup, page 1.
  1. On the last page, Look, email — done, pick a look, add an e-mail address for the morning summary if you want one, and press Finish ✔.
  2. DROIDSYNC then asks once: Put a DROIDSYNC shortcut on your Desktop? Yes or No — it is always added to the Start menu, so Windows Search finds it either way. You can add the Desktop shortcut later in Settings → Advanced → Add shortcuts.

The last setup page and Windows' small shortcut question aren't pictured here.

Back up QuickBooks first. In QuickBooks Desktop: File → Back Up Company → Create Local Backup. It takes two minutes. See the beta deal.
  • A two-minute tour. Right after setup, DROIDSYNC offers a quick tour that lights up each button in turn — nothing runs while it is open. Help in the sidebar plays it again any time.
Guide 2

Connect the PAR portal

DROIDSYNC reads each store's Sales Summary by signing in to your PAR/Brink portal — the same portal you look at every morning. It only reads; it never changes anything in PAR.

In first-time setup
  1. Your POS & books
  2. Connect your POS
  3. Sign in to the portal once (opens a browser)
Then on Home, under Stores
  1. Log in to portal
  2. Type the password once
  3. Log in
Later
  1. Settings
  2. POS portal
Where the portal sign-in lives.
  1. On Your POS & books, pick PAR Brink POS and the QuickBooks you use, then press Next >. Not sure which QuickBooks? If it opens from an icon on a PC and asks for a company file, it's Desktop; if you sign in to it in a web browser, it's Online.
Setup, page 1: your POS and your books.
  1. On Connect your POS, A. Portal login is how DROIDSYNC reads PAR today (PAR API access is marked Coming soon). Check the Portal address, type your Portal username, and keep the suggested Reports folder unless you want another. The ? beside each box explains it.
  2. Press Sign in to the portal once (opens a browser) and log in on your portal's own page, the way you always do. Then press Next >. You can also do this later from Home.
Setup, page 2: the portal details and the one-time sign-in.
  1. After setup, press Log in to portal on Home (under the Stores table) and type your portal password once, then Log in. Windows encrypts it on this PC, so scheduled runs sign in by themselves.
Log in to portal asks for the password once.
  • Changed your portal password? Press Log in to portal again and type the new one. “Forget saved password” removes it.
  • PAR's official API is being built and isn't offered yet; the portal login is how DROIDSYNC reads PAR today.
  • How the password is protected: the FAQ and Safety & Security.
Guide 3

Connect QuickBooks

Each store posts into its own QuickBooks company. You connect each one once, on this PC — and DROIDSYNC never asks for your QuickBooks password.

QuickBooks Desktop
  1. Your stores
  2. Find my stores automatically
  3. Connect QuickBooks
  4. Connect now

QuickBooks then asks its own permission question, once per company.

QuickBooks Online
  1. Connect QuickBooks Online
  2. Connect now
  3. Intuit's sign-in page
  4. Connected!
The one-time connection, for each kind of QuickBooks.

QuickBooks Desktop

  1. On setup's Your stores page, leave Your QuickBooks: on QuickBooks Desktop and press Find my stores automatically. It reads your store list from the portal and pairs each store with its company file (.qbw) on this PC; untick any you don't want and press Add the ticked stores. Or press + Add one by hand.
Setup, page 3: your stores (here, the demo's three made-up stores).
  1. After setup, press Connect QuickBooks on Home (under the Stores table) and pick the store next to Store:.
  2. Open QuickBooks on that store's company file and log in as Admin.
  3. Press ▶  Connect now.
  4. QuickBooks itself asks whether to let DROIDSYNC in. Pick the last answer — “Yes, always allow access; even when my QuickBooks isn't running” — then Continue, Yes, Done. Leave “allow access to personal data” unticked.
  5. When the sheet says the store is connected, pick the next store and repeat. You never have to do it again on this computer.
The Connect QuickBooks sheet spells out the same steps. QuickBooks' own permission window isn't pictured.

QuickBooks Online

  1. On setup's Your stores page, pick QuickBooks Online next to Your QuickBooks: — or later, in Settings → Stores.
Setup, page 3, with QuickBooks Online picked.
  1. Press Connect QuickBooks Online on Home (under the Stores table), pick the store and press Connect now.
  2. Your browser opens Intuit's own sign-in page: log in and pick that store's company. When the browser says Connected!, go back to DROIDSYNC. The link renews itself.
The Connect QuickBooks Online sheet. Intuit's sign-in page opens in your browser and isn't pictured.
  • QuickBooks Online for real companies opens as soon as Intuit approves DROIDSYNC — until then email us and we set you up personally, usually the same day.
  • Taking it back: in QuickBooks Desktop, Edit → Preferences → Integrated Applications; in QuickBooks Online, Settings → Apps.
  • Settings → Support → Connection check... tests the live connection for each store.
Guide 4

Set up account mappings

Mappings say where each line of the POS Sales Summary lands in QuickBooks. One shared set covers every store unless you choose otherwise.

The quick way
  1. Account mappings
  2. Learn my books
  3. Study my books
  4. Apply the ticked changes
By hand
  1. Journal
  2. Deposit
  3. Paid outs
  4. + Add rule

Each rule is a report line, the QuickBooks account it goes to, and Debit or Credit.

Two ways to build your mappings.
  1. On Home, press the small Run on step 1, Get POS reports, so DROIDSYNC has a real report to read. This step only reads the portal; nothing is posted.
Home's status card: each step has its own Run.
  1. Open Account mappings in the sidebar.
  2. Next to Post the day's sales as: choose Journal entry, Sales receipt or Invoice. An invoice is money owed and stays open until a payment is applied, so for sales already paid, Sales receipt is usually the one.
Account mappings, on the Journal tab.
  1. The quick way: press Learn my books. Pick a store, how many Days to study (days your bookkeeper already posted by hand) and the Ending day, then press Study my books.
  2. Every suggestion comes with its evidence. Tick the ones you want and press Apply the ticked changes. Nothing changes until you apply.
Learn my books before a study. Suggestions appear once it has read your POS reports and QuickBooks.
  1. Or map by hand: on the Journal, Deposit or Paid outs tab press + Add rule. Pick the Report line (label), type the QuickBooks account exactly as it appears in your chart of accounts (Parent:Sub for a sub-account), choose Debit or Credit for a journal rule, and press Save.
A journal rule being filled in: report line, account and side.
  1. On the Deposit tab, set Deposit into bank account and Verify against report line(s), pressing Save beside each.
The Deposit tab: the bank account and the lines the deposit is checked against.
  • New tender? When the sync finds a money line that isn't mapped, a “New money lines found” window asks which QuickBooks account it belongs to.
  • View a POS report (on this page, or in the Run menu) lists every label you can use in a mapping.
  • Preview what would post shows what your mappings make of the last report, without posting anything.
  • Use one set of mappings for every store is on to start; switch it off to give a store mappings of its own.
  • Names must match your chart of accounts exactly — see DS-515, DS-516 and DS-550.
View a POS report, on the demo's made-up report. A real Sales Summary has many more lines.
Guide 5

Your first sync — Preview first

Before you trust it with the nightly books, look. Preview shows exactly what would post, and nothing is sent to QuickBooks.

Look first
  1. Filters
  2. Run daily sync ▾
  3. Preview - reads, never posts
Then post
  1. Run daily sync
  2. Get POS reports
  3. Post into QuickBooks
  4. Result

On the keyboard: Ctrl+Shift+R previews; Ctrl+R runs the sync and asks first.

Preview, then run.
  1. Back up QuickBooks (File → Back Up Company → Create Local Backup). DROIDSYNC reminds you once, before your first import.

QuickBooks' backup window and DROIDSYNC's one-time reminder box aren't pictured here.

  1. On Home, open Filters (top right) and tick the stores to include under Stores in runs — or press Include every store.
  2. Syncing yesterday? Leave the date alone. For another day, open the ▾ beside Run daily sync, choose Sync a past day... and type the date as MM/DD/YYYY (blank means yesterday).
Filters open, and the Sync a past day box in the status card.
  1. Preview reads the reports DROIDSYNC last downloaded, so first press Run on Get POS reports (step 1). It only reads the portal.
Step 1 on its own: Get POS reports.
  1. Open the ▾ beside Run daily sync and choose Preview - reads, never posts — or press Ctrl+Shift+R.
The Run menu: Preview, a past day, Payroll, a POS report, and the run options.
  1. For each store, Preview shows the journal entry lines and whether they balance, the deposit and the bank account it goes into, and any problems the real run would hit. QuickBooks isn't opened.
Preview of the demo's made-up reports: “No problems found — the real run would post exactly this.”
  1. Happy with it? Press Run daily sync. Step 1 gets the POS reports, Step 2 posts into QuickBooks, and a progress bar shows how far along it is. Stop after current step stops it cleanly between steps.
A scripted demo run: Step 1 done, Step 2 posting.
  1. When it finishes, Result says how it went — for example Clean · 0 problems — and the money cards and Activity show the day.
  2. Open QuickBooks and check the entries against your POS report. Every one carries a DroidSync memo.
Finished: Result reads Clean · 0 problems. The check in QuickBooks isn't pictured.
  • Re-running is safe. DROIDSYNC asks QuickBooks first and skips a day that's already posted.
  • Run options, in the same menu: Show browser window · Force re-run (even if today's sync already finished OK) · Allow old report files (skips the ‘downloaded today’ check).
  • Each step also has its own Run, to do one step at a time.
Guide 6

Schedule the morning run

Set a time once, and the sync runs every day by itself — with a plain-English summary waiting when it's done.

One daily run
  1. Settings
  2. Schedule
  3. Run every day at: 05:00
  4. Save settings
Or one timer per store
  1. Minutes apart: 30
  2. Set up
The summary by e-mail
  1. Email
  2. Email the summary to
  3. Send a test
Settings → Schedule and Email.
  1. Open Settings in the sidebar (Ctrl+,) and pick Schedule.
  2. Tick Run every day at: and type a 24-hour time, for example 05:00.
  3. Leave Close QuickBooks before a scheduled run ticked (it is by default), so the early run opens the right company file.
  4. Several stores? Instead of one run for all, use One timer per store: set Minutes apart: and press Set up. Each store gets its own browser, and a store can have its own start time (Settings → Stores → Edit).
  5. Press Save settings (top right).
Settings → Schedule.
  1. For the summary by e-mail, open Email and type an address in Email the summary to.
  2. Tick Daily summary — after every sync. The monthly report on the 1st is optional.
  3. Press Save settings, then Send a test. The first e-mail is a confirmation link; click it once and the summaries start.
Settings → Email, with an example address.
  • The PC must be on and you must be signed in to Windows at that time. If the PC is asleep, Windows wakes it for the run, as long as wake timers are allowed in Windows' power settings. If it was off, the sync starts as soon as it's turned on again, and a failed run retries every hour (up to 4 tries).
  • No e-mail set? The morning summary is saved on your Desktop as a text file instead. E-mailed summaries are sent through DROIDSYNC's mail relay.
Guide 7

Read the dashboard

Home answers one question first — did last night's books post? Dashboard and Compare show the last 30 days, built only from what DROIDSYNC posted.

Every morning
  1. Home
  2. The status card
  3. The money cards
  4. Stores
The last 30 days
  1. Dashboard
  2. Compare

None of these screens opens QuickBooks — they read DROIDSYNC's own record of what it posted.

Where the numbers are.
  1. On Home, the top card answers the first question — “All stores posted for …”, or which store needs a look. The next sync time sits under the Run button.
  2. The four money cards show the day: Net sales (next to a typical same weekday), Deposits posted, Journal total and Over / short against your per-store limit.
  3. In the Stores table each store has the day's sales, its over/short and a status — Posted, Problems, No runs, Noted, Closed or Closed?. Click the status for the details.
Home the morning after a clean sync, in demo mode.
  1. Each store's row carries its last 30 days as squares: green when posted (darker means more sales), amber for over/short past the limit or problems, red when not posted, and an outline when there's no sync record. Point at a square for that day's numbers; click it to open the day.
Pointing at a day shows its numbers.
  1. Dashboard: every store, every day of the last 30 — the same squares, then a card per store with its net sales, deposits, over/short, days posted and what needs a look. Press Refresh after a run.
Dashboard: the last 30 days, store by store.
  1. Compare: stores ranked by net sales over the last 7 days or 30 days against the period before, with labor as a share of sales (when your POS reports labor), over/short and one plain sentence each. Who led each day underlines the day's top store.
Compare: the ranking, and who led each day.
  1. The morning summary (by e-mail, or a text file on your Desktop) lists each store's numbers, then anything under “PROBLEMS - these need a human:”, then “WORTH A LOOK:” — where a drawer that runs short or over several days in a row gets flagged.
The morning summary, in outline
STORE NUMBERS
  each store — deposit, net sales, over/short

PROBLEMS - these need a human:
  anything that needs you, with its DS- code

WORTH A LOOK:
  for example, a drawer short several days running
Its layout — not a real summary.
  • It never has to open QuickBooks to draw these — they come from DROIDSYNC's own record of what it posted.
  • For month-end, Reports → Close My Month turns the month into a one-page calendar per store.
Guide 8

Undo an import

Posted a day with the wrong mapping? Take it back cleanly. Only entries carrying DROIDSYNC's own memo marker are listed — hand-entered transactions never appear.

In the sidebar
  1. Undo imports
  2. Look back: Last 24 hours
  3. Find DROIDSYNC entries
  4. Delete ticked entries
  5. Type DELETE

The app asks once more, in its own words: “This permanently removes N DROIDSYNC entries from QuickBooks. Your bookkeeper's own entries are never touched.”

Undo DROIDSYNC imports, step by step.
  1. Click Undo imports in the sidebar, just above Settings. It has its own place there, so it's always one click away.
The sidebar: Undo imports sits just above Settings.
  1. Choose Look back: — Last 15 minutes, Last hour, Last 24 hours, Last 7 days or Last 30 days. It counts when DROIDSYNC created the entries, not their dates.
  2. Untick any store you want left alone, and tick Include payroll hours if you want those too.
Undo DROIDSYNC imports, before a search.
  1. Press Find DROIDSYNC entries. Only entries carrying DROIDSYNC's own memo marker are listed, all ticked to start.
  2. Untick anything you want to keep, then press Delete ticked entries.
The list after a search. Demo mode has no QuickBooks, so these rows come from the demo's own records.
  1. Type DELETE and press Delete them.

The last check is a small “Really delete?” sheet with one box for the word DELETE. It isn't pictured here.

  1. Fix the mapping, then open Reports → Missed-day check to re-post the removed days cleanly.
The Missed-day check card on the Reports page.
  • Journals, deposits, sales receipts, invoices, payroll hours and vendor bills that DROIDSYNC posted can all be listed. Names it added, such as a vendor or employee, stay.
  • If QuickBooks refuses, check the company's closing date, and that you're signed in as Admin in single-user mode.
Guide 9

Payroll, positive pay and monthly reports

The pay-period and month-end chores, each in its own window. Payroll has its own place in the sidebar; the rest are cards on the Reports page — pinned ones first, and the whole card opens the report.

Reports: pinned first, then grouped; every card says whether it needs you.

Payroll hours

  1. Open Payroll in the sidebar — or choose Payroll... in the Run menu (the ▾ beside Run daily sync).
The Payroll sync window.
  1. Pick the pay period: type the dates, use Calendar ▾ (click the first day, then the last), or a Quick pick like Last 2 weeks.
  2. Tick the stores under Stores.
Calendar ▾: click the first day, then the last.
  1. Press Pull payroll (Step 1). It writes every employee's hours into a review spreadsheet; nothing is posted yet.
  2. Review it in Excel: change any number, set Include to No on rows to skip, and save.
  3. Press Import into QuickBooks (Step 2). Your numbers win, hours already posted are never posted twice, and QuickBooks still builds the paychecks.
  4. Optional: under Automatic schedule, pick how often it repeats — Daily, Weekly, Every 2 weeks, Monthly or Quarterly — and a time, then press Turn ON automatic sync.
The two steps, and the automatic schedule.

Positive pay

  1. Open Reports → Positive pay. Set the Pay date:, the Bank account: and who it goes to under E-mail to:, and tick the stores.
  2. Press Build and e-mail now (or Build only). You get the file your bank's positive-pay upload wants — Type, Date, Num, Name, Memo, Amount.
  3. Upload it at your bank yourself; the app never touches the bank. Automatic - on payroll mornings can build it on the days of the month you choose.
Positive pay, from the Pay date row down.

Month-end

  1. Close My Month: pick the Month: and press Preview for a calendar per store — clean, problem and missing days — with deposits, net sales and over/short. Save + open (HTML) keeps it as one page; Export to Excel makes a workbook for your accountant.
Close My Month, previewing last month.
  1. Sales Tax Helper: one month of sales tax per store, day by day, with the net sales it was collected on — ready to check against your state filing.
Sales Tax Helper, with example rates for the demo stores.
  1. Monthly Excel export: pick the month and press Create workbook — the whole month, every store, in one file. A tick box builds last month's by itself, and Settings → Email can send the monthly report on the 1st.
Monthly Excel export.
  • Employees to import... in the Payroll window (after Step 1) unticks anyone whose hours should never be sent.
  • Names are never guessed. A POS name that doesn't match anyone in QuickBooks is reported by name, and everyone else's hours still post.
  • Payroll files (Intuit) makes IIF and CSV import files with no QuickBooks connection needed.
  • QuickBooks Online Payroll paychecks can't be read by apps, so positive pay tells you to add those from Payroll's own paycheck list.
Guide 10

Use error codes

When something needs you, DROIDSYNC says so in plain English — what happened, what to do — and gives it a DS- code you can look up.

How a problem reads in the app
[DS-514] QuickBooks wouldn't open the company file.
What to do: Close QuickBooks if it's on another company; dismiss dialogs; or authorize the app.
Error code DS-514 — look it up on the Error Decoder page of the DROIDSYNC website.
Where to see it
  1. Home
  2. Problems ›
  3. What needs a human
  4. What to do

Open the Error Decoder

The message format every DS- code uses.
  1. After a run, a store that needs you shows Problems › in the Stores table, with its Next step right under it. After a run you started yourself, a DROIDSYNC — attention needed window lists what went wrong too.
Home when one store needs a look (a made-up demo problem).
  1. Click the store's Problems › badge (or Open details). What needs a human says what happened, What to do says how to fix it, and Today's log, this store shows the log lines when there are any.
  2. Every message carries a DS- code, like [DS-516] here. Look it up on the Error Decoder for the full explanation and fix.
  3. Fixed it? Run again — nothing posts twice. Or press Dismiss - I've seen this: the badge turns to a quiet Noted until a later run has problems of its own.
  4. Still stuck? Email the code and today's log (Open log folder) to [email protected].
The store's details: what happened, and what to do.
  • A scheduled run that hits a problem also leaves a DROIDSYNC ALERT text file on your Desktop, so you can't miss it.
  • Settings → Support → Create diagnostics zip packs the logs for a bug report with every password and token stripped out. It's saved on your PC; nothing is sent until you attach it to an e-mail.
  • Bugs and ideas: the feedback page.
Guide 11

Try demo mode

Demo mode opens DROIDSYNC with two made-up stores — Northside and Lakeview, of Demo Restaurants LLC — and scripted syncs. No POS portal and no QuickBooks are touched. Every screenshot on this site was taken in demo mode, with a third made-up store, Riverside, added for the pictures.

The demo company

Demo Restaurants LLC, with two made-up stores: Northside and Lakeview. Every number is made up.

What it never touches

Your POS portal, QuickBooks, Windows' Task Scheduler, your Desktop and updates. Its data lives in a throwaway folder.

Demo mode, in short.
  1. Demo mode is started with DROIDSYNC's demo switch; there isn't a button for it in the app yet. Email us and we'll walk you through opening it.

Starting demo mode happens before the app window opens.

  1. You'll see the orange DEMO badge beside the greeting at the top of Home, and DEMO in the window title. The Activity card's Log view says “DEMO MODE - Demo Restaurants LLC, 2 stores, scripted syncs, nothing real is touched.”
Home in demo mode, with the DEMO badge beside the greeting.
  1. Press Run daily sync and watch a scripted run finish in a few seconds.
A scripted run in progress.
  1. Look around Dashboard, Compare, Reports and Settings — they're filled with made-up history.
Dashboard
Compare
Reports
Settings
Four pages to try in demo mode. Select one to enlarge.
  1. To leave, close the app and open it normally. Demo mode lasts only for that session.

Leaving demo mode is just closing the app window.

  • In demo mode, Log in to portal and Connect QuickBooks only write a note in the log. No schedules, no Desktop files, no updates, and the demo's data goes to a throwaway folder.
  • Want to see the real thing on your own books, safely? Use Preview: it shows exactly what would post without posting anything.
Guide 12

Get around with the keyboard

Every page is a key or two away. The sidebar shows each page's shortcut right beside its name.

Go to anything
  1. Ctrl+K
  2. Type part of a name
  3. Enter
Every shortcut
  1. F1
Two keys to remember.
  1. Press Ctrl+K to open Go to.
  2. Type part of a page, report or store name, move with the arrow keys, and press Enter. A store opens its status details.
Go to (Ctrl+K): pages, reports and stores.
  1. Press F1 for the full list of shortcuts. Esc closes a menu or a card.
Keyboard shortcuts (F1).
  • Ctrl+1 … Ctrl+9 open the sidebar pages in order, top to bottom; Ctrl+, opens Settings.
  • Ctrl+R runs the daily sync and asks first; Ctrl+Shift+R previews. Ctrl+L reopens the last report you used.
  • Shortcuts never fire while a question or card is open, so a key can't act behind your back.
  • The What's coming link beside the version number, at the bottom of the sidebar, shows what's being built next.

Still stuck?

A human reads every message.

Error Decoder

Every DS- code, what it means and how to fix it.

Look up a code

Feedback & bugs

Tell us what works, what's confusing, and what broke.

Send feedback

Email us

Setup help, QuickBooks Online early access, or just a question.

[email protected]