Quickbooks deprecating support for minor versions <75 of the Online Accounting API on August 1, 2025

[EvanGrote]

I received an email this morning from the Intuit Developer Group that beginning August 1, 2025, they will be discontinuing support for minor versions 1 through 74 of the QuickBooks Online Accounting API.

Here is the blog linked in the email announcing the change.

From the email:

In your API request, if you specify a value for the minorversion parameter that is less than 75, it will be ignored and the system will respond with data corresponding to minor version 75.
If you don't specify a minor version in your request, the response will default to minor version 75 rather than the base version.

Currently, this gem uses minor version 47, so the minor version will need to be updated to avoid breaking changes when Intuit begins responding to version 47 requests with version 75 responses.

[bretweinraub]

I just came in to post the same thing.....

[ruckus]

Apologies for the lack of documentation on the minorversion .

Yes it is configurable gem-wide by setting

Quickbooks.minorversion = 75

somewhere. Perhaps a Rails initializer if thats your jam.

I am traveling right now but will eventually update the base gem to 75 since its currently at 47 per @EvanGrote comment

quickbooks-ruby/lib/quickbooks-ruby.rb

Line 196 in 568b0aa

@@minorversion = 47

[nicho1991]

Do we know if there will be any incombatility on this upgrade? 47 to 75 is afterall, a pretty big jump!
also, noting the blog mentions that using any sub 75 minorversion, it will just reponse as if it was 75, so its probably important to do some testing on the 75 version before July

[nehresma]

Do we know if there will be any incombatility on this upgrade? 47 to 75 is afterall, a pretty big jump! also, noting the blog mentions that using any sub 75 minorversion, it will just reponse as if it was 75, so its probably important to do some testing on the 75 version before July

@nicho1991 I believe it will depend on how your application is using the API. I'm in the process of reading through the release notes for all the minor versions to see how I will be impacted: https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/minor-versions#minor-version-summary

[ruckus]

From my playing around with various versions in the past it just unlocks different fields. The shape of the data is the same. But sometimes new fields are exposed.

So it should be backwards compatible with any current client code you might have.

That has been my experience at least.

[nehresma]

@ruckus Yes, I agree. FWIW, I just finished the process of upgrading all of our code to use minor version 75 and for our purposes, it was completely backwards compatible. We use:

• Account
• Class
• CompanyCurrency
• Customer
• Deposit
• Invoice
• Payment
• Preferences
• RefundReceipt
• TaxCode
• TaxRate

All my specs pass, and I re-recorded all of our VCR cassettes with the minorversion 75.

For now, I'm just setting Quickbooks.minorversion = '75' in a Rails initializer, but I'll update our gem when the next version is released.

[nicho1991]

I dont know if you guys are testing in production account, but according to the article you can only really test this in sandbox by February 10, 2025

[mtarek97]

Any updates on the release for minor version 75?

[nehresma]

@mtarek97 FWIW, there's actually no need to wait for a gem update on this. You can just set Quickbooks.minorversion = '75' in your app and Bob's your uncle.

[mariusprepdd]

In my case other model api are working well except Reports API .

I have updated minor config
Quickbooks.minorversion = 75

I'm running the reports api like this

service = Quickbooks::Service::Reports.new
service.company_id = @realm
service.access_token = access_token_obj

income_report = service.query('ProfitAndLoss', nil, options)
report = income_report.all_rows

# iterate over rows 
report.each do |row|
  ...
end

Line income_report = service.query('ProfitAndLoss', nil, options) is generating the following error
#<RuntimeError: HTTP Error Code: 406, Msg: >

Any idea, please?

[ravemz]

Seems like reports API isn't accepting application/xml requests. I have verified using cURL and Postman - same request with application/json works fine.

Seeing this on our production and the gem is far from supporting json globally.

[ruckus]

Yes this gem can never really support JSON natively. The whole point of the gem is to serialize between Ruby and QBO data model objects via XML.

If one needed to use JSON then I would recommend this gem isn't used and someone rolls their own, just taking the authentication stuff and maybe some of the Service classes as ideas.

Ultimately if I needed to use JSON I wouldn't even take a data model approach at all and I would just be sure to generate correctly shaped JSON requests in my application and not make it part of the gem.

Thats my $0.02.

I asked Intuit a few years back if they ever planned to deprecate XML and they said no. But I also wouldn't be surprised if there is a day where they do it and only support JSON. Which would suck because I'd have a lot of application code to re-write...

[hhff]

@ravemz @mariusprepdd - I'm seeing the same issue, reports endpoint return 406.

Anyone have a workaround just yet?