A pesquisa por taxas moderadoras é implementada através da mensagem do tipo Query QBP^ZT1. Esta permite obter a lista de itens cobráveis de um utente por episódio.
No caso da integração com soluções de Gestão de Atendimento, é com base nesta pesquisa que o utente terá a possibilidade de liquidar as taxas em dívida referentes ás suas visitas à instituição.
Esta operação suportada os seguintes parâmetros de pesquisa:
Parâmetros aceites | Descrição |
---|---|
@EncounterID | Nº Episódio |
@TaxID | Nº de taxa |
@ProcessNumber | Nº Processo |
@HealthCardNumber | Nº SNS |
@SMS | |
@DomainCode | Módulo |
@PatientID | ID do Utente |
@Status | Estado (PY, CG, AJ) |
@BeginDate | Data Inicio |
@EndDate | Data Final |
@TaxDetail | Inclusão do segmento FT1 com o detalhe/discriminação das taxas [ Y / N ] (Default=Y) |
É possível também filtrar pelo estado da taxa e, dessa forma, visualizar apenas as consultas pagas ou as por pagar. Neste caso, convém fazer uma consulta composta filtrando por número de processo e estado para não resultar numa pesquisa muito extensa. Esta pesquisa irá retornar, no caso de existirem, todos os episódios e respetivas taxas associadas do utente (expressas pelos segmentos PV1 e FT1.
Nota: Caso o Utente seja isento no contexto de um determinado episódio, o segmento PV2 virá preenchido com a identificação da isenção (PV2-30).
Query Profile
Query Statement ID | ZT1 |
Type: | Query |
Query Name: | Find Tax |
Query Trigger (= MSH-9): | QBP^ZT1^QBP_Q11 |
Query Mode: | Both |
Response Trigger (= MSH-9): | RSP^ZT1^RSP_ZT1 |
Query Characteristics: | @EncounterID; @TaxID; @ProcessNumber; @HealthCardNumber; @SMS; @DomainCode; @PatientID; @Status; @BeginDate; @EndDate |
Purpose: | Analisar todas as taxas associadas ao Utente. |
Response Characteristics: | Obter as taxas correspondentes ao utente pesquisado |
Exemplo de uma mensagem Pesquisa de Taxas - Nº Processo
Esta mensagem representa uma pesquisa das taxas moderadoras do utente com número de processo 99319276.
MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160419174043||QBP^ZT1^QBP_Q11|14addda8-f8b6-4745-9386-2e3bba238e57|D|2.5| QPD|ZT1^Find Tax||@ProcessNumber^99319276|||| RCP|I|50^RD|||| DSC|1| |
---|
Resposta:
Na resposta, são devolvidas as taxas moderadoras da Utente "LAST_NAME" conforme o exemplo seguinte. Podemos verificar que esta utente tem três episódios com taxa (um episódio de Urgência e dois episódios de Consulta Externa), sendo que no primeiro (número episódio "14000640" - URG) tem um valor a pagar de 18.40 euros, um total de descontos de 140.50 euros, e já pagou 21.60 euros. Portanto, caso pretenda liquidar este episódio, só terá que pagar os 18.40 euros remanescentes. Pode também verificar-se abaixo o detalhe de cada item. No total, este episódio de Urgência tem 10 itens, dos quais dois já foram pagos (PY). O primeiro, no valor de 20.6 euros, foi liquidado através do Quiosque no dia 19/04/2016 tendo gerado o número de recibo 12013415. O item 5, no valor de 1 euro, foi igualmente liquidado pela mesma via. Os restantes itens ainda não foram pagos e, portanto, apresentam o estado CG.
O campo FT1.7 indica o número de taxa.
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160419174043||RSP^ZT1^RSP_ZT1|4c1a8c26-7c08-403d-a017-fccb1faa5a98|D|2.5| MSA|AA|14addda8-f8b6-4745-9386-2e3bba238e57| QAK||OK|ZT1^Find Tax|12|12|0| QPD|ZT1^Find Tax||@ProcessNumber^99319276|||| PID|1||267765^^^HOS^NS~375346331^^^HAS^SNS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRS^PH^^^^^^^^^243429775|||||99319276^^^HOS||||||||||||| PV1|1|URG||||||||||||5|||||14000640^^^HOS||||||||||||||||||||||||||||18,4|140,5|21,6| FT1|1|12013415^HOS||20160418092830|20160419000000|PY|16400291^Urg\XEA\ncia^SNOMED CT|||1|20,6&Eur^TP|20,6&Eur||||3147202||URG||||20,6&Eur^AP|14000640|3133^^QUIOSQUE^^^^^^HOS~2954^^QUIOSQUE^^^^^^N.Mecanogr\XE1\fico|1^Urg\XEA\ncia^SNOMED CT| FT1|2|||20160418000000||CG|16400314^Laborat\XF3\rio [AR] - [A21609] - CREATINAQUINASE (CK), S^SNOMED CT|||1|,5&Eur^TP|,5&Eur||||3147202|AR|URG||||,5&Eur^AP|14000640||4^Laborat\XF3\rio [AR] - [A21609] - CREATINAQUINASE (CK), S^SNOMED CT| FT1|3|||20160418000000||CG|16400317^Radiologia [MR] - [M11010] - ABDOMEN SIMPLES 1 INCIDENCIA^SNOMED CT|||1|1,3&Eur^TP|1,3&Eur||||3147202|MR|URG||||1,3&Eur^AP|14000640||5^Radiologia [MR] - [M11010] - ABDOMEN SIMPLES 1 INCIDENCIA^SNOMED CT| FT1|4|||20160418000000||CG|16400318^Radiologia [MR] - [M10781] - MAO 2 INCIDENCIAS^SNOMED CT|||1|1,1&Eur^TP|1,1&Eur||||3147202|MR|URG||||1,1&Eur^AP|14000640||5^Radiologia [MR] - [M10781] - MAO 2 INCIDENCIAS^SNOMED CT| FT1|5|12013415^HOS||20160418000000|20160419000000|PY|16400319^Radiologia [MR] - [M10745] - COTOVELO 2 INCIDENCIAS^SNOMED CT|||1|1&Eur^TP|1&Eur||||3147202|MR|URG||||1&Eur^AP|14000640|3133^^QUIOSQUE^^^^^^HOS~2954^^QUIOSQUE^^^^^^N.Mecanogr\XE1\fico|5^Radiologia [MR] - [M10745] - COTOVELO 2 INCIDENCIAS^SNOMED CT| FT1|6|||20160418000000||CG|16400320^Radiologia [MR] - [F51240] - DESCOMPRESSAO E RESOLUCAO DE VOLVO INTESTINAL(VER GDH DE AMBULATORIO)^SNOMED CT|||1|3,5&Eur^TP|3,5&Eur||||3147202|MR|URG||||3,5&Eur^AP|14000640||5^Radiologia [MR] - [F51240] - DESCOMPRESSAO E RESOLUCAO DE VOLVO INTESTINAL(VER GDH DE AMBULATORIO)^SNOMED CT| FT1|7|||20160418000000||CG|16400352^Radiologia [MR] - [Z27040] - CRIOPRESERVACAO DE CELULAS PROGENITORAS HEMATOPOIETICAS DE SANGUE PERIFERICO^SNOMED CT|||1|50&Eur^TP|50&Eur||||3147202|MR|URG||||50&Eur^AP|14000640||5^Radiologia [MR] - [Z27040] - CRIOPRESERVACAO DE CELULAS PROGENITORAS HEMATOPOIETICAS DE SANGUE PERIFERICO^SNOMED CT| FT1|8|||20160419000000||CG|16400353^Radiologia [MR] - [M15713] - DESOBSTRUCAO INTRALUMINAL COM CRIOTERAPIA^SNOMED CT|||1|40&Eur^TP|40&Eur||||3147202|MR|URG||||40&Eur^AP|14000640||5^Radiologia [MR] - [M15713] - DESOBSTRUCAO INTRALUMINAL COM CRIOTERAPIA^SNOMED CT| FT1|9|||20160418000000||CG|16400354^Laborat\XF3\rio [AP] - [Y28140] - ESTUDO DA RESPOSTA ALOGENICA POR CULTURA LINFOCITARIA (RACL)^SNOMED CT|||1|32,5&Eur^TP|32,5&Eur||||3147202|AP|URG||||32,5&Eur^AP|14000640||4^Laborat\XF3\rio [AP] - [Y28140] - ESTUDO DA RESPOSTA ALOGENICA POR CULTURA LINFOCITARIA (RACL)^SNOMED CT| FT1|10|||20160419000000||CG|16400355^Laborat\XF3\rio [AR] - [B31725] - EXAME DE HIBRIDACAO IN SITU, C/ FISH, EM LAVADOS VESICAIS OU URINA, CONJUNTO DE QUATRO SON^SNOMED CT|||1|30&Eur^TP|30&Eur||||3147202|AR|URG||||30&Eur^AP|14000640||4^Laborat\XF3\rio [AR] - [B31725] - EXAME DE HIBRIDACAO IN SITU, C/ FISH, EM LAVADOS VESICAIS OU URINA, CONJUNTO DE QUATRO SON^SNOMED CT| IN1|1|990004^ENTIDADE DESCONHECIDA^HOS|11111||||||||||||||||||||||||||||||||||||||||||||||| PID|2||267765^^^HOS^NS~375346331^^^HAS^SNS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRS^PH^^^^^^^^^243429775|||||99319276^^^HOS||||||||||||| PV1|2|CON||||||||20045||||5|||||||||||||||||||||||||||||||||7,75|0|0| FT1|1|||20160419090000||CG|16400378^Consulta^SNOMED CT|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^SNOMED CT| IN1|2|935601^SNS^HOS|99999||||||||||||||||||||||||||||||||||||||||||||||375346331^^^HOS| PID|3||267765^^^HOS^NS~375346331^^^HAS^SNS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRS^PH^^^^^^^^^243429775|||||99319276^^^HOS||||||||||||| PV1|3|CON||||||||20045||||5|||||^^^||||||||||||||||||||||||||||7,75|0|0| FT1|1|||20160428080000||CG|16400379^Consulta^SNOMED CT|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^SNOMED CT| IN1|3|935601^SNS^HOS|99999||||||||||||||||||||||||||||||||||||||||||||||375346331^^^HOS| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Nº de Processo e Estado
Esta mensagem representa uma pesquisa de taxas moderadoras em dívida do utente com número de processo "99319276".
MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160419172245||QBP^ZT1^QBP_Q11|b7e4939e-6f7d-4d1b-88da-745c07289cc2|D|2.5| QPD|ZT1^Find Tax||@ProcessNumber^99319276~@Status^CG|||| RCP|I|50^RD|||| DSC|1| |
---|
Resposta:
Na resposta, são devolvidas todas as taxas moderadoras por pagar da Utente "LAST_NAME". Neste exemplo, podemos ver que só aparecem as taxas em dívida deste utente. Todas as outras não são devolvidas.
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160419172245||RSP^ZT1^RSP_ZT1|af124fa8-0d64-477b-ab4b-86aa09f4835f|D|2.5| MSA|AA|b7e4939e-6f7d-4d1b-88da-745c07289cc2| QAK||OK|ZT1^Find Tax|9|9|0| QPD|ZT1^Find Tax||@ProcessNumber^99319276~@Status^CG|||| PID|1||267765^^^HOS^NS~375346331^^^HAS^SNS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRS^PH^^^^^^^^^243429775|||||99319276^^^HOS||||||||||||| PV1|1|URG||||||||||||5|||||14000640^^^HOS||||||||||||||||||||||||||||18,4|86,4|21,6| FT1|1|||20160418000000||CG|16400314^Laborat\XF3\rio [AR] - [A21609] - CREATINAQUINASE (CK), S^SNOMED CT|||1|,5&Eur^TP|,5&Eur||||3147202|AR|URG||||,5&Eur^AP|14000640||4^Laborat\XF3\rio [AR] - [A21609] - CREATINAQUINASE (CK), S^SNOMED CT| FT1|2|||20160418000000||CG|16400317^Radiologia [MR] - [M11010] - ABDOMEN SIMPLES 1 INCIDENCIA^SNOMED CT|||1|1,3&Eur^TP|1,3&Eur||||3147202|MR|URG||||1,3&Eur^AP|14000640||5^Radiologia [MR] - [M11010] - ABDOMEN SIMPLES 1 INCIDENCIA^SNOMED CT| FT1|3|||20160418000000||CG|16400318^Radiologia [MR] - [M10781] - MAO 2 INCIDENCIAS^SNOMED CT|||1|1,1&Eur^TP|1,1&Eur||||3147202|MR|URG||||1,1&Eur^AP|14000640||5^Radiologia [MR] - [M10781] - MAO 2 INCIDENCIAS^SNOMED CT| FT1|4|||20160418000000||CG|16400320^Radiologia [MR] - [F51240] - DESCOMPRESSAO E RESOLUCAO DE VOLVO INTESTINAL(VER GDH DE AMBULATORIO)^SNOMED CT|||1|3,5&Eur^TP|3,5&Eur||||3147202|MR|URG||||3,5&Eur^AP|14000640||5^Radiologia [MR] - [F51240] - DESCOMPRESSAO E RESOLUCAO DE VOLVO INTESTINAL(VER GDH DE AMBULATORIO)^SNOMED CT| FT1|5|||20160418000000||CG|16400352^Radiologia [MR] - [Z27040] - CRIOPRESERVACAO DE CELULAS PROGENITORAS HEMATOPOIETICAS DE SANGUE PERIFERICO^SNOMED CT|||1|50&Eur^TP|50&Eur||||3147202|MR|URG||||50&Eur^AP|14000640||5^Radiologia [MR] - [Z27040] - CRIOPRESERVACAO DE CELULAS PROGENITORAS HEMATOPOIETICAS DE SANGUE PERIFERICO^SNOMED CT| FT1|6|||20160419000000||CG|16400353^Radiologia [MR] - [M15713] - DESOBSTRUCAO INTRALUMINAL COM CRIOTERAPIA^SNOMED CT|||1|40&Eur^TP|40&Eur||||3147202|MR|URG||||40&Eur^AP|14000640||5^Radiologia [MR] - [M15713] - DESOBSTRUCAO INTRALUMINAL COM CRIOTERAPIA^SNOMED CT| FT1|7|||20160419000000||CG|16400355^Laborat\XF3\rio [AR] - [B31725] - EXAME DE HIBRIDACAO IN SITU, C/ FISH, EM LAVADOS VESICAIS OU URINA, CONJUNTO DE QUATRO SON^SNOMED CT|||1|30&Eur^TP|30&Eur||||3147202|AR|URG||||30&Eur^AP|14000640||4^Laborat\XF3\rio [AR] - [B31725] - EXAME DE HIBRIDACAO IN SITU, C/ FISH, EM LAVADOS VESICAIS OU URINA, CONJUNTO DE QUATRO SON^SNOMED CT| IN1|1|990004^ENTIDADE DESCONHECIDA^HOS|11111||||||||||||||||||||||||||||||||||||||||||||||^^^| PID|2||267765^^^HOS^NS~375346331^^^HAS^SNS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRS^PH^^^^^^^^^243429775|||||99319276^^^HOS||||||||||||| PV1|2|CON||||||||20045||||5|||||^^^||||||||||||||||||||||||||||7,75|0|0| FT1|1|||20160419090000||CG|16400378^Consulta^SNOMED CT|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^SNOMED CT| IN1|2|935601^SNS^HOS|99999||||||||||||||||||||||||||||||||||||||||||||||375346331^^^HOS| PID|3||267765^^^HOS^NS~375346331^^^HAS^SNS||LAST_NAME^FIRST_NAME^MIDDLE_NAME^^^^L||19470712000000|F|||RUA DA MORADA^^CIDADE^DISTRITO^9999-999^PT^N^CONCELHO^999999||^PRS^PH^^^^^^^^^243429775|||||99319276^^^HOS||||||||||||| PV1|3|CON||||||||20045||||5|||||^^^||||||||||||||||||||||||||||7,75|0|0| FT1|1|||20160428080000||CG|16400379^Consulta^SNOMED CT|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^SNOMED CT| IN1|3|935601^SNS^HOS|99999||||||||||||||||||||||||||||||||||||||||||||||375346331^^^HOS| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Sem resultados
Esta mensagem representa a pesquisa de uma taxa moderador pelo respetivo Número de Taxa.
MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20160419173501||QBP^ZT1^QBP_Q11|1d93da22-2c63-4e76-94a9-f94361399750|D|2.5| QPD|ZT1^Find Tax||@TaxID^16400291|||| RCP|I|50^RD|||| DSC|1| |
---|
Resposta:
Na resposta, é devolvida a informação "Taxa não encontrada" porque, para aquele Número de taxa, não existe nenhum registo de taxa moderadora.
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20160419173501||RSP^ZT1^RSP_ZT1|11021440-f4ac-4aa2-a84e-062cdca7dc26|D|2.5| MSA|AA|1d93da22-2c63-4e76-94a9-f94361399750|Taxa n\XE3\o encontrada| QAK||NF|ZT1^Find Tax|0|0| QPD|ZT1^Find Tax||@TaxID^16400291|||| |
---|
--- Novas mensgens----
Exemplo de uma mensagem Pesquisa de Taxas - Com o detalhe das taxas dos segmentos FT1
Esta mensagem representa a pesquisa de uma taxa moderadora pelo respetivo número do utente, módulo e um período
MSH|^~\&|HL7_DEFAULT|DEV|HOS|DEV|20210623105808||QBP^ZT1^RSP_ZT1|dee74867-8e73-4d57-8c18-d9bde339e654|D|2.5| |
---|
Resposta:
Na resposta, é devolvida a informação com detalhamento da taxa moderadora.
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20210623123947||RSP^ZT1^RSP_ZT1|8b2803ee-f3b5-45a5-b660-d5d7fd639381|D|2.5| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Sem o detalhe das taxas dos segmentos FT1
Esta mensagem representa a pesquisa de uma taxa moderadora pelo respetivo número do utente, módulo e um período
MSH|^~\&|HL7_DEFAULT|DEV|HOS|DEV|20210623105808||QBP^ZT1^RSP_ZT1|2ee74867-8e73-4d57-8c18-d9bde339e654|D|2.5| |
---|
Resposta:
Na resposta, é devolvida informação sem o detalhamento da taxa moderadora.
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20210623123638||RSP^ZT1^RSP_ZT1|58bc9999-1ccc-4001-9ffc-0b9041551ce4|D|2.5| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Com o detalhe das taxas dos segmentos FT1 (13:10:33.245 -> 13:10:33.747 ( 502 ms))
Esta mensagem representa a pesquisa de uma taxa moderadora pelo respetivo número do utente, módulo e um período
MSH|^~\&|HL7_DEFAULT|DEV|HOS|DEV|20210623105808||QBP^ZT1^RSP_ZT1|3ee74867-8e73-4d57-8c18-d9bde339e654|D|2.5| |
---|
Resposta:
Na resposta, é devolvida informação como detalhamento com mais de uma taxa moderadora.
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20210623131033||RSP^ZT1^RSP_ZT1|d40ca603-2b7f-4b05-ac3d-cefec5d7f270|D|2.5| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Sem o detalhe das taxas dos segmentos FT1 -- 13:10:53.942 -> 13:10:54.249 ( 307 ms)
Esta mensagem representa a pesquisa de uma taxa moderadora pelo respetivo número do utente, módulo e um período
Resposta:
Na resposta, é devolvida informação sem o detalhamento da taxa moderadora.
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20210623131054||RSP^ZT1^RSP_ZT1|b1524be3-fd87-49ef-9453-d98fa8530483|D|2.5| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Com o detalhe das taxas dos segmentos FT1 ( 13:17:00.250 -> 13:17:00.956 ( 706 ms))
Esta mensagem representa a pesquisa de uma taxa moderadora pelo respetivo número do utente, módulo e um período
MSH|^~\&|HL7_DEFAULT|DEV|HOS|DEV|20210623105808||QBP^ZT1^RSP_ZT1|5ee74867-8e73-4d57-8c18-d9bde339e654|D|2.5| |
---|
Resposta:
Na resposta, é devolvida informação como detalhamento com mais de uma taxa moderadora com mais de um episódio.
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20210623131700||RSP^ZT1^RSP_ZT1|b24d84bc-344c-4d2e-a592-723d7a15968f|D|2.5| |
---|
Exemplo de uma mensagem Pesquisa de Taxas - Sem o detalhe das taxas dos segmentos FT1 -- 13:17:16.968 -> 13:17:17.370 ( 402 ms)
Esta mensagem representa a pesquisa de uma taxa moderadora pelo respetivo número do utente, módulo e um período
Resposta:
Na resposta, é devolvida informação sem o detalhamento da taxa moderadora com mais de um episódio
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20210623131717||RSP^ZT1^RSP_ZT1|e4c449bd-e202-46f8-a216-996c8ef50308|D|2.5| |
---|