Resumen Digital de Atención en Salud (RDA)
0.7.2 - STU1 Colombia

Resumen Digital de Atención en Salud (RDA) - Local Development build (v0.7.2) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Operaciones

Operaciones FHIR RDA

¿Qué son las Operaciones en FHIR?

FHIR define un conjunto de operaciones que van más allá del modelo clásico CRUD (Crear, Leer, Actualizar, Eliminar). Estas operaciones permiten ejecutar funciones especializadas sobre uno o más recursos, y se exponen a través de la API RESTful bajo rutas definidas como:

[base]/$[nombre-operacion]
[base]/[tipo-recurso]/$[nombre-operacion]
[base]/[tipo-recurso]/[id]/$[nombre-operacion]

Estas operaciones se utilizan cuando:

  • El comportamiento no puede expresarse adecuadamente con los métodos REST estándar.
  • Se necesita ejecutar una acción compleja, con lógica de negocio específica.
  • Se requiere una salida o entrada personalizada.
  • Se requiere una interacción que implique múltiples recursos o procesamiento intensivo.

Operaciones personalizadas

Además de las operaciones estándar, para el escenario RDA se han definido operaciones personalizadas para simplificar los procesos de consulta, recepción y validación de información.

Cada operación puede aceptar parámetros de entrada y devolver un recurso de salida (usualmente Parameters, Bundle u otros recursos FHIR).

Documentación oficial: 3.2.0 Extended Operations on the RESTful API

Uso de Operaciones en el escenario RDA (Resumen Digital de Atención en Salud)

En un entorno de interoperabilidad basado en FHIR como un RDA, las operaciones permiten encapsular reglas de negocio complejas y facilitar consultas específicas a través de un patrón más controlado y estandarizado.

A continuación se describen las principales operaciones utilizadas en este escenario:

Consultar Paciente Similar

Esta operación permite recuperar el recurso Patient a partir de criterios de búsqueda como número de documento, tipo de documento o nombres completos.

  • Parámetros de entrada: recurso Parameters en formato JSON.
  • Resultado esperado: recurso Patient (si hay coincidencia única).
consultar-paciente

Consultar Organización (IPS)

Esta operación permite recuperar la información de una organización habilitada (recurso Organization) y sus sedes (recursos Location asociados), a partir de datos como el número de habilitación y el NIT.

  • Parámetros de entrada: número de habilitación, NIT.
  • Resultado esperado: recursos Organization y Location.
consultar-organizacion

Consultar Profesional de Salud

Esta operación retorna la información de un profesional de salud, modelado como recurso Practitioner o PractitionerRole, a partir de datos como número de identificación y nombres exactos.

  • Parámetros de entrada: tipo y número de documento, nombre(s).
  • Resultado esperado: recurso Practitioner, posiblemente enlazado con PractitionerRole.
consultar-profesional-salud

Consultar RDAs del Paciente

Esta operación permite buscar y recuperar todos los Resúmenes Digitales de Atención (RDA) (recurso Composition) a partir de datos como tipo y número de identificación de un paciente específico.

  • Parámetros de entrada: tipo y número de documento del paciente.
  • Resultado esperado: Bundle con recursos como Composition.
consultar-rda-paciente

Consultar información de un RDA

Esta operación retorna el conjunto completo de recursos referenciados de un Resumen Digital de Atención (RDA) (recurso Composition) específico.

  • Parámetros de entrada: id del recurso Composition.
  • Resultado esperado: Bundle con recursos como Composition, Observation, Encounter, MedicationStatement, etc. .
operacion-document

Consultar Codificación

Esta operación permite obtener la definición completa de un sistema de códigos específico (recurso CodeSystem).

  • Parámetros de entrada: id/nombre del CodeSystem.
  • Resultado esperado: CodeSystem.
consultar-codificacion

Validar Codificación

Esta operación verifica si un código específico es válido dentro de un sistema de códigos determinado.

  • Parámetros de entrada: id/nombre del CodeSystem y código.
  • Resultado esperado: Parameters.
consultar-validate-code

Lookup Codificación

Esta operación permite buscar y obtener información detallada sobre un código específico dentro de la terminología.

  • Parámetros de entrada: recurso Parameters en formato JSON.
  • Resultado esperado: Parameters.
consultar-lookup

Consultar Inmunización

Esta operación permite recuperar el historial de inmunizaciones (vacunación) de un paciente específico.

Definición de la operación Consultar Inmunizacion.

  • Parámetros de entrada: recurso Parameters en formato JSON.
  • Resultado esperado: Bundle con recursos tipo Immunization y Patient.
consultar-inmunizacion

Consultar Paciente exacto

Esta operación permite buscar de forma exacta un paciente.

  • Parámetros de entrada: recurso Parameters en formato JSON.
  • Resultado esperado: Recurso tipo Patient.
consultar-paciente-exacto

Enviar Nota Aclaratoria

Esta operación permite enviar una nota aclaratoria referenciando un RDA previamente reportado.

  • Parámetros de entrada: recurso Observation con la nota aclaratoria.
  • Resultado esperado: Bundle RDA actualizado con la sección de notas aclaratorias.
enviar-nota

Recomendaciones técnicas

  • Las operaciones deben seguir la semántica de GET o POST y usar Content-Type: application/fhir+json.
  • Todos los parámetros deben estar representados como recursos FHIR Parameters, incluyendo cada parámetro como un elemento parameter.name y su valor (valueString, valueIdentifier, etc.).
  • La definición formal de cada operación personalizada debería incluirse como archivos .xml o .json en input/operations/ si se desea documentar en la IG.

Referencias