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 | 968KB | 15 September 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) |
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.1 | Final | 1.26MB | 4 May 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) |
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.6 | Final | 286KB | 20 July 2023 |
|
ATO M2M Conformance Suite Guidance (DOCX) |
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.18 | Living | 1.2MB | 14 September 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.5 (ZIP) | 0.5 | Draft | 7.15KB | 13 April 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 |