Exchange of buisness documents like invoices between business finance systems ought to be as simple as email. This site provides some open specifications and test services designed to make that easy.
- As a business, I want to send electronic invoices to my customer systems and know the payment status so I can manage my cashflow and get cheap debtor financing if I need it.
- As a business I want all invoices and tax receipts from my authorised suppliers to be automatically loaded to my financial system ready for my approval so I can reduce my administration burden.
We want the simplest, lowest cost and most secure solution to these needs so we've developed a suite of RESTful API standards and thrown in strong identity measures that support end-to-end encryption and digital signatures. This site supports implementers by providing:
- A suite of technical specifications and free test points.
- A suite of semantic specifications and free test points.
- A set of special interest groups with collaboration tools.
- A transparent governance model with free participation for any interested party.
The Australian Digital Business Council has published an interoperability framework that aims to increase national productivity through automation of common buisness processes such as invoicing. The standards are based on a 4 corner model from Europe that depends heavily on traditional EDI hubs and B2B standards like ebXML. Although workable, uptake has been slow in Europe and so the Digital Business Council has also created a RESTful working group that aims to provide a simpler and more secure peer-to-peer implementation model based on ubiquitous internet standards such as REST. This site is the repository for those specifications.
Unlike single provider APIs (eg google or facebook), a B2B community needs all businesses to implement the same interface so that the same document format (e.g. an invoice) can be sent from any business to any other business. The diagram shows how it works.
- A business that wishes to participate in the network first proves their identity via an OIDC "log in with.." an identity provider service. Different identity assurance levels are supported in an open identity market.
- With an IDP token at given identity assurance level, the business publishes their service end-point and public key to a metadata publisher in accordance with the SMP specification. So, for example, the the SMP will now show (with medium level of assurance) that "ACME" identified by ABN=12345678911 provides an e-invoice service at https://api.acme.com.au/v1/invoice
- ACME's supplier "Widget Co" has also verified identity and published their services to the SMP. When Widget Co wants to send and invoice to ACME, then Widget Co will lookup ACME's service infomation (using ACME's ABN as the lookup key).
- Widget will digitally sign the invoice and then use ACME's public key to encrypt it. Then Widget will POST the invoice to ACME's service end point in accordance with the TAP (Transaction Access Point) specification.
- ACME will verify Widget's signature, decrypt the invoice, and process it in ACME's financial system. At each key stage in the invoice lifecycle (received, approved/disputed, paid), ACME will send an invoice response document to Widget Co.
- Both Widget and ACME will optionally record the signed invoices and responses in the blockchain using the Notary (NRY) specification. This provides both a non-repudiable transaction audit log and can be used by authorised third parties to provide additional services like invoice financing (so Widget Co can get paid immediately even though ACME's terms are 60 days net).
- In most cases, all these steps 1 to 6 will be performed automatically by ACME's and Widget's financial software.
The success of the interoperability framework depends on uptake by the ledger software providers. Those systems must implement a number of interfaces in a consistent way - which requires clear standards, good test services, and easy to use tooling. That is the purpose of this site.
There are five technical specifications, each with it's own github repository. Ledger vendors must implement in accordance with the compliance statement
A federated set of one or more identity providers are the key source of trust for the network. This specification defines a standard taxonomy of OIDC claims and scopes, together with a set of identity assurance levels and a standard way to link identity claims.
- IDP Working Group GitHub repository.
Specification URL | Version | Status | API Definition | Test Service | Issues List |
---|---|---|---|---|---|
IDP 1.0 spec | 1.0 | IDP 1.0 API | idp.testpoint.io | IDP 1.0 Issues |
The framework assumes that there could be multiple metadata publishers (SMP) in the network and so the digital capability locator is essentially a DNS entry (NAPTR Record type) that is used to redirect a lookup query for a given business identifier to the correct SMP.
- DCL Working Group GitHub repository.
Specification URL | Version | Status | API Definition | Test Service | Issues List |
---|---|---|---|---|---|
DCL 1.0 spec | 1.0 | DCL 1.0 API | dcl.testpoint.io | DCL 1.0 Issues |
The framework depends heavily on the ability to discover detailed service information for any given business identifier. The SMP maintains a list of businesses, with a list of services for each business. Each service lists supported document formats and transport protocols and holds a digital certificate for message signing and encryption.
- SMP Working Group GitHub repository.
Specification URL | Version | Status | API Definition | Test Service | Issues List |
---|---|---|---|---|---|
SMP 1.0 spec | 1.0 | SMP 1.0 API | smp.testpoint.io | SMP 1.0 Issues |
The ledger access point, is the service interface for a given business and so hosts the end-point to which business documents are sent. The access point is an avaialbility mediator (allowing specific businesses to have intermittent connectivity) and is responsible for signature validation and submitting transactions to the notary service.
- TAP Working Group GitHub repository.
Specification URL | Version | Status | API Definition | Test Service | Issues List |
---|---|---|---|---|---|
TAP 1.0 spec | 1.0 | TAP 1.0 API | tap.testpoint.io | TAP 1.0 Issues |
The notary serivce provides an irrefutable history of a specific "contract" (eg an invoice and it's status lifecycle), recorded in a blockchain distributed ledger. This service supports dispute resolution and provides the foundation platform for financial services such as debtor financing.
- NRY Working Group GitHub repository.
Specification URL | Version | Status | API Definition | Test Service | Issues List |
---|---|---|---|---|---|
NRY 1.0 spec | 1.0 | NRY 1.0 API | nry.testpoint.io | NRY 1.0 Issues |
The technical framework exists only to provide the foundation for the secure and reliable interchange of business documents such as electronic invoices. The specifications in this section describe the semantics of each business document. Note that;
- the semantics can vary depending on the process context - for example "commercial invoice" and "reciptient created tax invoice" are two different processes that leverage the same document type.
- each process has at least two roles (eg Buyer and Seller) with different requirements under the specification.
Therefore the semantic specifictions group compliance requirements by process and role.
Like the technical specifications, the semantic specification are developed using the COSS (Consensus Oriented Specification System) governance model.
The Billing Specifications are based on OASIS UBL2.1 billing semantics and include the Invoice, Credit Note, Debit Note, and Application Response documents. The process roles are buyer and seller. The invoice specification is semantically identical to the to ADBC e-invoice semantic model.
- Billing Working Group GitHub repository.
Specification URL | Version | Status | API Definition | Test Service | Issues List |
---|---|---|---|---|---|
Billing 1.0 spec | 1.0 | Billing 1.0 API | billing.testpoint.io | Billing 1.0 Issues |
Coming soon - let us know by raising a ticket in the ordering semantics repository if you'd like to lead this group
Coming soon - let us know by raising a ticket in the fulfilment semantics repository if you'd like to lead this group
There is a clear opportunity to simplify the current Superstream Techncial Specifications by replacing the complex XBRL payload with a simple (but semantically equivalent) JSON model and by replacing the complex ebMS3/AS4 4-corner messaging model with the same simple and secure Peer to Peer RESTful model that is used for national e-invoicing. Let us know by raising a ticket in the superannuation semantics repository if you'd like to lead this group.
We value the support and opinions of special interest groups and so we provide some collaboration tools to facilitate consultation and collaboration. If you'd like to participate (or just watch the conversation) of a particular group then please follow the links to subscribe to the chat channel or low volume mailing list. If you'd like to create a new special interest group, please join the engagement group and raise your request there.
Group Name | Purpose | Chat Room | Mailing List | Archive |
---|---|---|---|---|
Engagement SIG | For stakeholder engagement and outreach - to engage all interested parties. | Engagement chat | List sign-up | View archive |
Development SIG | For implementers that would like to share their experiences and get help | Developer chat | List sign-up | View archive |
Information Security SIG | For those concerned about information security and privacy issues related to the specifciations. | Infosec chat | List sign-up | View archive |
Ledger SIG | For discussions related to Ledger implementation of semantic specifications | Ledger chat | List sign-up | View archive |
Trade Finance SIG | For discussions about trade finance services that can leverage the specifciations | Trade Finance chat | List sign-up | View archive |
All technical specifications are developed in the public domain using the COSS (Consensus Oriented Specification System) governance model. COSS ensures that any interested party can participate (because it imposes no restrictions on contributions). It also maximises consensus because, if the editor does not accept your contribution, you can always fork the specification and become the new editor (if others agree they'll follow, but if nobody else likes your fork then you'll be editor of a lonely specification that will wither on the vine).
The secure-by-design nature of the framework eliminates the need for implementation governance or any provider accreditations. Furthermore, the use of independent identity providers such as banks, government, or other entities subject to "know your customer" legisation means that identity assurance is, by definition, not governed by the ADBC. Therefore, implementation governance within this framework is reduced to;
- Defining a set of assurance levels that are used to classify identity providers - so that particpants in the network can have a clear shared understanding of the identity integrity of any message sent or received. This is the role of the [IDP Specification]((https://identity-provider.readthedocs.org/).
- A key principle that relying parties (eg implementers of the SMP or TAP specifications) will stake their reputation on the strength of identity that they demand for their customers.
All specifications are developed in the public domain. To make your voice heard, you can:
- To comment on a specification, click on the relevant "Issues List" link against any technical specification and then hit "new issue" when you land in github.
- To participate in a special interest group, click on the relevant "chat room" link in the special interest group table.
- If you just want to be kept informed, then click on relevant "Mailing list" link in the special interest group table.
A new technical specification can be launched at any time via the following process:
- Raise a ticket in the root ausdigital repository with title “Proposed SPEC”. Document a high level scope and purpose of the proposed spec in the issue.
- Prove evidence of participation interest by collecting "+1" in the form of comments on the issue from at least 6 other people from at least 3 different organisations.
- Nominate an Editor
- Indicate acceptance of the COSS governance model and the SemVer versioning model for specification development.
- Once steps 1 to 4 are complete, we will create the repository, give the editor write access, and add the default document template
- The new editor should then notify relevant special interest groups of issues or questions regarding the new SPEC
As a software application vendor seeking compliance with the framework you;
- MUST support the TAP specification, and
- MUST support the client role in the DCL specification, and
- MUST support the client role in the SMP specification, and
- MUST support the RP (Relying Party) role in the IDP specification, and
- MAY support the client role in the NRY specification, and
- MAY choose to outsource these specification compliance requirements to a compliant third party services provider.
As a software application vendor seeking compliance with the framework you;
- SHOULD support one or more of the business document semantic specifications, and
- MAY choose to support one or more processes for the given business document, and
- MAY choose to support one or more roles (eg buyer or seller) in the relevant process, and
- MUST publish all supported semantic documents, processes, and roles to an SMP
The Australian Digital Business Council has published an e-invoicing framework that ias based on a similar model from Europe. The framework assumes a "4 corner model" where messages flow from sender (corner 1), to sender's EDI hub (corder 2), to recipients EDI hub (corner 3), to the ultimate recipient (corner 4). The technical specifications are published to the Interoperability Framework page and include;
- A service discovery model based on based on OASIS BDX-L (DNS Lookup) and BDX-SMP (detailed metadata) standards. The ADBC has published profiles of the OASIS specifications as the DCL and the DCP specifications.
- A messaging model based on OASIS ebMS3 and AS4 standards. The ADBC profile is published as the "Access Point" specifciation.
- A semantic model based on OASIS UBL 2.1 standards. The ADBC profile is published as the "eInvoicing Semantic Model".
The ADBC specifications have a weak technical security model (no encryption, no signatures, and an identity model based on known customers of the EDI hubs). As a consequence, the ADBC model demands high integrity behaviour from the Hubs. This is implemented as a suite of accreditation and governance models operated and enforced by the ADBC:
- The Access Point Provider Agreement and
- The Digital Capability Publisher Provider Agreement and
- Some internal governance rules that are not generally published.
The RESTful peer-to-peer model is secure by design and so needs no governance framework to ensure the integrity of network service providers. It is also cheaper to build and operate since it leverages ubiquitous web standards supported by every technology stack and does not depend on multiple hubs for routing messages.
- It is a Peer-to-Peer model that does not need traditional EDI hubs.
- It includes a "Transaction Access Point" (TAP) that is a high avaialbility end point proxy for encrypted messages and cannot inspect the payload.
- It includes a new "Identity Provider" (IDP) framework that recognises the existence of an independent identity market that can be leveraged by the framework to provide identity confidence at different assurance levels.
- It includes a service discovery framework that is backwards compatible with the ADBC DCL and DCP specifications but extends them to support distributed key management.
- It includes a new "Notary" (NRY) specification that provides a blockchain based proof of existence of digital transactions that can be used for non-repudiable audit and new financial services (such as invoice financing for small & medium businesses).
- It includes exactly the same invoice semantic model as the ADBC invlice specifications but uses a JSON representation and, more importantly, includes an invoice signed status response document from the buyer (eg "got your invoice and it's approved for payment in 60 days") that can be used for invoice financing purposes.
It is quite feasible that both specifications can work together in the same network. That is because the service discovery components are the same and the invoice semantics are the same. The 4-corner model will work well to connect up existing EDI hubs (about 15% of the market) whilst the RESTful model will work well for the remaining 85%. Connections between the two are achieved simply by the EDI hubs exposing a RESTful interface to bridge traffic.