QuickBooks Desktop refuses onError="rollbackOnError" for the whole document, though the XSD allows it

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

QuickBooks Desktop refuses a document whose QBXMLMsgsRq has onError="rollbackOnError", although the XSD lists it beside stopOnError and continueOnError. It runs none of the requests and returns no response XML. The Web Connector reports the whole document as failed through the hresult passed to receiveResponseXML, 0x80040413.

A document holding three read-only queries:

qbXML
<QBXMLMsgsRq onError="rollbackOnError">
  <CompanyQueryRq/>
  <BarCodeQueryRq/>
  <HostQueryRq/>
</QBXMLMsgsRq>

The message that came with the hresult:

Text
QuickBooks does not support the "rollbackOnError" value of the "onError" attribute.

What to do

Use stopOnError or continueOnError. A document sent with rollbackOnError will fail the same way every time, so do not retry it as sent. If you write your own Web Connector SOAP service, expect receiveResponseXML to bring this hresult and message instead of a response.

Not observed

  • Whether any QuickBooks Desktop edition or version supports rollbackOnError.

Error codes on this page

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