DocumentaçãoSuporteCosta Rica · Contato
O ponto de partida

O ecossistema já está definido. A pergunta é de que lado a sua organização fica.

Quando um país define sua arquitetura de interoperabilidade, conectar-se deixa de ser opcional. Sua organização vai ter de responder consultas, publicar o que produz, ou ambas as coisas — e vai ter de provar que consegue antes de a deixarem entrar. A maioria descobre tarde: faltavam três ou quatro capacidades que nunca estiveram em projeto nenhum, e elas aparecem na fase de testes, quando a data já está comprometida. Nosso trabalho é que você saiba isso hoje.

Papéis

Consumidor, produtor, custodiante: quase ninguém é só um

O intercâmbio se organiza por papéis, não por tipo de instituição. Um mesmo hospital costuma cumprir os três ao mesmo tempo, e as obrigações não se escolhem: elas se acumulam.

Consulta para decidir

Consumidor

Precisa ver informação que outro gerou —um resultado, uma vacina, um episódio anterior— no momento em que está atendendo o paciente.

O que vão lhe exigir

Provar quem consulta, em nome de quem e com que propósito; e que cada consulta fica registrada.

O que quase sempre falta

Ninguém definiu o propósito de uso nem onde fica o consentimento. A consulta funciona nos testes e trava na revisão jurídica.

Tipicamente
  • Serviços de emergência
  • Ambulatório
  • Farmácia
  • Referência e contrarreferência
Gera o dado

Produtor

Produz informação clínica de que o resto do ecossistema precisa: resultados de laboratório, notificações, laudos de imagem, vacinas aplicadas.

O que vão lhe exigir

Publicar em conformidade com o perfil nacional, com a terminologia vinculada e no momento em que o fato ocorre — não em um lote no fim do mês.

O que quase sempre falta

O sistema que gera o dado não consegue produzir o perfil, e o projeto descobre isso quando esse sistema já foi comprado.

Tipicamente
  • Laboratórios
  • Serviços de imagem
  • Imunização
  • Notificação compulsória
Responde pelo dado

Custodiante

Guarda a informação e responde por ela: quem pode vê-la, por quanto tempo é conservada e o que se entrega quando o ecossistema pede. Às vezes é o mesmo que a produz; às vezes é um papel à parte.

O que vão lhe exigir

Estar disponível quando o consultarem, entregar apenas o autorizado e conseguir reconstruir quem acessou o quê, meses depois.

O que quase sempre falta

O repositório existe, mas não há disponibilidade comprometida, nem auditoria consultável, nem política de retenção escrita.

Tipicamente
  • Repositórios institucionais
  • Redes de prestadores
  • Registros nacionais
  • Operadores de PACS

Se a sua organização produz e também consulta, não dá para escolher: aplicam-se as duas colunas. E se guarda o que produz, aplicam-se as três. Essa acumulação é a razão pela qual os projetos de conexão levam o dobro do estimado.

Lacunas

O que falta você construir?

Sete capacidades. Abra as que o seu papel exige e você vai reconhecer em quais está pronto e quais hoje não estão em nenhum projeto da sua organização.

CapacidadeConsumidorProdutorCustodiante
Resolução de identidade do pacienteConsumidorObrigatórioProdutorObrigatórioCustodianteObrigatório
O que é

Saber que o prontuário que você tem e o que o ecossistema responde são da mesma pessoa, mesmo que os identificadores não coincidam.

Se você não a tem

Une ou separa históricos errados. É o erro que mais rápido vira incidente clínico e o mais caro de corrigir para trás.

Como se resolve

Consulta-se o índice do ecossistema em vez de replicá-lo, com uma política escrita para os casos que não resolvem automaticamente.

  • IHE PIX / PDQm
  • FHIR Patient $match
Localização da informaçãoConsumidorObrigatórioProdutorConforme o casoCustodianteObrigatório
O que é

Descobrir que informação existe sobre um paciente e quem a tem, antes de trazê-la.

Se você não a tem

Sem isso você só consegue perguntar a quem já sabia que tinha algo, que é exatamente o contrário do motivo pelo qual existe um HIE.

Como se resolve

Consulta-se o registro de documentos do ecossistema e recupera-se apenas o que a decisão clínica daquele momento exige.

  • IHE XDS.b / XCA
  • IHE MHD
  • FHIR DocumentReference
Consentimento e propósito de usoConsumidorObrigatórioProdutorConforme o casoCustodianteObrigatório
O que é

Declarar para que se consulta e verificar que há base para isso, a cada acesso e não uma única vez no início.

Se você não a tem

