HL7 PT FHIR Implementation Guide: Example IG Release 1 | STU1, published by HL7 Portugal. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-pt/patient-admin-ig/ and changes regularly. See the Directory of published versions

Inicio

Official URL: http://example.com/fhir/example/ImplementationGuide/hl7.fhir.pt.patient-admin-ig				Version: 1.0.0
Active as of 2020-02-26				Computable Name: ExampleIG

The specification herewith documented is for the time being a proof of concept specification, and may not be used for any implementation purposes. No liability can be inferred from the use or misuse of this specification, or its consequences.

Ambito

O presente guia de implementação (IG) foi desenvolvido com o objetivo de uniformizar a definição, utilização e partilha de informações entre diferentes sistemas de informação de saúde, assegurando uma interoperabilidade eficaz entre diferentes entidades e profissionais de saúde.

Este guia fornece especificações técnicas utilizando o FHIR Versão 4B, e funcionais e pressupõe que o leitor esteja familiarizado com a especificação funcional e com esta versão do FHIR.

Introdução

Em Portugal começam a existir várias implemetações em FHIR que mapeaiam as implementações de mensagens HL7v2.x para mensagens HL7 FHIR. Este IG pretende dar suporte a integrações em FHIR que implementam o paradigma de FHIR Messaging, fazendo a ponte entre as implementações que já existem em HL7v2.x e mensagens HL7 FHIR. Tem como base o perfil PatientAdministration Management da Estrutura Técnica de Infraestrutura de TI do IHE para a abordagem em HL7v2.x e que tem como atores "Patient Demographics Supplier" e "Patient Demographics Consumer".

O paradigma de mensagem FHIR permite manter a comunicação assáncrona de menagens e evoluir a comunicação para o Standard FHIR e ao mesmo tempo, usando ferramentas de conversão, manter a comunicação com os sistemas que mantém as integrações em HL7 v2 (Fig.1).

​

Fig.1 -Fhir Messaging Paradigms Schema

O perfil IHE PatientAdministration Managament apresenta duas transações: Patient Identity Management e Patient Enconter Management. O âmbito desta IG é focado na transação Patient Identity Management (Fig.2) o qual inclui as operações que permitem fazer a gestão dos dados demográfios dos utentes.

​

Fig.2 - Atores da trasanção Gestão da Identidade do Utente

O termo “dados demográficos do utente” refere-se aos dados da identidade completa do utente, incluindo informações sobre pessoas relacionadas com ele, como cuidador principal, médico de família, tutor, familiares mais próximos, entidades responsáveis, etc.

A transação Patient Identity Management transmite dados demográficos do utente no domínio de identificação do utente e contém eventos para criação, atualização, fusão/associaçao de utentes. Esta transação é usada nos vários contextos como internamento, e todos aqueles que recebem um leito na unidade de saúde, ou urgência, consulta externa, hospital de dia, ambulatório e outros que não têm atribuído um leito na unidade de saúde.

Em Hl7v2, as mensagens qu suportam as ações necessárias estão especificadas no profile IHE mencionado anteriormente prevendo a toca de mensagens com eventos especificos já defenidos pelo standard HL7 v2:

Event	Trigger	Message Static Definition
Create new patient	A28	ADT^A28^ADT_A05
Update patient information	A31	ADT^A31^ADT_A05
Change Patient Identifier List	A47	ADT^A47^ADT_A30
Merge two patients	A40	ADT^A40^ADT_A39

Tabela 1 - Subconjunto de mensagens obrigatórias com a opção “Fusão” (fonte IHE)

Event	Trigger	Message Static Definition
Create new patient	A28	ADT^A28^ADT_A05
Update patient information	A31	ADT^A31^ADT_A05
Change Patient Identifier List	A47	ADT^A47^ADT_A30
Link Patient Information	A24	ADT^A24^ADT_A24
Unlink Patient Information	A37	ADT^A37^ADT_A37

Tabela 2 - Subconjunto de mensagens obrigatórias com a opção “Associar/Desassociar” (fonte IHE)

Em FHIR não existe a definição de eventos pada dar suporte a mensagens orientadas a eventos tal como no HL7 v2, mas o FHIR está preparado para isso. Torna-se assim necessário definir uma sistema de codificação para estes eventos de forma a tormar uniforme os codigos dos eventos a enviar nas mensagens entre os diferentes sistemas.

Dependencies

Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package hl7.fhir.uv.ipa#1.1.0 This IG describes how an application acting on behalf of a patient can access information about the patient from an clinical records system using a FHIR based API. The clinical records system may be supporting a clinical care provider (e.g. a hospital, or a general practitioner), or a health data exchange, including a national health record system. (built Wed, Mar 19, 2025 14:34+0000+00:00)

Package hl7.fhir.uv.tools.r4#0.8.0 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Aug 5, 2025 20:09+1000+10:00)

Cross Version Analysis

This is an R4B IG. None of the features it uses are changed in R4, so it can be used as is with R4} systems. Packages for both R4 (hl7.fhir.pt.patient-admin-ig.r4) and R4B (hl7.fhir.pt.patient-admin-ig.r4b) are available.

Global Profiles

There are no Global profiles defined

IP statements

This publication includes IP covered under the following statements.

• This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license.html
  Show Usage
  • identifierType: PTPatient and VS_PatientIdentifierType

Autores e Colaboradores

Roles	Name	Organization	Contact
Author	Liliana Correia		lilianamsacorreia@gmail.com
Colaborador	Liliane Sousa
Colaborador	Márcia Amaral
Colaborador	Ana Nunes
Colaborador	André Bernardo