The ATO provides a number of common artefacts and reference documents to support DSPs in understanding key technical concepts (such as service versioning and configuration), business concepts (such as Taxpayer declarations) and artefact locations.  

Artefacts and reference documents have been organised into the categories below:

Artefact navigation

File name and description Version number Status Size Published date
ATO Artefacts and Location.xlsx
Provides links to all currently published material on sbr.gov.au and SBR ShareFile (where possible).
n/a Living 945KB 17 March 2023
ATO SBR Logical Artefact Map.pdf
PDF representation of the ATO High Level Logical Document Map
4.5 Final 204KB 12 March 2020

SBR ATO Site and Document Map.xlsx
Contains site maps for ATO content on sbr.gov.au/SBR Share File (with links where possible as of 12March2020 ) and the ATO High Level Logical Document Map. This should be used a guidance/example only documentation for new DSPs to understand some of the SBR development complexities

2.8 Final 484KB 12 March 2020

ATO platform specific implementation

File name and description Version number Status Size Published date
ATO Common Record Delimiter Validation Rules.xlsx
Describes the validation that is applied to any message received in the eCommerce Bulk format.
1.7 Final 94KB 28 October 2021
ATO ebMS3 Implementation Guide.docx
Describes the ATOs implementation of the SBR ebMS3 WIG.
2.0 Final 1.25MB 18 August 2022

Authentication and authorisation

File name and description Version number Status Size Published date
Software Developer Information Kit v2.0.pdf
Outlines the steps a DSP needs to perform to become CAA certified.
2.0 Final 979KB 23 September 2022

ATO Authorisation Errors.xlsx
Defines the Authorisation Errors that an end user may receive.

3.0 Final 359KB 26 March 2020

Common business guides

File name and description Version number Status Size Published date
ATO Common Business Implementation and Taxpayer Declaration Guide.docx
Describes the business context and client usage of the web services offered by the ATO and provides high level business guidance.
1.1 Final 484KB 6 August 2020

Environment information and testing

File name and description Version number Status Size Published date
ATO SBR Physical End Points.docx
Defines the physical end points for both SBR platforms (along with EVTE and PROD) and STS. SSL Certificate information has also been included.
3.5 Final 290KB 9 February 2023

ATO M2M Conformance Suite Guidance.docx
Provides guidance for DSPs with requirements to use existing conformance suites following deployment of the new Machine to Machine (M2M) authentication credential.

1.1 Final 238KB 29 August 2019

Service support

File name and description Version number Status Size Published date
ATO Message Repository.zip
Contains all ATO generated messages at the validation platform boundary layer and backend error responses.
3.42 Final 392KB 27 October 2022
ATO Service Characteristics Risk Chart.ppt
Describes the way in which the ATO classifies wholesale service actions and needs to be read in conjunction with the Service Registry.
1.0 Final 144KB 19 October 2017
ATO Message Structure Table Guide.docx
Describes the data for a service/action interface at a technical level with business guidance.
1.1 Final 217KB 23 July 2020
ATO Service Registry.xlsx
Lists all ATO services and related messages offered over the SBR platforms, technical configuration and deployment dates.
5.04 Living 1.17MB 02 March 2023
ATO Service Support Versioning Strategy.docx
Outlines key concepts, life cycle states of a service, principles for supporting versions and the decommissioning process.
1.1 Final 486KB 31 August 2017
ATO Validation and Rule Expression Guide.docx
Describes the ATO validations and structured rule expressions.
1.4 Final 271KB 6 August 2020
ATO TT2023 Message Repository v0.4.zip 0.4 Draft 5.34KB 16 March 2023

Taxonomies and schemas

File name and description Version number Status Size Published date
ATO Taxonomy Architecture and Naming Conventions.docx
Outlines the differences between ATO and SBR generated taxonomies, along with naming conventions for files.
1.2 Final 242KB 7 June 2018
ATO XML Schema Generation Algorithm.docx
Describes the algorithm used to generate XML Schemas from the Message Structure Table (MST) spreadsheet/s.
1.2 Final 283KB 25 June 2019
Last updated:
Last updated: 17 March 2023
Page ID: 252
ATO common artefacts and reference documents