É onde travam os projetos que já funcionavam tecnicamente. Ninguém assina uma entrada em produção com isso em aberto.

Como se resolve

Define-se o propósito de uso por caso, registra-se a base legal e amarra-se à autorização com que a solicitação viaja, não a uma caixinha de formulário.

  • IHE BPPC / APPC
  • FHIR Consent
  • SMART scopes
Publicação conforme ao perfilConsumidorConforme o casoProdutorObrigatórioCustodianteObrigatório
O que é

Entregar o que você produz com a estrutura, os campos obrigatórios e a terminologia que o guia nacional exige.

Se você não a tem

O que você publica é rejeitado. Ou pior: é aceito incompleto e chega assim a quem consulta, sem ninguém perceber até que importe.

Como se resolve

Valida-se contra o perfil antes de publicar e corrige-se na origem. Se o sistema de origem não consegue produzi-lo, resolve-se com uma camada de exposição, sem substituí-lo.

  • HL7 FHIR
  • IHE MHD / XDS.b
Resposta a consultas em tempo realConsumidorConforme o casoProdutorConforme o casoCustodianteObrigatório
O que é

Estar disponível para responder quando o ecossistema pergunta, com um tempo de resposta comprometido.

Se você não a tem

Um custodiante que não responde deixa de sê-lo na prática, e quem consultava toma a decisão clínica sem aquele dado.

Como se resolve

Compromete-se a disponibilidade como um número mensurável, com monitoramento, e separa-se o caminho de consulta externa do sistema que atende a operação diária.

  • IHE XCA / XCPD
  • FHIR RESTful API
Auditoria do acessoConsumidorObrigatórioProdutorObrigatórioCustodianteObrigatório
O que é

Conseguir reconstruir, meses depois, quem acessou qual informação, quando e com que justificativa.

Se você não a tem

É a primeira coisa que vão lhe pedir diante de uma reclamação. Se os registros já rotacionaram, a resposta institucional é que não se sabe.

Como se resolve

Projeta-se como componente, com retenção definida e consulta própria, e emite-se o evento em cada transação do ecossistema, não apenas no sistema local.

  • IHE ATNA
  • FHIR AuditEvent
Identidade de sistema, relógio e não repúdioConsumidorObrigatórioProdutorObrigatórioCustodianteObrigatório
O que é

Que o ecossistema saiba que quem pergunta é você, que todos os registros compartilhem a mesma hora e que o que foi trocado possa ser provado.

Se você não a tem

Sem sincronia de relógio a auditoria não reconstrói nada. Sem assinatura, um documento trocado não prova quem o emitiu nem que chegou íntegro.

Como se resolve

Certificados por organização e por subsistema, sincronização de relógio, e assinatura e carimbo nas trocas com valor probatório.

  • IHE ATNA / CT
  • JAdES
  • mTLS
ObrigatórioConforme o caso

Esse quadro é exatamente o primeiro entregável de uma avaliação de lacunas: estas linhas, preenchidas com o que a sua organização já tem, o que falta e quanto custa cada uma.

Transacionalidade

Como a sua arquitetura conversa com o HIE

Nenhuma integração é uma única chamada. Esta é a sequência real, e em cada passo há algo concreto que a sua arquitetura precisa conseguir fazer.

  1. 01

    Identificar o paciente

    Rumo ao ecossistema

    Antes de pedir qualquer coisa é preciso resolver de quem se está falando. Consulta-se o índice do ecossistema com os identificadores que você tem e recebe-se aquele pelo qual o resto o conhece.

    • PIX / PDQm
  2. 02

    Descobrir o que existe

    Rumo ao ecossistema

    Com a identidade resolvida, pergunta-se que informação existe sobre aquela pessoa: quem a tem, de que tipo é e de quando. Ainda não se traz nada.

    • XDS.b / MHD
  3. 03

    Recuperar só o necessário

    Rumo ao ecossistema

    Traz-se o documento ou o recurso de que a decisão daquele momento precisa, não o prontuário inteiro. O que se traz a mais fica fora do seu controle.

    • XCA / FHIR read
  4. 04

    Responder quando o consultado é você

    Rumo à sua organização

    O mesmo circuito, do outro lado: alguém identifica o paciente, vê que você tem informação e a pede. Sua arquitetura precisa responder a tempo, autorizar por caso de uso e recortar a resposta.

    • XCA / XCPD
  5. 05

    Publicar o que você produz

    Rumo ao ecossistema

    Cada vez que se gera um fato clínico relevante, publica-se em conformidade com o perfil, com a terminologia vinculada e no momento em que ocorre. O lote mensal já não serve.

    • MHD / FHIR create
  6. 06

    Registrar cada passo

    Nas duas pontas

    Cada uma das transações anteriores emite um evento de auditoria, nas duas pontas e com a mesma hora. É isso que depois permite responder a uma reclamação com fatos.

    • ATNA
    • CT
