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 590KB 16 November 2018
ATO SBR Logical Artefact Map.pdf
PDF representation of the ATO High Level Logical Document Map
4.4 Final 208KB 15 March 2018
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.6 Final 1.06MB 17 May 2018

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.1 Final 55.4KB 22 February 2018
ATO ebMS3 Implementation Guide.docx
Describes the ATOs implementation of the SBR ebMS3 WIG. This information was previously found in the cMIG and has been updated with a new pattern.
1.2 Final 1.3MB 8 March 2018

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.

1.0 Final 357KB 30 November 2017

Common business guides

File name and description Version number Status Size Published date
ATO Common Business Implementation Guide.docx
Describes the business context and client usage of the web services offered by the ATO and provides high level business guidance.
0.2 Draft 767KB 18 January 2018
ATO Taxpayer Declaration Guide.docx
Addresses the information the taxpayer (either as the sender or to an intermediary) must declare when submitting via SBR.
3.0 Final 290KB 21 September 2017

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 (VANguard). SSL Certificate information has also been included.
1.4 Final 295KB 17 May 2018

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.07 Final 322KB 15 November 2018
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.0 Final 234KB 23 November 2017
ATO Service Registry.xlsx
Lists all ATO services and related messages offered over the SBR platforms, technical configuration and deployment dates.
3.14 Living 961KB 15 November 2018
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.2 Final 276KB 19 July 2018

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.1 Final 276KB 23 November 2017
Last updated: 
16 November 2018
Page ID: 
252