visit the hl7 website The Demo site for our new HL7 Version 2+ (plus) Standard

18.4.173 QBP/RSP - Find Candidates including Visit Information (QBP) and Response (RSP) (Events Q32 and K32 ) (3.3.63)

This query/response is designed for interaction between a client system and an MPI (Master Person Index). The query consists of a set of demographic and/or visit attribute values for a person, and the response is the list of candidates considered by the MPI to match that set.

Each returned person, specified by a PID segment and by a PV1 segment containing information about the current visit, can also have an optional QRI - Query Response Instance segment containing information about the quality of the match.

Segment Cardinality Implement Status
QBP^Q32^QBP_Q21
MSH

Message Header

[1..1] SHALL
SFT

Software Segment

 
QPD

Query Parameter Definition

[1..1] SHALL
RCP

Response Control Parameter

[1..1] SHALL
DSC

Continuation Pointer

[0..1]  

 

QBP_Q21

MSH-15 MSH-16 Immediate ACK Application Ack
Blank Blank - RSP^K22^RSP_K22
Blank Blank - RSP^K23^RSP_K23
Blank Blank - RSP^K25^RSP_K25
Blank Blank - RSP^K32^RSP_K32
Blank Blank - RSP^K2^4^RSP_K24
Blank Blank - RSP^K21^RSP_K21
NE NE - -
NE NE - -
NE NE - -
NE NE - -
NE NE - -
NE NE - -
AL, SU, ER NE ACK^Q23^ACK -
AL, SU, ER NE ACK^Q22^ACK -
AL, SU, ER NE ACK^Q24^ACK -
AL, SU, ER NE ACK^Q32^ACK -
AL, SU, ER NE ACK^Q21^ACK -
NE AL, SU, ER - RSP^K25^RSP_K25
NE AL, SU, ER - RSP^K22^RSP_K22
NE AL, SU, ER - RSP^K21^RSP_K21
NE AL, SU, ER - RSP^K23^RSP_K23
AL, SU, ER AL, SU, ER ACK^Q25^ACK RSP^K25^RSP_K25
NE AL, SU, ER - RSP^K24^RSP_K24
NE AL, SU, ER - RSP^K32^RSP_K32
AL, SU, ER AL, SU, ER ACK^Q22^ACK RSP^K22^RSP_K22
AL, SU, ER AL, SU, ER ACK^Q21^ACK RSP^K21^RSP_K21
AL, SU, ER AL, SU, ER ACK^Q24^ACK RSP^K24^RSP_K24
AL, SU, ER AL, SU, ER ACK^Q32^ACK RSP^K32^RSP_K32
AL, SU, ER AL, SU, ER ACK^Q23^ACK RSP^K23^RSP_K23
We need some ER7 examples...
We need some XML examples...
Segment Cardinality Implement Status
RSP^K32^RSP_K32
MSH

Message Header

[1..1] SHALL
ARV

Access Restriction

  v2.9
MSA

Message Acknowledgment

[1..1] SHALL
ERR

Error

[0..1]  
QAK

Query Acknowledgment

[1..1] SHALL
QPD

Query Parameter Definition

[1..1] SHALL
QUERY_RESPONSE  
PID

Patient Identification

[1..1] SHALL
PD1

Patient Additional Demographic

[0..1]  
NK1

Next of Kin / Associated Parties

 
PV1

Patient Visit

[1..1] SHALL
PV2

Patient Visit - Additional Information

[0..1]  
QRI

Query Response Instance

[0..1]  
DSC

Continuation Pointer

[0..1]  

 

RSP_K32

MSH-15 MSH-16 Immediate ACK Application Ack
Blank Blank - -
NE NE - -
AL, SU, ER NE ACK^K32^ACK -
We need some ER7 examples...
We need some XML examples...

Following is an example of a Q25/K25 query/response pair of messages. First is the query:

MSH|^&~\|CLINREG|WESTCLIN|HOSPMPI|HOSP|199912121135-0600||QBP^Q25^QBP_Q21|8702|D|2.6

QPD|Q25^Find Candidates Including Visit Information^HL70471|111069|@PID.5.1^SMITH~@PV1.3.2^389 |80|MATCHWARE|1.2||^^^METRO HOSPITAL

RCP||I|20^RD

This query is asking for a list of persons matching the name SMITH who are recorded as being in Room 389. Candidates with a match level above 80 using the algorithm Matchware version 1.2 should be returned. The returned records should include identifiers for assigning authority METRO HOSPITAL. The RCP segment specifies that the number of matches should be limited to 20. Here is a sample response:

MSH|^&~\|HOSPMPI|HOSP|CLINREG|WESTCLIN|200412121135-0600||RSP^K25^RSP_K25|H352357509|D|2.6

MSA|AA|8702

QAK|111069|OK|Q25^Find Candidates Including Visit Information^HL70471|1

QPD|Q25^Find Candidates Including Visit Information^HL70471|111069|@PID.5.1^SMITH~ @PID.5.2^JOHN~@PID.8^M|80|MATCHWARE|1.2||^^^METRO HOSPITAL

PID|||66785^^^METRO HOSPITAL||Smith^John||19630423|M||C|N2378 South Street^^Madison^WI^53711

PV1||I|W^389^1^METRO HOSPITAL^^^^3||||12345^MORGAN^REX^J^^^MD^0010^METRO HOSPITAL^L||67890^GRAINGER^LUCY^X^^^MD^0010^METRO HOSPITAL^L|MED|||||A0||13579^POTTER^SHERMAN^T^^^MD^0010^METRO HOSPITAL^L

QRI|95||MATCHWARE 1.2

One candidate was returned. Notice the 1 at the end of the QAK segment signifying the number of matches. The group of segments includes a PID, PV1, and QRI segment; the QRI segment gives a confidence factor for the candidate.