Pedidos de exame

Para que serve

Este ecrã lista os pedidos de exame feitos pelos médicos durante as consultas. Permite:

• ver os pedidos e o seu estado;
• registar resultados de forma simples, em pares «parâmetro» e «resultado»;
• gerir as amostras recolhidas para cada pedido;
• gerar o relatório do exame em PDF.

Atenção. Existem no sistema dois ecrãs com o título Laboratório: este (/examorders) e o do Laboratório (/labs). Este é o mais simples: os resultados são pares de texto, sem valores de referência nem validação. Ver a secção «Por confirmar».

Os pedidos de exame são criados dentro do ecrã de atendimento, pelo médico. Ver o capítulo Prontuário.

Quando usar

• Para consultar os pedidos de exame em curso.
• Para registar resultados quando não é preciso o registo estruturado do ecrã de Laboratório.
• Para registar as amostras recolhidas.
• Para gerar e imprimir o relatório do exame.

Quem pode usar

Ação	Permissão / perfil	Perfis que têm
Abrir a página e ver os pedidos	Nenhuma além de ter sessão iniciada	Todos os utilizadores internos
Registar resultados	Nenhuma além de ter sessão iniciada	Todos os utilizadores internos
Criar e alterar pedidos de exame	perfil médico (doctor)	médico, admin, superadmin
Gerir amostras	Nenhuma além de ter sessão iniciada	Todos os utilizadores internos

Nota importante. Só a criação e a alteração de pedidos exigem o perfil de médico. Ver, registar resultados e gerir amostras não verificam permissões. O item Pedidos de exame só aparece no menu a quem tem view-lab-tests, mas isso apenas esconde o menu. Comunique isto ao responsável técnico da clínica.

Ecrãs e funcionalidades

Endereço: /examorders Menu: grupo Laboratório → Pedidos de exame

[CAPTURA: ecrã de pedidos de exame, com a lista de pedidos à esquerda e o painel de resultados à direita]

Lista de pedidos

Tabela com os pedidos, incluindo as colunas Estado e Prioridade.

• Se não houver nada: «Nenhuma solicitação de exame encontrada.»
• Se não houver paciente escolhido: «Nenhum paciente selecionado.»
• Se a pesquisa não devolver nada: «Nenhum paciente encontrado.»

Quando não há pedido escolhido, aparece: «Selecione uma solicitação de exame para visualizar ou inserir resultados.»

Painel de resultados

Tem duas colunas: Parâmetro e Resultado.

Se não houver nada registado: «Nenhum resultado registado.»

Gestão de amostras

Bloco onde se registam as amostras recolhidas para o pedido escolhido.

Se não houver nada: «Nenhuma amostra registada para este exame.»

Cada botão, o que faz

Na lista de pedidos

Botão	O que faz
Nova solicitação	Ainda não funciona. Mostra o aviso «Funcionalidade para nova solicitação ainda não implementada.» Os pedidos criam-se no ecrã de atendimento
Novo paciente	Não faz nada. O botão existe mas não tem ação associada
Ver detalhes	Abre o painel de resultados, só de leitura
Inserir resultados	Abre o painel de resultados para escrita. Só aparece se o pedido estiver Pendente

No painel de resultados (modo de escrita)

Botão	O que faz
Adicionar parâmetro	Pergunta «Digite o nome do novo parâmetro:» e acrescenta uma linha
Ícone de remover parâmetro	Apaga essa linha
Guardar resultados	Grava os resultados
Cancelar	Fecha o painel sem gravar

No painel de resultados (modo de leitura)

Botão	O que faz
Gerar relatório	Descarrega o relatório do exame em PDF
Fechar	Fecha o painel

Na gestão de amostras

Botão	O que faz	Quando fica indisponível
Adicionar amostra	Abre a janela Adicionar nova amostra	Se não houver pedido escolhido. Ao passar o rato aparece «Selecione uma solicitação primeiro»
Editar (numa linha)	Abre a janela Editar amostra	—
Excluir (numa linha)	Pergunta «Tem a certeza que deseja remover esta amostra?» e, se confirmar, apaga	—
Adicionar amostra (na janela)	Grava a amostra	—
Guardar alterações (na janela)	Grava a edição	—
Cancelar	Fecha sem gravar	—

Cada campo do formulário

Painel de resultados

Campo	Obrigatório	Notas
Parâmetro	Sim	Escrito na janela de Adicionar parâmetro
Resultado	Não	Texto livre

Janela Adicionar nova amostra / Editar amostra

Campo	Obrigatório	Regras	Notas
Tipo de amostra	Sim	Texto, até 255 caracteres	O exemplo sugerido é «Ex.: Sangue, Urina…»
Data de colheita	Sim	Data válida	—
Descrição	Não	Texto livre	O exemplo sugerido é «Descrição da amostra (opcional)»

Campos de um pedido de exame

Estes campos preenchem-se no ecrã de atendimento, não aqui. Ficam listados para referência.

Campo	Obrigatório	Regras
Tipo de exame	Sim	Texto, até 255 caracteres
Data do pedido	Sim	Data válida
Prioridade	Sim	Normal, Urgente ou Emergência
Estado	Sim	Pendente, Concluído ou Cancelado
Descrição	Não	Texto livre
Instruções	Não	Texto formatado
Data limite	Não	Data válida, depois da data do pedido
Data de conclusão	Não	Data válida, depois da data do pedido

