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
- ATO platform specific implementation
- Authentication and authorisation
- Common business guides
- Environment information and testing
- Service support
- Taxonomies and schemas
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 | 1MB | 24 April 2025 |
| 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 |
|---|---|---|---|---|
| Cloud Software Authentication & Authorisation (CAA) DSP 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.4 | Final | 340KB | 13 February 2025 |
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.10 | Final | 291KB | 10 April 2025 |
| 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.52 | Final | 409KB | 29 August 2024 |
| 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.50 | Living | 1.20MB | 24 April 2025 |
| 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 TT2025 Message Repository v0.5 (ZIP) | 0.5 | Draft | 10.9KB | 10 April 2025 |
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