An add whose *Ref names a record that isn't there answers 3120 when the ref gives a ListID, and 3140 when it gives a FullName

Observed 2026-09-20 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.

When an add's *Ref names a record that is not in the company file, the status code depends on how the reference names it. A reference by ListID answers 3120, "Object ... specified in the request cannot be found". A reference by FullName answers 3140, "There is an invalid reference to QuickBooks ...". QuickBooks refuses the whole add and reports only the first missing reference.

A CustomerRef by a ListID that does not exist (the line's item was missing too):

qbXML
<InvoiceAdd>
  <CustomerRef>
    <ListID>80000000-0000000000</ListID>
  </CustomerRef>
  <InvoiceLineAdd>
    <ItemRef>
      <FullName>Nonexistent Item XYZ</FullName>
    </ItemRef>
    <Amount>1.00</Amount>
  </InvoiceLineAdd>
</InvoiceAdd>
qbXML
<InvoiceAddRs statusCode="3120" statusSeverity="Error" statusMessage="Object &quot;80000000-0000000000&quot; specified in the request cannot be found. QuickBooks error message: Invalid argument. The specified record does not exist in the list." />

An existing customer and an ItemRef by a FullName that does not exist:

qbXML
<InvoiceAddRs statusCode="3140" statusSeverity="Error" statusMessage="There is an invalid reference to QuickBooks Item &quot;Repairs&quot; in the Invoice line. QuickBooks error message: Invalid argument. The specified record does not exist in the list." />

A line's ItemRef by an unknown ListID also answered 3120. The split is not universal: an ItemAssembliesCanBuildQueryRq whose ItemInventoryAssemblyRef gave a FullName that is not in the file answered 3120:

qbXML
<ItemAssembliesCanBuildQueryRs statusCode="3120" statusSeverity="Error" statusMessage="Object &quot;E2E Test Assembly&quot; specified in the request cannot be found. " />

What to do

Treat both 3120 and 3140 as "a referenced record is missing" when your request is an add, and read which one from how you sent the reference. Because QuickBooks names only the first missing reference, check that every referenced record exists before sending the add if you need to report them all at once.

Not observed

  • A missing reference inside a Mod request.
  • Whether "first" means document order.
  • Whether the messages had two spaces after the first sentence; these copies had runs of whitespace collapsed.

Error codes on this page

QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.