Comparison of Contract Versions

MYOB Advanced 2022 R2 supports three versions of system contracts. You can use endpoints with any of these contract versions. In this topic, you can learn the main differences between the contract versions.

Note: Contract Version 1 is not supported starting from MYOB Advanced 2018 R2.
Table 1. Comparison of Contract Versions
Characteristic Contract Version 2 Contract Version 3 Contract Version 4
The REST API is supported for the endpoints with this contract version. Yes Yes Yes
The SOAP API is supported for the endpoints with this contract version. Yes Yes No
You can specify particular fields of the entity to be returned from the system. Yes Yes Yes
By default, the system returns all fields of the entity (including fields of the linked and detail entities defined within the entity).

For the SOAP API: Yes

For the REST API: No

No No
Through the endpoint, you can work with the elements that were added to the MYOB Advanced form in a customization project. Yes Yes Yes
Through the endpoint, you can work with the predefined elements on an MYOB Advanced form that are not included in the entity definition. Yes Yes Yes
When optimization for speed of the retrieval of the list of records fails, the system behaves as follows. The system retrieves data in an unoptimized way (slow). The system returns an error. The system returns an error.
Custom endpoints created from scratch have this contract version. No No Yes
The system endpoint that has this contract version is included in MYOB Advanced 2022 R2. No Yes (Endpoint Versions Default/18.200.001 and Default/17.200.001) Yes (Endpoint Versions Default/20.200.001 and Default/22.200.001)