Documentação técnica

Conecte o Laudos.AI ao seu PACS, RIS e worklist

Esta visão geral técnica descreve como o Laudos.AI se integra à sua infraestrutura sem trocá-la: protocolos suportados (HL7 v2, FHIR R4, DICOM SR), API REST, webhooks, autenticação SSO, RBAC, trilha de auditoria e residência de dados no Brasil. A implantação é assistida por engenheiro, com ambiente de teste e mapeamento de campos acordado. O radiologista revisa, edita e assina; a IA acelera a estrutura, não decide.

Ver integrações Falar com engenharia

Como o Laudos.AI entra no fluxo

O Laudos.AI atua como uma camada pós-imagem. Ele recebe o contexto do exame do RIS (modalidade, parte do corpo, indicação clínica), apoia o radiologista na estruturação do laudo e devolve o resultado ao fluxo existente — sem exigir que a equipe abandone a worklist ou a interface que já usa.

O RIS envia a ordem do exame (HL7 v2 ou FHIR ServiceRequest).
O radiologista dita e revisa o laudo, com estruturação assistiva por modalidade.
Achados críticos são sinalizados via CRIT para comunicação rastreável.
O laudo assinado retorna ao PACS/RIS (DICOM SR, ORU ou FHIR DiagnosticReport).
Webhooks notificam sistemas externos sobre eventos do ciclo de vida.

Protocolos e pontos de integração

A escolha do protocolo depende do que a sua infraestrutura já fala. Detalhes por padrão em integrações.

HL7 v2 — Mensageria de ordem e resultado

Recebe ORM/ORU (ou variantes acordadas) do RIS para contexto do exame e devolve o laudo finalizado ao fluxo existente, com mapeamento de campos definido na implantação.

FHIR R4 — Recursos clínicos modernos

Suporte a DiagnosticReport, ImagingStudy e ServiceRequest para serviços que já operam em FHIR R4, com paginação e referências resolvíveis.

DICOM SR — Structured Report

Geração e consumo de Structured Report para devolver o laudo estruturado ao PACS, preservando a vinculação ao estudo de imagem.

API REST — Integração programática

Endpoints REST com autenticação por token para criar contexto de exame, recuperar laudos e disparar fluxos, quando HL7/FHIR não cobre o caso.

Worklist — Fila de trabalho

A worklist é organizada por prioridade e criticidade, com indicadores de tempo de laudo, integrada ao PACS/RIS sem forçar uma nova interface.

Webhooks — Eventos assíncronos

Notificações HTTP assinadas para eventos do ciclo de vida do laudo (criado, assinado, achado crítico comunicado), com reentrega em falha.

API REST

Quando HL7 ou FHIR não cobre o caso, a API REST permite criar contexto de exame, recuperar laudos e disparar fluxos programaticamente. As requisições usam autenticação por token, com escopos por recurso e versionamento de caminho.

Método	Caminho	Descrição
POST	/v1/studies	Registra o contexto de um exame (modalidade, parte do corpo, indicação) para iniciar o fluxo de laudo.
GET	/v1/reports/{id}	Recupera um laudo, incluindo status (rascunho, em revisão, assinado) e metadados de auditoria.
POST	/v1/reports/{id}/sign	Registra a assinatura do radiologista responsável após revisão e edição.
GET	/v1/critical-findings	Lista achados críticos sinalizados via CRIT, com status de comunicação e aceite.

Exemplo ilustrativo de requisição autenticada. Os caminhos e o esquema final são confirmados na implantação.

curl https://api.laudos.ai/v1/reports/REPORT_ID \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json"

Webhooks

Webhooks notificam sistemas externos sobre eventos do ciclo de vida do laudo. Cada entrega é assinada (HMAC) para verificação de origem, e falhas são reentregues com backoff. Eventos previstos:

Evento	Quando dispara
report.created	Um laudo foi iniciado a partir do contexto do exame.
report.signed	O radiologista revisou, editou e assinou o laudo.
critical_finding.flagged	Um achado crítico foi sinalizado para revisão e comunicação.
critical_finding.acknowledged	A comunicação do achado crítico recebeu aceite registrado.

{
  "event": "report.signed",
  "data": {
    "report_id": "rep_123",
    "study_id": "stu_456",
    "signed_by": "CRM-SP 192770",
    "signed_at": "2026-05-26T13:40:00-03:00"
  }
}

Autenticação, RBAC e residência BR

SSO (SAML 2.0 e OIDC)

RBAC institucional

Perfis e permissões por papel (radiologista, revisor, gestor, TI), com escopo por unidade e por cliente em telerradiologia.

Trilha de auditoria

Registro de quem fez o quê e quando, incluindo criação, edição, assinatura e comunicação de achado crítico.

Residência de dados no Brasil

Operação com dados no Brasil, em conformidade com a LGPD e as diretrizes da ANPD, com DPO designado.

Mais detalhes de conformidade em Segurança e LGPD.

Ambientes e implantação

A implantação prevê um ambiente de teste com dados sintéticos ou anonimizados, para validar mapeamentos HL7/FHIR, assinaturas de webhook e fluxos de assinatura antes de tocar dados reais. A passagem para produção é assistida por engenheiro, com checklist de integração e plano de contingência. Para acompanhar a evolução do produto, veja o changelog; para a disponibilidade dos serviços, o status.

Perguntas frequentes

Preciso trocar meu PACS ou RIS para integrar?

Não. O Laudos.AI entra depois da imagem e devolve o laudo ao fluxo existente por HL7 v2, FHIR R4, DICOM SR ou API REST. A integração existe para conectar, não para forçar uma nova interface. O mapeamento de campos é definido na implantação assistida por engenheiro.

Como funciona a autenticação?

A aplicação suporta SSO via SAML 2.0 e OIDC para login institucional, e a API usa tokens com escopos. O acesso é governado por RBAC (perfis e permissões por papel), com trilha de auditoria de quem fez o quê e quando.

Os dados ficam no Brasil?

Sim. A operação prevê residência de dados no Brasil, em conformidade com a LGPD (Lei nº 13.709/2018) e as diretrizes da ANPD, com Encarregado de Proteção de Dados (DPO) designado.

Existe ambiente de teste?

Sim. A implantação prevê ambiente de teste com dados sintéticos ou anonimizados, para validar mapeamentos, webhooks e fluxos antes de tocar dados reais.

A API substitui a revisão médica?

Não. A API estrutura e movimenta o laudo, mas o radiologista revisa, edita e assina. A IA acelera a estrutura, não toma a decisão clínica nem emite diagnóstico (Resolução CFM nº 2.454/2026).

Pronto para conectar?

A implantação é assistida por engenheiro, com ambiente de teste e mapeamento de campos acordado. Conecte ao PACS/RIS existente e mantenha o fluxo de laudagem familiar — com o radiologista no controle.

Começar grátis Falar com engenharia