Get Client Demographics Query


Used to query detailed demographic data corresponding to an individual patient in the PCR. This interaction occurs when the consuming system and/or user has:

  1. a unique primary (definitional) person identifier (e.g. PCR Enterprise ID (EID), Ontario health card number (HCN), medical record numbers (MRN) for standard model hospital, or corporate ID (CORPID) for a corporate model hospital); and,
  2. the registered source (i.e. OID) for the unique primary identifier.

 

As the receiver of the interaction request, the PCR will respond with the demographic data matching the query parameters. For example, given a primary client identifier (e.g. Ontario HCN OID & value), this service will return detailed demographic information (e.g. legal name, home address, date of birth, gender) and all active identifiers for the matched patient.

 

When this interaction sends a query to the PCR requesting all demographic and identification information associated with a specific person, only one primary identifier must be present as a query parameter.

 


Message Type

PRPA_IN101101CA

Category

Query

Standard

HL7v3



Interactions

Interaction

Trigger Event

Transmission Wrapper

Control Event Wrapper

Payload

PRPA_IN101101CA Get Client Demographic Query

PRPA_TE101101CA

Get Demographic Query

MCCI_MT002100CA

Request Transport Wrapper

MFMI_MT700751CA

Registry Query Request Wrapper - Human Initiated

PRPA_MT101101CA

Query by Client ID

PRPA_IN101102CA Get Client Demographic

PRPA_TE101102CA

Get Demographic

MCCI_MT002300CA

Application Ack

MFMI_MT700746CA

Registry Query

PRPA_MT101102CA

Get Demographics

 


Input:

Query by one of these primary IDs:

  1. PCR Enterprise ID (EID) aka Enterprise Client ID (ECID)
  1. Health Card Number (HCN)
  1. Corporate ID (CORPID) for corporate model hospitals
  1. Medical Record Number (MRN) for standard model hospitals

 

A source OID (ID Issuer) & corresponding ID value must be provided in the request.

For example, for PCR EID:

OID (ID Issuer) = 2.16.840.1.113883.3.239.20 (eHealth Ontario PCR Enterprise Identifier (EID))

ID = 123456

 

Output:

Based on exact matching the primary ID for a given active member record, return the entity view for that single client.  Response includes the entity view for that client when they have at least one active member record in the entity.  Detailed ‘golden record’ for the client is returned including the most up-to-date demographics across all active members in the entity, and all active identifiers.

 

Returns the following business attributes (where they exist, depending on PCR data density for the given client):

  • PCR EID
  • Ontario Health Card Number
  • Non-Ontario (Out-of-Province) Health Card Number(s)
  • Corporate ID(s)
  • Medical Record Number(s)
  • Legal Name
  • Alias Name
  • Date of Birth
  • Gender
  • Address(es):
    • Home
    • Mailing
    • Temporary
  • Phone Number(s):
    • Home
    • Work
    • Emergency
    • Other
  • Next of Kin Name
  • Primary (Communication) Language
  • Death Indicator
  • Death Date
  • Confidentiality Indicator

Sample Message

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<S:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
<wsa:Action>urn:hl7-org:v3:PRPA_IN101101CA.MR200903</wsa:Action>
<wsa:ReplyTo>
<wsa:Address>http://schemas.xmlsoap.org/ws/2005/08/addressing/role/anonymous</wsa:Address>
</wsa:ReplyTo>
<wsa:MessageID>uuid:ee80516a-ea98-4445-ad69-7edb55dc95bd</wsa:MessageID>
<wsa:To>www.example.com</wsa:To>
</S:Header>
<S:Body>
<PRPA_IN101101CA ITSVersion="XML_1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:hl7-org:v3">
<realmCode code="CA" />
<id specializationType="II.TOKEN" root="8734B5B4-8737-4FD8-BDAC-4200B095AA0C" />
<creationTime specializationType="TS.FULLDATETIME" value="20180417170310.807-0400" />
<responseModeCode code="I" />
<versionCode code="V3-2008N" />
<interactionId specializationType="II.PUBLIC" root="2.16.840.1.113883.1.6" extension="PRPA_IN101101CA" />
<profileId root="2.16.840.1.113883.2.20.2" extension="R02.04.03" />
<profileId root="2.16.840.1.113883.3.239.7" extension="V03.00" />
<processingCode code="P" />
<processingModeCode code="T" />
<acceptAckCode code="NE" />
<receiver typeCode="RCV">
<telecom specializationType="TEL.URI" value="http://142.222.17.102:8080/on" />
<device classCode="DEV" determinerCode="INSTANCE">
<id specializationType="II.BUS" root="2.16.840.1.113883.3.239.2" use="BUS" />
<name mediaType="text/plain" representation="TXT">eHealth Ontario Integration Facility</name>
<agent classCode="AGNT">
<agentOrganization classCode="ORG" determinerCode="INSTANCE">
<id specializationType="II.BUS" root="2.16.840.1.113883.3.239" use="BUS" />
</agentOrganization>
</agent>
</device>
</receiver>
<sender typeCode="SND">
<telecom specializationType="TEL.URI" value="http://innovation-lab.ca" />
<device classCode="DEV" determinerCode="INSTANCE">
<id specializationType="II.BUS" root="2.16.840.1.113883.3.239.4" extension="UniqueSenderIdentifier" use="BUS" />
<name mediaType="text/plain" representation="TXT">eHealth Ontario Portal Application</name>
<desc mediaType="text/plain" representation="TXT">I hereby accept the service agreement here: https://innovation-lab.ca/media/1147/innovation-lab-terms-of-use.pdf</desc>
</device>
</sender>
<controlActEvent classCode="CACT" moodCode="EVN">
<id specializationType="II.BUS" root="2.16.840.1.113883.19.3.207.15.1.1" extension="52379653" use="BUS" />
<code code="PRPA_TE101101CA" codeSystem="2.16.840.1.113883.1.18" />
<statusCode code="completed" />
<effectiveTime>
<low value="20180417170310.807-0400" />
</effectiveTime>
<reasonCode code="PATCAR" codeSystem="2.16.840.1.113883.11.14878" />
<author typeCode="AUT" contextControlCode="AP">
<time specializationType="TS.FULLDATETIME" value="20180417170310.807-0400" />
<assignedEntity1 classCode="ASSIGNED">
<id root="1.1.1.4" extension="5763665838" displayable="true" use="BUS" />
<assignedPerson classCode="PSN" determinerCode="INSTANCE">
<name specializationType="PN.BASIC">
<family partType="FAM">User</family>
<given partType="GIV">Test</given>
</name>
</assignedPerson>
<representedOrganization classCode="ORG" determinerCode="INSTANCE">
<id specializationType="II.PUBLIC" root="1.1.1.5" extension="123456789012" displayable="true" />
<name mediaType="text/plain" representation="TXT">Mohawk College Hospital</name>
</representedOrganization>
</assignedEntity1>
</author>
<queryByParameter>
<queryId specializationType="II.TOKEN" root="BE911500-730F-4D9F-8096-ADD985A0688B" />
<initialQuantity specializationType="INT.POS" value="10" />
<parameterList>
<clientIDPub>
<value specializationType="II.PUBLIC" root="2.16.840.1.113883.3.239.19.66" extension="1182615488" />
</clientIDPub>
</parameterList>
</queryByParameter>
</controlActEvent>
</PRPA_IN101101CA>
</S:Body>
</S:Envelope>


*a valid UniqueSenderIdentifier needs to be replaced in the example above