QRY^A19 – Pesquisa Informação completa do Utente

Owned by Ana Maria Alves Baião (Unlicensed)
Last updated: Mar 18, 2022 by Artur Longo (Unlicensed)
3 min read

A pesquisa de toda a informação associada a um utente é implementada através de mensagem do tipo Query QRY^A19. A resposta a esta mensagem deve agregar a informação demográfica do utente pesquisado bem como todo o seu histórico de episódios. 

Esta operação é suportada pelos seguintes parâmetros de pesquisa:

Parâmetros aceitesDescrição
@PatientIDID do Utente
@ProcessNumberNº Processo
@HealthCardNumberNº SNS
@VisitNumberNº episódio
@DomainCodeMódulo
@StatusEstado
@SessionIDNº Sessão

A resposta (ADR^A19) deve conter todos os segmentos de identificação do utente consoante a pesquisa efectuada.


 Query Profile

Query Statement ID (Query ID=Q22):

A19

Type:

Query

Query Name:

ADT response

Query Trigger (= MSH-9):

QRY^A19^QRY_A19

Query Mode:

Both

Response Trigger (= MSH-9):

ADR^A19^ADR_A19

Query Characteristics:

@PatientID; @ProcessNumber; @HealthCardNumber; @VisitNumber; @DomainCode; @Status; @SessionID

Purpose:

Pesquisa informação associada a um utente

Response Characteristics:

Envia a informação relativa ao utente pesquisado

(warning) Nota: Sempre que a pesquisa é feita por nº de episódio deverá ser composta pelo episódio e módulo, caso contrário será uma pesquisa pouco restrita e não devolverá dados. 

Exemplo de uma pesquisa completa dos dados do Utente:

Esta mensagem exemplifica uma pesquisa de toda a informação associada ao utente com o Número de Processo "17005720".

MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170516162552||QRY^A19^QRY_A19|ee8bc033-ddaa-447b-95fc-f7fd5e92fdc4|D|2.5||
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|17005720^^^^^^^^^^^^@ProcessNumber|DEM||


Resposta: 

Na mensagem de resposta são enviados os episódio associados ao utente e toda informação associada aos mesmos, como por exemplo o Seguro de Saúde que foi associado ao episódio (segmento GT1).

MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20181105160227||ADR^A19^ADR_A19|000815d8-4227-4c9f-a755-cc6efc20d731|D|2.5|
MSA|AA|ee8bc033-ddaa-447b-95fc-f7fd5e92fdc4|
QAK||OK|QUERY1494948352340|6|3|3|
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|17005720^^^^^^^^^^^^@ProcessNumber|DEM|
PID|1||383033^^^HOS^NS~187740198^^^HAS^SNS~001944 1996^^^IRN^C~12345632^^^AT^NIF||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19490201000000|F||||||||||17005720^^^HOS|||||PT 030813 030800|||PT^PORTUGAL^ISO 3166|||20181009000000|Y|
ZID|1||||N|
ROL|||FHCP|^UTILIZADOR^TESTE||||||1031772|
NK1|3|UTILIZADOR^TESTE|X^Pr\XF3\prio^HOS|
NK1|4|FDF^ASDASD SD|FTH^Father^HL7-0063|
NK1|5|FFSD^ DSFSDF SDF SD|MTH^Mother^HL7-0063|
PV1|1|LAB|||||||||||||||||14000217^^^HOS||||||||||||||||||||||OVERBOOK|||20180319000000||||||15565541^^^HOS^TAX|V|
GT1|1|941030^^^HOS|||||||||||||||||||CLUBE DESPORTIVO |
IN1|1|920011^SEGUROS-LISBOA^HOS|||||||||||||||||||||||||||||||||||||||||||||||123456^^^HOS|
IN1|2|933070^TRIBUNAL JUDICIAL^HOS|||||||||||||||||||||||||||||||||||||||||||||||124325435^^^HOS|
IN2|||||||||||||||||||||||||||||||||||||||||||||||2441^^ECONOMISTAS|A|
PID|2||383033^^^HOS^NS~187740198^^^HAS^SNS~001944 1996^^^IRN^C~12345632^^^AT^NIF||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19490201000000|F||||||||||17005720^^^HOS|||||PT 030813 030800|||PT^PORTUGAL^ISO 3166|||20181009000000|Y|
ZID|2||||N|
ROL|||FHCP|^UTILIZADOR^TESTE||||||1031772|
PV1|2|LAB|||||||||||||||||14000217^^^HOS||||||||||||||||||||||OVERBOOK|||20180319000000||||||15565542^^^HOS^TAX|V|
GT1|2|941030^^^HOS|||||||||||||||||||CLUBE DESPORTIVO|
IN1|1|920011^SEGUROS-LISBOA^HOS|||||||||||||||||||||||||||||||||||||||||||||||123456^^^HOS|
IN1|2|933070^TRIBUNAL JUDICIAL^HOS|||||||||||||||||||||||||||||||||||||||||||||||124325435^^^HOS|
PID|3||383033^^^HOS^NS~187740198^^^HAS^SNS~001944 1996^^^IRN^C~12345632^^^AT^NIF||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19490201000000|F||||||||||17005720^^^HOS|||||PT 030813 030800|||PT^PORTUGAL^ISO 3166|||20181009000000|Y|
ZID|3||||N|
ROL|||FHCP|^UTILIZADOR^TESTE||||||1031772|
PV1|3|LAB|||||||||||||||||14000217^^^HOS||||||||||||||||||||||OVERBOOK|||20180319000000||||||15565546^^^HOS^TAX|V|
GT1|3|941030^^^HOS|||||||||||||||||||CLUBE DESPORTIVO|
IN1|1|920011^SEGUROS-LISBOA^HOS|||||||||||||||||||||||||||||||||||||||||||||||123456^^^HOS|
IN1|2|933070^TRIBUNAL JUDICIAL^HOS|||||||||||||||||||||||||||||||||||||||||||||||124325435^^^HOS|

Exemplo de uma pesquisa completa dos dados do Utente:

Esta mensagem representa uma pesquisa composta de toda a informação associada ao utente com o Número de Episódio "14001025" e módulo "CON".

MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170516162552||QRY^A19^QRY_A19|ee8bc033-ddaa-447b-95fc-f7fd5e92fdc4|D|2.5|
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|14001025^^^^^^^^^^^^@VisitNumber~CON^^^^^^^^^^^^@DomainCode|DEM|


Resposta:

A resposta devolve toda a informação relativa ao utente cujo número de visita corresponde ao da pesquisa efectuada. Neste caso em particular, foi devolvida a informação do paciente "LAST_NAME".

MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20170516173646||ADR^A19^ADR_A19|618e6db2-c633-4f3c-a1cc-af9fea6af116|D|2.5|
MSA|AA|ee8bc033-ddaa-447b-95fc-f7fd5e92fdc4
QAK||OK|QUERY1494948352340|1|1|0
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|14001025^^^^^^^^^^^^@VisitNumber~CON^^^^^^^^^^^^@DomainCode|DEM|
PID|1||278095^^^HOS^NS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||20020520000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRN^PH^^^^^^^^^243595231|||||17005794^^^HOS|||||PT 141201 141200|||PT^^ISO 3166||||N|
ZID|1|||||IDE_I^Isen\XE7\\XF5\es^HOS^2^CRIANCAS ATE AOS 17 ANOS DE IDADE,INCLUSIVE^HOS
PV1|1|CON||U|||||1657^MEDICA^TESTE^^^^^^HOS~36750^MEDICA^TESTE^^^^^^N.Ordem~21891^MEDICA^TESTE^^^^^^N.Mecanogr\XE1\fico|20001|||||||1845^31^Utilizador de Testes -^^^^^^HOS~2031^31^Utilizador de Testes -^^^^^^N.Mecanogr\XE1\fico||14001025^^^HOS||||||||||||||||||||||COMPLETE|||20170515150300||||||16405747^^^HOS^TAX|V|
PV2||||||||||||||||||||||||||||||77^ESPECIALIDADES ISENTAS^HOS
IN1|1|935601^SNS^HOS|||||||||||||||||||||||||||||||||||||||||||||||174668848^^^HOS|


