qbXML status code 3120

Error

The request named a record by its ListID or TxnID, and the company file has no such record.

What QuickBooks says

Object "%1" specified in the request cannot be found. %4

QuickBooks fills in the marked parts when it answers: usually the value, the field, the kind of record and a longer explanation of its own.

It arrives on the response element as statusCode="3120" statusSeverity="Error", with this text in statusMessage.

What to do

It may have been deleted or merged in QuickBooks, or the id came from another company file. Look it up again (by name, say) and retry with the id QuickBooks returns.

Seen from a real company file

  • Answering InvoiceAdd:

    Object "80000019-1790258733" specified in the request cannot be found. QuickBooks error message: Invalid argument. The specified record does not exist in the list.

Things to know

  • 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

With QuBe Sync's API

QuBe Sync reads QuickBooks' response for you. When InvoiceAdd gets this code, your webhook receives this JSON:

Webhook state and error
{
  "error": {
    "debug_message": null,
    "error_code": 3120,
    "error_type": "quickbooks_business_error",
    "hresult": null,
    "message": "Object \"80000019-1790258733\" specified in the request cannot be found. QuickBooks error message: Invalid argument. The specified record does not exist in the list.",
    "user_message": "QuickBooks couldn't find one of the records referenced in this request (for example, a customer, item, or account). Double-check that the id or name you referenced still exists in QuickBooks and is spelled exactly right."
  },
  "state": "error"
}

Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).