Conformidade

O que é preciso demonstrar antes de deixarem você conectar

Entrar em um ecossistema nacional não é um acordo técnico entre duas equipes: há requisitos que se provam com evidência. Convém conhecê-los antes de comprometer uma data, não depois.

Conformidade com o perfil nacional

O que exigem de você

Que o que você publica cumpre o guia de implementação vigente, com os campos obrigatórios e a terminologia vinculada.

Com o que se demonstra

Relatório de validação contra o perfil, com casos de teste que cobrem os cenários reais e não apenas o caminho feliz.

Terminologias corretas e vigentes

O que exigem de você

Que os códigos que você envia existem, estão vigentes e pertencem ao ValueSet que o guia exige.

Com o que se demonstra

Validação terminológica automatizada no ponto de publicação, e um plano escrito do que acontece quando um ValueSet muda de versão.

Identidade e autorização

O que exigem de você

Certificados de organização e de subsistema, e autorização por caso de uso em vez de acesso geral ao sistema.

Com o que se demonstra

Registro no ecossistema, prova de autenticação mútua e matriz do que cada consumidor pode pedir.

Auditoria reconstruível

O que exigem de você

Registro de cada acesso, com retenção definida e capacidade de responder a uma consulta pontual.

Com o que se demonstra

Demonstração de uma busca real: quem viu o prontuário desta pessoa nos últimos seis meses, respondida em minutos.

Valor probatório da troca

O que exigem de você

Que o que foi trocado possa ser atribuído a quem o emitiu e provado inalterado, nos casos que exigem isso.

Com o que se demonstra

Assinatura e carimbo dos documentos ou recursos, com validação do lado receptor. A Meddyg prestou assistência técnica ao Banco Central da Costa Rica para habilitar a assinatura JAdES de recursos FHIR.

Testes de conexão aprovados

O que exigem de você

Passar pelo ciclo de testes do ecossistema com dados parecidos com os reais, antes de tocar em produção.

Com o que se demonstra

Ambiente de testes com dados sintéticos, conjunto de casos acordado e evidência de cada transação executada de ponta a ponta.

Método

Da decisão de conectar-se à primeira transação em produção

Seis etapas. A primeira define o seu papel, porque todo o resto —escopo, custo e data— depende disso.

  1. 01

    Definição de papel e casos

    Estabelecemos quais papéis a sua organização cumpre, serviço por serviço, e com quais casos de uso concretos ela entra no ecossistema. Sem isso, qualquer estimativa é um chute.

    O que fica
    • Papéis atribuídos por serviço
    • Casos de uso priorizados
    • Escopo da primeira conexão
  2. 02

    Avaliação de lacunas

    Confrontamos as capacidades que o seu papel exige com o que a sua arquitetura faz hoje, e separamos o que é preciso construir do que só é preciso configurar. É aqui que a data fica realista.

    O que fica
    • Quadro de lacunas por papel
    • Estimativa de esforço por lacuna
    • Riscos da conexão
  3. 03

    Desenho da integração

    Definimos qual componente fala com o ecossistema, que transações suporta, como se autentica e o que se recorta em cada resposta.

    O que fica
    • Desenho de transações
    • Ponto de exposição e controles
    • Matriz de autorização por caso
  4. 04

    Construção e conformidade

    Constrói-se o que falta e valida-se contra o perfil nacional na origem, não no final. Quando o sistema de origem não consegue produzir o perfil, resolve-se com uma camada de exposição em vez de substituí-lo.

    O que fica
    • Componentes de integração
    • Relatórios de validação
    • Casos de teste automatizados
  5. 05

    Testes com o ecossistema

    Executamos o ciclo de testes de ponta a ponta, incluindo os cenários que falham: o paciente que não resolve, o documento que não está conforme, a outra ponta que não responde.

    O que fica
    • Evidência de testes
    • Achados e correções
    • Aprovação de conexão
  6. 06

    Entrada em produção e operação

    Acompanhamos a primeira transação real e deixamos o monitoramento, a auditoria e o procedimento para quando quem falha é a outra ponta.

    O que fica
    • Plano de entrada e de reversão
    • Monitoramento e alertas
    • Transferência para a equipe interna
Entregáveis

O que fica nas mãos da organização

Material com o qual se estima, se contrata e se demonstra conformidade — não uma apresentação.

Quadro de lacunas por papel

