qbXML status code 3170

Error

QuickBooks refused to save the change to an existing record.

What QuickBooks says

There was an error when modifying a %1. %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="3170" statusSeverity="Error", with this text in statusMessage.

Seen from a real company file

  • Answering JournalEntryMod:

    There was an error when modifying a General Journal transaction. QuickBooks error message: Transaction not in balance.

Things to know

  • An unbalanced journal entry is refused with 3180 on add and 3170 on mod, both ending "Transaction not in balance."

With QuBe Sync's API

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

Webhook state and error
{
  "error": {
    "debug_message": null,
    "error_code": 3170,
    "error_type": "quickbooks_business_error",
    "hresult": null,
    "message": "There was an error when modifying a General Journal transaction.  QuickBooks error message: Transaction not in balance.",
    "user_message": "QuickBooks won't allow this change to the record. QuickBooks said: There was an error when modifying a General Journal transaction.  QuickBooks error message: Transaction not in balance."
  },
  "state": "error"
}

Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).