BC Client Registry FHIR Implementation Guide
1.0.0 - Build CI Canada flag

BC Client Registry FHIR Implementation Guide - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Capability Statement

The Capability Statement for Client Registry

BC HCIM Server Capability Statement

This capability statement describes the use cases that are supported by the BC FHIR implementation of the Client Registry when it is acting as a server.

Notifications Distributor (Client) — Operations Only

PCR as a client posts notifications/distributions via a patient-level operation.

Operation Definitions

The defined Operations

AddPatient

This operation is used for newborns or to 'force create' a patient.

Find Candidates By Example

This operation is used to query for a patient. The response can contain 0 or more Patients.

GetDemographics

This operation is used to query for a patient. The response can contain 0 or 1 Patient.

Merge Patient

This operation is used to merge patients.

Revise Patient

This operation is used to revise a patient's demographics.

Patient Profile

The BC Patient profile

ClientRegistryPatient

General constraints on the Patient resource for use in the BC Client Registry project.

PatientMerge

General constraints on the Patient resource for use in the BC Client Registry project Merge Operation.

Supporting Profiles - Bundles

Bundles that support Patient and Client Registry Operations - Request and Response

AddRequestBundle

A Bundle that is used in the Client Registry for Add Patient requests.

AddResponseBundle

A Bundle that is used in the Client Registry response to Add Patient requests.

AsyncAckBundle

A Bundle that is used for the ACK response to an aynchronous operation request.

FindCandidatesRequestBundle

A Bundle that is used in the Find Candidates Operation request.

GetDemographicsRequestBundle

A Bundle that is used in the Get Demographics Operation request.

ReviseRequestBundle

A Bundle that is used in the Client Registry for Revise Patient requests. This is also used by Patient Notitifications.

ReviseResponseBundle

A Bundle that is used in the Client Registry response to Revise Patient requests.

SearchResponseBundle

A Bundle that is used in the Client Registry response to Find Candidates and Get Demographics queries.

Supporting Profiles

Artifacts associated with resources that support Patient and Client Registry Operations

MetadataParametersAsync

Parameters profile for BC meta data - async messages.

MetadataParametersIn

Parameters profile for BC meta data - incoming messages. This profile is also intended to force the inclusion of specific parameters for the related Parameters.

MetadataParametersOut

Parameters profile for BC meta data - outbound messages.

Request Examples

A set of operation request examples

AddNewbornByMumsPHN-Request

Example of $Add request with Mother's PHN.

AddPatient-Request

Example of $Add Patient request with all data fields populated.

FindCandidates-Request

Example of $FindCandidates request

FindNewbornByMumsPHN-Request

Example of $FindCandidates request with Mother's PHN.

GetDemographics-Request

Example of $GetDemographics request

GetDemographics-Request-By-SSRI

Example of $GetDemographics request by SSRI.

GetDemographics-withHistory-Request

Example of $GetDemographics request with History

Merge-Min-Request

Example of $Merge request with minimum data.

Merge-Request

Example of $Merge request.

Revise-Request-No-SRI

Example of $Revise request with no SRI.

Revise-withMaxData-Request

Example of $Revise request with all data fields populated.

Response Examples

A set of operation response examples

AddPatient-Response

Example of a $Add Patient Response message.

FindCandidates-Response

Example of $FindCandidates response

FindNewbornByMumsPHN-Response

Example of $FindCandidates response with Mother's PHN.

GetDemographics-Response

Example of $GetDemographics response

GetDemographics-Response-Masked

Example of $GetDemographics masked response.

GetDemographics-withHistory-Response

Example of $GetDemographics response with History

GetDemographics-withPHNInfo-Response

Example of $GetDemographics response with PHN info. Only organization users with specific access will receive this data, to be used by the admin Webapp

Merge-Response

Example of $Merge response.

Revise-Async-ACK

Example of an Asynchronous $Revise ACK message.

Revise-Response

