Guía de Implementación de Homologación Regional (PH4H) de Costa Rica - Versión en desarrollo (v0.1.0): borrador de trabajo de la Iniciativa HL7® Costa Rica, que puede cambiar sin aviso.

Inicio

URL oficial: https://hl7.or.cr/fhir/ph4h/ImplementationGuide/hl7.fhir.cr.ph4h				Versión: 0.1.0	¿Resaltar los cambios en el texto?
IG Standards status: Draft					Nombre computable: CRPH4H

Homologación regional (PH4H)

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.

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.

Estructuras de origen y destino

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).

• Ejecución. El motor corre en R5, la versión de la entrada, y carga las estructuras R4 con URL de versión. Un motor R4 leería la entrada como R4 y descartaría en silencio lo que R4 no tiene (por ejemplo, PractitionerRole.contact o la estructura de Practitioner.communication).
• Publicación. El IG Publisher todavía no resuelve esas URL, porque HL7 no ha publicado en el registro de paquetes sus estructuras entre versiones (hl7.fhir.uv.xver). Por eso el control de calidad reporta errores en los StructureMap (estructura no encontrada y, en cadena, contextos de destino desconocidos). Los mapas se verifican con el script de pruebas.

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

Pruebas

scripts/probar-mapas.sh transforma cada ejemplo de entrada R5 (input/pruebas/entrada), compara la salida con el ejemplo esperado (input/examples) y valida todas las salidas contra el perfil de su meta.profile. Toma los ConceptMap de la IG terminológica compilada con SUSHI.