# Resumen Internacional de Pacientes (IPS) en FHIR

> Las secciones del IPS y los códigos LOINC, cómo se construye el Bundle del documento FHIR, un extracto real generado por la plataforma y una llamada para producir un IPS validado.

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

**El Resumen Internacional de Pacientes (IPS) es un resumen de salud estándar y mínimo —alergias, medicamentos, problemas y, cuando están disponibles, inmunizaciones, resultados y signos vitales— empaquetado como un Bundle de documentos FHIR para que pueda ser leído en cualquier país.** Está definido por la [guía de implementación del IPS](https://hl7.org/fhir/uv/ips/) de HL7 FHIR y es utilizado por el Espacio Europeo de Datos Sanitarios para la atención transfronteriza. Anpheros genera un IPS para cualquier paciente a partir de su registro FHIR R4 con una sola llamada, `Patient/{id}/$summary`, y el resultado se valida sin errores en el validador oficial de HL7.

## Las secciones

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

## Cómo se construye el documento

Un FHIR IPS es un `Bundle` de tipo `document`, perfilado `Bundle-uv-ips`. Su primera entrada es un `Composition` (LOINC 60591-5 "Documento de resumen del paciente"), cuyas secciones hacen referencia a los recursos que siguen en el Bundle: los recursos Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization y Observation, y el autor y custodio. Cada sección lleva una narrativa XHTML generada, para que una persona pueda leer el documento sin software.

Este extracto proviene de un documento real generado por la plataforma para un paciente sintético (ids acortados):

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

## Generar uno

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

- Las secciones obligatorias nunca están vacías: cuando no hay nada registrado, lo indican con los códigos IPS ausente o desconocido, y una aplicación puede escribir explícitamente "no se conocen alergias".
- Los recursos con códigos inválidos se omiten y se informan en una cabecera de respuesta, de modo que un registro erróneo no rompa el documento.
- `?lang=en` o `?lang=ro` establece el idioma de la narrativa.
- Un paciente fuera de su acceso devuelve `404`.

## Preguntas frecuentes

### ¿Qué es un Resumen Internacional de Paciente (IPS)?
Un resumen mínimo y agnóstico a la especialidad de la salud de una persona —alergias, medicamentos y problemas, además de inmunizaciones, resultados y signos vitales cuando estén disponibles— estandarizado por HL7 como un documento FHIR para que pueda compartirse entre fronteras.

### ¿Qué secciones son obligatorias en un IPS?
Alergias e intolerancias (LOINC 48765-2), resumen de medicación (10160-0) y lista de problemas (11450-4). Se recomiendan inmunizaciones, resultados y signos vitales.

### ¿Cómo genero un IPS a partir de datos FHIR?
Recopile los recursos del paciente, cree una Composition con las secciones y narrativas del IPS, y empaquete todo como un Bundle de documentos. Con Anpheros esto es una solicitud: `GET /fhir/R4/Patient/{id}/$summary`.

### ¿Está validado el IPS de Anpheros?
Sí. El documento generado se valida sin errores en el validador oficial de HL7 FHIR contra la guía de implementación del IPS.

### ¿Para qué se utiliza el IPS en Europa?
El Espacio Europeo de Datos Sanitarios enumera el resumen del paciente entre las categorías prioritarias que deben ser intercambiables en el formato europeo.

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

## Relacionado

- [Plataforma FHIR](https://developers.anpheros.com/es/guides/fhir): `$summary`, `$everything` y los 26 tipos de recursos
- [Espacio Europeo de Datos Sanitarios (EHDS) para desarrolladores](https://developers.anpheros.com/es/guides/ehds-for-developers)
- [API de datos longitudinales del paciente](https://developers.anpheros.com/es/guides/longitudinal-patient-data-api)
- [Interoperabilidad de datos sanitarios](https://developers.anpheros.com/es/guides/interoperability)
- [El Resumen Internacional del Paciente, para pacientes](https://anpheros.com/guides/international-patient-summary)