Módulo 13 · Procedimientos¶
← Módulo 12 · Inicio · Módulo 14 →
Nivel: intermedio · Duración: 40 minutos · Necesitas: módulos 11 y 12
Lo que vas a aprender¶
- Qué es Procedure y qué lo diferencia de una orden.
- A enlazar un procedimiento con su motivo (
reasonReference). - A completar el registro con el resultado y el seguimiento.
La historia¶
El 10 de junio de 2025, a las 08:00, se realiza la mastectomía parcial de la mama izquierda que acordó el comité de tumores (módulo 12) y que Luis autorizó con su consentimiento informado. Al terminar se registra el procedimiento. Después se agrega el resultado: exitoso, con márgenes quirúrgicos libres de tumor, y el seguimiento: control de la herida en dos semanas y valoración por oncología.
Ficha del recurso: Procedure¶
¿Qué es? Algo que se hizo al paciente, o por el paciente: una cirugía, una curación, la colocación de un catéter, una sesión de fisioterapia, una consejería.
¿Para qué se usa? Para la historia quirúrgica y de intervenciones, y para la estadística de producción (cirugías realizadas).
¿Cuándo usar otro recurso?
| Si es... | Usa |
|---|---|
| Algo que se pide hacer y aún no se hace | ServiceRequest (módulo 10) |
| Un medicamento administrado | MedicationAdministration (módulo 15) |
| Una vacuna aplicada | Immunization (módulo 08) |
| Una medición (la presión arterial) | Observation (módulo 06) |
Elementos principales (https://hl7.org/fhir/R4/procedure.html):
| Elemento | Card. | Tipo | Para qué sirve |
|---|---|---|---|
identifier |
0..* | Identifier | Identificador del procedimiento. |
basedOn |
0..* | Reference(CarePlan | ServiceRequest) | La orden que lo pidió. |
partOf |
0..* | Reference(Procedure | Observation | MedicationAdministration) | El procedimiento mayor del que forma parte. |
status ⚑ |
1..1 | code | preparation, in-progress, not-done, on-hold, stopped, completed... |
statusReason |
0..1 | CodeableConcept | Por qué no se hizo o se detuvo. |
category |
0..1 | CodeableConcept | Clase: quirúrgico, diagnóstico, terapéutico. |
code |
0..1 | CodeableConcept | Qué se hizo. |
subject |
1..1 | Reference(Patient | Group) | A quién. |
encounter |
0..1 | Reference(Encounter) | En qué atención. |
performed[x] |
0..1 | dateTime | Period | string | Age | … | Cuándo. |
recorder |
0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole) | Quién lo registró. |
asserter |
0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole) | Quién lo informa. |
performer |
0..* | BackboneElement | Quiénes lo hicieron. |
performer.function |
0..1 | CodeableConcept | Con qué rol: cirujano, anestesiólogo. |
performer.actor |
1..1 | Reference(Practitioner | PractitionerRole | Organization | Patient | …) | La persona. |
performer.onBehalfOf |
0..1 | Reference(Organization) | En nombre de qué organización. |
location |
0..1 | Reference(Location) | Dónde: el quirófano. |
reasonCode |
0..* | CodeableConcept | Por qué, codificado. |
reasonReference |
0..* | Reference(Condition | Observation | Procedure | DiagnosticReport | …) | Por qué, como referencia a una Condition. |
bodySite |
0..* | CodeableConcept | En qué parte del cuerpo. |
outcome |
0..1 | CodeableConcept | El resultado. |
report |
0..* | Reference(DiagnosticReport | DocumentReference | Composition) | Informes del procedimiento. |
complication |
0..* | CodeableConcept | Complicaciones. |
followUp |
0..* | CodeableConcept | Indicaciones de seguimiento. |
note |
0..* | Annotation | Notas. |
Paso a paso: la cirugía¶
Paso 1 · El mínimo: estado y paciente¶
{
"resourceType": "Procedure",
"status": "completed",
"subject": {
"reference": "Patient/{{patientId}}",
"display": "Luis Alberto Paredes Cevallos"
}
}
Paso 2 · Qué se hizo y en qué parte del cuerpo¶
{
"category": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "387713003",
"display": "Surgical procedure"
}
],
"text": "Procedimiento quirúrgico"
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "64368001",
"display": "Partial mastectomy"
}
],
"text": "Mastectomía parcial"
},
"bodySite": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "80248007",
"display": "Left breast structure"
}
],
"text": "Mama izquierda"
}
]
}
category SNOMED 387713003 Surgical procedure y code SNOMED 64368001
Partial mastectomy.
Paso 3 · Cuándo, quién, por qué y según qué plan¶
{
"performedDateTime": "2025-06-10T08:00:00-05:00",
"recorder": {
"reference": "Practitioner/{{practitionerId}}",
"display": "Dra. Andrea Lucía Salazar Moreno"
},
"performer": [
{
"actor": {
"reference": "Practitioner/{{practitionerId}}",
"display": "Dra. Andrea Lucía Salazar Moreno"
},
"onBehalfOf": {
"reference": "Organization/{{hospitalId}}",
"display": "Hospital General Docente Ejemplo"
}
}
],
"reasonReference": [
{
"reference": "Condition/{{conditionCancerId}}",
"display": "Carcinoma ductal infiltrante de mama izquierda"
}
],
"basedOn": [
{
"reference": "CarePlan/{{carePlanId}}",
"display": "Plan de tratamiento del cáncer de mama"
}
]
}
performer.onBehalfOf: la cirujana opera en nombre del hospital.
reasonReference apunta al diagnóstico de cáncer del módulo 11: la cirugía
tiene un motivo verificable. basedOn apunta al plan del comité (módulo 12):
la cirugía es la primera actividad de ese plan.
Paso 4 · Identificador y narrativa¶
{
"identifier": [
{
"system": "https://f-slg.github.io/aprende-fhir/sid/procedimiento",
"value": "PROC-2025-0001"
}
],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Mastectomía parcial de mama izquierda, 10 de junio de 2025.</p></div>"
}
}
Solución: 13a_procedure_mastectomia.json.
El resultado y el seguimiento¶
Con PUT se agrega lo que se supo después. Lo que cambia:
{
"id": "{{procedureId}}",
"outcome": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "385669000",
"display": "Successful"
}
],
"text": "Exitoso"
},
"followUp": [
{
"text": "Control de herida quirúrgica en 2 semanas y valoración por oncología."
}
],
"note": [
{
"text": "Márgenes quirúrgicos libres de tumor."
}
]
}
outcome SNOMED 385669000 Successful. Solución:
13b_procedure_actualizar.json.
Ejercicios en el servidor¶
POST {{FHIRURL}}/Procedure → procedureId
PUT {{FHIRURL}}/Procedure/{{procedureId}}
Reto · Los procedimientos por diagnóstico¶
Busca todos los procedimientos realizados por el cáncer de mama de Luis:
GET {{FHIRURL}}/Procedure?subject=Patient/{{patientId}}&reason-reference=Condition/{{conditionCancerId}}
Para pensar¶
En el caso, la cirujana es la misma médica de la consulta. En la realidad
operaría un equipo: cirujano, ayudante, anestesiólogo e instrumentista. ¿Cómo
lo registrarías? (Pista: performer es una lista, y performer.function
dice el rol de cada uno.)
Autoevaluación¶
1. El cirujano pide una mastectomía para la próxima semana. ¿Procedure?
No: todavía no se hizo. Es una ServiceRequest. Cuando se realice, se
registra el Procedure, que puede apuntar a la orden con basedOn.
2. ¿Para qué sirve reasonReference si ya hay un code?
code dice qué se hizo; reasonReference, por qué, apuntando al
diagnóstico concreto del paciente. Permite responder "¿qué procedimientos se
hicieron por este cáncer?".
Resumen¶
- Procedure registra algo que se hizo; una orden es una ServiceRequest.
reasonReferenceenlaza el procedimiento con su diagnóstico.outcome,followUpycomplicationcompletan el registro.
Ejecutar este módulo¶
- Postman: carpeta 13 · Procedimientos.
- curl:
curl/taller.sh 13 - R:
dir <- "modulos/13-procedimientos/soluciones/"
fhir_crear("Procedure", paste0(dir, "13a_procedure_mastectomia.json"), guarda = "procedureId")
fhir_actualizar("Procedure/{{procedureId}}", paste0(dir, "13b_procedure_actualizar.json"))$outcome$text