Estados e prioridades

Estados

Etiqueta	Significado
Pendente	Ainda por processar. É o único estado em que se podem inserir resultados
Concluído	Já processado
Cancelado	Cancelado

Prioridades

Etiqueta	Significado
Normal	Sem urgência
Urgente	A processar com prioridade
Emergência	A processar de imediato

Exemplo prático

Situação: o Dr. Paulo pediu uma urina II à Sra. Neves durante a consulta. A técnica vai registar a amostra e depois o resultado.

Parte 1 — Registar a amostra

1. Ir a Laboratório → Pedidos de exame.
2. Na lista, clicar no pedido de urina II da Sra. Neves.
3. No bloco de amostras, clicar em Adicionar amostra.
4. Preencher:
   • Tipo de amostra: Urina
   • Data de colheita: 12/02/2026
   • Descrição: Primeira urina da manhã, jato médio.
5. Clicar em Adicionar amostra.
6. A amostra aparece na lista.

Parte 2 — Registar os resultados

7. Na linha do pedido, clicar em Inserir resultados.
8. Clicar em Adicionar parâmetro e escrever Densidade. Preencher o resultado: 1020.
9. Repetir para:
   • pH → 6,0
   • Proteínas → Negativo
   • Leucócitos → Raros
   • Nitritos → Positivo
10. Clicar em Guardar resultados.
11. Aparece «Resultados guardados com sucesso!»

Parte 3 — Gerar o relatório

12. Clicar em Ver detalhes na mesma linha.
13. Clicar em Gerar relatório.
14. O PDF abre numa nova janela e pode ser impresso ou guardado.

Fluxo completo

1. Ir a Laboratório → Pedidos de exame.
2. Escolher o pedido na lista.
3. Registar as amostras recolhidas, com Adicionar amostra.
4. Clicar em Inserir resultados.
5. Acrescentar os parâmetros com Adicionar parâmetro.
6. Preencher os resultados.
7. Clicar em Guardar resultados.
8. Clicar em Ver detalhes e depois em Gerar relatório, se for preciso imprimir.

Erros comuns e como resolver

Mensagem ou situação	Porquê	O que fazer
«Funcionalidade para nova solicitação ainda não implementada.»	O botão Nova solicitação não está feito	Os pedidos de exame criam-se no ecrã de atendimento, pelo médico
O botão Novo paciente não faz nada	Não tem ação associada	Crie o paciente em Pacientes → Lista de Pacientes
Não vejo o botão Inserir resultados	O pedido não está no estado Pendente	Só se registam resultados em pedidos pendentes
«Este pedido de exame não está associado a uma consulta, por isso não é possível gerar o relatório.»	O pedido não está ligado a nenhuma consulta	Não é possível gerar o PDF. Verifique se o pedido foi criado a partir de uma consulta
«Não foi possível gerar o relatório.»	Falha ao gerar o PDF	Tente de novo. Se persistir, contacte o administrador
«Clínica ou logo não encontradas.»	Faltam os dados de identificação da clínica	Fale com o administrador da clínica
«Erro ao guardar resultados.»	Falha ao gravar	Tente de novo. Não feche a página sem confirmar que gravou
«Erro ao carregar solicitações de exame: …»	Falha de ligação ao servidor	Verifique a internet e recarregue
«Não foi possível adicionar a amostra.»	Falha ao gravar a amostra	Confirme que escolheu um pedido primeiro
«Não foi possível remover a amostra.» / «Não foi possível atualizar a amostra.»	Falha ao gravar	Tente de novo
O botão Adicionar amostra está cinzento	Não escolheu nenhum pedido	Clique primeiro numa linha da lista
«Erro ao carregar amostras: …»	Falha de ligação	Recarregue a página

Dicas e boas práticas

• Escreva os nomes dos parâmetros sempre da mesma maneira. Este ecrã não tem catálogo de parâmetros: tudo é texto livre, e nomes diferentes para a mesma coisa tornam impossível comparar resultados ao longo do tempo.
• Registe a amostra antes dos resultados, com a data de colheita correta.
• Trate primeiro os pedidos marcados como Urgente e Emergência.
• Se a clínica precisa de valores de referência e de validação formal do resultado, use o ecrã de Laboratório e não este.
• Confirme com a direção qual dos dois ecrãs a clínica usa. Usar os dois ao mesmo tempo divide a informação em dois sítios.

Por confirmar

• Existem dois ecrãs com o título Laboratório. Este (/examorders) e o de Laboratório (/labs). Não foi possível confirmar qual é o ecrã oficial.
• Não é possível criar um pedido de exame a partir deste ecrã. O botão existe mas mostra um aviso de funcionalidade não implementada. Os pedidos são criados no ecrã de atendimento.
• Existem endereços para criar, ver e editar pedidos de exame (/examorders/ create, /examorders/{id}, /examorders/{id}/edit), mas não foram encontrados os ecrãs correspondentes. Provavelmente não funcionam.
• Esta página não verifica permissões para ver, registar resultados nem gerir amostras. Comunique ao responsável técnico da clínica.
• Algumas mensagens do sistema relacionadas com amostras aparecem em inglês.
• Não foi possível confirmar se existe forma de mudar o estado de um pedido para Concluído ou Cancelado a partir deste ecrã.