Building SBR into my application

This page provides a listing of SBR's suite of implementation support products available to software developers; the technical context and a checklist of the key steps that software developers need to consider during their implementation of SBR.

Please refer to the Developer tools section for the latest releases of the SBR Taxonomy and related artefacts.

Subscribe to the SWD Bulletin for news about SBR releases.

Please contact the SBR Service Desk for more information.

Web services Implementation Guide (WIG)

SBR's Web services Implementation Guide (WIG) describes common technical components and services that are re-used by all SBR AU Reports. The common services include: a single gateway that exposes four web services and supports industry standard web service protocols for message exchange, a standard business document header, a secure token server, and a harmonised set of error conditions and exception codes.

The WIG is available on the Common Components page.

Back to top

Web services Description Language (WSDL's)

The Web services Description Language (WSDL) is the standard syntax for the definition of web services defined by the world wide web consortium (W3C). A WSDL describes the service, the information exchanged, and the technical protocols used for the exchange.

SBR provides generic "list", "prefill", "prelodge" and "lodge" web services together with a WSDL for each. This collection also includes the XML Schema for the SBR standard business document header which is a mandatory part of every message.

The .Net and Java WSDL's are available on the Common Components page.

Back to top

Reference Client

The Reference Client file provides software developers with a sample implementation file for Core Services 2010. The Reference client will show SWD's how to package the XBRL documents into a SOAP message for transmitting to Core Services.

The Reference client is available for both the .NET and Java programming languages.

Due to licensing conditions, to obtain a copy of the Reference Client and associated documentation, please contact SBRServiceDesk@sbr.gov.au.

Back to top

Message Implementation Guide (MIG)

There is a Message Implementation Guide (MIG) for each report in scope for SBR. The guide is the entry point for software developers wanting to support a specific SBR report (e.g. business activity statement, payroll tax etc). In many cases there are several interactions around a specific form (e.g. "list" previous lodgments, "prefill" with government data, "calculate" an obligation, and "lodge" a report). The MIG provides the business interaction models and the data element content, contexts, and business rules for each requesting / responding message that supports the implementation of a business service.

The Common MIG'S are available on each report page, together with agency specific MIG's.

Back to top

Schematron files

Schematron is a rule-based validation language for making assertions about the presence or absence of patterns in XBRL trees. Schematron XSLT style sheets are used to implement any business validation rules including simple calculations.

For each form there may be a (one) Schematron file, however, not every form will require a Schematron file.

The Schematron files are available on each report page.

Back to top

Taxonomy architecture

XBRL is a common reporting language, based on international standards and best practice. The SBR Taxonomy is made up of a structured list of reporting definitions, references, rules and relationships that support all of the SBR reports in scope.

The taxonomy architecture document describes the architecture of the SBR taxonomy and shows how the library of harmonised data elements (the SBR AU Taxonomy) is packaged and how the data elements are re-used across government reports (the SBR AU Reports). The document also defines the version control processes and how to navigate the taxonomy. The taxonomy architecture document is complemented by a description of SBR naming conventions.

The Taxonomy Architecture and SBR Naming Convention documents are available on the Re-usable components page.

Back to top

Taxonomy files

This is the collection of XML schemas and XML link-bases, optimised for financial reporting, that constitute the SBR taxonomy.

The SBR AU Taxonomy contains a complete set of harmonised data elements and associated definitions for information to be exchanged between business and government under SBR. Like a dictionary, the SBR AU Taxonomy uniquely defines each data element, with each equivalent to one of the individual pieces of information sought on a government report (i.e. form).

The SBR AU Report reflects the specific message interaction for each agency report supported by SBR. This is achieved by importing and re-using data elements and their associated definitions from the SBR AU Taxonomy. Like words from a dictionary, individual entries from the SBR AU Taxonomy list are combined to define the complete content of each agency report. There is at least one taxonomy report (and sometimes several) for each agency report/form supported by SBR.

The SBR Taxonomy can be viewed and downloaded using the Yeti Taxonomy Viewer with machine readable code available from http://sbr.gov.au/taxonomy/.

Back to top

Identity management client

The SBR solution leverages a new multi-agency authentication credential that will be accepted by all participating agencies. The document suite explains how the credential is issued and managed. It also explains how it is linked to agency business services to authorise primary credential holders or their delegates (employees or intermediaries).

The Identity management client provides both .NET and Java programming language API's, sample code, and user guides for the Key Store and Token Request to facilitate authenticated connectivity to Core Services for both test and production environments.

Due to licensing conditions, to obtain a copy of the Reference Client and associated documentation, please contact SBRServiceDesk@sbr.gov.au.

Technical documentation for the Identity management client is included in the following files:

  • SBR Identity management client overview
  • imclient-java (zip file)
  • imclient-dotnet (zip file)

Within each zip file you will find the following sub-directories:

  • Readme.txt
  • key store
  • Token request (only the token request source code is provided in the October 2009 release).

SBR is currently assessing the feasibility of releasing source code for the Key store and you will be advised of the outcome in due course. Please note that sample code is embedded within the User guides under the Token request sub-directory for both .NET and Java. The purpose of the sample code is to show how the two API's work together to facilitate authenticated connectivity to Core Services.

Back to top

Last updated: 27 Apr 2016
Page ID: 13969