AU Core Implementation Guide
0.3.0-ballot - R1
This page is part of the AU Core (v0.3.0-ballot: AU Core R1 Ballot 5) based on FHIR (HL7® FHIR® Standard) R4. . For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org.au/fhir/core/CapabilityStatement/au-core-client | Version: 0.3.0-ballot | |||
Standards status: Draft | Maturity Level: 0 | Computable Name: AUCoreClientCapabilityStatement | ||
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License. HL7 Australia© 2022+; Licensed Under Creative Commons No Rights Reserved. |
This CapabilityStatement describes the basic rules for the AU Core server actor that is responsible for providing responses to queries submitted by AU Core clients. The complete list of FHIR profiles, RESTful operations, and search parameters supported by AU Core servers are defined in this CapabilityStatement.
Raw OpenAPI-Swagger Definition file | Download
json
, SHOULD support xml
application/json-patch+json
Note to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as "SHALL NOT". A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
client
The AU Core Client SHALL:
Support the AU Core Patient resource profile.
Support at least one additional resource profile from the list of AU Core Profiles.
Implement the RESTful behavior according to the FHIR specification.
Support JSON source formats for all AU Core interactions.
The AU Core Client SHOULD:
- For authentication and authorisation, systems MAY support any SMART App Launch and SMART Backend Service Authorization. When this is not avalable, basic authentication MAY be used.
transaction
interaction.batch
interaction.search-system
interaction.history-system
interaction.The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include
_revinclude
Resource Type | Profile | R | S | U | C | Searches |
_include
|
_revinclude
|
Operations |
---|---|---|---|---|---|---|---|---|---|
AllergyIntolerance | http://hl7.org.au/fhir/core/StructureDefinition/au-core-allergyintolerance | y | y | clinical-status, patient, patient.identifier, patient+clinical-status |
Provenance:target
|
||||
Condition | http://hl7.org.au/fhir/core/StructureDefinition/au-core-condition | y | y | category, clinical-status, code, onset-date, patient, patient.identifier, patient+category, patient+category+clinical-status, patient+clinical-status, patient+code, patient+onset-date |
Provenance:target
|
||||
Encounter | http://hl7.org.au/fhir/core/StructureDefinition/au-core-encounter | y | y | class, date, discharge-disposition, identifier, location, patient, patient.identifier, patient+class, patient+date, patient+discharge-disposition, patient+location, patient+status, patient+type, status, type |
Provenance:target
|
||||
Immunization | http://hl7.org.au/fhir/core/StructureDefinition/au-core-immunization | y | y | date, patient, patient.identifier, patient+date, patient+status, patient+vaccine-code, status, vaccine-code |
Provenance:target
|
||||
Location | http://hl7.org.au/fhir/core/StructureDefinition/au-core-location | y | y | address, address-city, address-postalcode, address-state, identifier, name | |||||
Medication | http://hl7.org.au/fhir/core/StructureDefinition/au-core-medication | y | |||||||
MedicationRequest | http://hl7.org.au/fhir/core/StructureDefinition/au-core-medicationrequest | y | y | _id, authoredon, category, identifier, intent, patient, patient.identifier, patient+intent, patient+intent+authoredon, patient+intent+status, status |
MedicationRequest:medication
|
Provenance:target
|
|||
MedicationStatement | http://hl7.org.au/fhir/core/StructureDefinition/au-core-medicationstatement | y | y | effective, patient, patient.identifier, patient+effective, patient+status, status |
MedicationStatement:medication
|
Provenance:target
|
|||
Observation | http://hl7.org.au/fhir/core/StructureDefinition/au-core-waistcircum, http://hl7.org.au/fhir/core/StructureDefinition/au-core-bodyweight, http://hl7.org.au/fhir/core/StructureDefinition/au-core-bodytemp, http://hl7.org.au/fhir/core/StructureDefinition/au-core-diagnosticresult, http://hl7.org.au/fhir/core/StructureDefinition/au-core-heartrate, http://hl7.org.au/fhir/core/StructureDefinition/au-core-resprate, http://hl7.org.au/fhir/core/StructureDefinition/au-core-diagnosticresult-path, http://hl7.org.au/fhir/core/StructureDefinition/au-core-smokingstatus, http://hl7.org.au/fhir/core/StructureDefinition/au-core-bloodpressure, http://hl7.org.au/fhir/core/StructureDefinition/au-core-bodyheight | y | y | category, code, date, patient, patient.identifier, patient+category, patient+category+date, patient+category+status, patient+code, patient+code+date, status |
Provenance:target
|
||||
Organization | http://hl7.org.au/fhir/core/StructureDefinition/au-core-organization | y | y | _id, address, identifier, name |
Provenance:target
|
||||
Patient | http://hl7.org.au/fhir/core/StructureDefinition/au-core-patient | y | y | _id, birthdate, birthdate+family, birthdate+name, family, family+gender, gender, gender+name, identifier, indigenous-status, name, patient-gender-identity |
Provenance:target
|
||||
Practitioner | http://hl7.org.au/fhir/core/StructureDefinition/au-core-practitioner | y | y | _id, identifier, name |
Provenance:target
|
||||
PractitionerRole | http://hl7.org.au/fhir/core/StructureDefinition/au-core-practitionerrole | y | y | _id, identifier, organization, practitioner, practitioner.identifier, specialty |
PractitionerRole:practitioner
|
Provenance:target
|
|||
Procedure | http://hl7.org.au/fhir/core/StructureDefinition/au-core-procedure | y | y | code, date, patient, patient.identifier, patient+code+date, patient+date, patient+status, status |
Provenance:target
|
||||
Provenance | http://hl7.org.au/fhir/core/StructureDefinition/au-core-provenance | y | y |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the AllergyIntolerance resource, the client SHALL support the AU Core profile and the conformance expectations for the AllergyIntolerance resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | clinical-status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
Conformance | Parameters | Types |
---|---|---|
SHOULD | patient+ clinical-status |
reference + token
|
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Condition resource, the client SHALL support the AU Core profile and the conformance expectations for the Condition resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | category |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | clinical-status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | code |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | onset-date |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
Conformance | Parameters | Types |
---|---|---|
SHALL | patient+ clinical-status |
reference + token
|
SHALL | patient+ category |
reference + token
|
SHOULD | patient+ category+ clinical-status |
reference + token + token
|
SHOULD | patient+ code |
reference + token
|
SHOULD | patient+ onset-date |
reference + date
|
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Encounter resource, the client SHALL support the AU Core profile and the conformance expectations for the Encounter resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | class |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | discharge-disposition |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | identifier |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | location |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | type |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
Conformance | Parameters | Types |
---|---|---|
SHALL | patient+ date |
reference + date
|
SHOULD | patient+ class |
reference + token
|
SHOULD | patient+ discharge-disposition |
reference + token
|
SHOULD | patient+ location |
reference + reference
|
SHOULD | patient+ status |
reference + token
|
SHOULD | patient+ type |
reference + token
|
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Immunization resource, the client SHALL support the AU Core profile and the conformance expectations for the Immunization resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | date |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | vaccine-code |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Location resource, the client SHALL support the AU Core profile and the conformance expectations for the Location resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | address |
string
|
|
SHALL | name |
string
|
|
SHOULD | address-city |
string
|
|
SHOULD | address-state |
string
|
|
SHOULD | address-postalcode |
string
|
|
MAY | identifier |
token
|
The client SHALL provide at least a code value and SHOULD provide both the system and code values. The server SHALL support both. |
resolves
read
.
search-type
,create
,update
,delete
,vread
,patch
,history-instance
.
MedicationAdministration, MedicationDispense, MedicationRequest, and MedicationStatement resources can represent a medication, using an external reference to a Medication resource. If the client supports the Medication resource, the client SHALL support the AU Core profile and the conformance expectations for the Medication resource.
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the MedicationRequest resource, the client SHALL support the AU Core profile and the conformance expectations for the MedicationRequest resource.
The MedicationRequest resources can represent a medication using either a code or refer to the Medication resource. When referencing Medication, the resource may be contained or an external resource. The server MAY choose any one way or more than one method, but if an external reference to Medication is used, the server SHALL support the
_include
parameter for searching this element. The client application SHALL support all methods.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHOULD | _id |
token
|
|
SHOULD | identifier |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | authoredon |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | category |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | intent |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the MedicationStatement resource, the client SHALL support the AU Core profile and the conformance expectations for the MedicationStatement resource.
The MedicationStatement resources can represent a medication using either a code or refer to the Medication resource. When referencing Medication, the resource may be contained or an external resource. The server MAY choose any one way or more than one method, but if an external reference to Medication is used, the server SHALL support the
_include
parameter for searching this element. The client application SHALL support all methods.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | effective |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Observation resource, the client SHALL support the AU Core profile and the conformance expectations for the Observation resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | category |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | code |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Organization resource, the client SHALL support the AU Core profile and the conformance expectations for the Organization resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | address |
string
|
|
SHALL | identifier |
token
|
The client SHALL provide at least a code value and SHOULD provide both the system and code values. The server SHALL support both. The client SHOULD support search using HPI-O and ABN identifiers as defined in the profile. The server SHOULD support search using HPI-O and ABN identifiers as defined in the profile. |
SHALL | name |
string
|
|
SHOULD | _id |
token
|
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
The client SHALL support the Patient resource, the AU Core profile, and the conformance expectations for the Patient resource.
Clients SHALL be able to access the patient record using the following API call:
GET [url]/Patient/[id]
Clients SHOULD use these search parameters that servers are required to support to access the patient record:
_id
identifier
Servers are not required to support any additional search parameters, and clients SHOULD NOT expect servers to do so.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id |
token
|
|
SHALL | identifier |
token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
SHOULD | name |
string
|
|
SHOULD | family |
string
|
|
MAY | birthdate |
date
|
The client SHALL provide a value precise to the day offset. The server SHALL support a value precise to the day offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | gender |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | indigenous-status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | patient-gender-identity |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Practitioner resource, the client SHALL support the AU Core profile and the conformance expectations for the Practitioner resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | identifier |
token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using a HPI-I identifier as defined in the profile. The server SHOULD support search using a HPI-I identifier as defined in the profile. |
SHOULD | name |
string
|
|
SHOULD | _id |
token
|
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the PractitionerRole resource, the client SHALL support the AU Core profile and the conformance expectations for the PractitionerRole resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | identifier |
token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using a HPI-I identifier as defined in the profile. The server SHOULD support search using a HPI-I identifier as defined in the profile. |
SHALL | practitioner |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | practitioner.identifier |
reference.token
|
The client SHALL provide at least a code value and SHOULD provide both the system and code values. The server SHALL support both. The client SHOULD support search using a HPI-I identifier as defined in the AU Core Practitioner profile. The server SHOULD support search using a HPI-I identifier as defined in the AU Core Practitioner profile. |
SHOULD | _id |
token
|
|
SHOULD | specialty |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | organization |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
resolves
read
,search-type
.
create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Procedure resource, the client SHALL support the AU Core profile and the conformance expectations for the Procedure resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient |
reference
|
The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | patient.identifier |
reference.token
|
The client SHALL provide both the system and code values. The server SHALL support both. The client SHOULD support search using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. The server SHOULD support search using the using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
MAY | code |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date |
date
|
The client SHALL provide a value precise to the second + time offset. The server SHALL support a value precise to the second + time offset. The client SHALL support these search comparators The server SHALL support these search comparators |
MAY | status |
token
|
The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
.
search-type
,create
,update
,delete
,vread
,patch
,history-instance
.
If the client supports the Provenance resource, the client SHALL support the AU Core profile and the conformance expectations for the Provenance resource.