HL7 PT FHIR Implementation Guide: Example IG Release 1 | STU1
1.0.0 - STU1

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

Plain Language Summary goes here

## 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

IG | Package | FHIR | Comment
--- | --- | --- | ---
HL7 PT FHIR Implementation Guide: Example IG Release 1 | STU1 | hl7.fhir.pt.patient-admin-ig#1.0.0 | R4B |
HL7 Terminology (THO) | hl7.terminology.r4#6.5.0 | R4 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r4#5.2.0 | R4 |
International Patient Summary Implementation Guide | hl7.fhir.uv.ips#current | R4 |
International Patient Access | hl7.fhir.uv.ipa#1.1.0 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.2.0 | R4 |
SMART App Launch | hl7.fhir.uv.smart-app-launch#2.0.0 | R4 |
FHIR Tooling Extensions IG | hl7.fhir.uv.tools.r4#0.8.0 | R4 | for example references

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, PTPractitioner, VS_PatientIdentifierType and VS_PractitionerIdentifierType

### 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 |  |