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^HOS|||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^HOS| FT1|2|||20160418000000||CG|16400314^[A21609] - CREATINAQUINASE (CK), S^HOS|||1|,5&Eur^TP|,5&Eur||||3147202|AR|URG||||,5&Eur^AP|14000640||4^Laborat\XF3\rio^HOS| FT1|3|||20160418000000||CG|16400317^[M11010] - ABDOMEN SIMPLES 1 INCIDENCIA^HOS|||1|1,3&Eur^TP|1,3&Eur||||3147202|MR|URG||||1,3&Eur^AP|14000640||5^Radiologia^HOS| FT1|4|||20160418000000||CG|16400318^[M10781] - MAO 2 INCIDENCIAS^HOS|||1|1,1&Eur^TP|1,1&Eur||||3147202|MR|URG||||1,1&Eur^AP|14000640||5^Radiologia^HOS| FT1|5|12013415^HOS||20160418000000|20160419000000|PY|16400319^[M10745] - COTOVELO 2 INCIDENCIAS^HOS|||1|1&Eur^TP|1&Eur||||3147202|MR|URG||||1&Eur^AP|14000640|3133^^QUIOSQUE^^^^^^HOS~2954^^QUIOSQUE^^^^^^N.Mecanogr\XE1\fico|5^Radiologia^HOS| FT1|6|||20160418000000||CG|16400320^[F51240] - DESCOMPRESSAO E RESOLUCAO DE VOLVO INTESTINAL(VER GDH DE AMBULATORIO)^HOS|||1|3,5&Eur^TP|3,5&Eur||||3147202|MR|URG||||3,5&Eur^AP|14000640||5^Radiologia^HOS| FT1|7|||20160418000000||CG|16400352^[Z27040] - CRIOPRESERVACAO DE CELULAS PROGENITORAS HEMATOPOIETICAS DE SANGUE PERIFERICO^HOS|||1|50&Eur^TP|50&Eur||||3147202|MR|URG||||50&Eur^AP|14000640||5^Radiologia^HOS| FT1|8|||20160419000000||CG|16400353^[M15713] - DESOBSTRUCAO INTRALUMINAL COM CRIOTERAPIA^HOS|||1|40&Eur^TP|40&Eur||||3147202|MR|URG||||40&Eur^AP|14000640||5^Radiologia^HOS| FT1|9|||20160418000000||CG|16400354^[Y28140] - ESTUDO DA RESPOSTA ALOGENICA POR CULTURA LINFOCITARIA (RACL)^HOS|||1|32,5&Eur^TP|32,5&Eur||||3147202|AP|URG||||32,5&Eur^AP|14000640||4^Laborat\XF3\rio^HOS| FT1|10|||20160419000000||CG|16400355^[B31725] - EXAME DE HIBRIDACAO IN SITU, C/ FISH, EM LAVADOS VESICAIS OU URINA, CONJUNTO DE QUATRO SON^HOS|||1|30&Eur^TP|30&Eur||||3147202|AR|URG||||30&Eur^AP|14000640||4^Laborat\XF3\rio^HOS| 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^HOS|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^HOS| 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^HOS|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^HOS| IN1|3|935601^SNS^HOS|99999||||||||||||||||||||||||||||||||||||||||||||||375346331^^^HOS|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^[A21609] - CREATINAQUINASE (CK), S^HOS|||1|,5&Eur^TP|,5&Eur||||3147202|AR|URG||||,5&Eur^AP|14000640||4^Laborat\XF3\rio^HOS| FT1|2|||20160418000000||CG|16400317^[M11010] - ABDOMEN SIMPLES 1 INCIDENCIA^HOS|||1|1,3&Eur^TP|1,3&Eur||||3147202|MR|URG||||1,3&Eur^AP|14000640||5^Radiologia^HOS| FT1|3|||20160418000000||CG|16400318^[M10781] - MAO 2 INCIDENCIAS^HOS|||1|1,1&Eur^TP|1,1&Eur||||3147202|MR|URG||||1,1&Eur^AP|14000640||5^Radiologia ^HOS| FT1|4|||20160418000000||CG|16400320^[F51240] - DESCOMPRESSAO E RESOLUCAO DE VOLVO INTESTINAL(VER GDH DE AMBULATORIO)^HOS|||1|3,5&Eur^TP|3,5&Eur||||3147202|MR|URG||||3,5&Eur^AP|14000640||5^Radiologia^HOS| FT1|5|||20160418000000||CG|16400352^[Z27040] - CRIOPRESERVACAO DE CELULAS PROGENITORAS HEMATOPOIETICAS DE SANGUE PERIFERICO^HOS|||1|50&Eur^TP|50&Eur||||3147202|MR|URG||||50&Eur^AP|14000640||5^Radiologia^HOS| FT1|6|||20160419000000||CG|16400353^[M15713] - DESOBSTRUCAO INTRALUMINAL COM CRIOTERAPIA^HOS|||1|40&Eur^TP|40&Eur||||3147202|MR|URG||||40&Eur^AP|14000640||5^Radiologia^HOS| FT1|7|||20160419000000||CG|16400355^[B31725] - EXAME DE HIBRIDACAO IN SITU, C/ FISH, EM LAVADOS VESICAIS OU URINA, CONJUNTO DE QUATRO SON^HOS |||1|30&Eur^TP|30&Eur||||3147202|AR|URG||||30&Eur^AP|14000640||4^Laborat\XF3\rio^HOS| 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^HOS|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^HOS| 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^HOS|||1|7,75&Eur^TP|7,75&Eur||||3147202||CON||||7,75&Eur^AP|||2^Consulta^HOS| 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|||| |
|---|
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 número do utente 155704, módulo, período e @Status CG – Por pagar.
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 número do utente 155704, módulo, período, @Status CG – Por pagar e @TaxDetail - N.
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 - Sem o detalhe das taxas dos segmentos FT1
Esta mensagem representa a pesquisa de uma taxa moderadora pelo número do utente 162432, módulo, período, @Status CG – Por pagar e @TaxDetail - N.
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| |
|---|