QuickBooks declines requests its edition, preferences or subscriptions don't allow, sometimes with 3231 "not processed" for a request sent alone

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

QuickBooks declines requests that the company file's edition, preferences or subscriptions do not allow, though the XSD and Intuit's reference list them all. Three codes have been seen: 3250, "This feature is not enabled or not available in this version of QuickBooks.", for BarCodeQueryRq; 3262 for a request that needs a payroll subscription; and 3231, "The request has not been processed.", even for a request sent alone in its document.

A LeadQueryRq, the only request in its document, answered:

qbXML
<LeadQueryRs statusCode="3231" statusSeverity="Error" statusMessage="The request has not been processed." />

EmployeeDefaultQueryRq, PayrollLastPeriodQueryRq, SalesTaxReturnQueryRq and SalesTaxReturnLineQueryRq have answered the same 3231, alone, on the same company file.

What to do

Do not read a 3231 as "skipped because an earlier request in the batch failed" unless an earlier request did fail. A 3231 on the first or only request means QuickBooks will not run that request for this file. Treat it, like 3250 and 3262, as a request this company file does not support, and do not retry it.

Not observed

  • Which edition, preference or subscription decides between 3250 and 3231. Every observation is from one company file.
  • Whether Pro and Premier decline more requests the same way.

Error codes on this page

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