Example of a $Revise Patient Response message.

RESTful Examples

A set of RESTful request examples

Force-Create-Request

Example of RESTful force create request.

Newborn-Request

Example of RESTful newborn request.

Revise-Request

Example of RESTful $Revise request.

Revise-Request-No-SRI-RESTful

Example of RESTful $Revise request with no SRI.

Distribution Examples

A set of Distribution examples

COMP-Distribution-Notification
NEW-Distribution-Notification
NEWBORN-Distribution-Notification-Masked-MumPHN

Behavior: Operation Definitions

These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.

Patient Notification

This operation is used notify a user that a patient's record has changed.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

HCIMPatientChangeSubscription

Profile on subscription for HCIM Patient Changes

MergeRequestBundle

A Bundle that is used in the Client Registry for Add Patient requests.

MergeResponseBundle

A Bundle that is used in the Client Registry response to Merge Patient requests.

MetadataParametersSubscription

Parameters profile for BC meta data when a subscription response is sent.

PatientByExample

Will get removed. General constraints on the Patient resource for use in the BC Client Registry project for queries. PatientByExample is a resource of the Client Registry FHIR implementation use only by Get Demographics and Find Candidates

SubscriptionNotificationBundle

A Bundle that is used in the Client Registry when sending subscription notifications.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

BC Address Validation Status Code

A code that represents the validation status of the address

BC Birth Date History

This extension allows the Client Registry to include historical birth dates in a single Patient resource.

BC Business Dates

The effective dates for the parent element.

BC Death Date History

This extension allows the Client Registry to include historical death dates and flags in a single Patient resource.

BC Death Verified Flag

The Patients death is verified and as recorded in the Client Registry as a flag. This also includes death verified flag history as required.

BC Death Verified Flag History

This extension allows the Client Registry to include historical death flags in a single Patient resource.

BC Gender History

This extension allows the Client Registry to include historical gender codes in a single Patient resource.

BC Identifier Status

Identifier status.

BC Merge Status Code

A code that represents the Merge status of the Patient.

BC Multiple Birth History

This extension allows the Client Registry to include historical multiple birth values in a single Patient resource.

BC SourceID and UserID

Identifiers for the source and user that modified the specific element that this extension is on.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

BC Address Validation Value Set

BC Address Validation value set used to describe the validation status of an address

BC Client Registry Patient Change Notification Events Value Set

Codes used to indicate that type of patient changes that a subscriber is interested in receiving.

BC Contact Point System Value Set

BC Contact Point System value set, sliced to meet BC constraints.

BC Contact Point Use Value Set

BC Contact Point Use value set, sliced to meet BC constraints.

BC Identifier Status Value Set

BC Identifier Status value set used to describe the status of an identifier.

BC Identifier Use Value Set

BC Identifier Use value set, sliced to meet BC constraints.

BC Merge Status Value Set

BC Merge Status value set used to describe the merge status of a Patient.

BC Name Use value set.

BC Name Use value set, sliced to meet BC constraints.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

BC Client Registry Address Validation Status Code

Codes used to define the address validation status.

BC Client Registry Operation Outcome details code system

BC Client Registry Operation Outcome details code system

BC Client Registry Patient Change Notification Events Code System

Codes used to indicate that type of patient changes that a subscriber is interested in receiving.

BC Client Registry merge status.

Codes used to describe the merge status.

BC Client registry identifier status code system

BC Client registry identifier status code system.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

OperationOutcome-Example

Example OperationOutcome for a Client Registry Add, Revise or Merge.

OperationOutcome-Search-Example

Example OperationOutcome for a Client Registry Search

Patient-GetDemographics-Example

Example of Patient for $GetDemographics operation response

SampleCompositeSubscriptionRequest

Sample subscription request for Composite View events

Other

These are resources that are used within this implementation guide that do not fit into one of the other categories.

HCIM Patient Change Distributions Topic

This is the subscription topic used for subscribing to different change distributions.