HL7® Iniciativa Costa Rica

Guía de Implementación de Homologación Regional (PH4H) de Costa Rica
0.1.0 - ci-build Costa Rica bandera

Guía de Implementación de Homologación Regional (PH4H) de Costa Rica - Versión en desarrollo (v0.1.0): no se debe usar en producción. Es un borrador en discusión en las mesas de trabajo de la Iniciativa HL7® Costa Rica y cambia sin aviso. Vea el ciclo de vida de las guías.

Inicio

URL oficial: https://hl7.or.cr/fhir/ph4h/ImplementationGuide/hl7.fhir.cr.ph4h Versión: 0.1.0
IG Standards status: Draft Nivel de madurez: 0 Nombre computable: CRPH4H

Homologación regional (PH4H)

Guía en desarrollo: no se debe usar en producción. Es un borrador en discusión en las mesas de trabajo de la Iniciativa HL7® Costa Rica y cambia sin aviso. Está en la etapa de diseño FHIR, validación técnica y discusión, con nivel de madurez FMM 0. Ver el ciclo de vida de las guías.

Esta guía publica las transformaciones de los recursos FHIR R5 de Costa Rica a los perfiles FHIR R4 de la guía core de RACSEL (PH4H) y de IPS. El nodo nacional de PH4H las ejecuta al enviar, con la operación StructureMap/$transform.

Logo de la Ruta Panamericana de Salud Digital (PH4H): «Salud, estés donde estés»
PH4H, la Ruta Panamericana de Salud Digital.

La guía está en R4, la versión de destino: RACSEL e IPS son sus dependencias y los ejemplos de salida se validan contra sus perfiles. El análisis de homologación y las decisiones están en docs/homologacion-racsel.md.

Mapas

StructureMap Origen (R5) Destino (R4) Ejemplo de salida
CRPatientToLACPatient Paciente LACPatient (RACSEL) Patient/ejemplo-cr
CROrganizationToLACOrganization Organización LACOrganization (RACSEL) Organization/ejemplo-clinica-privada
CRPractitionerToIPS Profesional de salud Practitioner-uv-ips (IPS) Practitioner/ejemplo-medica
CRPractitionerRoleToIPS Rol del profesional PractitionerRole-uv-ips (IPS) PractitionerRole/ejemplo-rol-medica
CRComun Tipos de datos comunes    

CRComun reúne los grupos que comparten los demás mapas: identificador, referencia, concepto, nombre, contacto, dirección y periodo.

Cómo se usan

El nodo nacional ejecuta cada mapa con StructureMap/$transform en un motor que corre en R5, con los ConceptMap de esta guía y de la terminológica, y valida la salida contra su perfil con el paquete de RACSEL. La página Uso de los mapas describe el flujo paso a paso, lo que debe cargar el motor, las reglas de envío y ejemplos con el validador de HL7 y con un servidor, además de las convenciones para escribir mapas nuevos.

Los mapas declaran el origen y el destino con URL de versión, como los mapas oficiales de HL7 entre versiones: http://hl7.org/fhir/5.0/StructureDefinition/<recurso> (R5) y http://hl7.org/fhir/4.0/StructureDefinition/<recurso> (R4). El IG Publisher todavía no resuelve esas URL, así que el control de calidad reporta errores en los StructureMap; los mapas se verifican con el script de pruebas (ver Uso de los mapas).

Terminología

ConceptMap IG Uso
cr-sistema-identificador-oid Esta guía URI de cada sistema de identificación CR → OID de RACSEL
cr-sistema-identificador-tipo Esta guía URI → tipo HL7 v2-0203, para las referencias lógicas (el OID del país no distingue el tipo)
cr-pais-alfa3-alfa2 Terminológica País ISO 3166-1 alfa-3 → alfa-2
cr-profesion-salud-isco08 Terminológica Profesión de salud → ISCO-08