Módulo 08 · Vacunación¶
← Módulo 07 · Inicio · Módulo 09 →
Nivel: intermedio · Duración: 60 minutos · Necesitas: módulos 04 y 05
Lo que vas a aprender¶
- Qué es el recurso Immunization y qué datos de una vacunación registra.
- A registrar una vacuna no aplicada y su motivo (
not-done). - A codificar las vacunas con CVX y la dosis del esquema con
protocolApplied. - A obtener el carné de vacunación de un paciente con una búsqueda.
La historia¶
En la consulta del 20 de marzo, la Dra. Salazar revisa el esquema de vacunación de Luis: le falta la vacuna contra la influenza de la campaña de este año y el refuerzo de Td (tétanos y difteria), que en adultos se aplica cada 10 años. Pero Luis tiene 38,4 °C: una enfermedad aguda con fiebre es motivo para diferir la vacunación. La médica registra que no se vacunó y por qué, y le indica volver cuando esté bien.
El 3 de abril de 2025, ya recuperado, Luis va al vacunatorio. La Lcda. Rosa Elena Quishpe Tenesaca le aplica las dos vacunas.
Ficha del recurso: Immunization¶
¿Qué es? El registro de una dosis de vacuna: aplicada, o que se decidió no aplicar. Cada dosis es un Immunization.
¿Para qué se usa? Para el carné de vacunación del paciente, para calcular coberturas de los programas de inmunización y para la vigilancia de eventos supuestamente atribuibles a la vacunación (ESAVI).
¿Cuándo usar otro recurso?
- La recomendación de qué vacunas le tocan: ImmunizationRecommendation.
- La evaluación de si una dosis cuenta para el esquema: ImmunizationEvaluation.
- Una orden de vacunar que todavía no se cumple: MedicationRequest o ServiceRequest.
Elementos principales (https://hl7.org/fhir/R4/immunization.html):
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
identifier |
0..* | Identifier | Identificador del registro. |
status ⚑ |
1..1 | code | completed, entered-in-error o not-done. |
statusReason |
0..1 | CodeableConcept | Por qué no se aplicó. |
vaccineCode |
1..1 | CodeableConcept | Qué vacuna: un código CVX, SNOMED CT o del catálogo nacional. |
patient |
1..1 | Reference(Patient) | A quién. |
encounter |
0..1 | Reference(Encounter) | En qué atención. |
occurrence[x] |
1..1 | dateTime | string | Cuándo se aplicó (o cuándo se decidió no aplicarla). |
recorded |
0..1 | dateTime | Cuándo se registró. |
primarySource |
0..1 | boolean | true si lo registra quien vacunó; false si viene de un carné u otro registro. |
location |
0..1 | Reference(Location) | Dónde se vacunó. |
manufacturer |
0..1 | Reference(Organization) | Fabricante. |
lotNumber |
0..1 | string | Número de lote: clave para rastrear un ESAVI. |
expirationDate |
0..1 | date | Fecha de vencimiento del lote. |
site |
0..1 | CodeableConcept | Sitio de aplicación: brazo izquierdo, muslo derecho... |
route |
0..1 | CodeableConcept | Vía: intramuscular, subcutánea, oral, intradérmica. |
doseQuantity |
0..1 | Quantity | Cantidad aplicada: 0,5 mL. |
performer |
0..* | BackboneElement | Quién vacunó. |
note |
0..* | Annotation | Notas. |
reasonCode |
0..* | CodeableConcept | Por qué se vacunó. |
isSubpotent ⚑ |
0..1 | boolean | Si la dosis no cuenta (se aplicó mal, cadena de frío rota). |
reaction |
0..* | BackboneElement | Reacciones posteriores. |
protocolApplied |
0..* | BackboneElement | Qué dosis del esquema es. |
protocolApplied.series |
0..1 | string | El esquema o la campaña. |
protocolApplied.targetDisease |
0..* | CodeableConcept | Contra qué enfermedad. |
protocolApplied.doseNumber[x] |
1..1 | positiveInt | string | Número de dosis. |
protocolApplied.seriesDoses[x] |
0..1 | positiveInt | string | Cuántas dosis tiene el esquema. |
CVX es la terminología de vacunas de los CDC de Estados Unidos, la más
usada en FHIR (http://hl7.org/fhir/sid/cvx). Cada país puede usar además
su propio catálogo de vacunas.
Paso a paso: la vacuna diferida¶
Paso 1 · El mínimo: estado, vacuna, paciente y fecha¶
{
"resourceType": "Immunization",
"status": "not-done",
"vaccineCode": {
"coding": [
{
"system": "http://hl7.org/fhir/sid/cvx",
"code": "141",
"display": "Influenza, split virus, trivalent, preservative"
}
],
"text": "Influenza estacional"
},
"patient": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
},
"occurrenceDateTime": "2025-03-20T08:00:00-05:00"
}
occurrence[x] es obligatorio, aunque la vacuna no se aplique: es la
fecha en que se decidió no aplicarla. status: not-done es un modificador
(⚑): un sistema que lo ignore contaría esta vacuna como aplicada.
Paso 2 · Por qué no se aplicó¶
{
"statusReason": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
"code": "MEDPREC",
"display": "medical precaution"
}
],
"text": "Precaución médica: enfermedad aguda con fiebre"
},
"note": [
{
"text": "Se indica volver al vacunatorio cuando esté sin fiebre."
}
]
}
statusReason usa la tabla v3-ActReason: MEDPREC es medical
precaution, precaución médica por la fiebre. Otros motivos posibles son
PATOBJ (el paciente se niega) o IMMUNE (ya es inmune).
Paso 3 · En qué consulta y quién lo informa¶
{
"encounter": {
"reference": "Encounter/{{encounterId}}",
"display": "Consulta por dolor abdominal"
},
"recorded": "2025-03-20",
"primarySource": true,
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Vacuna contra la influenza NO aplicada el 20 de marzo de 2025: se difiere por fiebre (38,4 °C).</p></div>"
}
}
Solución: 08a_immunization_diferida.json.
La enfermera y la atención en el vacunatorio¶
Antes de registrar las vacunas, crea a la enfermera
(08b_practitioner_enfermera.json)
y la atención del 3 de abril
(08c_encounter_vacunacion.json).
Ya sabes construirlos (módulos 04 y 05). Fíjate en dos detalles:
- Cada visita es un Encounter nuevo: la consulta del 20 de marzo y la vacunación del 3 de abril son dos atenciones distintas.
- En la enfermera,
qualification.codesolo tienetext: cuando no hay un código adecuado, un texto es mejor que un código equivocado.
Paso a paso: la vacuna contra la influenza¶
Paso 1 · El mínimo: estado, vacuna, paciente y fecha¶
{
"resourceType": "Immunization",
"status": "completed",
"vaccineCode": {
"coding": [
{
"system": "http://hl7.org/fhir/sid/cvx",
"code": "141",
"display": "Influenza, split virus, trivalent, preservative"
}
],
"text": "Influenza estacional"
},
"patient": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
},
"occurrenceDateTime": "2025-04-03T10:10:00-05:00"
}
CVX 141 es la vacuna inyectable de influenza estacional. El display debe
ser el nombre oficial de CVX, en inglés.
Paso 2 · Dónde y quién la registra¶
{
"encounter": {
"reference": "Encounter/{{vaccinationEncounterId}}",
"display": "Vacunatorio, 3 de abril de 2025"
},
"recorded": "2025-04-03",
"primarySource": true
}
primarySource: true: la registra quien la aplicó. Si la vacuna se
transcribiera de un carné de papel, sería false.
Paso 3 · El producto: lote y vencimiento¶
{
"lotNumber": "FLU-25-0417",
"expirationDate": "2025-12-31"
}
Si hubiera un ESAVI, el lote permite saber qué otras personas recibieron el mismo producto.
Paso 4 · Cómo se aplicó: sitio, vía y dosis¶
{
"site": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "368208006",
"display": "Left upper arm structure"
}
],
"text": "Brazo izquierdo"
},
"route": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-RouteOfAdministration",
"code": "IM",
"display": "Injection, intramuscular"
}
],
"text": "Intramuscular"
},
"doseQuantity": {
"value": 0.5,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
El sitio con SNOMED CT (368208006 Left upper arm structure), la vía con la
tabla v3-RouteOfAdministration (IM, intramuscular) y la dosis con UCUM
(mL).
Paso 5 · Quién vacunó y qué dosis del esquema es¶
{
"performer": [
{
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0443",
"code": "AP",
"display": "Administering Provider"
}
],
"text": "Vacunadora"
},
"actor": {
"reference": "Practitioner/{{nursePractitionerId}}",
"display": "Lcda. Rosa Elena Quishpe Tenesaca"
}
}
],
"protocolApplied": [
{
"series": "Campaña de influenza 2025",
"targetDisease": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "6142004",
"display": "Influenza"
}
],
"text": "Influenza"
}
],
"doseNumberPositiveInt": 1
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Vacuna contra la influenza estacional, 0,5 mL IM en el brazo izquierdo, lote FLU-25-0417.</p></div>"
}
}
performer.function con AP (Administering Provider) indica que la
enfermera es quien la aplicó. protocolApplied dice que es la dosis 1 de la
campaña 2025, contra la influenza. Solución:
08d_immunization_influenza.json.
El refuerzo de Td: otra vacuna, otro esquema¶
Lo que cambia en la vacuna Td:
{
"vaccineCode": {
"coding": [
{
"system": "http://hl7.org/fhir/sid/cvx",
"code": "09",
"display": "Td (adult), 2 Lf tetanus toxoid, preservative free, adsorbed"
}
],
"text": "Td (tétanos y difteria, adultos)"
},
"lotNumber": "TD-24-1180",
"expirationDate": "2026-06-30",
"site": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "368209003",
"display": "Right upper arm structure"
}
],
"text": "Brazo derecho"
},
"protocolApplied": [
{
"series": "Esquema de adultos (refuerzo cada 10 años)",
"targetDisease": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "76902006",
"display": "Tetanus"
}
],
"text": "Tétanos"
}
],
"doseNumberPositiveInt": 4,
"seriesDosesPositiveInt": 4
}
]
}
Es la cuarta dosis de un esquema de cuatro (doseNumberPositiveInt: 4,
seriesDosesPositiveInt: 4), en el brazo derecho. Solución:
08e_immunization_td.json.
Ejercicios en el servidor¶
08a a 08e · Registrar la vacunación¶
POST {{FHIRURL}}/Immunization (vacuna diferida)
POST {{FHIRURL}}/Practitioner → nursePractitionerId
POST {{FHIRURL}}/Encounter → vaccinationEncounterId
POST {{FHIRURL}}/Immunization (influenza)
POST {{FHIRURL}}/Immunization (Td)
08f · El carné de vacunación¶
GET {{FHIRURL}}/Immunization?patient=Patient/{{patientId}}&_sort=date
_sort=date ordena por fecha. Verás las tres: la diferida del 20 de marzo y
las dos del 3 de abril. Para el carné solo cuentan las aplicadas: agrega
&status=completed.
08g y 08h · Error a propósito: la vacuna sin fecha¶
Si el servidor acepta la creación, guarda inmediatamente el id devuelto
como errorImmId, 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 (08e1_vacuna_sin_fecha.json) una
vacuna con estado, código y paciente, pero sin occurrenceDateTime. El
servidor responde 201 Created. El validador sí lo detecta:
Immunization.occurrence[x]: minimum required = 1, but only found 0
Una vacuna sin fecha no sirve para el esquema: no se sabe si la siguiente
dosis toca ya o en diez años. Bórrala con
DELETE {{FHIRURL}}/Immunization/{{errorImmId}}.
Tras el borrado, comprueba GET {{FHIRURL}}/Immunization/{{errorImmId}}:
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).
Para pensar¶
Para calcular la cobertura de vacunación contra la influenza de una provincia necesitas el numerador (personas vacunadas) y el denominador (población objetivo). ¿Qué búsqueda FHIR te daría el numerador? ¿De dónde sacarías el denominador? (Pista: las proyecciones de población por provincia y edad del INEC.)
Autoevaluación¶
1. ¿Por qué se registra una vacuna que no se aplicó?
Para que quede constancia de que se ofreció y por qué no se aplicó. Sirve para el seguimiento del paciente y para analizar oportunidades perdidas de vacunación.
2. Una vacuna se transcribe de un carné de papel. ¿Qué cambia?
primarySource: false, y se puede indicar el origen con reportOrigin. No
se conoce, en general, el lote ni quién vacunó.
3. ¿Por qué status es un modificador?
Porque not-done invierte el significado: el resto del recurso describe una
vacuna que no se aplicó. Un sistema que ignore el estado la contaría como
aplicada.
Resumen¶
- Immunization registra una dosis: aplicada (
completed) o no (not-done, con sustatusReason). - El lote, el sitio, la vía y quién vacunó son clave para la seguridad.
protocolApplieddice qué dosis del esquema es.- Cada visita es un Encounter distinto.
Ejecutar este módulo¶
- Postman: carpeta 08 · Vacunación.
- curl:
curl/taller.sh 08 - R:
carne <- fhir_buscar("Immunization?patient=Patient/{{patientId}}&_sort=date")
fhir_tabla(carne, list(
fecha = function(r) substr(r$occurrenceDateTime, 1, 10),
vacuna = function(r) r$vaccineCode$text,
estado = function(r) r$status,
lote = function(r) r$lotNumber
))