Formato de datos de historias clínicas

Los datos de los registros médicos se almacenan en formato HL7 FHIR.

Registros médicos admite las siguientes versiones de Fast Healthcare Interoperability Resources (FHIR):

Tipos de recursos médicos

FHIR se compone de un conjunto de componentes modulares llamados recursos. El conjunto admitido de recursos de FHIR y las categorías correspondientes se basan aproximadamente en las secciones del Resumen Internacional del Paciente.

Estos recursos se asignan a categorías de datos en Health Connect, a los que se hace referencia como tipos de recursos médicos en la API. Los recursos de observación se asignan en función del contenido, como los nombres y códigos de los identificadores lógicos de observación (LOINC) y las categorías de FHIR.

Las observaciones que no pertenecen a ninguna de estas categorías no se escriben en Health Connect.

Tabla 1: Tipos de recursos médicos de Health Connect
Tipo de recurso médico de Health Connect Recursos de FHIR Declaración de permisos de Health Connect
Alergias AlergiaIntolerancia android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
Condiciones Condition android.permission.health.READ_MEDICAL_DATA_CONDITIONS
Laboratorio

Observación

  • Categoría laboratory de FHIR
 android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
Medicamentos Medication, MedicationRequest, MedicationStatement android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
Datos personales Paciente android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
Datos del profesional Practitioner, PractitionerRole android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
Embarazo

Observación

  • Códigos LOINC de embarazo
 android.permission.health.READ_MEDICAL_DATA_PREGNANCY
Procedimientos Procedimiento android.permission.health.READ_MEDICAL_DATA_PROCEDURES
Historia social

Observación

  • Códigos LOINC de historial social
  • Categoría social-history de FHIR
 android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
Vacunas Vacunación android.permission.health.READ_MEDICAL_DATA_VACCINES
Visitas Encounter, Location, Organization android.permission.health.READ_MEDICAL_DATA_VISITS
Signos vitales

Observación

  • Códigos LOINC de signos vitales
  • Categoría vital-signs de FHIR
 android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS

Recursos para pacientes

Por el momento, Health Connect está diseñado para almacenar datos de registros médicos de una sola persona. Por lo tanto, todos los recursos de FHIR escritos deben pertenecer a la misma persona.

No es raro que existan varios recursos de paciente de FHIR en un sistema para una sola persona. Se recomienda que las apps concilien los datos y escriban un solo recurso Patient en Health Connect. Sin embargo, esto no se aplica para adaptarse a las diferentes estructuras organizativas que pueden existir.

Validación de datos

Las APIs de registros médicos aceptan recursos de FHIR válidos de versiones compatibles, y Health Connect realiza algunas validaciones para confirmar que se sigue la especificación de FHIR para cada versión compatible.

Las verificaciones de validación marcadas como Próximamente aún no se aplican, pero se incluirán en una versión futura. Te recomendamos que desarrolles tu app en función de todas las verificaciones de validación que se indican para mantener la compatibilidad con versiones futuras.

Tabla 2: Validación de datos de FHIR en Health Connect
Nivel Verificación de validación
JSON válido Los datos cumplen con el formato JSON.
FHIR compatible

Se admite la versión de FHIR declarada por la aplicación de escritura. Health Connect admite las siguientes versiones de FHIR:

  • 4.0.1
  • 4.3.0
FHIR compatible

Se admite el tipo de recurso FHIR registrado en la instancia del recurso. Health Connect admite los siguientes tipos de recursos de FHIR:

  • AlergiaIntolerancia
  • Condition
  • Encounter
  • Vacunación
  • Ubicación
  • Medicamento
  • MedicationRequest
  • MedicationStatement
  • Observación
  • Organización
  • Paciente
  • Profesionales
  • PractitionerRole
  • Procedimiento
