# Resumo Internacional do Paciente (IPS) em FHIR

> As secções do IPS e os códigos LOINC, como o Bundle do documento FHIR é construído, um excerto real gerado pela plataforma e uma chamada para produzir um IPS validado.

Source: https://developers.anpheros.com/pt/guides/international-patient-summary-fhir

**O Resumo Internacional do Paciente (IPS) é um resumo de saúde padrão e mínimo — alergias, medicamentos, problemas e, quando disponíveis, imunizações, resultados e sinais vitais — empacotado como um Bundle de documento FHIR para que possa ser lido em qualquer país.** É definido pelo [guia de implementação IPS](https://hl7.org/fhir/uv/ips/) do HL7 FHIR e utilizado pelo Espaço Europeu de Dados de Saúde para cuidados transfronteiriços. A Anpheros gera um IPS para qualquer paciente a partir do seu registo FHIR R4 com uma única chamada, `Patient/{id}/$summary`, e o resultado valida com 0 erros no validador oficial do HL7.

## As secções

<!-- visual:ips-sections -->

## Como o documento é construído

Um FHIR IPS é um `Bundle` do tipo `document`, com perfil `Bundle-uv-ips`. A sua primeira entrada é um `Composition` (LOINC 60591-5 "Documento de resumo do Paciente"), cujas secções referenciam os recursos que se seguem no Bundle: os recursos Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization e Observation, e o autor e o custodiante. Cada secção contém uma narrativa XHTML gerada, para que uma pessoa possa ler o documento sem software.

Este excerto provém de um documento real gerado pela plataforma para um paciente sintético (ids encurtados):

```json
{
  "resourceType": "Bundle",
  "type": "document",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Bundle-uv-ips"]},
  "entry": [
    {"resource": {
      "resourceType": "Composition",
      "status": "final",
      "type": {"coding": [{"system": "http://loinc.org", "code": "60591-5", "display": "Patient summary Document"}]},
      "title": "International Patient Summary",
      "author": [{"reference": "Device/…", "display": "Anpheros Platform"}],
      "custodian": {"reference": "Organization/…", "display": "Anpheros"},
      "section": [
        {"title": "Allergies", "code": {"coding": [{"system": "http://loinc.org", "code": "48765-2"}]},
         "entry": [{"reference": "AllergyIntolerance/…"}]},
        {"title": "Medications", "code": {"coding": [{"system": "http://loinc.org", "code": "10160-0"}]},
         "entry": [{"reference": "MedicationStatement/…"}]}
      ]
    }},
    {"resource": {"resourceType": "Patient"}},
    {"resource": {"resourceType": "AllergyIntolerance"}},
    {"resource": {"resourceType": "MedicationStatement"}}
  ]
}
```

## Gerar um

```bash
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" \
  -H "Authorization: Bearer $KEY" -o ips.json
```

- As secções obrigatórias nunca estão vazias: quando nada é registado, indicam-no com os códigos IPS ausente-ou-desconhecido, e uma aplicação pode escrever explicitamente "sem alergias conhecidas".
- Recursos com códigos inválidos são omitidos e reportados num cabeçalho de resposta, para que um registo incorreto não quebre o documento.
- `?lang=en` ou `?lang=ro` definem a língua da narrativa.
- Um paciente fora do seu acesso retorna `404`.

## Perguntas Frequentes

### O que é um International Patient Summary (IPS)?
Um resumo mínimo e agnóstico de especialidade da saúde de uma pessoa — alergias, medicamentos e problemas, mais imunizações, resultados e sinais vitais quando disponíveis — padronizado pela HL7 como um documento FHIR para que possa ser partilhado entre fronteiras.

### Quais secções são obrigatórias num IPS?
Alergias e intolerâncias (LOINC 48765-2), resumo de medicação (10160-0) e lista de problemas (11450-4). Imunizações, resultados e sinais vitais são recomendados.

### Como gero um IPS a partir de dados FHIR?
Recolha os recursos do paciente, construa uma Composição com as secções e narrativas do IPS, e empacote tudo como um Bundle de documento. Com o Anpheros isto é um pedido: `GET /fhir/R4/Patient/{id}/$summary`.

### O IPS do Anpheros é validado?
Sim. O documento gerado valida-se com 0 erros no validador oficial HL7 FHIR contra o guia de implementação do IPS.

### Para que é utilizado o IPS na Europa?
O European Health Data Space lista o resumo do paciente entre as categorias prioritárias que devem ser intercâmbias no formato europeu.

<!-- visual:cta-ips -->

## Relacionado

- [Plataforma FHIR](https://developers.anpheros.com/pt/guides/fhir): `$summary`, `$everything` e os 26 tipos de recursos
- [Espaço Europeu de Dados de Saúde (EHDS) para programadores](https://developers.anpheros.com/pt/guides/ehds-for-developers)
- [API de dados longitudinais do paciente](https://developers.anpheros.com/pt/guides/longitudinal-patient-data-api)
- [Interoperabilidade de dados de saúde](https://developers.anpheros.com/pt/guides/interoperability)
- [O Resumo Internacional do Paciente, para pacientes](https://anpheros.com/guides/international-patient-summary)