Medicines Data Repository Implementation Guide
0.1.0 - ci-build

Medicines Data Repository Implementation Guide, published by Te Whatu Ora. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7NZ/mdr/ and changes regularly. See the Directory of published versions

CapabilityStatement: Medicines Data Repository FHIR Server (Experimental)

Official URL: https://apibroker.whanautahi.com/mdr/fhir/metadata Version: 0.1.0
Draft as of 2022-09-01 Computable Name: NZ_MDR

MDR Capability Statement

Raw OpenAPI-Swagger Definition file | Download

Medicines Data Repository FHIR Server

  • Implementation Guide Version: 0.1.0
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+json
  • Supported Patch Formats:
  • Published on: 2022-09-01 20:26:40+0000
  • Published by: Te Whatu Ora

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.

FHIR RESTful Capabilities

Mode: server

Security
Enable CORS: no
Security services supported: OAuth

Supports OAuth 2.0 - Client Credential flow. [OAuth token endpoint] (https://login.microsoftonline.com/7a71250a-e506-4080-8e6a-ae1e8a771e22/oauth2/v2.0/token)

Summary of System-wide Interactions

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
MedicationRequesthttp://hl7.org/fhir/StructureDefinition/MedicationRequesty_id, identifier, _lastUpdated, _security, code, status, authoredon, patient, requester, locationObservation:based-on, MedicationDispense:prescription
MedicationDispensehttp://hl7.org/fhir/StructureDefinition/MedicationDispensey_id, identifier, _lastUpdated, _security, code, patient, location, whenprepared, whenhandedover, statusMedicationDispense:prescription

Resource Conformance: supportedMedicationRequest

Profile Conformance
SHALL
Reference Policy
literal, local

Interaction summary
  • Supports read.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Logical id of this artifact

SHALLidentifiertoken

Return prescriptions with this external identifier (SCID Item Identifier)

SHALL_lastUpdateddate

When the resource version last changed

SHALL_securitytoken

Security Labels applied to this resource

SHALLcodetoken

Return prescriptions of this medication code (NZULM)

SHALLstatustoken

Status of the prescription

SHALLauthoredondate

Return prescriptions written on this date

SHALLpatientreference

Returns prescriptions for a specific patient (NHI)

SHALLrequesterreference

Returns prescriptions prescribed by this prescriber (CPN)

SHALLlocationreference

Returns prescriptions prescribed at the facility (HPI Facility ID)

 

Resource Conformance: supportedMedicationDispense

Profile Conformance
SHALL
Reference Policy
literal, local

Interaction summary
  • Supports read.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Logical id of this artifact

SHALLidentifiertoken

Returns dispenses with this external identifier (SCID Item Identifier)

SHALL_lastUpdateddate

When the resource version last changed

SHALL_securitytoken

Security Labels applied to this resource

SHALLcodetoken

Returns dispenses of this medicine code (NZULM)

SHALLpatientreference

The identity of a patient to list dispenses for (NHI)

SHALLlocationreference

Returns dispenses performed at the principal physical location (HPI Facility ID)

SHALLwhenprepareddate

Returns dispenses prepared on this date

SHALLwhenhandedoverdate

Returns dispenses handed over on this date

SHALLstatustoken

Returns dispenses with a specified dispense status