ID único del recurso El recurso tiene un campo de ID con un valor que cumple con los requisitos de expresión regular.
ID único del recurso El recurso no comparte un ID con otro recurso de FHIR del mismo tipo de recurso del mismo MedicalDataSource.
Reglas de negocio No incluye un recurso de FHIR contenido. Los recursos contenidos son recursos de FHIR anidados dentro de un recurso "principal". Se usan cuando el recurso principal necesita hacer referencia a otro recurso, pero el sistema no tiene suficiente información para crear este como un recurso independiente con existencia independiente.
FHIR base válido Los campos de nivel superior en el JSON de FHIR existen en la especificación de FHIR para el tipo de recurso determinado.
FHIR base válido Los campos de nivel superior no tienen valores nulos de JSON.
FHIR base válido Todos los campos obligatorios de nivel superior están presentes.
FHIR base válido Los campos de nivel superior definidos como elementos repetitivos en FHIR tienen un tipo de datos array de JSON.
FHIR base válido Los campos de nivel superior (incluidos los elementos dentro de los array de JSON) definidos como tipos complejos en FHIR tienen un tipo de datos object de JSON.
FHIR base válido Los campos de nivel superior (incluidos los elementos dentro de los array de JSON) definidos como tipos primitivos en FHIR tienen el tipo de datos JSON correcto.
Tipo de datos de FHIR Tipo de datos JSON
integer, unsignedInt, positiveInt, decimal número
boolean boolean
instant, time, date, dateTime, string, code, markdown, id uri, url, oid, uuid, canonical, integer64, base64Binary número
Próximamente
FHIR base válido Los campos de nivel superior definidos como tipos primitivos en FHIR cumplen con los requisitos de expresión regular. Próximamente
FHIR base válido Las extensiones de los tipos primitivos existen en la especificación de FHIR y tienen un tipo de datos object JSON.
FHIR base válido No se registra más de un campo para los campos de elección (fieldname[x]).Por ejemplo, effectiveDateTime y effectivePeriod no pueden estar presentes en la misma instancia de recurso.
FHIR base válido Los tipos de datos complejos contienen campos y tipos de datos que coinciden con la especificación de FHIR. Próximamente
FHIR base válido Los elementos de estructura (y los elementos dentro de tipos complejos) contienen campos y tipos de datos que coinciden con la especificación de FHIR. Próximamente
FHIR base válido Elemento Extensions Los campos value[x] son de un tipo válido y contienen contenido según ese tipo de datos. Los elementos de extensión se pueden incluir en cualquier recurso para representar información adicional que no forma parte de la especificación base. Contienen un campo url que vincula a la definición de la extensión y un campo value[x] que contiene el valor de la extensión. value[x] debe provenir de una lista establecida de tipos de datos aceptados. Próximamente

Datos de FHIR transformados

Algunas apps transforman los datos de FHIR para satisfacer sus propios requisitos. Por ejemplo:

  • Combinación de datos de diferentes fuentes (por lo general, APIs de FHIR)
  • Asignar códigos a terminologías globales (por ejemplo, SNOMED, LOINC, ICD) y estandarizar unidades
  • Consolidar y anular la duplicación de datos
  • Corregir problemas de formato o de calidad de los datos
  • Filtrar registros según reglas de negocio específicas de la app

Los datos FHIR transformados y sin transformar se pueden escribir en Health Connect, siempre que cumplan con la especificación FHIR R4. Te recomendamos que escribas los datos transformados siempre que sea posible. Sin embargo, ten en cuenta las siguientes consideraciones:

  • Las apps con casos de uso limitados pueden filtrar una cantidad significativa de registros de los que otras apps del ecosistema podrían crear valor para el usuario. En tales situaciones, puede ser beneficioso escribir el FHIR sin transformar que sea más completo. Sin embargo, asegúrate de informar a los usuarios que se comparte este conjunto de datos más amplio.
  • Si combinas datos que provienen de diferentes fuentes, puedes escribir datos en un solo MedicalDataSource en Health Connect. También debes asignar un ID nuevo a cada recurso para evitar conflictos y actualizar las referencias de recursos para que apunten a los IDs nuevos.
  • La combinación de datos de varias fuentes en un solo MedicalDataSource puede ocultar el origen de los datos. Como a menudo es útil para los consumidores de datos comprender la procedencia de los datos, recomendamos completar el campo meta.source para cada recurso con la fuente original del registro (por lo general, una URL base de FHIR).
Anterior
Descripción general
Siguiente
Cómo escribir datos médicos