{"id":23203,"date":"2024-09-11T17:28:22","date_gmt":"2024-09-11T17:28:22","guid":{"rendered":"https:\/\/synder.com\/help\/?p=23203"},"modified":"2026-06-04T15:25:31","modified_gmt":"2026-06-04T15:25:31","slug":"how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error","status":"publish","type":"post","link":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/","title":{"rendered":"How to Resolve the Invalid Reference Id : Line.SalesItemLineDetail.ItemRef. Error"},"content":{"rendered":"<p>This guide explains how to resolve QuickBooks Online sync failures caused by the error: <strong>Line.SalesItemLineDetail.ItemRef: Invalid Reference Id<\/strong>.<\/p>\n<p><strong>This guide applies to:<\/strong><\/p>\n<ul class=\"wp-block-list\">\n<li>Transactions with <strong>Failed<\/strong> or <strong>Canceled<\/strong> sync status<\/li>\n<li>Sync issues caused by missing or invalid Product\/Service references in QuickBooks Online<\/li>\n<li>Transactions that need validation and a retry after item or mapping correction<\/li>\n<\/ul>\n<h2 class=\"wp-block-heading\">What this error means<\/h2>\n<p>This error means the <strong>Product\/Service<\/strong> used in the transaction is missing, inactive, or no longer matches the corresponding item in QuickBooks Online. QuickBooks identifies Products\/Services using an <strong>ItemRef<\/strong> value. If that reference becomes invalid, the sync fails.<\/p>\n<p>Common causes include:<\/p>\n<ul class=\"wp-block-list\">\n<li>The Product\/Service is missing or inactive in QuickBooks Online<\/li>\n<li>The item was renamed or replaced<\/li>\n<li>The transaction references an outdated or duplicate copy of the item<\/li>\n<li>The mapping in Synder no longer matches QuickBooks Online<\/li>\n<li>Temporary QuickBooks validation delays<\/li>\n<\/ul>\n<h2 class=\"wp-block-heading\">How to fix the Invalid Reference Id error<\/h2>\n<p>Follow these steps in order.<\/p>\n<h3 class=\"wp-block-heading\">Step 1: Verify the Product\/Service in QuickBooks Online<\/h3>\n<p>Before retrying, check that the Product\/Service is set up correctly in QuickBooks Online:<\/p>\n<ul class=\"wp-block-list\">\n<li>Confirm the item <strong>exists<\/strong> in QuickBooks Online<\/li>\n<li>Confirm the item is <strong>active<\/strong><\/li>\n<li>Verify the item <strong>matches<\/strong> what Synder is using in its mapping<\/li>\n<li>Confirm the item has not been replaced, recreated, or duplicated<\/li>\n<\/ul>\n<p>If the item is missing, inactive, or mismatched, restore or correct it before continuing.<\/p>\n<h3 class=\"wp-block-heading\">Step 2: Retry the sync for a single transaction<\/h3>\n<ol class=\"wp-block-list\">\n<li>Go to the <strong>Synder Dashboard<\/strong>.<\/li>\n<li>Then navigate to <strong>Overview &#x2192; Transactions feed &#x2192; Sync issues<\/strong>.<\/li>\n<li>Locate the affected transaction.<\/li>\n<li>Click <strong>Fix<\/strong>, then select <strong>Sync Again<\/strong>.<\/li>\n<\/ol>\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"752\" height=\"624\" src=\"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-sync-issues.png\" alt=\"Synder Dashboard showing Sync Issues feed with numbered steps highlighting Transactions feed, Sync Issues tab, and Fix button\" class=\"wp-image-28614\" \/><\/figure>\n<h3 class=\"wp-block-heading\">Alternative: Retry via the Platform Transactions tab<\/h3>\n<ol class=\"wp-block-list\">\n<li>Open the affected transaction.<\/li>\n<li>Click <strong>Explain<\/strong> to confirm the ItemRef error.<\/li>\n<li>Then click <strong>Sync Again<\/strong>.<\/li>\n<\/ol>\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"833\" height=\"561\" src=\"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-platform-transactions.png\" alt=\"Synder Platform Transactions tab showing Explain button and Sync Again option\" class=\"wp-image-28615\" \/><\/figure>\n<h3 class=\"wp-block-heading\">Step 3: Retry multiple transactions at once (bulk)<\/h3>\n<ol class=\"wp-block-list\">\n<li>Go to <strong>Synder Dashboard &#x2192; Synchronization Issues<\/strong>.<\/li>\n<li>Filter by error: <em>Line.SalesItemLineDetail.ItemRef: Invalid Reference Id<\/em>.<\/li>\n<li>Click <strong>See related transactions<\/strong>.<\/li>\n<li>Select all relevant transactions.<\/li>\n<li>Click <strong>Sync<\/strong>.<\/li>\n<\/ol>\n<h2 class=\"wp-block-heading\">How to confirm the error is resolved<\/h2>\n<p>The issue is resolved when all three of these are true:<\/p>\n<ul class=\"wp-block-list\">\n<li>The transaction status changes to <strong>Synced<\/strong><\/li>\n<li>The transaction appears in QuickBooks Online<\/li>\n<li>The error no longer shows in Sync Issues<\/li>\n<\/ul>\n<p>If the error returns after syncing, check that the Product\/Service mapping in Synder is still aligned with the item in QuickBooks Online.<\/p>\n<h2 class=\"wp-block-heading\">Key takeaway<\/h2>\n<p>This error is caused by a broken or missing <strong>ItemRef<\/strong> link between Synder and QuickBooks Online. Therefore, the fix is always the same: verify the product exists and is active in QBO, then retry the sync. If the issue persists, <a href=\"https:\/\/synder.com\/contact\/\">reach out to the Synder support team<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This guide explains how to resolve QuickBooks Online sync failures caused by the error: Line.SalesItemLineDetail.ItemRef: Invalid Reference Id. This guide applies to: Transactions with Failed or Canceled sync status Sync issues caused by missing or invalid Product\/Service references in QuickBooks Online Transactions that need validation and a retry after item or mapping correction What this [&hellip;]<\/p>\n","protected":false},"author":2233,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","advgb_blocks_editor_width":"","advgb_blocks_columns_visual_guide":"","footnotes":""},"categories":[394,367],"tags":[],"ppma_author":[338],"class_list":["post-23203","post","type-post","status-publish","format-standard","hentry","category-sync-error-messages","category-troubleshooting"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.4 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to Resolve the Invalid Reference Id Error - Synder Guide<\/title>\n<meta name=\"description\" content=\"Learn how to fix the &#039;Invalid Reference Id : Line.SalesItemLineDetail.ItemRef.&#039; error with this step-by-step guide.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Resolve the Invalid Reference Id Error - Synder Guide\" \/>\n<meta property=\"og:description\" content=\"Learn how to fix the &#039;Invalid Reference Id : Line.SalesItemLineDetail.ItemRef.&#039; error with this step-by-step guide.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/\" \/>\n<meta property=\"og:site_name\" content=\"Synder\" \/>\n<meta property=\"article:published_time\" content=\"2024-09-11T17:28:22+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-04T15:25:31+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-sync-issues.png\" \/>\n<meta name=\"author\" content=\"George Bylin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"George Bylin\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Resolve the Invalid Reference Id Error - Synder Guide","description":"Learn how to fix the 'Invalid Reference Id : Line.SalesItemLineDetail.ItemRef.' error with this step-by-step guide.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/","og_locale":"en_US","og_type":"article","og_title":"How to Resolve the Invalid Reference Id Error - Synder Guide","og_description":"Learn how to fix the 'Invalid Reference Id : Line.SalesItemLineDetail.ItemRef.' error with this step-by-step guide.","og_url":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/","og_site_name":"Synder","article_published_time":"2024-09-11T17:28:22+00:00","article_modified_time":"2026-06-04T15:25:31+00:00","og_image":[{"url":"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-sync-issues.png"}],"author":"George Bylin","twitter_card":"summary_large_image","twitter_misc":{"Written by":"George Bylin","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/","url":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/","name":"How to Resolve the Invalid Reference Id Error - Synder Guide","isPartOf":{"@id":"https:\/\/synder.com\/help\/#website"},"primaryImageOfPage":{"@id":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/#primaryimage"},"image":{"@id":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/#primaryimage"},"thumbnailUrl":"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-sync-issues.png","datePublished":"2024-09-11T17:28:22+00:00","dateModified":"2026-06-04T15:25:31+00:00","author":{"@id":"https:\/\/synder.com\/help\/#\/schema\/person\/bdbaa16742639e5b66d1597314150d70"},"description":"Learn how to fix the 'Invalid Reference Id : Line.SalesItemLineDetail.ItemRef.' error with this step-by-step guide.","breadcrumb":{"@id":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/#primaryimage","url":"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-sync-issues.png","contentUrl":"https:\/\/synder.com\/help\/wp-content\/uploads\/sites\/2\/2026\/06\/synder-invalid-reference-sync-issues.png","width":1654,"height":1116},{"@type":"BreadcrumbList","@id":"https:\/\/synder.com\/help\/how-to-resolve-the-invalid-reference-id-line-salesitemlinedetail-itemref-error\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/synder.com\/help\/"},{"@type":"ListItem","position":2,"name":"How to Resolve the Invalid Reference Id : Line.SalesItemLineDetail.ItemRef. Error"}]},{"@type":"WebSite","@id":"https:\/\/synder.com\/help\/#website","url":"https:\/\/synder.com\/help\/","name":"Synder","description":"Articles &amp; FAQ","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/synder.com\/help\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/synder.com\/help\/#\/schema\/person\/bdbaa16742639e5b66d1597314150d70","name":"George Bylin","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/synder.com\/help\/#\/schema\/person\/image\/d964462c94c5eab2959c8b8c4e5201f2","url":"https:\/\/secure.gravatar.com\/avatar\/0518e0b967bd48f772b5909627a09fcc?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/0518e0b967bd48f772b5909627a09fcc?s=96&d=mm&r=g","caption":"George Bylin"},"url":"https:\/\/synder.com\/help\/author\/egorbylin\/"}]}},"author_meta":{"display_name":"George Bylin","author_link":"https:\/\/synder.com\/help\/author\/egorbylin\/"},"featured_img":null,"coauthors":[{"link":"https:\/\/synder.com\/help\/author\/egorbylin\/","display_name":"George Bylin"}],"tax_additional":{"categories":{"linked":["<a href=\"https:\/\/synder.com\/help\/category\/troubleshooting\/sync-error-messages\/\" class=\"advgb-post-tax-term\">Sync Error Messages<\/a>","<a href=\"https:\/\/synder.com\/help\/category\/troubleshooting\/\" class=\"advgb-post-tax-term\">Troubleshooting &amp; Diagnostics<\/a>"],"unlinked":["<span class=\"advgb-post-tax-term\">Sync Error Messages<\/span>","<span class=\"advgb-post-tax-term\">Troubleshooting &amp; Diagnostics<\/span>"]}},"comment_count":"0","relative_dates":{"created":"Posted 2 years ago","modified":"Updated 2 days ago"},"absolute_dates":{"created":"Posted on September 11, 2024","modified":"Updated on June 4, 2026"},"absolute_dates_time":{"created":"Posted on September 11, 2024 5:28 pm","modified":"Updated on June 4, 2026 3:25 pm"},"featured_img_caption":"","series_order":"","authors":[{"term_id":338,"user_id":2233,"is_guest":0,"slug":"egorbylin","display_name":"George Bylin","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/543115bfe37c160e73946ae9c0969368?s=96&d=mm&r=g","author_category":"","first_name":"","last_name":"","user_url":"","job_title":"","description":""}],"_links":{"self":[{"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/posts\/23203"}],"collection":[{"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/users\/2233"}],"replies":[{"embeddable":true,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/comments?post=23203"}],"version-history":[{"count":3,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/posts\/23203\/revisions"}],"predecessor-version":[{"id":28616,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/posts\/23203\/revisions\/28616"}],"wp:attachment":[{"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/media?parent=23203"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/categories?post=23203"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/tags?post=23203"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/synder.com\/help\/wp-json\/wp\/v2\/ppma_author?post=23203"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}