Módulo 10 · Órdenes y derivación¶
← Módulo 09 · Inicio · Módulo 11 →
Nivel: intermedio · Duración: 90 minutos · Necesitas: módulos 04, 05 y 07
Lo que vas a aprender¶
- A modelar dónde se atiende (Location) y en qué rol trabaja un profesional (PractitionerRole).
- A pedir un estudio o un procedimiento con ServiceRequest.
- A derivar a un paciente a otro servicio.
- A cerrar el ciclo orden → resultado con
basedOn. - A buscar "hacia atrás" con
_revinclude.
La historia¶
El 22 de abril de 2025, Luis vuelve al consultorio 3 de medicina general: se palpó un nódulo en la mama izquierda. La Dra. Salazar encuentra un nódulo de unos 2 cm en el cuadrante superior externo y pide una ecografía urgente.
El 25 de abril la ecografía muestra un nódulo sólido e irregular de 2,4 cm: BI-RADS 4, sospechoso. El 28 de abril la médica pide una biopsia y deriva a Luis a Oncología Clínica, con el Dr. Esteban Patricio Ruiz Montalvo. En la derivación menciona el antecedente que registró en el módulo 07: la madre de Luis tuvo cáncer de mama.
Ficha del recurso: Location¶
¿Qué es? Un lugar físico donde se prestan servicios: un consultorio, una sala, una cama, un quirófano, un vacunatorio, una ambulancia.
¿Para qué se usa? Para decir dónde ocurrió una atención
(Encounter.location), dónde trabaja un profesional
(PractitionerRole.location) o dónde se agenda una cita (Schedule.actor).
¿Cuándo usar otro recurso? La institución es una Organization (módulo 04). Location es el sitio; Organization, quien lo administra.
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
identifier |
0..* | Identifier | Código del lugar. |
status ⚑ |
0..1 | code | active, suspended o inactive. |
name |
0..1 | string | Nombre. |
description |
0..1 | string | Descripción. |
mode |
0..1 | code | instance (un lugar concreto) o kind (una clase de lugar, como "ambulancia"). |
type |
0..* | CodeableConcept | Qué servicio se presta: consulta, emergencia, oncología. |
telecom |
0..* | ContactPoint | Teléfono o extensión. |
address |
0..1 | Address | Dirección. |
physicalType |
0..1 | CodeableConcept | Qué es físicamente: edificio, piso, sala, cama. |
position |
0..1 | BackboneElement | Coordenadas geográficas. |
managingOrganization |
0..1 | Reference(Organization) | La organización responsable. |
partOf |
0..1 | Reference(Location) | El lugar más grande del que forma parte (la sala dentro del piso). |
hoursOfOperation |
0..* | BackboneElement | Horario de atención. |
Ficha del recurso: PractitionerRole¶
¿Qué es? El rol que cumple un profesional en una organización: qué hace, con qué especialidad, dónde y en qué horario.
¿Para qué se usa? Practitioner es la persona (módulo 04); PractitionerRole, la persona en un puesto. La Dra. Salazar puede ser médica general en este hospital y docente en una universidad: un Practitioner y dos PractitionerRole. Muchos recursos aceptan una referencia a PractitionerRole en lugar de Practitioner, y es mejor usarla: dice no solo quién, sino con qué rol y para qué organización.
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
active |
0..1 | boolean | Si el rol está vigente. |
period |
0..1 | Period | Desde y hasta cuándo. |
practitioner |
0..1 | Reference(Practitioner) | La persona. |
organization |
0..1 | Reference(Organization) | La organización. |
code |
0..* | CodeableConcept | El rol: médico, enfermera, investigador. |
specialty |
0..* | CodeableConcept | La especialidad. |
location |
0..* | Reference(Location) | Dónde atiende. |
healthcareService |
0..* | Reference(HealthcareService) | Los servicios que presta. |
telecom |
0..* | ContactPoint | Contacto en ese puesto. |
availableTime |
0..* | BackboneElement | Horario disponible. |
notAvailable |
0..* | BackboneElement | Periodos en que no está disponible (vacaciones). |
Ficha del recurso: ServiceRequest¶
¿Qué es? Una orden o solicitud de que se haga algo: un examen de laboratorio, un estudio de imagen, un procedimiento, una interconsulta, una derivación, una terapia.
¿Para qué se usa? Para el circuito de pedidos: quién pide qué, para
quién, con qué prioridad y por qué. Cuando el servicio se cumple, el
resultado (DiagnosticReport, Procedure, Specimen) apunta a la orden con
basedOn o request, y así se sabe qué orden se cumplió.
¿Cuándo usar otro recurso?
| Si se pide... | Usa |
|---|---|
| Un medicamento | MedicationRequest (módulo 15) |
| Una dieta | NutritionOrder |
| Un dispositivo (silla de ruedas, glucómetro) | DeviceRequest |
| Cualquier otro servicio | ServiceRequest |
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
identifier |
0..* | Identifier | Número de la orden. |
basedOn |
0..* | Reference(CarePlan | ServiceRequest | MedicationRequest) | El plan u otra orden de la que deriva. |
replaces |
0..* | Reference(ServiceRequest) | La orden a la que reemplaza. |
requisition |
0..1 | Identifier | Identificador común de varias órdenes pedidas juntas. |
status ⚑ |
1..1 | code | draft, active, on-hold, revoked, completed, entered-in-error. |
intent ⚑ |
1..1 | code | proposal, plan, order, original-order... |
category |
0..* | CodeableConcept | Clase: laboratorio, imagen, derivación, consejería. |
priority |
0..1 | code | routine, urgent, asap o stat. |
doNotPerform ⚑ |
0..1 | boolean | true si es una orden de no hacer algo. |
code |
0..1 | CodeableConcept | Qué se pide. |
subject |
1..1 | Reference(Patient | Group | Location | Device) | Para quién. |
encounter |
0..1 | Reference(Encounter) | En qué atención se pidió. |
occurrence[x] |
0..1 | dateTime | Period | Timing | Cuándo debe hacerse. |
authoredOn |
0..1 | dateTime | Cuándo se pidió. |
requester |
0..1 | Reference(Practitioner | PractitionerRole | Organization | Patient | …) | Quién lo pide. |
performerType |
0..1 | CodeableConcept | Qué tipo de profesional o servicio debe hacerlo. |
performer |
0..* | Reference(Practitioner | PractitionerRole | Organization | CareTeam | …) | Quién concretamente debe hacerlo. |
reasonCode |
0..* | CodeableConcept | Por qué, codificado. |
reasonReference |
0..* | Reference(Condition | Observation | DiagnosticReport | DocumentReference) | Por qué, como referencia a una Condition, Observation o informe. |
supportingInfo |
0..* | Reference(Resource) | Información adicional para quien lo hará. |
specimen |
0..* | Reference(Specimen) | Las muestras, si ya se tomaron. |
bodySite |
0..* | CodeableConcept | En qué parte del cuerpo. |
note |
0..* | Annotation | Notas para quien lo hará. |
doNotPerform y status son modificadores (⚑): una orden con
doNotPerform: true dice exactamente lo contrario que la misma orden sin él.
El ciclo de una orden:
ServiceRequest (ecografía, active) ──▶ se hace el estudio ──▶ DiagnosticReport.basedOn ──▶ orden
└──▶ la orden pasa a completed
Paso a paso: el consultorio¶
Paso 1 · El mínimo: nombre y estado¶
{
"resourceType": "Location",
"name": "Consultorio 3 de Medicina General",
"status": "active"
}
Paso 2 · Qué clase de lugar es¶
{
"mode": "instance",
"type": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"code": "FMC",
"display": "Family Medicine clinic"
}
],
"text": "Consulta de medicina general"
}
],
"physicalType": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
"code": "ro",
"display": "Room"
}
],
"text": "Sala"
}
}
mode: instance: es este consultorio, no "los consultorios" en general.
type usa la tabla v3-RoleCode (FMC, consulta de medicina familiar y
general) y physicalType, la tabla location-physical-type (ro, una
sala).
Paso 3 · Dónde está y quién lo administra¶
{
"address": {
"line": [
"Av. Principal Ejemplo S00-00"
],
"city": "Quito",
"state": "Pichincha",
"country": "EC"
},
"managingOrganization": {
"reference": "Organization/{{hospitalId}}",
"display": "Hospital General Docente Ejemplo"
},
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/ubicacion",
"value": "HGDE-CONS-03"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Consultorio 3 de Medicina General, planta baja del Hospital General Docente Ejemplo.</p></div>"
}
}
Solución: 10a_location_consultorio.json.
Paso a paso: el rol de la Dra. Salazar¶
Paso 1 · El mínimo: quién y dónde trabaja¶
{
"resourceType": "PractitionerRole",
"practitioner": {
"reference": "Practitioner/{{practitionerId}}",
"display": "Dra. Andrea Lucía Salazar Moreno"
},
"organization": {
"reference": "Organization/{{hospitalId}}",
"display": "Hospital General Docente Ejemplo"
}
}
Paso 2 · Qué rol y qué especialidad¶
{
"code": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/practitioner-role",
"code": "doctor",
"display": "Doctor"
}
],
"text": "Médica"
}
],
"specialty": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394814009",
"display": "General practice (specialty)"
}
],
"text": "Medicina general"
}
]
}
code dice el rol (doctor) y specialty, la especialidad con SNOMED CT
(394814009, General practice).
Paso 3 · En qué consultorio y en qué horario¶
{
"active": true,
"location": [
{
"reference": "Location/{{officeLocationId}}",
"display": "Consultorio 3 de Medicina General"
}
],
"availableTime": [
{
"daysOfWeek": [
"mon",
"tue",
"wed",
"thu",
"fri"
],
"availableStartTime": "07:00:00",
"availableEndTime": "13:00:00"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Dra. Andrea Lucía Salazar Moreno: médica general en el Hospital General Docente Ejemplo,</p><p>consultorio 3, de lunes a viernes de 07:00 a 13:00.</p></div>"
}
}
availableTime: de lunes a viernes (daysOfWeek) de 07:00 a 13:00. Solución:
10b_practitionerrole_medica_general.json.
El oncólogo. Se crea su Practitioner
(10c), igual que el de la
médica en el módulo 04, y su rol. Lo que cambia respecto del rol de la Dra.
Salazar:
{
"practitioner": {
"reference": "Practitioner/{{oncologistId}}",
"display": "Dr. Esteban Patricio Ruiz Montalvo"
},
"code": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/practitioner-role",
"code": "doctor",
"display": "Doctor"
}
],
"text": "Médico"
}
],
"specialty": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394593009",
"display": "Medical oncology"
}
],
"text": "Oncología clínica"
}
]
}
La consulta por el nódulo¶
Es un Encounter como el del módulo 05. Lo que cambia:
{
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/encuentro",
"value": "ENC-2025-0003"
}
],
"participant": [
{
"type": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
"code": "ATND",
"display": "attender"
}
]
}
],
"individual": {
"reference": "PractitionerRole/{{salazarRoleId}}",
"display": "Dra. Salazar · Medicina general"
}
}
],
"period": {
"start": "2025-04-22T08:00:00-05:00",
"end": "2025-04-22T08:30:00-05:00"
},
"reasonCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "89164003",
"display": "Breast lump"
}
],
"text": "Nódulo en la mama izquierda"
}
],
"location": [
{
"location": {
"reference": "Location/{{officeLocationId}}",
"display": "Consultorio 3 de Medicina General"
}
}
]
}
Dos novedades: participant.individual apunta al rol de la médica, no a
la persona, y location dice en qué consultorio fue. Solución:
10e_encounter_consulta_nodulo.json.
Paso a paso: la orden de ecografía¶
Paso 1 · El mínimo: estado, intención y paciente¶
{
"resourceType": "ServiceRequest",
"status": "completed",
"intent": "order",
"subject": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
}
}
status, intent y subject son obligatorios. intent: order dice que es
una orden firme. La creamos directamente como completed porque en el taller
el estudio ya se hizo; en un sistema real nacería active y pasaría a
completed al cumplirse.
Paso 2 · Qué se pide, con qué prioridad y de qué parte del cuerpo¶
{
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "363679005",
"display": "Imaging"
}
],
"text": "Imagenología"
}
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "47079000",
"display": "Ultrasonography of breast"
}
],
"text": "Ecografía de mama"
},
"priority": "urgent",
"bodySite": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "80248007",
"display": "Left breast structure"
}
],
"text": "Mama izquierda"
}
]
}
code con SNOMED CT (47079000, Ultrasonography of breast) y priority
es un code con cuatro valores posibles: routine, urgent, asap y
stat.
Paso 3 · Quién lo pide, cuándo, en qué consulta y por qué¶
{
"encounter": {
"reference": "Encounter/{{noduleEncounterId}}",
"display": "Consulta por nódulo mamario, 22 de abril de 2025"
},
"authoredOn": "2025-04-22T08:20:00-05:00",
"requester": {
"reference": "PractitionerRole/{{salazarRoleId}}",
"display": "Dra. Salazar · Medicina general"
},
"reasonCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "89164003",
"display": "Breast lump"
}
],
"text": "Nódulo palpable en la mama izquierda"
}
]
}
Paso 4 · Identificador y narrativa¶
{
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/orden",
"value": "ORD-2025-0101"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Orden: ecografía de mama izquierda, prioridad urgente.</p><p>Motivo: nódulo palpable de 2 cm en el cuadrante superior externo.</p></div>"
}
}
Solución: 10f_servicerequest_ecografia.json.
Paso a paso: el informe de la ecografía¶
Es un DiagnosticReport, como el de patología del módulo 11 (su ficha está
allí). Lo nuevo es basedOn: cierra el ciclo con la orden.
Paso 1 · El mínimo: estado y código¶
{
"resourceType": "DiagnosticReport",
"status": "final",
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "24601-7",
"display": "US Breast"
}
],
"text": "Ecografía de mama"
}
}
LOINC 24601-7, US Breast.
Paso 2 · De quién, cuándo y quién informa¶
{
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0074",
"code": "RAD",
"display": "Radiology"
}
],
"text": "Imagenología"
}
],
"subject": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
},
"effectiveDateTime": "2025-04-25T10:00:00-05:00",
"issued": "2025-04-25T12:00:00-05:00",
"performer": [
{
"reference": "Organization/{{hospitalId}}",
"display": "Hospital General Docente Ejemplo"
}
]
}
category con RAD (Radiology) de la tabla v2-0074.
Paso 3 · A qué orden responde¶
{
"basedOn": [
{
"reference": "ServiceRequest/{{ultrasoundRequestId}}",
"display": "Orden de ecografía de mama"
}
]
}
Paso 4 · La conclusión: BI-RADS 4¶
{
"conclusion": "Nódulo sólido de bordes irregulares de 2,4 cm en el cuadrante superior externo de la mama izquierda. BI-RADS 4: sospechoso. Se recomienda biopsia.",
"conclusionCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "89164003",
"display": "Breast lump"
}
],
"text": "Nódulo mamario sospechoso"
}
],
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/informe",
"value": "INF-IMG-2025-0212"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Ecografía de mama izquierda (25 de abril de 2025): nódulo sólido, irregular, de 2,4 cm, BI-RADS 4.</p><p>Se recomienda biopsia.</p></div>"
}
}
BI-RADS es la clasificación de los estudios de mama: 4 significa
"sospechoso", con indicación de biopsia. Solución:
10g_diagnosticreport_ecografia.json.
La orden de biopsia y la derivación¶
Las dos se construyen como la orden de ecografía. Lo que cambia en la
biopsia (10h):
{
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/orden",
"value": "ORD-2025-0102"
}
],
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "108252007",
"display": "Laboratory procedure"
}
],
"text": "Procedimiento de laboratorio"
}
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "122548005",
"display": "Biopsy of breast"
}
],
"text": "Biopsia de mama"
},
"authoredOn": "2025-04-28T09:00:00-05:00",
"reasonReference": [
{
"reference": "DiagnosticReport/{{ultrasoundReportId}}",
"display": "Ecografía BI-RADS 4"
}
]
}
Su motivo (reasonReference) es el informe de la ecografía: el BI-RADS 4
justifica la biopsia. En el módulo 11, la muestra (Specimen.request) y el
informe de patología (DiagnosticReport.basedOn) apuntarán a esta orden.
Lo que cambia en la derivación (10i):
{
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/orden",
"value": "ORD-2025-0103"
}
],
"status": "active",
"category": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "3457005",
"display": "Patient referral"
}
],
"text": "Derivación"
}
],
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "3457005",
"display": "Patient referral"
}
],
"text": "Derivación a Oncología Clínica"
},
"authoredOn": "2025-04-28T09:05:00-05:00",
"performerType": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "394593009",
"display": "Medical oncology"
}
],
"text": "Oncología clínica"
},
"performer": [
{
"reference": "PractitionerRole/{{oncologistRoleId}}",
"display": "Dr. Ruiz · Oncología clínica"
}
],
"reasonReference": [
{
"reference": "DiagnosticReport/{{ultrasoundReportId}}",
"display": "Ecografía BI-RADS 4"
}
],
"supportingInfo": [
{
"reference": "FamilyMemberHistory/{{motherHistoryId}}",
"display": "Madre con cáncer de mama a los 52 años"
}
],
"note": [
{
"text": "Paciente varón de 46 años con nódulo sospechoso y madre con cáncer de mama. Se solicita valoración prioritaria."
}
]
}
categoryycodeSNOMED3457005, Patient referral.performerTypedice a qué servicio se deriva (oncología clínica) yperformer, a quién concretamente: al rol del Dr. Ruiz.supportingInfoapunta al antecedente familiar del módulo 07: el oncólogo lo verá sin buscarlo.status: active: la derivación sigue abierta hasta que el oncólogo atienda a Luis.
Ejercicios en el servidor¶
| Paso | Petición | Guarda |
|---|---|---|
| 10a | POST /Location |
officeLocationId |
| 10b | POST /PractitionerRole (médica general) |
salazarRoleId |
| 10c | POST /Practitioner (oncólogo) |
oncologistId |
| 10d | POST /PractitionerRole (oncólogo) |
oncologistRoleId |
| 10e | POST /Encounter |
noduleEncounterId |
| 10f | POST /ServiceRequest (ecografía) |
ultrasoundRequestId |
| 10g | POST /DiagnosticReport (ecografía) |
ultrasoundReportId |
| 10h | POST /ServiceRequest (biopsia) |
biopsyRequestId |
| 10i | POST /ServiceRequest (derivación) |
referralId |
10j · Las órdenes del paciente¶
GET {{FHIRURL}}/ServiceRequest?subject=Patient/{{patientId}}&_sort=authored
Devuelve las tres órdenes en orden cronológico: ecografía, biopsia y derivación.
10k · ¿Qué se hizo con cada orden? _revinclude¶
GET {{FHIRURL}}/ServiceRequest?subject=Patient/{{patientId}}&_revinclude=DiagnosticReport:based-on
_include (módulo 05) trae los recursos a los que apuntan los
resultados. _revinclude hace lo contrario: trae los recursos que apuntan
a los resultados. Aquí, los informes cuyo basedOn es alguna de las
órdenes. Verás las tres órdenes (search.mode: match) y dos informes
(include): el de la ecografía y, cuando hagas el módulo 11, el de
patología. La derivación no tiene informe: todavía está abierta.
10l · Los oncólogos del hospital¶
GET {{FHIRURL}}/PractitionerRole?specialty=http://snomed.info/sct|394593009&_include=PractitionerRole:practitioner
Busca roles por especialidad e incluye a la persona de cada rol. Es la búsqueda que haría un sistema para elegir a quién derivar.
10m · Error a propósito: la prioridad en español¶
Envía (10e1_prioridad_en_espanol.json)
una orden con "priority": "urgente". El servidor responde 400:
HAPI-1821: [element="priority"] Invalid attribute value "urgente": Unknown ServiceRequestPriority code 'urgente'
Para pensar¶
Una derivación en papel suele perderse: no se sabe si el paciente llegó, ni
qué dijo el especialista. Con FHIR, la derivación es un recurso con estado.
¿Qué búsqueda usarías para listar las derivaciones a oncología que llevan más
de 15 días en estado active? (Pista: combina status, performer o
category, y authored con el prefijo lt, "menor que".)
Autoevaluación¶
1. ¿Practitioner o PractitionerRole en ServiceRequest.requester?
Mejor PractitionerRole: dice quién pide la orden, con qué rol y en qué organización. Los dos están permitidos.
2. ¿Cómo sabe el sistema que el informe de la ecografía cumple esa orden?
Porque el DiagnosticReport tiene basedOn apuntando a la ServiceRequest. Con
_revinclude=DiagnosticReport:based-on se recupera desde la orden.
3. ¿Qué diferencia hay entre performerType y performer?
performerType dice qué tipo de profesional o servicio debe atender
(oncología clínica); performer, quién concretamente (el rol del Dr.
Ruiz). Se puede indicar solo el tipo y dejar que el servicio asigne a la
persona.
Resumen¶
- Location es el lugar; PractitionerRole, el profesional en un puesto.
- ServiceRequest pide un servicio: estudio, procedimiento o derivación.
- Los resultados apuntan a la orden con
basedOn(orequesten Specimen). _revincludetrae los recursos que apuntan a los resultados de la búsqueda.
Ejecutar este módulo¶
- Postman: carpeta 10 · Órdenes y derivación.
- curl:
curl/taller.sh 10 - R:
ordenes <- fhir_buscar("ServiceRequest?subject=Patient/{{patientId}}&_revinclude=DiagnosticReport:based-on")
fhir_tabla(ordenes, list(
tipo = function(r) r$resourceType,
que = function(r) r$code$text,
estado = function(r) r$status
))