As capacidades que o seu papel exige, o que já está resolvido, o que falta e quanto custa cada lacuna.

Desenho da integração

Qual componente fala com o ecossistema, que transações suporta e sob quais controles de identidade, autorização e auditoria.

Dossiê de conformidade

Os requisitos técnicos e normativos com a evidência que os comprova, organizados para serem apresentados como estão.

Conjunto de casos de teste

Os cenários de conexão, inclusive os que falham, automatizados para poder repeti-los a cada mudança.

Plano de conexão por etapas

Qual caso de uso entra primeiro, com quais dependências e em que ordem convém para que algo chegue logo à produção.

Monitoramento e operação

O que se mede, o que dispara alerta e o que fazer quando a ponta que deixa de responder é a outra.

Casos

Conexões que estão operando

Cada um destes projetos resolveu um papel concreto dentro de um ecossistema de intercâmbio, e ficou funcionando.

O papel que resolveuTransacionalidade com o ecossistema

Intercâmbio nacional sobre X-Road

Provas de conceito junto à Agência Nacional de Governo Digital para validar transações de recursos FHIR sobre a plataforma nacional, dentro da demonstração funcional de interoperabilidade da Costa Rica: intercâmbio seguro entre sistemas diferentes, sem centralizar os dados.

O papel que resolveuCustodiante que recebe

Servidor FHIR nacional de notificações do EDUS/CCSS

Desenho, implantação em produção e operação do primeiro servidor FHIR que recebe as notificações de doenças de notificação compulsória, vacinas e resultados de laboratório do EDUS/CCSS, e posteriormente de outros estabelecimentos de saúde.

O papel que resolveuProdutor rumo a um ecossistema regional

Notificação regional de ESAVI

Parte da equipe da Meddyg participou como consultora no desenho do primeiro guia de implementação HL7© FHIR© para a notificação regional de ESAVI, e no desenho e implementação da infraestrutura que receberia essas notificações.

O papel que resolveuCustodiante de estudos

Intercâmbio de imagens médicas sob DICOM

Implementação de arquiteturas de PACS e estações de trabalho de diagnóstico para o intercâmbio de imagens médicas sob o padrão DICOM, em hospitais públicos do Serviço Nacional de Saúde da República Dominicana.

Os modelos e perfis que citamos nesta página —OpenHIE, IHE, HL7 FHIR— são o método com que trabalhamos, não clientes. Quando um caso corresponde a um cliente, dizemos o nome.

Para quem

Quem tem esta conversa pendente

Serve tanto a quem já recebeu uma data de conexão quanto a quem ainda não sabe que papel lhe foi atribuído.

Instituições públicas de saúde

Institutos, ministérios e hospitais a quem o ecossistema nacional já atribuiu um papel e, muitas vezes, uma data.

Prestadores privados e redes

Clínicas, hospitais e redes que precisam participar sem abrir sua rede nem refazer seu prontuário.

Laboratórios e serviços de imagem

Produtores de resultados de quem se vai exigir publicação conforme ao perfil, no momento em que o fato ocorre.

Áreas de TI e integração

Equipes que precisam responder quanto tempo leva e quanto custa conectar-se, e hoje não têm com o que estimar.

Fornecedores de software de saúde

Fabricantes cujo produto precisa cumprir o perfil nacional para que o cliente consiga se conectar.

Programas nacionais e regionais

Iniciativas que precisam conectar dezenas de organizações com o mesmo critério, em vez de negociar uma a uma.

Autodiagnóstico

Sinais de que a conexão vai custar mais do que o estimado

Atribuíram um papel a você no ecossistema e você não tem certeza do que isso significa em obrigações concretas.
Você consegue publicar o que produz, mas não sabe se está conforme ao perfil nacional até alguém rejeitar.
Você não conseguiria reconstruir quem consultou o prontuário de uma pessoa nos últimos seis meses.
Cada consulta ao ecossistema é resolvida com um desenvolvimento diferente, feito pelo fornecedor da vez.
Pediram uma data de conexão e a estimativa se apoia no que você espera, não no que mediu.
Você sabe que vai ter de responder consultas em tempo real, e hoje o único que poderia responder é o sistema que atende a operação diária.

Se você reconhece três ou mais, não falta um projeto: falta um diagnóstico. Esse primeiro passo se mede em semanas e é o que faz a data deixar de ser uma aposta.

Você sabe qual papel lhe coube e o que falta para cumpri-lo?

Dizemos exatamente quais capacidades o seu papel exige, quais você já tem, quais faltam e em que ordem convém construí-las — com a evidência que o ecossistema vai lhe pedir.