Módulo 06 · Observaciones: signos vitales y tipos de valor¶
← Módulo 05 · Inicio · Módulo 07 →
Nivel: básico · Duración: 75 minutos · Necesitas: módulo 05
Lo que vas a aprender¶
- Qué es Observation, el recurso más usado de FHIR.
- A registrar signos vitales según el perfil de signos vitales de FHIR R4.
- Los distintos tipos de valor (
value[x]). - A modelar mediciones con varias partes usando
component. - A expresar unidades con UCUM y códigos con LOINC.
La historia¶
En la consulta del 20 de marzo, a las 07:30, la Dra. Salazar registra:
| Medición | Resultado |
|---|---|
| Presión arterial | 128/84 mmHg |
| Temperatura | 38,4 °C |
| Frecuencia respiratoria | 20 por minuto |
| Frecuencia cardíaca | 102 por minuto |
| Fiebre | presente |
| Motivo de consulta | "Dolor abdominal tipo cólico desde hace 3 días, con náuseas y diarrea" |
| Sangre oculta en heces | positiva |
| Reacción de Widal, antígeno O | título 1:160 |
Cada una es una Observation.
Ficha del recurso: Observation¶
¿Qué es? Una medición o afirmación simple sobre un paciente: un signo vital, un resultado de laboratorio, un hallazgo del examen físico, el puntaje de una escala, un dato social (tabaquismo, ocupación).
¿Para qué se usa? Para casi todo lo que se mide o se observa. Es el recurso más usado de FHIR: un paciente hospitalizado puede acumular miles.
¿Cuándo usar otro recurso?
- Un diagnóstico o problema de salud: Condition.
- Un informe que agrupa resultados (un hemograma completo, un informe de patología): DiagnosticReport, que apunta a las Observation (módulo 11).
- Una alergia: AllergyIntolerance.
- Las respuestas de un formulario completo: QuestionnaireResponse.
Elementos principales (https://hl7.org/fhir/R4/observation.html):
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
status ⚑ |
1..1 | code | registered, preliminary, final, amended, cancelled, entered-in-error. |
category |
0..* | CodeableConcept | Clase: vital-signs, laboratory, exam, survey, social-history, imaging... |
code |
1..1 | CodeableConcept | Qué se observó: casi siempre un código LOINC. |
subject |
0..1 | Reference(Patient | Group | Device | Location) | De quién. |
focus |
0..* | Reference(Resource) | Sobre qué, si no es el propio paciente (un tumor, un feto). |
encounter |
0..1 | Reference(Encounter) | En qué atención. |
effective[x] |
0..1 | dateTime | Period | Timing | instant | Cuándo se observó. |
issued |
0..1 | instant | Cuándo se publicó el resultado. |
performer |
0..* | Reference(Practitioner | PractitionerRole | Organization | CareTeam | …) | Quién lo midió o informó. |
value[x] |
0..1 | Quantity | CodeableConcept | string | boolean | … | El resultado. Su tipo cambia según la observación (ver abajo). |
dataAbsentReason |
0..1 | CodeableConcept | Por qué no hay resultado (muestra hemolizada, paciente se negó). |
interpretation |
0..* | CodeableConcept | Alto, bajo, normal, positivo... |
note |
0..* | Annotation | Comentarios. |
bodySite |
0..1 | CodeableConcept | Parte del cuerpo. |
method |
0..1 | CodeableConcept | Cómo se midió. |
specimen |
0..1 | Reference(Specimen) | La muestra analizada. |
referenceRange |
0..* | BackboneElement | Valores de referencia. |
hasMember |
0..* | Reference(Observation | QuestionnaireResponse | MolecularSequence) | Observaciones que agrupa (un panel). |
component |
0..* | BackboneElement | Partes de una observación con varios valores (sistólica y diastólica). |
Los tipos de value[x]:
| Si el resultado es... | Se usa | Ejemplo del caso |
|---|---|---|
| una cantidad con unidad | valueQuantity |
Temperatura 38,4 °C |
| sí o no | valueBoolean |
Fiebre: presente |
| un texto libre | valueString |
Motivo de consulta |
| un concepto codificado | valueCodeableConcept |
Sangre oculta: positivo |
| una proporción | valueRatio |
Título 1:160 |
| un número entero | valueInteger |
Número de deposiciones |
| una fecha, una hora, un periodo | valueDateTime, valueTime, valuePeriod |
Fecha de la última menstruación |
El perfil de signos vitales. FHIR R4 define que todo signo vital debe
tener status, category = vital-signs, code LOINC, subject,
effective[x] y un valor en unidades UCUM. El validador aplica este perfil
automáticamente cuando reconoce el código LOINC de un signo vital, aunque
el recurso no lo declare.
| Signo vital | LOINC | Unidad UCUM |
|---|---|---|
| Presión arterial (panel) | 85354-9 |
componentes en mm[Hg] |
| Presión sistólica / diastólica | 8480-6 / 8462-4 |
mm[Hg] |
| Temperatura corporal | 8310-5 |
Cel |
| Frecuencia respiratoria | 9279-1 |
/min |
| Frecuencia cardíaca | 8867-4 |
/min |
| Saturación de oxígeno | 2708-6 |
% |
| Peso / talla | 29463-7 / 8302-2 |
kg / cm |
| Índice de masa corporal | 39156-5 |
kg/m2 |
UCUM (Unified Code for Units of Measure) es el estándar de unidades. En
valueQuantity, unit es lo que lee la persona (°C) y code lo que
entiende la máquina (Cel). Los códigos UCUM distinguen mayúsculas.
Paso a paso: la presión arterial¶
La presión arterial no es un valor sino dos: sistólica y diastólica. No
se registra como texto ("128/84") ni como proporción: es una observación
con dos componentes, cada uno con su propio código y valor.
Paso 1 · Lo que exige el perfil de signos vitales¶
{
"resourceType": "Observation",
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/observation-category",
"code": "vital-signs",
"display": "Vital Signs"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "85354-9",
"display": "Blood pressure panel with all children optional"
}
],
"text": "Presión arterial"
},
"subject": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
},
"effectiveDateTime": "2025-03-20T07:30:00-05:00",
"component": [
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8480-6",
"display": "Systolic blood pressure"
}
],
"text": "Presión sistólica"
},
"valueQuantity": {
"value": 128,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
}
},
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8462-4",
"display": "Diastolic blood pressure"
}
],
"text": "Presión diastólica"
},
"valueQuantity": {
"value": 84,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
}
}
]
}
Como 85354-9 es un signo vital, el validador exige desde el primer paso
todo lo del perfil: estado, categoría, código, paciente, fecha y los dos
componentes. Si quitas uno, verás el error. Por ejemplo, sin component:
Observation.component: minimum required = 2, but only found 0 (from http://hl7.org/fhir/StructureDefinition/bp|4.0.1)
La observación principal no tiene value[x]: los valores están en los
componentes.
Paso 2 · En qué consulta, quién midió y la narrativa¶
{
"encounter": {
"reference": "Encounter/{{encounterId}}",
"display": "Consulta por dolor abdominal"
},
"performer": [
{
"reference": "Practitioner/{{practitionerId}}",
"display": "Dra. Andrea Lucía Salazar Moreno"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Presión arterial: 128/84 mmHg.</p></div>"
}
}
encounter enlaza con la consulta del módulo 05 y performer, con la
médica. Solución:
06a_observation_presion_arterial.json.
Los demás signos vitales: cambia el código y el valor¶
La temperatura, la frecuencia respiratoria y la cardíaca son iguales a la
presión arterial, pero con un solo valor en valueQuantity en lugar de
componentes. Esto es lo que cambia en la temperatura:
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8310-5",
"display": "Body temperature"
}
],
"text": "Temperatura corporal"
},
"valueQuantity": {
"value": 38.4,
"unit": "°C",
"system": "http://unitsofmeasure.org",
"code": "Cel"
}
}
Soluciones: 06b temperatura ·
06c frecuencia respiratoria ·
06d frecuencia cardíaca.
Otros tipos de valor¶
| Ejercicio | Código | Valor | Solución |
|---|---|---|---|
| 06e · Fiebre | SNOMED 386661006 Fever |
"valueBoolean": true |
06e |
| 06f · Motivo de consulta | LOINC 10154-3 |
"valueString": "Dolor abdominal…" |
06f |
| 06g · Sangre oculta en heces | LOINC 2335-8 |
valueCodeableConcept SNOMED 10828004 Positive |
06g |
| 06h · Título de Widal | solo code.text |
valueRatio 1 / 160 |
06h |
Fíjate en la categoría de cada una: la fiebre es un hallazgo del examen
(exam), el motivo de consulta lo cuenta el paciente (survey) y la sangre
oculta y el Widal son de laboratorio (laboratory).
Ejercicios en el servidor¶
06a a 06h · Registrar las observaciones¶
POST {{FHIRURL}}/Observation
Guarda los id de los cuatro signos vitales (obsPAId, obsTempId,
obsFRId, obsFCId): los usarás en el módulo 09.
06i · Buscar los signos vitales¶
GET {{FHIRURL}}/Observation?subject=Patient/{{patientId}}&category=vital-signs
Devuelve los cuatro signos vitales y no las demás observaciones. Prueba
también &code=http://loinc.org|8310-5 para traer solo la temperatura.
06j · Error a propósito: el decimal con coma¶
Envía (06e1_decimal_con_coma.json)
una temperatura con "value": "38,4". El servidor responde 400:
HAPI-1821: [element="value"] Invalid attribute value "38,4": Character , is neither a decimal digit number, decimal point, nor "e" notation exponential mark.
En JSON los números van sin comillas y con punto: 38.4.
06k y 06l · Error a propósito: la observación sin código¶
Si el servidor acepta la creación, guarda inmediatamente el id devuelto
como errorObsId, junto con la dirección del servidor. Postman y los scripts
del taller guardan esa variable por ti. Si repites el intento, conserva cada
ID antes de sobrescribirlo. Si el servidor rechaza el recurso, no ejecutes el
borrado con un ID de un intento anterior.
Envía (06e2_observacion_sin_codigo.json)
una observación con estado, paciente y valor, pero sin code. El
servidor responde 201 Created: la guarda.
¿Qué es 38,4 °C? ¿La temperatura? ¿La de la habitación? Sin code el dato no
sirve. code es obligatorio (1..1) y el validador lo detecta:
Observation.code: minimum required = 1, but only found 0
El servidor no comprobó la cardinalidad: es un error de contenido (módulo
01). Bórrala con DELETE {{FHIRURL}}/Observation/{{errorObsId}} para que no
quede en el expediente de Luis.
Reto · Codificar el título de Widal¶
La observación 06h solo tiene code.text. Busca en
https://loinc.org/search/ el código LOINC del título de anticuerpos contra
el antígeno O de Salmonella typhi en suero, agrégalo como coding y valida
el recurso.
Tras el borrado, comprueba GET {{FHIRURL}}/Observation/{{errorObsId}}:
en HAPI se espera 410 Gone. Un 404 indica que no se encuentra el recurso,
pero no demuestra por sí solo que el borrado se haya realizado en el servidor
correcto. Conserva la respuesta del DELETE (200 o 204).
Autoevaluación¶
1. ¿Por qué la presión arterial no usa valueRatio ni valueString?
Porque son dos mediciones distintas, cada una con su propio código LOINC.
Con componentes, un sistema puede graficar la sistólica o alertar si la
diastólica supera un umbral. Con un texto "128/84", no.
2. ¿Qué diferencia hay entre unit y code en un valueQuantity?
unit es lo que lee la persona (°C, latidos/min). code es la unidad
UCUM que entiende la máquina (Cel, /min). Para comparar o convertir se usa
code.
3. El servidor aceptó una observación sin code. ¿Por qué?
Porque muchos servidores no validan la cardinalidad al guardar. Que el servidor acepte un recurso no garantiza que sea válido: hay que validarlo.
Resumen¶
- Observation registra mediciones y hallazgos; su
codedice qué es y suvalue[x], el resultado. - Los signos vitales siguen un perfil que exige categoría, código LOINC, paciente, fecha y unidades UCUM.
- Las mediciones de varias partes usan
component. - Los números van con punto y sin comillas.
Ejecutar este módulo¶
- Postman: carpeta 06 · Observaciones.
- curl:
curl/taller.sh 06 - R:
signos <- fhir_buscar("Observation?subject=Patient/{{patientId}}&category=vital-signs")
fhir_tabla(signos, list(
signo = function(r) r$code$text,
valor = function(r) r$valueQuantity$value %||% paste(
vapply(r$component, function(c) format(c$valueQuantity$value), ""), collapse = "/"),
unidad = function(r) r$valueQuantity$unit %||% "mmHg"
))