# Résumé International des Patients (IPS) en FHIR

> Les sections IPS et les codes LOINC, comment le Bundle de documents FHIR est construit, un extrait réel généré par la plateforme, et un appel pour produire un IPS validé.

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

**Le Résumé International des Patients (IPS) est un résumé de santé standard et minimal — allergies, médicaments, problèmes et, lorsqu'ils sont disponibles, vaccinations, résultats et signes vitaux — conditionné sous forme de Bundle de documents FHIR afin de pouvoir être lu dans n'importe quel pays.** Il est défini par le [guide d'implémentation IPS](https://hl7.org/fhir/uv/ips/) de HL7 FHIR et utilisé par l'Espace européen des données de santé pour les soins transfrontaliers. Anpheros génère un IPS pour tout patient à partir de son dossier FHIR R4 en un seul appel, `Patient/{id}/$summary`, et le résultat est validé sans aucune erreur par le validateur officiel HL7.

## Les sections

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

## Comment le document est construit

Un FHIR IPS est un `Bundle` de type `document`, profilé `Bundle-uv-ips`. Sa première entrée est un `Composition` (LOINC 60591-5 "Patient summary Document"), dont les sections référencent les ressources qui suivent dans le Bundle : les ressources Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization et Observation, ainsi que l'auteur et le dépositaire. Chaque section porte un récit XHTML généré, permettant à une personne de lire le document sans logiciel.

Cet extrait provient d'un document réel généré par la plateforme pour un patient synthétique (ids raccourcis) :

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

## Générer un seul

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

- Les sections requises ne sont jamais vides : lorsqu'aucun élément n'est enregistré, elles l'indiquent avec les codes IPS absent-ou-inconnu, et une application peut écrire explicitement "pas d'allergies connues".
- Les ressources avec des codes invalides sont omises et signalées dans un en-tête de réponse, de sorte qu'un mauvais enregistrement ne corrompt pas le document.
- `?lang=en` ou `?lang=ro` définit la langue du texte narratif.
- Un patient hors de votre portée d'accès renvoie `404`.

## Foire aux questions

### Qu'est-ce qu'un International Patient Summary (IPS) ?
Un résumé minimal et indépendant de la spécialité médicale concernant la santé d'une personne — allergies, médicaments et problèmes, ainsi que les immunisations, les résultats et les signes vitaux lorsque disponibles — standardisé par HL7 en tant que document FHIR afin de pouvoir être partagé au-delà des frontières.

### Quelles sections sont requises dans un IPS ?
Allergies et intolérances (LOINC 48765-2), résumé des médicaments (10160-0) et liste des problèmes (11450-4). Les immunisations, les résultats et les signes vitaux sont recommandés.

### Comment générer un IPS à partir de données FHIR ?
Collectez les ressources du patient, construisez une Composition avec les sections et les narrations de l'IPS, et regroupez le tout dans un Bundle de documents. Avec Anpheros, cela ne nécessite qu'une seule requête : `GET /fhir/R4/Patient/{id}/$summary`.

### L'IPS Anpheros est-il validé ?
Oui. Le document généré est validé sans aucune erreur par le validateur officiel HL7 FHIR par rapport au guide d'implémentation de l'IPS.

### À quoi sert l'IPS en Europe ?
L'Espace européen des données de santé (EHDS) mentionne le résumé du patient parmi les catégories prioritaires qui doivent être échangeables au format européen.

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

## Liens Utiles

- [Plateforme FHIR](https://developers.anpheros.com/fr/guides/fhir) : `$summary`, `$everything` et les 26 types de ressources
- [European Health Data Space (EHDS) pour les développeurs](https://developers.anpheros.com/fr/guides/ehds-for-developers)
- [API de données patient longitudinales](https://developers.anpheros.com/fr/guides/longitudinal-patient-data-api)
- [Interopérabilité des données de santé](https://developers.anpheros.com/fr/guides/interoperability)
- [Le Résumé Patient International, pour les patients](https://anpheros.com/guides/international-patient-summary)