# API de EHR y API de registros médicos

> Cómo las aplicaciones leen y escriben registros de salud sobre FHIR: API de EHR hospitalarias vs. API de registros controlados por el paciente, qué cubre cada una, GDPR y alojamiento en la UE, y HIPAA (BAA y región de EE. UU. bajo petición).

Source: https://developers.anpheros.com/es/guides/ehr-api

**Una API de EHR (API de registro electrónico de salud, también llamada API de EMR o API de registros médicos) permite al software leer y escribir el registro de salud de un paciente — datos demográficos, diagnósticos, medicamentos, alergias, resultados, documentos — a través de Internet, generalmente como recursos HL7 FHIR R4 detrás de OAuth.** Los proveedores de EHR hospitalarios como Epic y Oracle Health exponen APIs FHIR a sus propios registros, y en EE. UU. los EHR certificados deben ofrecer acceso al paciente a través de dichas APIs. Anpheros es una pieza diferente: una API de registros médicos controlada por el paciente sobre la que cualquier aplicación puede construirse, donde clínicas, laboratorios, aplicaciones y dispositivos escriben en un registro FHIR R4 por persona y el acceso necesita el consentimiento de esa persona.

<!-- visual:ehr-stack -->

## Dos tipos de API de registros médicos

| | API de EHR de hospital (p. ej., Epic, Oracle Health) | API de registros controlados por el paciente (Anpheros) |
|---|---|---|
| De quién son los registros | Un hospital o sistema de salud | Una persona, de todas las fuentes que escriben en él |
| Cómo se obtiene acceso | Registro de la aplicación con el proveedor, a menudo por sistema de salud | Clave de sandbox de autoservicio; producción después de un acuerdo de procesamiento de datos |
| Quién autoriza | El sistema de salud y el paciente para aplicaciones de acceso del paciente | El paciente (consentimiento OAuth) o su organización para los pacientes que crea |
| Escritura de datos | Limitada, depende del proveedor | Crear, actualizar y eliminar sus propios recursos; procedencia en cada escritura |
| Estándar | FHIR R4 (US Core en EE. UU.) | FHIR R4 más una API REST más sencilla |
| Mejor para | Leer lo que registró un hospital | Crear un producto sobre un registro que las personas llevan consigo |

Funcionan juntas: una aplicación puede leer un EHR de hospital a través de su API y mantener el registro propio de la persona en Anpheros, con el hospital como fuente registrada.

## Lo que cubre la API de registros de Anpheros

| Parte del registro | Recurso FHIR | REST v1 |
|---|---|---|
| Demografía | `Patient` | `/v1/patients` |
| Diagnósticos | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| Medicamentos | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| Resultados y signos vitales | `Observation` (LOINC) | `/v1/patients/{id}/observations`, importación de laboratorio |
| Documentos | `DocumentReference` | `/v1/patients/{id}/documents` |
| Todo, en orden | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| Un resumen compartible | `Patient/$summary` (IPS) | — |

```bash
# one patient's active problems, as FHIR
curl "https://platform.anpheros.com/fhir/R4/Condition?patient=$PID&clinical-status=active" \
  -H "Authorization: Bearer $KEY"
```

## Cumplimiento y ubicación de datos

- **RGPD y la UE:** los datos se almacenan y procesan en la Unión Europea (Google Cloud `europe-west4`, Países Bajos); cada lectura y escritura se registra y es visible para el paciente; el acceso por parte de otras aplicaciones requiere el consentimiento del paciente.
- **HIPAA:** Anpheros actúa como Business Associate para clínicas de EE. UU. Un acuerdo de Business Associate (BAA) y una región de datos de EE. UU. están disponibles bajo petición para clientes de producción; la producción para datos de pacientes de EE. UU. se abre después de que se firme el BAA. Hasta entonces, no almacene información de salud protegida que esté sujeta a HIPAA en Anpheros.

## Preguntas frecuentes

### ¿Qué es una API de EHR?
Una interfaz a través de la cual el software lee y escribe registros de salud electrónicos, generalmente recursos HL7 FHIR R4 como Patient, Condition, MedicationStatement y Observation, autorizados con OAuth y SMART on FHIR.

### ¿Cuál es la diferencia entre una API de EHR y una API de EMR?
En la práctica, los términos se utilizan indistintamente. EMR tradicionalmente significa el registro de una consulta; EHR, un registro destinado a ser compartido entre proveedores. Ambos se exponen generalmente como APIs FHIR hoy en día.

### ¿Puedo acceder a la EHR de un hospital a través de Anpheros?
No. Anpheros no se conecta a las EHR de los hospitales por sí solo. Su aplicación puede leer la API FHIR de un hospital por separado y almacenar lo que la persona permita en su registro de Anpheros.

### ¿Existe una API gratuita de registros médicos para desarrolladores?
Sí. El sandbox de Anpheros es gratuito, con 30 pacientes sintéticos sobre FHIR R4 y REST; la producción comienza a partir de 99 € al mes.

### ¿Cumple Anpheros con HIPAA?
Anpheros actúa como **Business Associate** para clínicas de EE. UU.: un Acuerdo de Business Associate (BAA) y una región de datos de EE. UU. están disponibles bajo petición para clientes de producción, además del programa de seguridad escrito (análisis de riesgos, políticas, registro de auditoría, cifrado, copias de seguridad). Pregunte antes de almacenar información de salud protegida: la producción se abre después de firmar el BAA. Consulte [Seguridad, privacidad y residencia de datos](https://developers.anpheros.com/es/guides/security).

<!-- visual:cta-ehr -->

## Relacionado

- [API de Salud](https://developers.anpheros.com/es/guides/healthcare-api)
- [Expediente médico del paciente](https://developers.anpheros.com/es/guides/patient-medical-record)
- [API de datos longitudinales del paciente](https://developers.anpheros.com/es/guides/longitudinal-patient-data-api)
- [Plataforma de consentimiento del paciente para aplicaciones de salud](https://developers.anpheros.com/es/guides/patient-consent-platform)
- [Seguridad, privacidad y residencia de datos](https://developers.anpheros.com/es/guides/security)
- [Cómo integrar sistemas de clínicas con un backend FHIR](https://developers.anpheros.com/es/guides/integrate-clinic-systems-fhir)
