Health Information Exchange
0.1.0 - ci-build
Costa Rica
Health Information Exchange - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://hix.meddyg.com/fhir/hix/ImplementationGuide/meddyg.hix | Version: 0.1.0 | |||
| Draft as of 2026-09-22 | Computable Name: HixHealthInformationExchange | |||
HIX define una arquitectura de referencia para comunidades que comparten documentos clínicos. No propone un estándar nuevo. Articula los perfiles de IHE, los estándares y las especificaciones necesarios para operar una comunidad así sobre FHIR, y sigue el modelo de comunidad de Mobile Health Document Sharing (MHDS), que toma como referencia sin declarar conformidad con él.
Esta guía describe los roles de la comunidad, sus límites de confianza y la relación entre sus componentes. Explica, entre otras decisiones, por qué la localización y la recuperación se median de forma centralizada, por qué la custodia documental se mantiene distribuida por defecto y cómo IUA y OAuth 2.0 establecen la base de autorización y delegación entre los participantes. Cuando la autorización requiere la participación de una persona, incorpora SMART App Launch en el flujo interactivo que esa persona completa desde su navegador.
Esta arquitectura abarca las siguientes capacidades dentro de la comunidad:
Las siguientes capacidades forman parte de la arquitectura HIX, pero su especificación detallada se definirá en una versión posterior de esta guía. La arquitectura ya establece los límites, los puntos de integración y los flujos que permiten incorporarlas sin alterar la topología mediada de la comunidad.
Los casos de uso que dependen de estas capacidades se listan al final de la sección 2.5 del Volumen 1.
Las palabras clave MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, NOT RECOMMENDED, MAY y OPTIONAL, cuando aparecen íntegramente en mayúsculas, se interpretan conforme a RFC 2119 y RFC 8174.
Estas palabras expresan requisitos normativos de HIX. El resto del lenguaje utilizado en esta guía es descriptivo, salvo que se indique explícitamente lo contrario.
Cuando HIX incorpora o referencia requisitos definidos por un perfil IHE, una especificación HL7 FHIR o un RFC, dichos requisitos conservan la fuerza normativa establecida por su especificación de origen.
HIX utiliza terminología definida por IHE, HL7 FHIR y OAuth 2.0. Salvo que se indique lo contrario, los nombres de perfiles y actores conservan el significado establecido por su especificación de origen.
En esta guía, un perfil IHE define un conjunto de capacidades y transacciones, mientras que un actor IHE representa el rol que un sistema desempeña dentro de dicho perfil.
| Término | Significado |
|---|---|
| MHDS — Mobile Health Document Sharing | Perfil IHE que define una comunidad de intercambio de documentos clínicos basada en FHIR y la composición de perfiles necesaria para operarla. HIX lo toma como arquitectura de referencia. |
| MHD — Mobile access to Health Documents | Perfil IHE para publicar, localizar y recuperar documentos clínicos mediante FHIR. HIX usa sus actores Document Source, Document Consumer, Document Recipient y Document Responder. |
| PMIR — Patient Master Identity Registry | Perfil IHE para gestionar y sincronizar identidades maestras de pacientes. |
| PIXm — Patient Identifier Cross-referencing for mobile | Perfil IHE con el que cada miembro declara sus identidades locales de paciente y resuelve un identificador a la identidad maestra. |
| PDQm — Patient Demographics Query for Mobile | Perfil IHE para localizar a un paciente por sus datos demográficos cuando no se dispone de un identificador conocido por la comunidad. |
| mCSD — Mobile Care Services Discovery | Perfil IHE utilizado para consultar organizaciones participantes, servicios y endpoints. En HIX, el endpoint de cada custodio declara además el canal de transporte por el que se lo alcanza. |
| ATNA — Audit Trail and Node Authentication | Perfil IHE que aporta la autenticación de nodos, la confidencialidad en tránsito y el registro de eventos de auditoría. |
| CT — Consistent Time | Perfil IHE que mantiene sincronizados los relojes de todos los sistemas de la comunidad, para que los eventos de auditoría y la vigencia de los tokens signifiquen lo mismo en cada extremo. |
| BALP — Basic Audit Log Patterns | Perfil IHE de contenido que define patrones reutilizables de AuditEvent. De ellos derivan los eventos de auditoría que cada perfil especifica para sus transacciones. |
| IUA — Internet User Authorization | Perfil IHE utilizado por HIX como base de autorización para las interacciones protegidas entre sus participantes. Sus requisitos aplican a todos los flujos de autorización de HIX. |
| SMART App Launch | Especificación de HL7 que HIX usa en los flujos interactivos en los que la autorización requiere la participación de una persona desde su navegador. |
| X-Road | Capa de intercambio de datos entre organizaciones sobre transporte mTLS entre servidores de seguridad. HIX la admite como canal hacia un custodio, declarado en el directorio; no aporta semántica documental. |
| RLS — Record Locator Service | Componente central de HIX responsable de localizar los documentos clínicos disponibles para un paciente y mediar su recuperación desde los custodios correspondientes. |
Los siguientes términos relacionados con OAuth 2.0 y la arquitectura de autorización de HIX se utilizan a lo largo de la guía:
| Término | Significado |
|---|---|
| Client | Aplicación que solicita acceso a un recurso protegido. |
| AS — Authorization Server | Actor responsable de la autorización y de la emisión, comprobación e intercambio de los tokens que circulan entre los participantes de HIX. |
| RS — Resource Server | Servicio que protege recursos y evalúa los tokens presentados para autorizar el acceso. |
| Access token | Credencial presentada por un Client ante un Resource Server para solicitar acceso. |
| Audience | Identificador del Resource Server al que está destinado un token. |
| Scope | Alcance del acceso solicitado o concedido al Client. |
| PEP — Policy Enforcement Point | Punto donde se aplica una decisión de política sobre una solicitud, sea permitir, denegar o filtrar. En HIX el Record Locator Service es el primer PEP de la comunidad, y cada custodio es además PEP de su propio endpoint. |
| PDP — Policy Decision Point | Punto donde se toma la decisión que el PEP aplica. En HIX la decisión de divulgación se toma en la infraestructura central, en el Record Locator Service o en el Document Registry. El Authorization Server decide sobre la autorización, nunca sobre la divulgación. |
HIX organiza sus requisitos en diferentes niveles de abstracción. Los volúmenes de esta guía deben leerse de forma complementaria y no como especificaciones independientes.
La guía se publica también en formatos pensados para leerla fuera del sitio.
Nota. Estos archivos sirven para asistir al implementador, no para sustituirlo. Un asistente de IA puede equivocarse al leer o al resumir. El criterio técnico y la responsabilidad sobre lo que se implementa recaen siempre en quien implementa, y el texto que obliga es el de esta guía.
HIX es una comunidad FHIR R5. De los perfiles IHE que compone, MHD está publicado sobre R5 y los demás solo sobre R4, y en esa versión se declaran. IUA, ATNA y CT no se distribuyen como paquetes FHIR, y por eso no figuran aquí aunque HIX los use. MHDS tampoco figura, porque HIX lo toma como referencia y no depende de su paquete.
| IG | Package | FHIR | Comment |
|---|---|---|---|
| meddyg.hix#0.1.0 | R5 | ||
| hl7.terminology.r5#7.4.0 | R5 | Automatically added as a dependency - all IGs depend on HL7 Terminology | |
| hl7.fhir.uv.extensions.r5#5.3.0 | R5 | Automatically added as a dependency - all IGs depend on the HL7 Extension Pack | |
| hl7.fhir.uv.tools.r5#1.1.2 | R5 | for example references |
Package hl7.fhir.uv.extensions.r5#5.3.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sat, May 16, 2026 18:32+1000+10:00) |
Package hl7.fhir.uv.tools.r5#1.1.2 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Mar 24, 2026 11:13+1100+11:00) |