Módulo 15 · Medicamentos¶
← Módulo 14 · Inicio · Módulo 16 →
Nivel: intermedio · Duración: 90 minutos · Necesitas: módulos 06, 11 y 14
Lo que vas a aprender¶
- La diferencia entre prescribir (MedicationRequest) y administrar (MedicationAdministration).
- A expresar una dosis con texto y con datos estructurados (
Dosage). - A justificar una dosis con una observación (
supportingInformation). - El ciclo de vida de una receta: activa → suspendida.
La historia¶
Son las actividades 2 y 3 del plan del comité (módulo 12).
Quimioterapia. El 1 de julio de 2025 se pesa y se mide a Luis: 72 kg y 1,57 m. Su superficie corporal es 1,77 m². La dosis de doxorrubicina es 60 mg/m² × 1,77 m² = 106,2 mg por vía intravenosa, cada 21 días, 4 ciclos. El primer ciclo se administra el 2 de julio, de 09:00 a 09:30, en la cita del módulo 14. Dos horas después, Luis tiene náuseas leves.
Hormonoterapia. Como el tumor es receptor de estrógeno positivo, el 15 de octubre se prescribe tamoxifeno 20 mg diarios por vía oral, durante 5 años. Luis toma la primera dosis en casa al día siguiente. En febrero de 2026 se suspende por intolerancia: sofocos intensos y dolor articular, que Luis informa en el cuestionario de seguimiento del módulo 16.
Antes de prescribir, el sistema puede revisar las alergias del módulo 07: Luis es alérgico a la penicilina, no a estos medicamentos.
Ficha del recurso: MedicationRequest¶
¿Qué es? Una orden o propuesta de que el paciente reciba un medicamento: la receta de un tratamiento ambulatorio o la indicación de un paciente hospitalizado.
¿Para qué se usa? Para la prescripción: qué medicamento, cuánto, cómo, por cuánto tiempo, quién lo ordena y por qué.
¿Cuándo usar otro recurso? Repasa la tabla del módulo 07: MedicationStatement (lo que el paciente dice que toma), MedicationDispense (lo que se entregó) y MedicationAdministration (lo que se administró).
Elementos principales (https://hl7.org/fhir/R4/medicationrequest.html):
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
identifier |
0..* | Identifier | Número de la receta. |
status ⚑ |
1..1 | code | active, on-hold, cancelled, completed, stopped, draft... |
statusReason |
0..1 | CodeableConcept | Por qué se suspendió o canceló. |
intent ⚑ |
1..1 | code | proposal, plan, order, original-order... |
category |
0..* | CodeableConcept | inpatient, outpatient, community, discharge. |
priority |
0..1 | code | routine, urgent, asap, stat. |
medication[x] |
1..1 | CodeableConcept | Reference(Medication) | Qué medicamento. |
subject |
1..1 | Reference(Patient | Group) | Para quién. |
encounter |
0..1 | Reference(Encounter) | En qué atención. |
supportingInformation |
0..* | Reference(Resource) | Datos que justifican la orden: peso, superficie corporal. |
authoredOn |
0..1 | dateTime | Cuándo se prescribió. |
requester |
0..1 | Reference(Practitioner | PractitionerRole | Organization | Patient | …) | Quién prescribe. |
reasonCode |
0..* | CodeableConcept | Por qué, codificado. |
reasonReference |
0..* | Reference(Condition | Observation) | Por qué, como referencia a una Condition. |
basedOn |
0..* | Reference(CarePlan | MedicationRequest | ServiceRequest | ImmunizationRecommendation) | El plan del que forma parte. |
note |
0..* | Annotation | Notas. |
dosageInstruction |
0..* | Dosage | Cómo tomarlo. |
dispenseRequest |
0..1 | BackboneElement | Cuánto entregar en farmacia y cuántas veces. |
substitution |
0..1 | BackboneElement | Si se permite el genérico. |
priorPrescription |
0..1 | Reference(MedicationRequest) | La receta a la que reemplaza. |
Ficha del recurso: MedicationAdministration¶
¿Qué es? El registro de que un medicamento se administró a un paciente: cuándo, cuánto, por qué vía y quién.
¿Para qué se usa? Para la hoja de administración de medicamentos de enfermería, la quimioterapia, los tratamientos supervisados (como el de la tuberculosis) y la trazabilidad de cada dosis.
Elementos principales (https://hl7.org/fhir/R4/medicationadministration.html):
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
status ⚑ |
1..1 | code | in-progress, not-done, on-hold, completed, entered-in-error, stopped. |
statusReason |
0..* | CodeableConcept | Por qué no se administró. |
category |
0..1 | CodeableConcept | inpatient, outpatient o community. |
medication[x] |
1..1 | CodeableConcept | Reference(Medication) | Qué medicamento. |
subject |
1..1 | Reference(Patient | Group) | A quién. |
context |
0..1 | Reference(Encounter | EpisodeOfCare) | En qué atención. |
supportingInformation |
0..* | Reference(Resource) | Datos que la justifican. |
effective[x] |
1..1 | dateTime | Period | Cuándo: un momento o un periodo (una infusión). |
performer |
0..* | BackboneElement | Quién la administró. |
reasonCode |
0..* | CodeableConcept | Por qué, codificado. |
reasonReference |
0..* | Reference(Condition | Observation | DiagnosticReport) | Por qué, como referencia. |
request |
0..1 | Reference(MedicationRequest) | La orden que se cumple. |
note |
0..* | Annotation | Notas: eventos, observaciones. |
dosage |
0..1 | BackboneElement | Lo que se administró realmente. |
dosage.route |
0..1 | CodeableConcept | Por qué vía. |
dosage.dose |
0..1 | Quantity | Cuánto. |
dosage.rate[x] |
0..1 | Ratio | Quantity | A qué velocidad (en una infusión). |
La estructura Dosage, que se usa en MedicationRequest,
MedicationStatement y otros, combina siempre dos cosas:
text: la indicación como la leería una persona ("20 mg por vía oral una vez al día, durante 5 años");- datos estructurados para las máquinas:
timing(frecuencia y duración),route(vía) ydoseAndRate(dosis).
Paso a paso: la superficie corporal¶
La dosis de quimioterapia depende de la superficie corporal, así que primero
se registra como observación (LOINC 8277-6, categoría vital-signs). Ya
sabes construirla (módulo 06):
15a_observation_superficie_corporal.json.
Paso a paso: la prescripción de doxorrubicina¶
Paso 1 · El mínimo: estado, intención, medicamento y paciente¶
{
"resourceType": "MedicationRequest",
"status": "active",
"intent": "order",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "372817009",
"display": "Doxorubicin"
}
],
"text": "Doxorrubicina"
},
"subject": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
}
}
intent: order dice que es una orden que se debe cumplir. Una propuesta
del comité de tumores sería proposal; un plan, plan.
Paso 2 · Quién, cuándo y por qué¶
{
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "outpatient",
"display": "Outpatient"
}
]
}
],
"authoredOn": "2025-07-01",
"requester": {
"reference": "Practitioner/{{practitionerId}}",
"display": "Dra. Andrea Lucía Salazar Moreno"
},
"reasonReference": [
{
"reference": "Condition/{{conditionCancerId}}",
"display": "Carcinoma ductal infiltrante de mama izquierda"
}
]
}
Paso 3 · La dosis: texto y datos estructurados¶
{
"dosageInstruction": [
{
"text": "60 mg/m² (106,2 mg) por vía intravenosa cada 21 días, 4 ciclos",
"timing": {
"repeat": {
"count": 4,
"frequency": 1,
"period": 21,
"periodUnit": "d"
}
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "47625008",
"display": "Intravenous route"
}
],
"text": "Vía intravenosa"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 106.2,
"unit": "mg",
"system": "http://unitsofmeasure.org",
"code": "mg"
}
}
]
}
]
}
timing.repeat: una vez (frequency: 1) cada 21 días (period: 21,
periodUnit: d), 4 veces (count: 4). La vía intravenosa con SNOMED
47625008 y la dosis con UCUM (mg).
Paso 4 · La justificación: superficie corporal¶
{
"supportingInformation": [
{
"reference": "Observation/{{obsBSAId}}",
"display": "Superficie corporal 1,77 m²"
}
],
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/receta",
"value": "RX-2025-0101"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Doxorrubicina 60 mg/m² (106,2 mg) IV cada 21 días, 4 ciclos.</p></div>"
}
}
supportingInformation apunta a la observación de 1,77 m²: cualquiera puede
verificar el cálculo de 60 mg/m² × 1,77 m² = 106,2 mg. Solución:
15b_medicationrequest_doxorrubicina.json.
Paso a paso: la administración del primer ciclo¶
Paso 1 · El mínimo: estado, medicamento, paciente y momento¶
{
"resourceType": "MedicationAdministration",
"status": "completed",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "372817009",
"display": "Doxorubicin"
}
],
"text": "Doxorrubicina"
},
"subject": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
},
"effectivePeriod": {
"start": "2025-07-02T09:00:00-05:00",
"end": "2025-07-02T09:30:00-05:00"
}
}
effectivePeriod, no effectiveDateTime: una infusión dura un tiempo, de
09:00 a 09:30.
Paso 2 · Quién la administró y por qué orden¶
{
"category": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medication-admin-category",
"code": "outpatient",
"display": "Outpatient"
}
]
},
"performer": [
{
"actor": {
"reference": "Practitioner/{{practitionerId}}",
"display": "Dra. Andrea Lucía Salazar Moreno"
}
}
],
"request": {
"reference": "MedicationRequest/{{medReqDoxoId}}",
"display": "Doxorrubicina 60 mg/m²"
},
"reasonReference": [
{
"reference": "Condition/{{conditionCancerId}}",
"display": "Carcinoma ductal infiltrante de mama izquierda"
}
],
"supportingInformation": [
{
"reference": "Observation/{{obsBSAId}}",
"display": "Superficie corporal 1,77 m²"
}
]
}
request enlaza la administración con la receta: así se sabe qué orden se
está cumpliendo.
Paso 3 · Cuánto y cómo se administró¶
{
"dosage": {
"text": "106,2 mg diluidos en 100 mL de solución salina, en 30 minutos",
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "47625008",
"display": "Intravenous route"
}
],
"text": "Vía intravenosa"
},
"dose": {
"value": 106.2,
"unit": "mg",
"system": "http://unitsofmeasure.org",
"code": "mg"
},
"rateQuantity": {
"value": 200,
"unit": "mL/h",
"system": "http://unitsofmeasure.org",
"code": "mL/h"
}
},
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Primer ciclo de doxorrubicina: 106,2 mg IV en 30 minutos, 2 de julio de 2025.</p></div>"
}
}
rateQuantity: 200 mL/h, la velocidad de la infusión. Solución:
15c_medicationadministration_doxorrubicina.json.
15d · El evento posterior. Las náuseas se registran con una nota en la misma administración. Lo que cambia:
{
"id": "{{medAdminDoxoId}}",
"note": [
{
"time": "2025-07-02T11:00:00-05:00",
"text": "Náuseas grado 1 dos horas después de la infusión; se administró ondansetrón 8 mg VO."
}
]
}
El tamoxifeno: otra receta, otro ciclo de vida¶
La receta de tamoxifeno sigue el mismo modelo que la de doxorrubicina. Lo que cambia:
{
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/receta",
"value": "RX-2025-0207"
}
],
"medicationCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "373345002",
"display": "Tamoxifen"
}
],
"text": "Tamoxifeno"
},
"authoredOn": "2025-10-15",
"dosageInstruction": [
{
"text": "20 mg por vía oral una vez al día, durante 5 años",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "d",
"boundsDuration": {
"value": 5,
"unit": "años",
"system": "http://unitsofmeasure.org",
"code": "a"
}
}
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route"
}
],
"text": "Vía oral"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 20,
"unit": "mg",
"system": "http://unitsofmeasure.org",
"code": "mg"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 11,
"quantity": {
"value": 30,
"unit": "comprimidos"
},
"expectedSupplyDuration": {
"value": 30,
"unit": "días",
"system": "http://unitsofmeasure.org",
"code": "d"
}
}
}
Fíjate en dispenseRequest: 30 comprimidos por entrega, para 30 días, con 11
repeticiones (un año de tratamiento por receta). Solución:
15e_medicationrequest_tamoxifeno.json.
La primera dosis la toma el propio Luis en su casa: la administración
tiene category: community y performer es el paciente
(15f_medicationadministration_tamoxifeno.json).
15g · Suspender. En febrero de 2026 la receta se suspende. No se borra:
se actualiza con status: stopped y el motivo. Lo que cambia:
{
"id": "{{medReqTamoxId}}",
"status": "stopped",
"statusReason": {
"text": "Intolerancia: sofocos intensos y dolor articular"
},
"note": [
{
"time": "2026-02-10T10:00:00-05:00",
"text": "Se suspende el tamoxifeno por intolerancia; se valorará una alternativa en oncología."
}
]
}
Ejercicios en el servidor¶
| Paso | Petición | Guarda |
|---|---|---|
| 15a | POST /Observation (superficie corporal) |
obsBSAId |
| 15b | POST /MedicationRequest (doxorrubicina) |
medReqDoxoId |
| 15c | POST /MedicationAdministration |
medAdminDoxoId |
| 15d | PUT /MedicationAdministration/{{medAdminDoxoId}} |
|
| 15e | POST /MedicationRequest (tamoxifeno) |
medReqTamoxId |
| 15f | POST /MedicationAdministration |
medAdminTamoxId |
| 15g | PUT /MedicationRequest/{{medReqTamoxId}} (stopped) |
15h y 15i · Error a propósito: la receta sin intención¶
Si el servidor acepta la creación, guarda inmediatamente el id devuelto
como errorMedReqId, 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 (15e1_receta_sin_intencion.json)
una receta sin intent. El servidor responde 201 Created. El validador
lo detecta:
MedicationRequest.intent: minimum required = 1, but only found 0
¿Es una orden o una propuesta? Sin intent, una farmacia no sabe si debe
dispensar. Bórrala con DELETE {{FHIRURL}}/MedicationRequest/{{errorMedReqId}}.
Tras el borrado, comprueba GET {{FHIRURL}}/MedicationRequest/{{errorMedReqId}}:
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. La enfermera registra que administró la dosis de las 08:00. ¿Qué recurso?
MedicationAdministration, con request apuntando a la MedicationRequest
que se cumple.
2. ¿Por qué no se borra la receta de tamoxifeno al suspenderla?
Porque es parte de la historia del paciente: se prescribió, se tomó y se
suspendió por intolerancia. Esa información sirve para no volver a
indicarlo. Se actualiza a stopped con su statusReason.
3. ¿Para qué sirve supportingInformation en la receta de doxorrubicina?
Para enlazar los datos que justifican la dosis (la superficie corporal), de modo que se pueda verificar el cálculo.
Resumen¶
- MedicationRequest es la orden; MedicationAdministration, lo que se
administró;
requestlas enlaza. Dosagecombina un texto para personas y datos estructurados.- Una receta se suspende con
stopped, no se borra.
Ejecutar este módulo¶
- Postman: carpeta 15 · Medicamentos.
- curl:
curl/taller.sh 15 - R:
recetas <- fhir_buscar("MedicationRequest?subject=Patient/{{patientId}}")
fhir_tabla(recetas, list(
medicamento = function(r) r$medicationCodeableConcept$text,
estado = function(r) r$status,
motivo = function(r) r$statusReason$text %||% ""
))