AU Core Implementation Guide
0.2.2-preview - Preview Australia flag

This page is part of the Australian Core IG (v0.2.2-preview: AU Core) based on FHIR R4. For a full list of available versions, see the Directory of published versions

Resource Profile: AU Core Encounter

Official URL: http://hl7.org.au/fhir/core/StructureDefinition/au-core-encounter Version: 0.2.2-preview
Standards status: Draft Maturity Level: 0 Computable Name: AUCoreEncounter

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 profile sets minimum expectations for an Encounter resource to record, search, and fetch basic encounter information for a patient. It is based on the AU Base Encounter profile and identifies the additional mandatory core elements, extensions, vocabularies and value sets that SHALL be present in the Encounter when conforming to this profile. It provides the floor for standards development for specific uses cases in an Australian context.

Usage scenarios

The following are supported usage scenarios for this profile:

  • Query for a specific patient encounter
  • Query for all patient encounters
  • Record or update a patient encounter

Comparison with other national and international specifications

A resource conforming to this profile:

No equivalent International Patient Access or International Patient Summary profile.

Conformance in reverse is not guaranteed, i.e. a resource conforming to US Core MAY NOT conform to AU Core.

Profile specific implementation guidance

  • The use of coding can vary significantly across systems, client applications need to understand that they may encounter codes they do not recognise and be prepared to handle those resources appropriately. Servers SHOULD populate Encounter.code.text and/or Encounter.code.coding.display so that client applications can at least display the condition even if the client application does not recognise the code supplied.
  • The Encounter resource can represent a reason as a code with Encounter.reasonCode, or a reference with Encounter.reasonReference to a Condition or other resource.
    • Although both are marked as must support, servers are not required to support both a code and a reference, but they SHALL support at least one of these elements
    • A client application SHALL support both elements

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from AUBaseEncounter

NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..*AUBaseEncounterAn encounter in an Australian healthcare context
... extension:encounterDescription S0..1EncounterDescriptionDescription, overview or summary of an encounter
... identifier S0..*IdentifierIdentifier(s) by which this encounter is known
... status S1..1codeplanned | arrived | triaged | in-progress | onleave | finished | cancelled +
... type S0..*CodeableConceptSpecific type of encounter
Binding: https://healthterminologies.gov.au/fhir/ValueSet/encounter-type-1 (preferred)
... serviceType S0..1CodeableConceptSpecific type of service
Binding: https://healthterminologies.gov.au/fhir/ValueSet/service-type-1 (preferred)
... subject S1..1Reference(AU Core Patient)The patient or group present at the encounter
... participant S0..*BackboneElementList of participants involved in the encounter
.... type S0..*CodeableConceptRole of participant in encounter
.... individual S0..1Reference(AU Core Practitioner | AU Core PractitionerRole | AU Core RelatedPerson)Persons involved in the encounter other than the patient
... period S1..1PeriodThe start and end time of the encounter
... reasonCode S0..*CodeableConceptCoded reason the encounter takes place
... reasonReference[x] S0..*Reference(AU Core Condition | AU Core Observation | AU Core Procedure)Reason the encounter takes place (reference)
... hospitalization S0..1BackboneElementDetails about the admission to a healthcare service
.... dischargeDisposition S0..1CodeableConceptSeparation Mode
... location S0..*BackboneElementList of locations where the patient has been
.... location S1..1Reference(AU Core Location)Location the encounter takes place
... serviceProvider S0..1Reference(AU Core Organization)The organization (facility) responsible for this encounter

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Encounter.typepreferredhttps://healthterminologies.gov.au/fhir/ValueSet/encounter-type-1
Encounter.serviceTypepreferredhttps://healthterminologies.gov.au/fhir/ValueSet/service-type-1

 

Other representations of profile: CSV, Excel, Schematron

Notes:

Below is an overview of the mandatory and optional search parameters and combined search parameters. FHIR search operations and the syntax used to describe the interactions is described here.

Any search parameter defined in FHIR may be ‘allowed’ by the system unless explicitly marked as “SHALL NOT”. A few items are marked as MAY in this implementation guide to highlight their potential relevance.

Parameter(s) Conformance Type(s) Requirements (when used alone or in combination)
patient SHALL reference The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both.
patient+date SHALL reference+date
patient+class SHOULD reference+token
patient+discharge-disposition SHOULD reference+token
patient.identifier SHOULD 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.
patient+location SHOULD reference+reference
patient+status SHOULD reference+token
patient+type SHOULD reference+token
class MAY token The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both.
date MAY date A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset.
discharge-disposition MAY token The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both.
identifier MAY token The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both.
location MAY reference The client SHALL provide at least an id value and MAY provide both the Type and id values. The server SHALL support both.
status MAY token The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both.
type MAY token The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both.

Mandatory Search Parameters:

The following search parameters and search parameter combinations SHALL be supported:

  1. SHALL support searching using the patient search parameter:
    • SHALL support these _revinclude parameters: Provenance:target
    • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])

    GET [base]/Encounter?patient={Type/}[id] or optionally GET [base]/Encounter?patient.identifier=[system|][code]

    Example:

    1. GET [base]/Encounter?patient=5678
    2. GET [base]/Encounter?patient.identifier=http://ns.electronichealth.net.au/id/medicare-number|32788511952
    3. GET [base]/Encounter?patient.identifier=http://ns.electronichealth.net.au/id/hi/ihi/1.0|8003608833357361

    Implementation Notes: Fetches a bundle of all Encounter resources for the specified patient (how to search by reference and how to search by token)

  2. SHALL support searching using the combination of the patient and date search parameters:
    • SHALL support these _revinclude parameters: Provenance:target
    • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])
    • SHALL support these date comparators: gt,lt,ge,le
    • SHOULD support multipleAnd search on date (e.g.date=[date]&date=[date]]&...)

    GET [base]/Encounter?patient={Type/}[id]&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

    Example:

    1. GET [base]/Encounter?patient=5678&date=ge2020-01-01T00:00:00Z

    Implementation Notes: Fetches a bundle of all Encounter resources for the specified patient and date (how to search by reference and how to search by date)

Optional Search Parameters:

The following search parameters and search parameter combinations SHOULD be supported:

  1. SHOULD support searching using the combination of the patient and class search parameters:
    • SHALL support these _revinclude parameters: Provenance:target
    • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])

    GET [base]/Encounter?patient={Type/}[id]&class={system|}[code]

    Example:

    1. GET [base]/Encounter?patient=5678&class=http://terminology.hl7.org/CodeSystem/v3-ActCode|AMB

    Implementation Notes: Fetches a bundle of all Encounter resources for the specified patient and class (how to search by reference and how to search by token)

  2. SHOULD support searching using the combination of the patient and discharge-disposition search parameters:
    • SHALL support these _revinclude parameters: Provenance:target
    • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])

    GET [base]/Encounter?patient={Type/}[id]&discharge-disposition={system|}[code]

    Example:

    1. GET [base]/Encounter?patient=5678&discharge-disposition=9
    2. GET [base]/Encounter?patient=5678&discharge-disposition=9&_revinclude=Provenance:target

    Implementation Notes: Fetches a bundle of all Encounter resources for the specified patient and discharge disposition (how to search by reference and how to search by token)

  3. SHOULD support searching using the combination of the patient and location search parameters:
    • SHALL support these _revinclude parameters: Provenance:target
    • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])

    GET [base]/Encounter?patient={Type/}[id]&location={Type/}[id]

    Example:

    1. GET [base]/Encounter?patient=5678&location=Location/vic-hospital

    Implementation Notes: Fetches a bundle of all Encounter resources matching the specified patient and location (how to search by reference)