An unbalanced journal entry is refused with 3180 on add and 3170 on mod, both ending "Transaction not in balance."
Observed 2026-10-02 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.
QuickBooks refuses a journal entry whose debits and credits differ, and the status code follows the verb: 3180 for JournalEntryAdd and 3170 for JournalEntryMod. The messages are the same apart from "saving" and "modifying", with two spaces after the first sentence. Nothing is saved and nothing changes. Intuit's reference says the credits must total the debits but not which code an unbalanced entry gets.
An add debiting 1.00 and crediting 2.00, with the references cut:
<JournalEntryAdd>
<TxnDate>2026-10-01</TxnDate>
<JournalDebitLine>
<AccountRef>…</AccountRef>
<Amount>1.00</Amount>
</JournalDebitLine>
<JournalCreditLine>
<AccountRef>…</AccountRef>
<Amount>2.00</Amount>
<EntityRef>…</EntityRef>
</JournalCreditLine>
</JournalEntryAdd>
<JournalEntryAddRs statusCode="3180" statusSeverity="Error" statusMessage="There was an error when saving a General Journal transaction. QuickBooks error message: Transaction not in balance." />
A mod that changed the credit line of a balanced 1.00 entry to 2.00:
<JournalEntryMod>
<TxnID>4EFD-1790956511</TxnID>
<EditSequence>1790956511</EditSequence>
<JournalLineMod>
<TxnLineID>4EFE-1790956511</TxnLineID>
<JournalLineType>Debit</JournalLineType>
<AccountRef>…</AccountRef>
<Amount>1.00</Amount>
</JournalLineMod>
<JournalLineMod>
<TxnLineID>4EFF-1790956511</TxnLineID>
<JournalLineType>Credit</JournalLineType>
<AccountRef>…</AccountRef>
<Amount>2.00</Amount>
<EntityRef>…</EntityRef>
</JournalLineMod>
</JournalEntryMod>
<JournalEntryModRs statusCode="3170" statusSeverity="Error" statusMessage="There was an error when modifying a General Journal transaction. QuickBooks error message: Transaction not in balance." />
What to do
Check that debits equal credits, to the cent, before sending an add or a mod. To recognise this refusal, read the status message as well as the code. Intuit's table calls 3170 "Object cannot be modified", so a 3170 alone does not mean the record is locked, and a 3180 alone does not mean the entry is out of balance.
Not observed
- A mod that unbalances an entry by adding or leaving out a line.
- Whether refused mods of other transactions also take 3170 where the add takes 3180.
Error codes on this page
QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.