Minor versions

QuickBooks Online V3 data services support minor versions in order to provide a way for you to access incremental changes without breaking existing apps. 

Minor version summary 

  • Release Date:  The date on which features for the minor version are available by request.  Service requests must explicitly include the version number number in order to access that version's features; otherwise, access is limited to generally available features.
  • Minimum SDK Version: The version of the SDK that defaults to the given minor version.
Minor VersionRelease
Date
Minimum SDK VersionNew Features
12June 30, 2017Java: 2.9.6

Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, and 11, plus the addition of the following:

  • Support for VendorCredit.Balance field.

-XSD: v3 minor version 12

11May 27, 2017

Java: 2.9.3
.NET: 3.1.0
PHP: 3.2.6

Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, 9, and 10, plus the addition of the following:

  • Support for CompanyInfo sparse update.
  • Validation on CompanyInfo.CompanyAddr field.

-XSD: v3 minor version 11

10April 25, 2017

Java: 2.9.3
.NET: 3.1.0

Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, and 9, plus the addition of the following:

-XSD: v3 minor version 10

9April 25, 2017

Java: 2.9.3
.NET: 3.1.0

Includes all minor versions 1, 2, 3, 4, 5, 6, 7 and 8, plus the addition of the following:

-XSD: v3 minor version 9

8November 15, 2016

Java: 2.7.1
.NET: 2.8.0
PHP: 3.2.4

Includes all minor versions 1, 2, 3, 4, 5, 6, and 7, plus the addition of the following:

  • Support for carbon copy and blind carbon copy email addresses in Invoice objects.

-XSD: v3 minor version 8

7Internal, only.  
6February 17, 2016Java: 2.5.0
.NET: 2.4.0
PHP:  2.2.0

Includes all minor versions 1, 2, 3, 4, and 5, plus the addition of the following:

-XSD: v3 minor version 6

5December 18,2015 Java: 2.4.0
.NET: 2.4.0
PHP:  2.5.0

Includes all minor version 1, minor version 2, minor version 3, and minor version 4 plus the addition of the following:

-XSD: V3 minor version 5

Phase 1—September 24, 2015

 

Java: 2.4.0
.NET: 2.4.0
PHP:  2.2.0 

Includes all minor version 1, minor version 2, and minor version 3 plus the addition of the following:

In support of enhanced inventory, the following are added to the Item resource:

  • Item.Sku attribute.
  • NonInventory to the list of valid Item.Type selections.

Phase 2—November 19, 2015

Java: 2.4.0
.NET: 2.4.0
PHP:  2.2.0 

Includes all minor version 1, minor version 2, minor version 3, and phase 1 of minor version 4 plus the addition of the following:

  • Images with item objects, via the Attachable resource. See Adding attachments to an object for details.
  • Item hierarchies with the Category item type.
  • Support for transaction-level tax calculations with the TxnTaxDetail element in Deposit objects for non-US locales.

-XSD: V3 minor version 4

3  Phase 1—May 29, 2015Java: 2.4.0
.NET: 2.4.0
PHP:  2.2.0

Includes all minor version 1 and minor version 2 plus the addition of the following:

Reports APIs

  • Reports API response for General Ledger report hierarchy is broken in certain circumstances when there are sub accounts configured in the QuickBooks Online company.
Phase 2—August 11, 2015Java: 2.4.0
.NET: 2.4.0
PHP:  2.2.0

Includes all minor version 1, minor version 2, and phase 1 of minor version 3 plus the addition of the following:

Transaction entities:

Phase 3—August 27, 2015Java: 2.4.0
.NET: 2.4.0
PHP:  2.2.0

Includes all minor version 1, minor version 2, and phases 1 and 2 of minor version 3 plus the addition of the following:

Transaction entities:

  • Account.TaxCodeRef attribute to specify the default tax code used for the account—available for global locales, only.

-XSD: V3 minor version 3

2March 25 2015PHP: 2.1.0

Minor version 2 includes all minor version 1 items plus the addition of the following:

Reports APIs for detailed report types:

  • Addition of ColKey metadata in report header which provides sub-classification of ColType.
  • Date format of YYYY-MM-DD is used instead of that defined in company preferences. This will be generally available in QuickBooks Online services v85.

Transaction entities:

  • Transaction tax type as defined in company setting is now used instead of always defaulting to Exclusive. (international QBO only). Further information to be provided.

-XSD: V3 minor version 2

1March 7 2014Java: 2.1.2
.NET: 2.0.4
PHP:  2.0.4

-Addition of TaxInclusiveAmt attribute Line.SalesItemLineDetail, Line.ItemBasedExpenseLineDetail, and Line.AccountBasedExpenseLineDetail line types.  Available for international editions of QBO, only.

-Addition of TotalAmt and HomeTotalAmt (international QBO only) attributes to JournalEntry entity.

-XSD: V3 minor version 1

pre-1Legacy V3Java: <=2.1.0
.NET: 2.0.0
PHP:  2.0.0
Legacy V3

Working with minor versions

  • Use the minorversion query parameter in REST API requests to access a version of the API other than the generally available version. For example, to invoke minor version 1 of the JournalEntry entity, issue the following request:
  • https://quickbooks.api.intuit.com/v3/company/<realmID>/journalentry/entityId?minorversion=1
  • Make sure you have downloaded the latest XSD. See table above for links.
  • Minor version changes can be accessed on a per-entity basis.  There is no need to apply minor version to all entities unless you wish to do so. 

Using the SDK with minor versions

  • The SDK version noted in the Minimum SDK Version column of the above table automatically accesses the features of the given minor version and all prior versions. 
  • Once a newer version of SDK is released, update your code to take advantage of new features and new minor version support. Apps using older version of the SDK will continue to run, however.

  • Make sure you have downloaded the latest XSD.

 

 Got Questions? Get Answers in our developer forums.