Guía de Implementación Core de Costa Rica
0.1.0 - ci-build
Guía de Implementación Core de Costa Rica - Compilación local de desarrollo (v0.1.0), generada con las herramientas de compilación de FHIR (HL7® FHIR® Standard). Vea el directorio de versiones publicadas
| Estado de las normas de la página: Informative |
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.
| 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. Puede registrar uno o varios tipos de servicio para clasificar lo prestado y vincular cada ocurrencia con el directorio cuando exista la oferta correspondiente. Es el contexto de la información clínica. Implementa el modelo lógico de la atención. |
| Dispositivo | Device | Perfil base nacional para una instancia de dispositivo en salud: software conectado al HIE o un equipo físico. Establece identidad, estado, nombre, categoría, tipo y organización responsable comunes; los perfiles derivados definen las reglas específicas de cada propósito. Requiere un identificador de instancia o número de serie: un UDI puede identificar solo el modelo y no basta por sí solo para identificar la unidad concreta, conforme a las definiciones de [Device R5](https://hl7.org/fhir/R5/device-definitions.html) y [DeviceDefinition R5](https://hl7.org/fhir/R5/devicedefinition.html). |
| 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: la lista de documentos enviados, 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). |
| Lista de documentos enviados | List | Lista de los documentos de un paciente que una organización envió juntos al HIE de Costa Rica: cuáles son, quién los envió y cuándo. Al consultar el HIE, muestra qué documentos llegaron en un mismo envío. Adaptada 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 natural con un vínculo familiar o legal declarado con un paciente en Costa Rica, como progenitor, tutor legal o representante individual. Declara el vínculo, pero no acredita por sí sola capacidad legal, tutela ni facultad para consentir. 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 RLS del HIE de Costa Rica indexa y localiza un documento clínico, sin contenerlo: qué documento es, de qué paciente, quién lo emitió, qué tan confidencial es y dónde está. Indexa una representación de cada versión; el documento clínico FHIR y su PDF son representaciones relacionadas. |
| Relación entre organizaciones | OrganizationAffiliation | Relación o asociación no jerárquica entre dos organizaciones de Costa Rica: prestación de servicios para otra entidad, administración por contrato o pertenencia a una red de proveedores, con su vigencia, el rol de la organización participante y dónde aplica. El recurso no sustituye el instrumento jurídico ni acredita por sí solo su validez. 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, los servicios que presta, las ubicaciones, horarios e idiomas de atención, el periodo y su contacto de trabajo. La disponibilidad del rol es individual y no se deduce del horario institucional de HealthcareService. 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. Se mantiene provisionalmente en Core hasta que exista la IG CR HIE; sus reglas son propias del registro operativo HIE. Los perfiles clínicos de equipos deben derivar de CRDevice, no de este perfil. |
| 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. |
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. |
| Nombre del paciente | HumanName | Nombre conocido del paciente o denominación temporal para uso operativo. |
| Nombre oficial del profesional | HumanName | Nombre oficial documentado de un profesional de salud identificado; no admite denominación temporal ni identidad anónima. |
| Extensión | Dónde se usa | Descripción |
|---|---|---|
| Fecha de nacimiento estimada | Patient.birthDate, RelatedPerson.birthDate, Practitioner.birthDate | Indica si la fecha de nacimiento registrada es una estimación. La ausencia de esta extensión no indica que la fecha esté confirmada. |
| Nacionalidad de la persona | Patient, RelatedPerson, Person | Perfil nacional de la extensión estándar patient-nationality. Conserva su URI y estructura; exige el código de país mediante ISO 3166-1 alfa-3 y presenta en español las descripciones de sus elementos. |
| 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. |
| Sexo asignado al nacer del contacto | Patient.contact | Sexo asignado al nacer de un contacto de Patient. Use unknown cuando se desconoce; no representa género administrativo ni determina por sí solo parámetros clínicos. Esta extensión CR existe porque individual-recordedSexOrGender no admite Patient.contact como contexto. |
| Sexo o género registrado | Patient, RelatedPerson, Person, Practitioner, FamilyMemberHistory | Perfil de la extensión estándar individual-recordedSexOrGender. Conserva su semántica y sus URI, y presenta en español las descripciones de sus elementos. |