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 | 945KB | 17 March 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.0 | Final | 1.25MB | 18 August 2022 |
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.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. |
3.5 | Final | 290KB | 9 February 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.42 | Final | 392KB | 27 October 2022 |
| 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.04 | Living | 1.17MB | 02 March 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.4.zip | 0.4 | Draft | 5.34KB | 16 March 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 |