A Mod with an out-of-date EditSequence is refused with 3200 and still answers the record as it stands, its current EditSequence included

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

QuickBooks refuses a Mod whose EditSequence is not the record's current one with status 3200 and changes nothing. The error answer still carries the record's *Ret as it stands now, with its current EditSequence, the same as a successful Mod of it would answer. The message ends with a space after the full stop.

This InvoiceMod sent an EditSequence that was out of date:

qbXML
<InvoiceMod>
  <TxnID>4F49-1791591366</TxnID>
  <EditSequence>1791564003</EditSequence>
  <Memo>…</Memo>
</InvoiceMod>

QuickBooks answered with the invoice unchanged (shortened):

qbXML
<InvoiceModRs statusCode="3200" statusSeverity="Error" statusMessage="The provided edit sequence &quot;1791564003&quot; is out-of-date. ">
<InvoiceRet>
<TxnID>4F49-1791591366</TxnID>
<TimeCreated>2026-10-09T17:16:06-08:00</TimeCreated>
<TimeModified>2026-10-09T17:29:35-08:00</TimeModified>
<EditSequence>1791592175</EditSequence>
...
<Memo>LT2 invoice 1</Memo>
...
<LinkedTxn>...</LinkedTxn>
<LinkedTxn>...</LinkedTxn>
<InvoiceLineRet>...</InvoiceLineRet>
<InvoiceLineRet>...</InvoiceLineRet>
</InvoiceRet>
</InvoiceModRs>

The InvoiceRet matched what an InvoiceQueryRq had read a minute earlier, lines and LinkedTxn included. A second InvoiceMod sent with <EditSequence>1791592175</EditSequence> was answered 0.

What to do

Do not discard the body of an answer just because its statusSeverity is Error. On a 3200, read the *Ret QuickBooks sent back: it is the record as it stands, so you can compare it with what you meant to change and, if your change still applies, send the Mod again with that EditSequence without querying the record first.

Not observed

  • Mods of types other than InvoiceMod.
  • Whether QuickBooks checks the EditSequence before or after the other fields sent.
  • Whether a Mod's IncludeRetElement applies to the record in the error answer.

Error codes on this page

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