A pesquisa de agendamentos é implementada através de uma mensagem SQM^S25. O objetivo desta operação é obter a lista de agendamentos consoante os critérios de pesquisa introduzidos.
Esta mensagem apresenta algumas diferenças relativamente às outras queries que temos vindo a abordar neste manual. Em vez do segmento QPDtemos o segmento QPD/wiki/spaces/PD/pages/42959023no qual devemos identificar, no campo QPD-8, os critérios de pesquisa a utilizar. De forma a limitar a pesquisa no tempo, é conveniente definir um intervalo de datas no qual pretendemos encaixar a pesquisa. Esse intervalo de datas deve ser passado no segmento QRF.
Os parâmetros de pesquisa suportados por esta operação são os seguintes:
| Parâmetros aceites | Descrição |
|---|---|
| @VisitNumber | Nº de episódio |
| @DomainCode | Modulo [0..n] |
| @SessionID | Sessão de Hospital de Dia |
| @PatientID | ID do Utente |
| @HealthCardNumber | Nº SNS |
| @ProcessNumber | Nº do processo |
| @Status | Estado (BOOKED, COMPLETE, CANCELLED, NOSHOW) [0..n] |
| @BeginDate | Data ínicio |
| @EndDate | Data fim |
| @AppointmentID | Número da marcação |
| @Service | Serviço / EspecialidadeEspecialidade [0..n] |
Posteriormente, é devolvida uma resposta (SQR^S25) com a lista de agendamentos resultante do tipo de pesquisa efectuada.
...
Query Statement ID : | S25 |
Type: | Query |
Query Name: | Schedule Query |
Query Trigger (= MSH-9): | SQM^S25^SQM_S25 |
Query Mode: | Both |
Response Trigger (= MSH-9): | SQR^S25^SQR_S25 |
Query Characteristics (= QRD-9): | @VisitNumber; @SessionID ; @PatientID; @HealthCardNumber; @ProcessNumber; @Status; @AppointmentID; @Service |
| Dates (= QRF-2 e QRF-3): | @BeginDate; @EndDate |
Purpose: | Pesquisa de Agendamentos |
Response Characteristics: | Envia a lista de agendamentos de acordo com os critérios de pesquisa. |
...
Esta mensagem representa uma pesquisa de todos os agendamentos para o dia 18/05/2017 do Utente com o número de processo "99354595". O número de resultados a serem devolvidos nesta pesquisa foi limitado a 2 no campo QRD-7.
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170610123809||SQM^S25^SQM_S25|015a44a2-dd12-40c9-8785-a0981df3fa59|D|2.5| QRD|20170610123808|R|D||||2^RD|99354595^^^^^^^^^^^^@ProcessNumber|SAL| QRF||20170518|20170518| |
|---|
Resposta:
Na resposta, são devolvidos apenas 2 registos, mas foram encontrados 8 registos para a pesquisa efetuada, esta informação é passada nos campos QAK-5 e QAK-4 respectivamente. Para esta pesquisa foram devolvidos os agendamentos que correspondem ao número de processo "99354595" para os dias 13 e 14 de Junho de 2017.
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20170613155058||SQR^S25^SQR_S25|59650c82-38c5-44ba-a348-4c8a94c90b34|D|2.5| |
|---|
Os 2 agendamentos que são devolvidos correspondem a:
- PV1-50/SCH-2 = 16406127 - Um episodio de consulta (SCH-8 = P)
- Nestes casos o modulo a que corresponde este agendamento deve ser validado no PV1-2
- PV1-50/SCH-2 = 6256358 - Um exame (SCH-8 = RAD)
- Nestes casos o modulo já vem identificado no próprio SCH-8 (RAD ou LAB)
Exemplo de uma mensagem Pesquisa de Agendamentos - Sem resultados
Esta mensagem representa uma pesquisa de agendamentos do utente com número de processo "99354595" no intervalo de datas compreendido entre os dias 10/06/2017 e 11/06/2017.
| MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170610123809||SQM^S25^SQM_S25|015a44a2-dd12-40c9-8785-a0981df3fa59|D|2.5| QRD|20170610123808|R|D||||20^RD|99354595^^^^^^^^^^^^@ProcessNumber|SAL| QRF||20170610|20170611| |
|---|
Resposta:
A mensagem de resposta reflecte que não foram encontrados quaisquer registos dentro do limite temporal estabelecido.
MSH|^~\&|HOS|DEV|HL7_DEFAULT|DEV|20170613161406||SQR^S25^SQR_S25|ab0a453c-c81e-45e4-8e46-e67358baf136|D|2.5| |
|---|
Exemplo de uma mensagem Pesquisa de Agendamentos
Neste exemplo é enviada uma mensagem de pesquisa de agendamentos com o parâmetro número de processo "99354595", no campo QRD-8. Nos campos QRF-2 e QRF-3 são passadas as datas limite de inicio e fim da pesquisa respectivamente. Neste caso apenas vão ser devolvidos resultados para o dia 14/06/2017.
MSH|^~\&|HL7_DEFAULT|INST|HOS|INST|20170605112050||SQM^S25^SQM_S25|ea8e77cc-c7b4-49c0-adf5-402bf4d9c3be|D|2.5| |
|---|
Resposta:
Neste exemplo foi encontrado um agendamento para o dia 14/06/2017 pelas 08:00. Esta mesma pesquisa também poderia ser feita usando como parâmetro o Nº SNS ou o ID deste utente, os resultados seriam os mesmos.
MSH|^~\&|HOS|INST|HL7_DEFAULT|INST|20170613150703||SQR^S25^SQR_S25|22a975c2-490c-43f6-bc76-dba9a6b3b138|D|2.5| |
|---|
...