AU eRequesting Implementation Guide
1.0.0-ci-build - CI Build
AU eRequesting Implementation Guide, published by HL7 Australia. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ci-build built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7au/au-fhir-erequesting/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org.au/fhir/ereq/CapabilityStatement/au-erequesting-server | Version: 1.0.0-ci-build | |||
| Standards status: Draft | Maturity Level: 1 | Computable Name: AUeRequestingServerCapabilityStatement | ||
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License. HL7 Australia© 2024+; Licensed Under Creative Commons No Rights Reserved. |
||||
This CapabilityStatement describes the basic rules for the AU eRequesting Server actor that is is a system that accepts diagnostic service requests and makes diagnostic service requests accessible. The complete list of FHIR profiles, RESTful operations, and search parameters supported by the AU eRequesting Server actor are defined in this CapabilityStatement.
The table below identifies where a Profile has a Must Support reference to other profiles or resources (i.e., Target Profiles). This list is provided to clarify where additional profiles or resources may need to be supported if the AU eRequesting Server actor supports a particular resource.
Raw OpenAPI-Swagger Definition file | Download
json, SHOULD support xmlapplication/json-patch+jsonNote 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.
serverThe AU eRequesting Server actor SHALL:
None defined.
transactioninteraction.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 |
|---|---|---|---|---|---|---|---|---|---|
| CommunicationRequest | Supported Profiles AU eRequesting CommunicationRequest CopyTo AU eRequesting CommunicationRequest Patient AU eRequesting CommunicationRequest Urgent Provider | Y | Y | Y | Y | _id | |||
| Condition | Supported Profiles AU Core Condition | Y | Y | Y | Y | _id | |||
| Consent | Supported Profiles AU eRequesting MHR Consent Withdrawal | Y | Y | Y | Y | _id | |||
| Coverage | Supported Profiles AU eRequesting Coverage | Y | Y | Y | Y | _id | |||
| DocumentReference | Supported Profiles AU eRequesting Clinical Context DocumentReference | Y | Y | Y | Y | _id | |||
| Encounter | Supported Profiles AU eRequesting Encounter | Y | Y | Y | Y | _id | |||
| Location | Supported Profiles AU Core Location | Y | Y | Y | Y | _id | |||
| Observation | Supported Profiles Observation Pregnancy - Status (IPS) Observation Pregnancy - Expected Delivery Date (IPS) | Y | Y | Y | Y | _id | |||
| Organization | Supported Profiles AU eRequesting Organization | Y | Y | Y | Y | _id, identifier | |||
| Patient | Supported Profiles AU eRequesting Patient Patient (IPS) | Y | Y | Y | Y | _id, identifier | |||
| Practitioner | Supported Profiles AU eRequesting Practitioner | Y | Y | Y | Y | _id, identifier | |||
| PractitionerRole | Supported Profiles AU eRequesting PractitionerRole | Y | Y | Y | Y | _id, identifier | PractitionerRole:practitioner, PractitionerRole:organization | ||
| Procedure | Supported Profiles AU Core Procedure | Y | Y | Y | Y | _id | |||
| RelatedPerson | Supported Profiles AU Core RelatedPerson | Y | Y | Y | Y | _id | |||
| ServiceRequest | Supported Profiles AU eRequesting Pathology Request AU eRequesting Imaging Request | Y | Y | Y | Y | _id, requisition, supporting-info | ServiceRequest:patient, ServiceRequest:requester, ServiceRequest:encounter, ServiceRequest:supporting-info | ||
| Task | Supported Profiles AU eRequesting Task Group AU eRequesting Task Diagnostic Request AU eRequesting Task Communication Request | Y | Y | Y | Y | _id, _lastUpdated, _tag, focus, group-identifier, owner, part-of, patient, requester, status, _lastUpdated+status+owner, owner+status, patient+status, requester+status | Task:focus, Task:owner, Task:patient, Task:requester | Task:part-of |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the CommunicationRequest resource, the AU eRequesting profiles, and the conformance expectations for the CommunicationRequest resource.
Where a CommunicationRequest profile is defined for a specific purpose that profile SHALL be used:
- Communication requests about providing a copy of the report to a patient or clinician SHALL use the AU eRequesting CommunicationRequest CopyTo profile
- Communication requests about communication with a patient from a filler SHALL use the AU eRequesting CommunicationRequest Patient profile
- Communication requests about communication from a filler to a clinical provider to notify them of urgent results SHALL use the AU eRequesting CommunicationRequest Urgent Provider profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor MAY support the Condition resource, the AU Core profile, and the conformance expectations for the Condition resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Consent resource, the AU eRequesting MHR Consent Withdrawal profile, and the conformance expectations for the Consent resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Coverage resource, the AU eRequesting profile, and the conformance expectations for the Coverage resource.
When using one of the below Coverage types, at least one of the corresponding identifiers SHOULD be populated:
Coverage Type Code Identifier Medicare PUBLICPOL AU Medicare Card Number Department of Veterans Affairs (DVA) VET AU DVA Number Concession payconc AU Pensioner Concession Card Number, AU Commonwealth Seniors Health Card Number , AU Health Care Card Number Private health insurance HIP AU Insurance Member Number Private (self funded) pay N/A
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the DocumentReference resource, the AU eRequesting profile, and the conformance expectations for the DocumentReference resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Encounter resource, the AU eRequesting profile, and the conformance expectations for the Encounter resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor MAY support the Location resource, the AU Core profile, and the conformance expectations for the Location resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Observation resource, the Observation Pregnancy - Status (IPS) and the Observation Pregnancy - Expected Delivery Date (IPS) profiles, and the conformance expectations for the Observation resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Organization resource, the AU eRequesting profile, and the conformance expectations for the Organization resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token | |
| SHALL | identifier | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Patient resource, the AU eRequesting profile, the Patient (IPS) profile, and the conformance expectations for the Patient resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token | |
| SHALL | identifier | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Practitioner resource, the AU eRequesting profile, and the conformance expectations for the Practitioner resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token | |
| SHALL | identifier | token |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the PractitionerRole resource, the AU eRequesting profile, and the conformance expectations for the PractitionerRole resource.
The AU eRequesting Server actor SHALL support the
_includeparameter forPractitionerRole:practitionerandPractitionerRole:organization.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token | |
| SHALL | identifier | token |
read, search-type.create, update.The AU eRequesting Server actor MAY support the Procedure resource, the AU Core profile, and the conformance expectations for the Procedure resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.If the AU eRequesting Server actor supports the RelatedPerson resource, the AU eRequesting Server actor SHALL support the AU Core profile, and the conformance expectations for the RelatedPerson resource.
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token |
read, search-type.create, update.AU eRequesting Pathology Request
AU eRequesting Imaging Request
The AU eRequesting Server actor SHALL support the ServiceRequest resource, at least one AU eRequesting Diagnostic Request profile, and the conformance expectations for the ServiceRequest resource.
The AU eRequesting Server actor SHALL support the
_includeparameter forServiceRequest:patient,ServiceRequest:requester,ServiceRequest:encounterandServiceRequest:supporting-info.Where a profile is defined for a specific domain that profile SHALL be used: Pathology requests SHALL use AU eRequesting Pathology Request profile; Imaging requests SHALL use AU eRequesting Imaging Request profile.
Information recorded in
ServiceRequest.noteSHALL NOT duplicate or overlap with clinical context captured inServiceRequest.supportingInfo:clinicalContext, or with any other information recorded in the ServiceRequest.AU eRequesting Imaging Request:
Placer systems SHALL populate
ServiceRequest.code.textso that fillers can at least display the service requested, even if they do not recognise the code supplied.Placer systems SHALL adhere to the following order of preference when populating the
ServiceRequest.code:
- A code selected from the RANZCR Radiology Referral value set is the preferred option
- A code selected from the SNOMED CT Imaging Procedure value set is the second most preferred option
- A local code is preferred over free text, preferably from a published and accessible FHIR code system
- Free text is the least preferred option which should not be used if a local code is known
AU eRequesting Pathology Request:
Placer systems SHALL populate
ServiceRequest.code.textso that fillers can at least display the service requested, even if they do not recognise the code supplied.Placer systems SHALL adhere to the following order of preference when populating the
ServiceRequest.code:
A code selected from the RCPA - SPIA Requesting Pathology Terminology Reference Set value set is the preferred option
A code selected from the SNOMED CT Pathology Procedure value set is the second most preferred option
A local code is preferred over free text, preferably from a published and accessible FHIR code system
Free text is the least preferred option which should not be used if a local code is known
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token | |
| SHALL | requisition | token | |
| SHALL | supporting-info | reference |
read, search-type.create, update.The AU eRequesting Server actor SHALL support the Task resource, the AU eRequesting profiles, and the conformance expectations for the Task resource.
The AU eRequesting Server actor SHALL support the
_includeparameter forTask:patient,Task:requester,Task:owner,Task:focus.The AU eRequesting Server actor SHALL support the
_revincludeparameter forTask:part-of.Where a task profile is defined for a specific purpose that profile SHALL be used:
Group tasks SHALL use AU eRequesting Task Group profile
Diagnostic request tasks SHALL use AU eRequesting Task Diagnostic Request profile
Communication request tasks SHALL use AU eRequesting Task Communication Request profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | _id | token | |
| SHALL | _lastUpdated | date | The AU eRequesting Server actor SHALL support |
| SHALL | _tag | token | |
| SHALL | focus | reference | |
| SHALL | group-identifier | token | |
| SHALL | owner | reference | The AU eRequesting Server actor SHALL support chained search owner.identifier using HPI-O and ABN identifiers as defined in the AU Core Organization profile. |
| SHALL | part-of | reference | |
| SHALL | patient | reference | The AU eRequesting Server actor SHALL support chained search patient.identifier using IHI, Medicare Number, and DVA Number identifiers as defined in the AU Core Patient profile. |
| SHALL | requester | reference | The AU eRequesting Server actor SHALL support chained search requester.identifier using Medicare Provider Number identifier as defined in the AU Core PractitionerRole profile. |
| SHALL | status | token | The AU eRequesting Server actor SHALL support |