---
title: "How to Fix Failed Accounting Syncs | Topkey"
description: "Bills stuck in Failed or never sent to QuickBooks or Xero? See how property managers find, fix and resync them in Topkey before month-end."
canonical: "https://topkey.io/academy/how-to-fix-failed-accounting-syncs-in-topkey"
language: "en"
---

# How to Fix Failed Accounting Syncs in Topkey

Bills stuck in Failed or never sent to QuickBooks or Xero? See how property managers find, fix and resync them in Topkey before month-end.

Published

November 17, 2026

Product area

Accounting

![How to Fix Failed Accounting Syncs in Topkey: Accounting Sync shows 42 items synced to QuickBooks Online, including 18 bills, 21 card transactions and 3 invoices](https://topkey.io/assets/3f5fab7884/failed-syncs-thumbnail.png)

## Failed Syncs at Month-End

It's the third of the month and the books close Friday. You open Accounting in Topkey and find a column of red Failed badges, each with an error description.

Most accounting sync errors come from a short list of causes. A vendor made inactive in your accounting software, an account that was never mapped, or a setting that decides which bills get sent and when. Each one has a fix.

This guide shows how to find and fix accounting sync errors in Topkey for [QuickBooks Online](https://topkey.io/integrations/quickbooks-online), [QuickBooks Desktop](https://topkey.io/integrations/quickbooks-desktop), [Xero](https://topkey.io/integrations/xero), [Oracle NetSuite](https://topkey.io/integrations/oracle-netsuite) and [Sage Intacct](https://topkey.io/integrations/sage-intacct). It also covers the problem most teams miss. Bills, transactions and owner charges that nobody sent never fail, so nothing turns red, and they're missing from your books at month-end.

## Why Syncs Fail, and Why Some Never Try

### Most Accounting Sync Errors Come from a Few Causes

Topkey sends each bill, transaction and invoice to your accounting software with references attached, such as a vendor, a category, a class, a location and a payment account. If one of those references breaks, the sync stops and the bill or transaction is marked Failed.

That usually happens one of four ways.

1.  Someone deletes or deactivates a vendor, category, class or location in QuickBooks Online or Xero while Topkey still points to it.
2.  An account was archived in Topkey's own chart of accounts, such as a card's payment account.
3.  An account was never mapped, so Topkey doesn't know where the bill or transaction belongs.
4.  A payment account is the wrong type, since QuickBooks Online only accepts a Bank or Credit Card account as the account a payment comes from.

None of this means your books are wrong. Two systems disagree about a name or an account, and one of them needs updating.

### The Bills and Owner Charges Nobody Sent

A bill or transaction that fails to sync turns red. One that nobody sent doesn't, so it's easy to miss until the books don't tie out.

Bills, transactions and owner charges end up unsent in three ways.

-   Nobody clicked Sync. Unless your account has Automatic syncing turned on, you select bills or transactions and click Sync. Anything nobody synced stays at Ready to Sync.
-   A setting is holding it. Send bills to \[your accounting software\] is set to When paid by default, so an unpaid bill stays in Topkey until it's paid.
-   An owner charge never went to your PMS. Until someone clicks Send to PMS, the charge is missing from the owner's statement.

To find them, open Accounting and set the Accounting Sync filter to All Except Synced, or Ready to Sync on the Transactions tab.

For owner charges, go to Portfolio → Work Orders and filter Type to Only Owner Charges and your PMS's sync status to Draft.

Jesse Hehn, General Manager of Stay Sandpoint, a 100-unit property manager on Guesty, knows that risk well. "If a transaction gets miscategorized or doesn't push to an owner statement, it falls into a black hole and our company eats the cost." The fix isn't working harder at month-end. It's knowing where to look.

## How Accounting Sync Works in Topkey

### Where to See Sync Status

Start on Dashboard Home. It flags failed accounting transactions and bills, along with failed PMS work orders.

For the full list, click Accounting in the left navigation and choose Transactions, Bills, Invoices or Expenses. Each tab has an Accounting Sync filter. Failed shows what broke. All Except Synced shows everything that hasn't reached your accounting software yet. The Transactions tab doesn't offer All Except Synced, so use Ready to Sync there.

### What Each Sync Status Means

Every bill, transaction, invoice and expense in Accounting has a status in the Sync Status column.

-   Ready to Sync means it hasn't been sent yet.
-   Preparing means Topkey is getting it ready to send.
-   Merchant Syncing means Topkey is adding the vendor or merchant to your accounting software before it sends the bill or transaction.
-   Syncing means the bill or transaction itself is being sent.
-   Payment Preparing means the bill is in and Topkey is getting its payment ready to send. Bills only.
-   Payment Syncing means the bill's payment is being sent. Bills only.
-   Payment Pending means the bill synced but its payment is still waiting to be sent. Bills only.
-   Synced means it's in your accounting software and nothing else is left to send.
-   Manually Synced means someone on your team marked it as synced in Topkey. Topkey didn't send anything, so it's only in your books if someone entered it there.
-   Failed means the last attempt to send it hit an error, and nothing new went to your accounting software.

Missing GL Code is a warning rather than a status. Add the GL code and the transaction is ready to sync.

![How a bill or transaction moves through accounting sync, from Ready to Sync and Syncing to Synced, or from Failed to fixed and synced again](https://topkey.io/assets/42eacf7c63/failed-syncs-1-every-failed-sync-gets-back-to-synced.png)

### Reading the Error When a Sync Fails

Hover over the Failed badge. A tooltip names the accounting software that rejected it and shows the error, with the next step for the common ones. To see every error on the page at once, click the eye icon labeled Show sync errors.

This works the same for QuickBooks Online, QuickBooks Desktop, Xero, Oracle NetSuite and Sage Intacct. Only the wording changes.

![Hovering a Failed badge in Topkey shows the error from the accounting software](https://topkey.io/assets/19b838a4e7/failed-syncs-2-hover-failed.png)

## Common QuickBooks Online Sync Errors and How to Fix Them

These are the QuickBooks Online errors property managers see most, in the tooltip's own words.

![Six common QuickBooks Online sync errors in Topkey, what each one means and how to fix it](https://topkey.io/assets/aa284b4b0b/failed-syncs-4-quickbooks-online-errors.png)

### Xero, NetSuite and Sage Intacct Sync Errors

Xero, Oracle NetSuite and Sage Intacct write their own error messages, so the wording varies. The causes are the same, such as a record that changed, an account that isn't mapped or a date that doesn't line up.

For the errors you can fix yourself, Topkey writes its own message. These are the ones property managers see most, in Topkey's own words.

![Eight Xero, NetSuite and Sage Intacct sync errors in Topkey, what each one means and how to fix it](https://topkey.io/assets/45f62266d6/failed-syncs-5-xero-netsuite-sage-intacct-errors.png)

Where your connection supports it, the message links straight to the re-sync step. Otherwise, choose what to re-sync in your accounting settings and click Initiate Re-sync.

### Fixing Chart of Accounts and Payment Account Mappings

"Please select account" means Topkey doesn't know which account in your books a bill or transaction belongs to. You set that in three places in Topkey, so check each one.

-   Settings → Accounting → Chart of Accounts lists the accounts Topkey pulled from your accounting software. If the account you need isn't here, re-sync Chart of accounts from your accounting settings.
-   Settings → Accounting → Category & GL Rules decides which account each category goes to. Make sure the category on the bill or transaction points to an account.
-   Settings → Integrations → \[your accounting software\] → Manage → Accounts holds the default accounts, such as payment, bill, American Express, invoice, expense and reservation. Fill in any that are blank.

If different cards or bank accounts should post to different accounts, turn on the account override under Account overrides. A table appears where you match each card or bank account to its own account. If your chart of accounts itself needs work, start with our [chart of accounts setup guide for vacation rental property management](https://topkey.io/blog/chart-of-accounts-for-vacation-rental-property-management-setup-guide-template).

### Negative Bills, Missing Bill Numbers and Split Transactions

A few situations catch experienced teams. A bill with a negative total won't go to QuickBooks Online as a bill; record a vendor credit instead. A bill with no number can fail, and turning on Auto-assign bill reference number fills blanks with the bill ID followed by "-topkey." And when a transaction is split between an owner and corporate, only the owner split becomes an owner charge. The corporate split stays out on purpose.

## Syncing Failed Bills and Transactions Again

### Retry One or Many from the Failed Filter

Set the Accounting Sync filter to Failed. Check the bill or transaction you fixed, or click Select all matching to grab everything that failed, then click Sync. A banner shows progress while it runs.

After fixing a mapping, sync one bill or transaction first. If it goes through, the fix worked and you can send the rest.

The Accounting panel on a single bill or transaction only shows a button if it synced before. Resync sends it again when resyncing is allowed, and Sync Payment sends a bill's payment when the bill went through but the payment didn't. For anything that has never synced, use the Failed filter.

### Check the Results in Sync History

Sync History is the last tab in Accounting. It lists each sync run with counts for what synced, what's waiting on a payment and what failed. Click View on a run to see what was in it and each error.

## Settings That Decide What Syncs

Some missing bills and transactions aren't failures. They're waiting because of a setting in Settings → Integrations → \[your accounting software\] → Manage.

Send bills to \[your accounting software\] is set to When paid by default, so an unpaid bill stays in Topkey until it's paid. Switch it to When approved if you want bills in your books as soon as they're approved. Only sync completed transactions is off by default. If your account has Automatic syncing, you can turn on a daily sync for transactions, bills, invoices and expenses; each is off until you turn it on.

## Five Rules for Every Failed Sync

### 1\. Fix the Cause Before You Sync Again

**Why it matters.** Syncing a failed bill or transaction again without changing anything fails the same way.

**Do this.** Read the error, fix the vendor, account or mapping it names, then sync.

### 2\. Test One Sync After a Mapping Fix

**Why it matters.** One test sync tells you whether the fix worked before you send the rest.

**Do this.** Sync a single fixed bill or transaction first. If it goes through, select the rest and sync them together.

### 3\. Re-Import After You Change Records in Your Accounting Software

**Why it matters.** When a vendor, category, class or location is deleted or made inactive there, every bill or transaction that still points to it fails.

**Do this.** Re-sync from your accounting settings (choose Suppliers or Chart of accounts and click Initiate Re-sync), then choose an active record and sync.

### 4\. Look for What's Waiting, Not Just What Failed

**Why it matters.** Bills, transactions and owner charges nobody sent never turn red, so they're easy to miss until month-end.

**Do this.** Filter to All Except Synced, or Ready to Sync on the Transactions tab, along with Failed.

### 5\. Know Which Settings Hold Bills Back

**Why it matters.** Send bills to \[your accounting software\] is set to When paid by default, so an unpaid bill waits in Topkey on purpose.

**Do this.** Check that setting under Settings → Integrations → \[your accounting software\] → Manage, and switch it to When approved if you want bills in your books sooner.

## Spot Your Next Sync Fix

A few patterns point to what to fix next.

-   Same error on a lot of bills or transactions? It's likely one mapping. Fix it once in your integration settings.
-   Unpaid bills missing from your books? Check Send bills to \[your accounting software\].
-   Bills stuck on Payment Pending? Open the bill and use Sync Payment.
-   Owner charges missing from statements? Send them from Portfolio → Work Orders.

## Keep Your Syncs Working

### Two Filters, Once a Week

The easiest way to avoid a month-end hunt is to run two filters every week.

1.  Send what's waiting. Filter to All Except Synced (Ready to Sync on Transactions) and sync it.
2.  Fix what failed. Filter to Failed, read each error, fix the cause and sync again.

Save both as [custom views](https://topkey.io/academy/how-to-save-time-with-custom-views-in-topkey) and the routine is one click away.

![A weekly routine of two Accounting Sync filters, All Except Synced and Failed](https://topkey.io/assets/7b8ec10de3/failed-syncs-3-two-filters-a-week.png)

### Push Owner Charges to Your PMS

Owner charges need the same habit. Go to Portfolio → Work Orders, filter Type to Only Owner Charges and your PMS's sync status to Draft, select them and click Send to PMS. Anything already sent is skipped.

This works for [Streamline](https://topkey.io/integrations/streamline), [Guesty](https://topkey.io/integrations/guesty) and [Track](https://topkey.io/integrations/track) when it's set to send work orders and owner charges. [Hostaway](https://topkey.io/integrations/hostaway) receives expenses instead of owner charges.

If a push fails, open the work order. The error under its status says what's wrong and how to fix it, such as a property whose owner isn't linked to Guesty.

Ramin Roudi, Founder and General Manager of Sway VRM, a 48-unit property manager on Streamline, describes what changes when the routine sticks. "Now we have a system, we're not stressing, and by the 4th or 5th we feel good about it." That's the goal, a close you check, not one you chase.

## Put it into practice

See how this workflow fits your portfolio with a Topkey specialist.

[Book a demo](https://topkey.io/demo)

## Accounting Sync FAQ

Why Didn't My Bill Sync to QuickBooks?

Either it failed or it's waiting. Hover the Failed badge to read the error. No badge usually means the bill isn't paid yet, since bills sync when paid by default.

Does Topkey Sync to My Accounting Software Automatically?

Not by default. You select bills or transactions and click Sync. Accounts with Automatic syncing can turn on a daily sync for each record type.

What Does Payment Pending Mean?

The bill reached your accounting software, but its payment hasn't synced yet.

Why Are My Owner Charges Missing from Streamline or Guesty?

They were likely never sent. Filter Portfolio → Work Orders to draft owner charges and click Send to PMS.

What Does Missing GL Code Mean?

It's a warning, not a sync status. Add the GL code and the transaction is ready to sync.

Can I See Every Sync Error at Once?

Yes. Click the eye icon labeled Show sync errors to show every error on the page.

Why Won't QuickBooks Online Accept My Negative Bill?

QuickBooks Online doesn't accept a bill with a total below zero. Record it as a vendor credit instead.

What Does "This Record Couldn't Be Synced" Mean?

Topkey didn't recognize the error. Check the record's fields and your accounting connection, then sync again. If it fails the same way, contact Topkey support.

## Month-End Without the Hunt

Picture the third of the month with nothing red on the screen. Every bill is in QuickBooks Online or Xero. Every owner charge is on its statement. The close is a check, not a search.

That's what two filters a week gets you. If you use Topkey, open Accounting and set the filter to Failed. If you don't yet, [see how Topkey syncs with QuickBooks Online](https://topkey.io/integrations/quickbooks-online).

## Disclosures

\*Topkey is a financial technology company and is not an FDIC-insured bank. Banking services provided by Thread Bank, Member FDIC. FDIC Insurance available for funds on deposit through Thread Bank, Member FDIC. FDIC deposit insurance covers the failure of an insured bank. Certain conditions must be satisfied for pass-through deposit insurance coverage to apply. The Topkey Visa debit card is issued by Thread Bank, Member FDIC, pursuant to a license from Visa U.S.A. Inc. and may be used anywhere Visa cards are accepted. The Topkey Visa charge card is issued by Thread Bank, Member FDIC, pursuant to a license from Visa U.S.A. Inc. and may be used anywhere Visa cards are accepted.

Accounts are eligible for pass-through deposit insurance only to the extent pass-through insurance is permitted by the rules and regulations of the FDIC, and if the requirements for pass-through insurance are satisfied. There may be a risk that pass-through deposit insurance is not available because conditions have not been satisfied. In such cases, funds may not be fully insured in the event the insured depository institution where the funds have been deposited were to fail.

\*\*Your deposits qualify for up to $3,000,000 in FDIC insurance coverage when Thread Bank places them at program banks in its deposit sweep program. Your deposits at each program bank become eligible for FDIC insurance up to $250,000, inclusive of any other deposits you may already hold at the bank in the same ownership capacity. You can access the terms and conditions of the sweep program at https://thread.bank/sweep-disclosure/ and a list of program banks at https://thread.bank/program-banks/. Please contact customerservice@thread.bank with questions on the sweep program. Pass-through insurance coverage is subject to conditions.

1 | The interest rate on the High Yield Deposit Account will be 2.93% with an Annual Percentage Yield (APY) of 2.97%. The interest rate on the Regular Deposit Account will be 1.52% with an Annual Percentage Yield (APY) of 1.53%. These rates are effective as of 9/17/26. These are variable rates and are subject to change after the accounts are opened based on the Federal Funds Rate. Minimum opening deposit and average balance requirements may apply. Fees could affect earnings on the account.

Topkey does not provide tax, legal, or accounting services. All information on this site is for educational purposes only.
