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 981KB  1 March 2024
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 12 March 2020 ) 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.2 Final 1.26MB  2 November 2023

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.1 Final 442KB  17 August 2023

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.7 Final 284KB 25 January 2024
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.46 Final 388KB  14 September 2023
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.26 Living 1.20MB  15 February 2024
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 TT2024 SBR Message Repository v0.3 (ZIP) 0.3 Draft 10.1KB 29 February 2024

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:
Page ID: 252
ATO common artefacts and reference documents