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

Perfiles y extensiones

Estado de las normas de la página: Informative

¿Resaltar los cambios en el texto?

Los perfiles, los tipos de datos y las extensiones que define esta guía. Cada perfil explica en su página qué restringe, con sus invariantes y ejemplos, y en la sección Uso en el HIE qué consultas debe responder el servidor. Los modelos lógicos, que describen la información sin depender de FHIR, están en Modelos lógicos, y los servicios que los usan, en Servicios del HIE.

Perfiles de recursos

Perfil	Recurso	Descripción
Atención	Encounter	Contacto entre un paciente y un establecimiento de salud en Costa Rica, en el que se le presta uno o varios servicios: consulta externa, emergencias, hospitalización, observación, un estudio o una teleconsulta. Es el contexto de la información clínica. Implementa el modelo lógico de la atención.
Documento clínico	Composition	Encabezado de un documento clínico de Costa Rica: un conjunto de información clínica que un autor reúne, un profesional valida y una organización custodia, y que se intercambia como una unidad (informe de imágenes médicas o de laboratorio, epicrisis, referencia, resumen del paciente). Implementa el modelo lógico del documento clínico.
Documento clínico (Bundle)	Bundle	Documento clínico completo de Costa Rica: un Bundle de tipo document con el encabezado (Documento clínico) y todos los recursos que este referencia. Se guarda sin firma: su firma digital va aparte, en la [firma del documento](StructureDefinition-cr-provenance-firma-documento.html), producida por GAUDÍ (ver [Firma digital](firma-digital.html)).
Envío de documentos	Bundle	Transacción con que un sistema envía documentos clínicos al HIE de Costa Rica: el lote de envío, una referencia por documento, los documentos (el Bundle de cada documento FHIR o el Binary de cada PDF) y la firma de cada documento FHIR. Es atómica: se guarda todo o nada. Adaptada de IHE MHD ITI-65.
Evento de auditoría	AuditEvent	Registro de un acceso u operación sobre datos en el HIE de Costa Rica: quién lo hizo, desde qué sistema, con qué propósito, sobre qué datos de qué paciente y con qué resultado, incluidos los intentos fallidos. Adapta IHE BALP a FHIR R5.
Firma del documento clínico	Provenance	Firma digital de un documento clínico de Costa Rica, separada del documento (detached): la firma de quien lo valida o el sello electrónico de la organización, producida por GAUDÍ (BCCR) y referida a la versión exacta del documento. Ver [Firma digital](firma-digital.html).
Lote de envío	List	Lote con que un sistema envía uno o varios documentos clínicos al HIE de Costa Rica: el paquete de referencias de un envío, adaptado del SubmissionSet de IHE MHD.
Observación	Observation	Resultado de una medición, un examen o una evaluación sobre un paciente en Costa Rica: una medida o una impresión de un estudio de imágenes, un resultado de laboratorio, un signo vital. Es la base común que perfila cada guía de dominio. Implementa el modelo lógico de la observación.
Organización	Organization	Organización que participa en la atención de salud en Costa Rica: establecimientos de salud públicos y privados, aseguradoras, instituciones del Estado y otras organizaciones. Implementa el modelo lógico de la organización.
Paciente	Patient	Persona que recibe atención de salud en Costa Rica: su identificación (cédula, DIMEX, pasaporte o expediente del establecimiento), su nombre, su sexo asignado al nacer, su fecha de nacimiento, sus datos de contacto, sus direcciones y sus contactos. Implementa el modelo lógico del paciente.
Persona relacionada	RelatedPerson	Persona con un vínculo legal o familiar con un paciente en Costa Rica que necesita identificarse formalmente: tutor legal, progenitor de una persona menor de edad o representante que firma un consentimiento. Implementa el modelo lógico de la persona relacionada.
Procedencia	Provenance	Historia de un dato que se intercambia fuera de un documento clínico, o de una operación del HIE sobre los datos: quién lo creó, lo corrigió, lo unió o lo transformó, cuándo, en nombre de qué organización y a partir de qué otros datos, con su firma digital.
Profesional de salud	Practitioner	Persona que presta servicios de salud en Costa Rica, con su identificación y su habilitación para ejercer: las colegiaturas en su colegio profesional y las especialidades inscritas. Implementa el modelo lógico del profesional de salud.
Referencia a documento	DocumentReference	Ficha con que el HIE de Costa Rica indexa un documento clínico, sin contenerlo: qué documento es, de qué paciente, quién lo emitió, qué tan confidencial es y dónde está. Hay una por cada versión del documento, que puede ser un documento clínico FHIR o un PDF.
Relación entre organizaciones	OrganizationAffiliation	Acuerdo formal entre dos organizaciones de Costa Rica que no es de jerarquía: administración por contrato, compra de servicios o pertenencia a una red de proveedores, con su vigencia, el rol de la organización participante y dónde aplica. Implementa el modelo lógico de la relación entre organizaciones.
Rol del profesional	PractitionerRole	Relación entre un profesional de salud y una organización en la que trabaja en Costa Rica: la profesión con que actúa, sus especialidades, las ubicaciones donde atiende, el periodo y su contacto de trabajo. Implementa el modelo lógico del rol del profesional.
Servicio de salud	HealthcareService	Servicio de salud que ofrece una organización en Costa Rica en una o varias ubicaciones: qué se ofrece, con qué especialidad o modalidad de imagen, qué requisitos pide, en qué horario y cómo contactarlo. Implementa el modelo lógico del servicio de salud.
Sistema de información	Device	Sistema de información conectado al HIE de Costa Rica: el expediente electrónico de un establecimiento, un sistema de laboratorio o de radiología, el MPI Nacional o el nodo nacional de PH4H. Dice qué sistema es, de quién es, en qué versión está y qué especificaciones implementa.
Ubicación	Location	Lugar físico donde se prestan servicios de salud en Costa Rica: la sede de un establecimiento, un edificio, un piso, un servicio, una sala, una cama o una unidad móvil. Implementa el modelo lógico de la ubicación.

Perfiles de tipos de datos

Los usan los perfiles de recursos para que un mismo dato (el nombre, la dirección) se valide igual en todos.

Perfil	Tipo de dato	Descripción
Dirección	Address	Dirección en Costa Rica o en otro país. En Costa Rica, la provincia, el cantón y el distrito llevan el código de la División Territorial Administrativa (DTA) del SNIT y deben ser concordantes entre sí; en otros países son texto libre.
Nombre	HumanName	Nombre oficial de una persona según su documento de identidad: hasta dos nombres y los apellidos, juntos en family y por separado en las extensiones del primer y el segundo apellido, con el progenitor del que proviene cada uno cuando se conoce.

Extensiones

Extensión	Dónde se usa	Descripción
Primer apellido	HumanName.family	Primer apellido de la persona, tal como consta en su documento de identidad, y el progenitor del que proviene cuando se conoce. La posición no indica el origen: en Costa Rica el orden lo eligen los progenitores al inscribir el nacimiento.
Segundo apellido	HumanName.family	Segundo apellido de la persona, tal como consta en su documento de identidad, y el progenitor del que proviene cuando se conoce. Lo tienen todas las personas costarricenses; muchas personas extranjeras no tienen segundo apellido.