← Documentação

Inteligência

Exames

Pedidos por modalidade, laudo estruturado assinado e leitura assistida por IA.

Visão geral

O módulo Exames cobre o ciclo completo: PEDIDO de exame por modalidade (laboratório, radiografia, ultrassom, tomografia, ressonância, ECG, ecocardiograma, endoscopia, citopatologia) com prioridade, indicação clínica e código TUSS/CBHPM; resultado com leitura assistida por IA (a Aura extrai e compara valores do laudo enviado — sempre como sugestão); e LAUDO ESTRUTURADO por template, com fluxo rascunho → liberado (assinado).

A tela é mestre-detalhe: a lista à esquerda tem todos os exames da unidade — pedidos e resultados na mesma lista — e clicar em qualquer linha abre aquele exame no painel da direita, com tudo dele: o que foi pedido, o andamento, a cobrança, o laudo e as ações disponíveis. Não há segunda tela: as antigas abas Pedidos / Fila de laudos / Encerrados viraram os filtros de status da própria lista.

Conceitos-chave

  • Pedido/requisição: solicitado → agendado → coletado/realizado → laudado → entregue (cancelamento exige motivo).
  • Pedido × resultado, uma lista e uma tela: o pedido (requisição → laudo assinado) e o resultado por upload (arquivo + leitura de IA) são registros de naturezas diferentes, mas para quem usa são um exame só: aparecem na mesma lista e abrem no mesmo lugar (/exames/{id} resolve qual dos dois é). Resultado anexado a um pedido aparece uma vez só, e cada tela linka a outra.
  • Status, vocabulário único: Aguardando (pedido solicitado/agendado/coletado, ou resultado ainda não lido), A laudar (exame feito esperando laudo — a antiga fila de laudos), Laudado, Entregue e Cancelado. O filtro fica na URL, então o link de uma triagem pode ser compartilhado.
  • Exame do catálogo: ao criar o pedido, escolha o exame que a unidade oferece (serviços da categoria exame em Serviços e preços) — é de onde sai o preço do item cobrado. O código TUSS/CBHPM continua disponível para convênio.
  • Realizar agora × requisição: escolhido um exame do catálogo, o pedido oferece Realizar agora — é o exame que a clínica executa na hora, então ele já nasce realizado e o valor entra na conta do atendimento imediatamente. Desmarque quando for só a requisição (o paciente vai fazer depois, ou fora): aí a cobrança acontece quando alguém marcar realizado.
  • Modalidade: laboratório e imagem são 1ª classe — cada uma com seus templates de laudo.
  • Laudo estruturado: seções do template (técnica, achados, impressão) + conclusão; liberar assina (hash SHA-256, tamper-evidence) e congela; correção entra por adendo imutável.
  • Extração por visão: a Aura lê o laudo enviado e sugere os valores.
  • Revisão obrigatória: os valores sugeridos precisam ser aprovados.

Como usar

  1. Em Exames, use Novo → Pedir exame (ou Pedir exame na ficha do paciente e no trilho da consulta) e preencha: paciente, exame do catálogo (dá o preço), modalidade, indicação e — com Convênios ativo — o código TUSS.

  2. Exame que a unidade executa na hora: deixe Realizar agora marcado — o valor entra na conta do atendimento na mesma ação. Requisição para depois: desmarque, e depois Marcar realizado (no painel do exame ou no card Exames da consulta) quando acontecer.

  3. Filtre a lista por A laudar, abra o exame, escolha o template, escreva por seções e libere (assina e congela).

  4. Para resultados que chegaram de fora, use Novo → Enviar resultado, anexe o laudo e use a leitura assistida da Aura; revise antes de salvar.

Casos de uso

  • Hemograma: anexe o laudo e deixe a Aura extrair os analitos.
  • Acompanhamento: compare o exame atual com o anterior.

Boas práticas

Erros comuns e soluções

Integrações

Anexos passam por Mídia; extrações são sugestões (Aprovações); resultados entram no prontuário. O exame realizado cobra automaticamente — seja pelo Realizar agora na criação, seja pelo Marcar realizado depois: item na conta aberta do paciente com o preço do serviço de exame escolhido no pedido (convênio resolve pela tabela da operadora via código TUSS) ou venda em aberto; pedido sem serviço e sem preço resolvível não gera cobrança e a falta fica registrada na Auditoria.

O caminho de volta também fecha: cancelar um exame já cobrado estorna o item da conta, quando ela ainda está aberta (conta fechada ou faturada não se mexe — a correção ali é pelo Faturamento, e o caso fica na Auditoria). E cancelar o atendimento cancela junto os pedidos de exame em aberto dele, além de encerrar protocolos e sugestões que ficaram esperando aprovação; o que já foi laudado ou entregue permanece, porque é fato registrado.

Permissões

Solicitar/laudar exige escrita clínica (clinical.write); LIBERAR o laudo exige autoridade clínica (clinical.approve).

Dúvidas frequentes

A IA preenche os valores sozinha?

Ela sugere a extração; os valores precisam ser revisados e aprovados.

Posso editar um laudo liberado?

Não — liberado é imutável (assinado com hash). Corrija por adendo, que fica registrado junto ao laudo.

De onde vêm os templates de laudo?

Há templates padrão por modalidade (seed) e a unidade pode criar os seus.

Onde foi parar a tela de Pedidos?

Deixou de existir como tela separada — era uma segunda lista dos mesmos exames. As três abas dela viraram os filtros de status da lista: Pedidos ≈ Aguardando, Fila de laudos = A laudar, Encerrados = Laudado/Entregue/Cancelado. As ações (agendar, marcar realizado, laudar, adendo, cancelar) ficam no painel do próprio exame.

Qual a diferença entre Pedir exame e Enviar resultado?

Pedir exame cria a requisição clínica — a unidade executa ou encaminha, e o desfecho é o laudo assinado. Enviar resultado é para o laudo que chegou pronto de fora: você anexa o arquivo e a Aura extrai os valores.

Cancelei a consulta. E o exame que eu tinha pedido nela?

É cancelado junto, se ainda estava em aberto. Exame já laudado ou entregue permanece — aconteceu de verdade e continua no prontuário.