A quick-reference guide to the most frequent Synder sync errors \u2014 your go-to resource for troubleshooting. Find your error, follow the fix. Each error includes notes on who typically hits it and why.<\/p>\n
Missing transactions? Jump to the Missing Transactions Checklist<\/a> below for a quick diagnosis.<\/p>\n Who hits this:<\/strong> Everyone on first setup \u2014 especially sellers who haven’t set up products in their accounting software yet.<\/p>\n Cause:<\/strong> This error has two distinct causes:<\/p>\n Fix:<\/strong><\/p>\n Who hits this:<\/strong> Multi-platform sellers most often \u2014 name mismatches between platforms and accounting software.<\/p>\n Cause:<\/strong> Synder searched by product name and\/or SKU and found nothing matching.<\/p>\n Fix:<\/strong><\/p>\n These are not error messages \u2014 they are configuration issues that can affect how your data syncs.<\/p>\n Who hits this:<\/strong> Bookkeepers who discover auto-created products going to the wrong account in a client’s books.<\/p>\n Cause:<\/strong> Synder auto-created a product and assigned it to the default income account configured in Settings.<\/p>\n Fix:<\/strong><\/p>\n Cause:<\/strong> Shipping items follow different mapping rules than regular products.<\/p>\n Fix:<\/strong> Check if there’s a separate shipping mapping in your integration settings. Map it explicitly.<\/p>\n Who hits this:<\/strong> Solo sellers who toggled settings without realizing auto-sync has per-type toggles.<\/p>\n Cause:<\/strong> Auto-sync was disabled \u2014 either globally or for a specific transaction type.<\/p>\n Fix:<\/strong><\/p>\n Bookkeepers: If a client’s auto-sync “just stopped,” check if the client logged into Synder and accidentally changed settings. The Changelog will tell you.<\/p>\n For a deeper understanding of how sync works, see sync fundamentals<\/a>.<\/p>\n Who hits this:<\/strong> Everyone \u2014 usually after a connection issue.<\/p>\n Cause:<\/strong> Synder automatically disabled auto-sync due to a connection issue or repeated sync failures.<\/p>\n Fix:<\/strong><\/p>\n The following errors apply only to Summary Sync mode<\/strong> (not Per Transaction mode).<\/p>\n Who hits this:<\/strong> Multi-platform sellers using Daily Summary, especially with Amazon.<\/p>\n Cause:<\/strong> The summary was generated before all transactions arrived from the platform. Amazon’s delayed data is the #1 cause. See the transaction synchronization duration breakdown<\/a> for details on platform timing.<\/p>\n Fix:<\/strong> Wait for all transactions to be available, then re-sync the summary. This is expected behavior \u2014 not a bug.<\/p>\n Multi-platform sellers: Consider syncing Amazon summaries with a 1-day delay to avoid this. Other platforms (Shopify, Stripe) rarely have this issue.<\/p>\n Who hits this:<\/strong> Multi-platform sellers processing international orders, bookkeepers with clients who sell globally.<\/p>\n Cause:<\/strong> Multi-currency conflict in QuickBooks Online. A transaction’s currency doesn’t match the customer\/vendor’s assigned currency.<\/p>\n Important context:<\/strong> In QuickBooks Online, customer records are tied to a specific currency. If a transaction comes in for an existing customer but in a different currency, QuickBooks Online requires a separate customer record. Synder handles this by creating a new customer entry for that currency \u2014 this is expected behavior based on a QuickBooks Online limitation, not a Synder bug.<\/p>\n Fix:<\/strong><\/p>\n Who hits this:<\/strong> Multi-platform sellers \u2014 e.g., Shopify order + PayPal payment where the customer name appears differently on each platform.<\/p>\n Cause:<\/strong> The customer name on the invoice (from e-commerce) doesn’t match the customer name on the payment (from payment gateway). For example, “John Smith” on Shopify vs “john@email.com” on PayPal.<\/p>\n Fix:<\/strong> Enable Smart Reconciliation<\/a> \u2014 it helps match invoices and payments even when customer names differ across platforms. If Smart Reconciliation is already enabled and still not matching correctly, check customer name search priority in settings.<\/p>\n Cause:<\/strong> Synder tried to match a payment to an existing invoice but reference numbers don’t align.<\/p>\n Fix:<\/strong> Check the invoice in accounting \u2014 does the document number match what the platform sent? Adjust numbering settings if needed.<\/p>\n Cause:<\/strong> Synder found an invoice but couldn’t apply the payment (amount mismatch, customer mismatch, or invoice already paid).<\/p>\n Fix:<\/strong><\/p>\n Who hits this:<\/strong> Sellers who didn’t configure tax mapping during setup.<\/p>\n Cause:<\/strong> Tax mapping isn’t configured correctly, or the “Apply Taxes” setting is not set up to match your workflow.<\/p>\n Fix:<\/strong><\/p>\n Cause:<\/strong> Tax amount Stripe reports differs from expected based on order data.<\/p>\n Fix:<\/strong> Check if Stripe Tax is enabled vs. manual tax calculation. Compare tax in Stripe dashboard with what Synder pulled.<\/p>\n Cause:<\/strong> Column mapping issues, usually related to discount fields.<\/p>\n Fix:<\/strong><\/p>\n Who hits this:<\/strong> Everyone periodically. Bookkeepers hit this most because clients change passwords or revoke access without notification.<\/p>\n Cause:<\/strong> OAuth token expired, password changed, or platform revoked access.<\/p>\n Fix:<\/strong><\/p>\n Bookkeepers: Set a weekly reminder to check connection health across all client organizations. A 30-second check per client prevents data gaps.<\/p>\n When you hit any sync error:<\/p>\n Still stuck? Email help@synder.com<\/a> with the error message and a screenshot.<\/p>\n Find your error message for an instant explanation and fix:<\/p>\nProduct & Service Errors<\/h2>\n
“Entity cannot be synchronized without Product or Service”<\/h3>\n
\n
\n
“No matching product found in accounting”<\/h3>\n
\n
Common Configuration Issues<\/h2>\n
Auto-created product is mapped to the wrong income account<\/h3>\n
\n
Product mapping is not working for shipping items<\/h3>\n
Auto-sync did not start<\/h3>\n
\n
Auto-sync was disabled automatically<\/h3>\n
\n
Summary Mode Errors<\/h2>\n
“Partially synced summary”<\/h3>\n
“Record all customer and supplier transactions in the currency assigned to them”<\/h3>\n
\n
Data Mismatch Errors<\/h2>\n
“Customer name is different in Invoice and Payment”<\/h3>\n
“Invoice number is not matching”<\/h3>\n
“Payment is not matched with Invoice”<\/h3>\n
\n
Tax Errors<\/h2>\n
“Sales Tax going to the incorrect Sales Tax Account”<\/h3>\n
\n
“Stripe tax discrepancy”<\/h3>\n
Import Errors<\/h2>\n
“Failed Excel import”<\/h3>\n
\n
Connection Errors<\/h2>\n
Platform shows as disconnected<\/h3>\n
\n
Quick Fix Checklist<\/h2>\n
\n
Error Messages A\u2013Z<\/h2>\n
\n\n
\n \nError Message<\/th>\n What It Means<\/th>\n Fix<\/th>\n<\/tr>\n<\/thead>\n \n Account not found<\/td>\n Account renamed\/deleted in QuickBooks Online\/Xero<\/td>\n Settings \u2192 update account mapping<\/td>\n<\/tr>\n \n API rate limit exceeded<\/td>\n Too many requests at once<\/td>\n Wait 15 min, retry. Sync in smaller batches if recurring.<\/td>\n<\/tr>\n \n Accounting period is closed<\/td>\n Period locked in QuickBooks Online\/Xero<\/td>\n Reopen period, then retry sync<\/td>\n<\/tr>\n \n Duplicate transaction detected<\/td>\n Already exists in QuickBooks Online\/Xero<\/td>\n Skip in Synder, or delete duplicate first<\/td>\n<\/tr>\n \n No Items Available to Sell (Xero)<\/td>\n Item not marked “for sale”<\/td>\n Edit item in Xero \u2192 enable “I sell this item”<\/td>\n<\/tr>\n \n Platform disconnected<\/td>\n OAuth expired<\/td>\n Log into platform \u2192 reconnect in Settings<\/td>\n<\/tr>\n \n Product\/Service not found<\/td>\n Product not mapped, auto-create disabled<\/td>\n Set up product mapping or enable auto-create<\/td>\n<\/tr>\n \n Tax code not found<\/td>\n Tax rate not mapped<\/td>\n Settings \u2192 Tax mapping \u2192 add missing rate<\/td>\n<\/tr>\n \n Clearing account not configured<\/td>\n No clearing account set<\/td>\n Settings \u2192 set Clearing Account<\/td>\n<\/tr>\n \n Customer already exists<\/td>\n Duplicate contacts in Xero<\/td>\n Merge\/deduplicate contacts in Xero<\/td>\n<\/tr>\n \n Inventory adjustment failed<\/td>\n Essential plan can’t create inventory items<\/td>\n Upgrade to Pro or map existing products<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Missing Transactions Checklist<\/h2>\n