Exemplo de pesquisa por nº de processo: 

Neste exemplo é efectuada uma pesquisa onde foi apenas passado o Número de Processo "99301509" como parâmetro. É também passado no segmento QRF um intervalo de datas que limita o tempo de início e fim da pesquisa.

MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170516162552||QRY^A19^QRY_A19|ef9bc033-ddda-447b-95fc-f7fd5e92fdc4|D|2.5|
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|99301509^^^^^^^^^^^^@ProcessNumber|DEM|
QRF||20170101|20170516||



Resposta:

Na resposta à pesquisa efectuada por número de processo, é retornada toda a informação acerca da paciente "LAST_NAME" à qual corresponde o processo com o número 99301509. A informação passada no segmento PID é de natureza demográfica, dados relativos ao seu familiar mais próximo são passados no segmento NK1, informação acerca da visita da utente no segmento PV1, neste caso trata-se de um episódio RAD, e por último, informação relativa aos seus seguros de saúde nos segmentos IN1 e IN2.

MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20170516174817||ADR^A19^ADR_A19|a614c4be-81ce-473a-a417-ec6f2d7005c4|D|2.5|
MSA|AA|ef9bc033-ddda-447b-95fc-f7fd5e92fdc4|
QAK||OK|QUERY1494948352340|1|1|0
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|99301509^^^^^^^^^^^^@ProcessNumber|DEM |
PID|1||290562^^^HOS^NS~273089887^^^HAS^SNS~11114757345^^^SS^NISS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19741214000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRN^PH^^^^^^^^^934073269|||S||99301509^^^HOS||||||||PT^^ISO 3166||||N |
NK1|1|^FLORENCE|OTH||^EMR^CP^^^^^^^^^243557029 |
PV1|1|RAD||||||||10001|||||||||14000729^^^HOS||||||||||||||||||||||COMPLETE|||20170419000000|||||||V |
IN1|1|935601^SNS^HOS|||||||||||||||||||||||||||||||||||||||||||||||273089887^^^HOS |
IN2|||||||||||||||||||||||||||||||||||||||||||||||2441^^ECONOMISTAS|A|


Exemplo de pesquisa por nº de sessão:

Neste exemplo é efetuada uma pesquisa pelo parâmetro número de sessão "22754015" no campo QRD-8.

MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170516162552||QRY^A19^QRY_A19|ee8cb122-ddaa-447b-95fc-f7fd5e92fdc4|D|2.5|
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|22754015^^^^^^^^^^^^@SessionID|DEM|


Resposta:

É devolvida uma mensagem de resposta com os dados do utente que corresponde ao número de sessão "22754015". O campo QAK-4 indica que foram encontrados 1 registo para esta pesquisa em particular e o campo QAK-5 que estão a ser devolvidos 1 registo nesta mensagem.

MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20170517130232||ADR^A19^ADR_A19|6b89e47b-6002-4f75-be85-502590e1aa4f|D|2.5|
MSA|AA|ee8cb122-ddaa-447b-95fc-f7fd5e92fdc4|
QAK||OK|QUERY1494948352340|1|1|0
QRD|20170516162552|R|I|QUERY1494948352340|||3^RD|22754015^^^^^^^^^^^^@SessionID|DEM|
PID|1||210732^^^HOS^NS~374370926^^^HAS^SNS~9156649^^^IRN^B~095465908^^^SS^NISS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19700311000000|M|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRN^PH^^^^^^^^^968760207|||M||14000264^^^HOS|||||PT 142106 142100|||PT^^ISO 3166||||N|
PV1|1|HDI|^999^^3147102^^Enfermaria^1^0^CADEIROES 1|||||1845^31^Utilizador de Testes -^^^^^^HOS~2031^31^Utilizador de Testes -^^^^^^N.Mecanogr\XE1\fico||40045|||||||||14000053^^^HOS||||||||||||||||||||||BOOKED|||20160512170000||||||22754015^^^HOS^VN|V|
IN1|1|935601^SNS^HOS|||||||||||||||||||||||||||||||||||||||||||||||374370926^^^HOS|