# Międzynarodowe Podsumowanie Pacjenta (IPS) w FHIR

> Sekcje IPS i kody LOINC, sposób budowania dokumentu FHIR Bundle, rzeczywisty fragment wygenerowany przez platformę oraz jedno wywołanie w celu uzyskania zweryfikowanego IPS.

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

**Międzynarodowe Podsumowanie Pacjenta (IPS) to standardowe, minimalne podsumowanie stanu zdrowia — alergie, leki, problemy zdrowotne oraz, jeśli dostępne, szczepienia, wyniki badań i parametry życiowe — spakowane jako dokument FHIR Bundle, dzięki czemu może być odczytane w dowolnym kraju.** Jest ono zdefiniowane przez [przewodnik implementacji IPS](https://hl7.org/fhir/uv/ips/) HL7 FHIR i używane przez Europejską Przestrzeń Danych Zdrowotnych do opieki transgranicznej. Anpheros generuje IPS dla dowolnego pacjenta z jego rekordu FHIR R4 za pomocą jednego wywołania, `Patient/{id}/$summary`, a wynik jest walidowany bez błędów w oficjalnym walidatorze HL7.

## Sekcje

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

## Jak zbudowany jest dokument

FHIR IPS to `Bundle` typu `document`, sprofilowany `Bundle-uv-ips`. Jego pierwszym wpisem jest `Composition` (LOINC 60591-5 "Patient summary Document"), którego sekcje odwołują się do zasobów następujących po nim w pakiecie: zasoby Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization i Observation, a także autor i powiernik. Każda sekcja zawiera wygenerowaną narrację XHTML, dzięki czemu dokument może być odczytany przez człowieka bez użycia oprogramowania.

Ten fragment pochodzi z rzeczywistego dokumentu wygenerowanego przez platformę dla pacjenta syntetycznego (identyfikatory skrócone):

```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"}}
  ]
}
```

## Generowanie jednego

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

- Wymagane sekcje nigdy nie są puste: gdy nic nie jest zarejestrowane, informują o tym za pomocą kodów IPS absent-or-unknown, a aplikacja może zapisać jawne "no known allergies".
- Zasoby z nieprawidłowymi kodami są pomijane i zgłaszane w nagłówku odpowiedzi, dzięki czemu jeden zły rekord nie przerywa dokumentu.
- `?lang=en` lub `?lang=ro` ustawia język narracji.
- Pacjent spoza Twojego dostępu zwraca `404`.

## Często zadawane pytania

### Czym jest Międzynarodowe Podsumowanie Pacjenta (IPS)?
Minimalne, niezależne od specjalizacji podsumowanie stanu zdrowia osoby — alergie, leki i problemy, a także, jeśli są dostępne, szczepienia, wyniki badań i parametry życiowe — standaryzowane przez HL7 jako dokument FHIR, aby można je było udostępniać transgranicznie.

### Które sekcje są wymagane w IPS?
Alergie i nietolerancje (LOINC 48765-2), podsumowanie leczenia (10160-0) i lista problemów (11450-4). Zalecane są szczepienia, wyniki badań i parametry życiowe.

### Jak wygenerować IPS z danych FHIR?
Zbierz zasoby pacjenta, zbuduj obiekt Composition z sekcjami i opisami IPS, a następnie spakuj wszystko jako dokument Bundle. W Anpheros jest to jedno żądanie: `GET /fhir/R4/Patient/{id}/$summary`.

### Czy IPS generowany przez Anpheros jest walidowany?
Tak. Wygenerowany dokument jest walidowany bez błędów w oficjalnym walidatorze HL7 FHIR zgodnie z przewodnikiem implementacji IPS.

### Do czego służy IPS w Europie?
Europejska Przestrzeń Danych o Zdrowiu wymienia podsumowanie pacjenta wśród priorytetowych kategorii, które muszą być wymienne w formacie europejskim.

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

## Powiązane

- [Platforma FHIR](https://developers.anpheros.com/pl/guides/fhir): `$summary`, `$everything` i 26 typów zasobów
- [Europejska Przestrzeń Danych o Zdrowiu (EHDS) dla deweloperów](https://developers.anpheros.com/pl/guides/ehds-for-developers)
- [API dla danych pacjenta w czasie rzeczywistym](https://developers.anpheros.com/pl/guides/longitudinal-patient-data-api)
- [Interoperacyjność danych w ochronie zdrowia](https://developers.anpheros.com/pl/guides/interoperability)
- [Międzynarodowe Podsumowanie Pacjenta, dla pacjentów](https://anpheros.com/guides/international-patient-summary)