ATO common artefacts and reference documents

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 790KB 25 September 2020
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) and the ATO High Level Logical Document Map.
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.4 Final 107MB 28 May 2020
ATO ebMS3 Implementation Guide.docx
Describes the ATOs implementation of the SBR ebMS3 WIG.
1.5 Final 1.3MB 12 March 2020

Authentication and authorisation

File name and description Version number Status Size Published date
ATO Cloud Software Authentication and Authorisation (CAA) SDK.pdf
Outlines the steps a DSP needs to perform to become CAA certified.
1.6 Final 1.05MB 7 March 2016

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.
2.5 Final 275KB 9 July 2020

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.23 Final 364KB 20 August 2020
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.
3.67 Living

1.11MB

24 September 2020
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

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: 
25 September 2020
Page ID: 
252