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

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

Operaciones Gestion Farmaceutica

Gestión Farmacéutica - Guía de Implementación FHIR® RDA

Bienvenido a la sección de Gestión Farmacéutica de la Guía de Implementación FHIR RDA (CO). Esta sección define los lineamientos funcionales y técnicos para la interoperabilidad de los procesos asociados a la prescripción, direccionamiento, programación y dispensación de medicamentos en el marco de la Interoperabilidad de la Historia Clínica Electrónica (IHCE), utilizando el estándar HL7® FHIR® R4.

La interoperabilidad de la gestión farmacéutica permite el intercambio seguro, oportuno y trazable de la información relacionada con el suministro de medicamentos financiados con recursos de la Unidad de Pago por Capitación (UPC), prescritos en el ámbito ambulatorio.

La presente guía está alineada con:

  • Ley 2015 de 2020.
  • Resolución 866 de 2021.
  • Resolución 1888 de 2025.
  • Modelo de Interoperabilidad de Historia Clínica Electrónica – IHCE.

Objetivo

Definir los perfiles FHIR, operaciones interoperables y lineamientos de implementación requeridos para soportar el ciclo interoperable de gestión farmacéutica en Colombia, garantizando:

  • Continuidad de la atención.
  • Trazabilidad integral del suministro de medicamentos.
  • Intercambio seguro y estandarizado de información.
  • Integración entre IPS, EAPB, gestores farmacéuticos y puntos de dispensación.
  • Disponibilidad de información clínica y administrativa relevante.

Alcance funcional

La gestión farmacéutica interoperable comprende las siguientes transacciones:

  1. Consulta de prescripciones.
  2. Direccionamiento.
  3. Programación.
  4. Dispensación.
  5. Consulta de dispensación.

Cada una de estas transacciones se implementa mediante estructuras interoperables basadas en recursos HL7 FHIR.

Arquitectura interoperable

La arquitectura de interoperabilidad de gestión farmacéutica hace parte del ecosistema IHCE definido por el Ministerio de Salud y Protección Social.

El intercambio de información utiliza:

  • API RESTful FHIR.
  • Recursos HL7 FHIR R4.
  • Operaciones personalizadas.
  • API Gateway.
  • Autenticación mediante API Key y certificados digitales.
  • Trazabilidad y auditoría.

Perfiles requeridos

Prescripción

Perfil basado en MedicationRequest.

Perfil:

Direccionamiento

Perfil basado en MedicationRequest.

Perfil:

  • MedicationRequestAddressing

Representa la asociación entre una prescripción y el gestor farmacéutico, proveedor, operador logístico o punto de dispensación responsable.

Programación

Perfil basado en MedicationRequest.

Perfil:

  • MedicationRequestScheduling

Representa las condiciones operativas definidas para la entrega o dispensación.

Dispensación

Perfil basado en MedicationDispense.

Perfil:

  • MedicationDispenseRDA

Representa el suministro efectivo, parcial o no efectivo de medicamentos.

Perfiles adicionales

Gestor Farmacéutico

Perfil sobre:

  • Organization

Punto de dispensación

Perfil sobre:

  • Location

Flujos interoperables

Consulta de prescripciones

Permite a las EAPB consultar las prescripciones interoperadas mediante los RDA.

Direccionamiento

Permite asociar el responsable del suministro de medicamentos.

Programación

Permite definir las condiciones operativas de entrega.

Dispensación

Permite registrar el resultado efectivo o parcial del suministro.

Participantes

Los principales participantes del modelo interoperable de gestión farmacéutica son:

  • Prestadores de Servicios de Salud (IPS).
  • Entidades Promotoras de Salud (EAPB).
  • Gestores farmacéuticos.
  • Operadores logísticos.
  • Puntos de dispensación.
  • Ministerio de Salud y Protección Social.

Seguridad

Los servicios interoperables deben implementar:

  • HTTPS/TLS.
  • API Gateway.
  • API Key.
  • Auditoría.
  • Trazabilidad.
  • Control de acceso basado en roles (RBAC).
  • Validación de referencias nacionales.

Referencias

  • HL7 FHIR R4.
  • Resolución 1888 de 2025.
  • Resolución 866 de 2021.
  • Ley 2015 de 2020.
  • Modelo IHCE Colombia.

Operaciones FHIR – Gestión Farmacéutica

¿Qué son las operaciones en FHIR?

FHIR define un conjunto de operaciones que permiten ejecutar funcionalidades especializadas sobre recursos interoperables.

Estas operaciones complementan el modelo RESTful tradicional y permiten implementar reglas de negocio complejas necesarias para los procesos de gestión farmacéutica interoperable.

Las operaciones pueden ejecutarse mediante:

[base]/$[operacion]
[base]/[resource]/$[operacion]
[base]/[resource]/[id]/$[operacion]

Operaciones en Gestión Farmacéutica

La gestión farmacéutica interoperable implementa operaciones para:

  • Consulta de prescripciones.
  • Direccionamiento.
  • Programación.
  • Dispensación.
  • Resolución de referencias.
  • Consulta de RDA.

Estas operaciones permiten garantizar la continuidad del proceso de suministro de medicamentos y la trazabilidad integral de cada transacción.


CONSULTA DE PRESCRIPCIONES

Listar RDA por EAPB

Permite consultar los RDA que contienen prescripciones asociadas a una EAPB.

Operación

POST /Composition/$consultar-rda-con-prescripcion-eapb

Capacidades requeridas

  • Filtro por rango de fechas.
  • Filtro por paciente.
  • Filtro por lastUpdated.
  • Filtro obligatorio por EAPB.
  • Filtro por IPS.

Resultado esperado

  • Bundle con recursos Composition.

Consultar documento RDA

Permite obtener el documento RDA completo con todos los recursos relacionados.

Operación

GET /Composition/{id}/$document*

Resultado esperado

  • Bundle con recursos relacionados.

DIRECCIONAMIENTO

Enviar direccionamiento

Permite registrar el direccionamiento de una prescripción hacia un gestor farmacéutico o punto de dispensación.

Operación

POST /MedicationRequest/$enviar-direccionamiento

Validaciones

  • Validar que el token corresponda a la organización que direcciona.
  • Resolver referencias mediante identifier:

    • EAPB.
    • REPS.
    • RETHUS.
    • Gestor farmacéutico.
  • Validar estados.
  • Crear MedicationRequestDireccionamiento.

Resultado esperado

  • MedicationRequestDireccionamiento.

Anular direccionamiento

Permite anular un direccionamiento previamente registrado.

Operación

PUT /MedicationRequest/{id-request-direccionamiento}/$anular-direccionamiento

Validaciones

  • Verificar token de la organización.
  • Resolver referencias mediante identifier.
  • Validar estados.
  • Actualizar MedicationRequestDireccionamiento.

PROGRAMACIÓN

Consultar direccionamientos por gestor farmacéutico

Permite consultar direccionamientos asociados a un gestor farmacéutico.

Operación

POST /MedicationRequest/$consultar-direcccionamiento-gf

Capacidades requeridas

  • Filtro por rango de fechas.
  • Filtro por paciente.
  • Filtro por lastUpdated.
  • Filtro obligatorio por gestor farmacéutico.

Resultado esperado

  • Bundle con recursos MedicationRequestDireccionamiento.

Resolver referencias

Permite recuperar todos los recursos relacionados a un direccionamiento.

Operación

GET /MedicationRequest/{id}/$everything

Resultado esperado

  • Bundle con recursos relacionados.

Enviar programación

Permite registrar la programación operativa de entrega o dispensación.

Operación

POST /MedicationRequest/$enviar-programacion

Validaciones

  • Verificar si existe un MedicationRequestScheduling asociado.
  • Validar número de entrega.
  • Validar token del gestor farmacéutico.
  • Resolver referencias mediante identifier.
  • Validar estados.
  • Crear MedicationRequestScheduling.

Resultado esperado

  • MedicationRequestScheduling.

Modificar programación

Permite modificar una programación previamente registrada.

Operación

PUT /MedicationRequest/{id-dispense-programado}/$anular-programacion

Validaciones

  • Validar token.
  • Resolver referencias.
  • Validar estados.
  • Modificar programación.

DISPENSACIÓN

Consultar programaciones por gestor farmacéutico

Permite consultar programaciones registradas.

Operación

POST /MedicationRequest/$consultar-programacion-gf

Capacidades requeridas

  • Filtro por rango de fechas.
  • Filtro por paciente.
  • Filtro por lastUpdated.
  • Filtro obligatorio por gestor farmacéutico.

Resultado esperado

  • Bundle con recursos MedicationRequestProgramacion.

Resolver referencias de programación

Operación

GET /MedicationRequest/{id-programado}/$everything

Resultado esperado

  • Bundle con recursos relacionados.

Enviar dispensación

Permite registrar la entrega efectiva, parcial o no efectiva de medicamentos.

Operación

POST /MedicationDispense/$enviar-dispensacion

Validaciones

  • Verificar si existe un MedicationDispenseRDA asociado.
  • Validar número de entrega.
  • Validar token del gestor farmacéutico.
  • Resolver referencias mediante identifier.
  • Validar estados.
  • Crear MedicationDispenseRDA.
  • Generar identificador aleatorio.

Resultado esperado

  • MedicationDispenseRDA.

Modificar dispensación

Permite actualizar una dispensación previamente registrada.

Operación

PUT /MedicationDispense/{id-dispense-dispensado}/$anular-dispensacion

Validaciones

  • Validar token.
  • Resolver referencias.
  • Validar estados.
  • Modificar dispensación.

CONSULTA DE DISPENSACIÓN

Consultar dispensaciones por gestor farmacéutico

Operación

POST /MedicationDispense/$consultar-dispensacion-gf

Capacidades requeridas

  • Filtro por rango de fechas.
  • Filtro por paciente.
  • Filtro por lastUpdated.
  • Filtro obligatorio por gestor farmacéutico.

Resultado esperado

  • Bundle con recursos MedicationDispenseRDA.

Resolver referencias de dispensación

Operación

GET /MedicationDispense/{id-dispensación}/$everything

Resultado esperado

  • Bundle con recursos relacionados.

Consulta de dispensación por EAPB

Permite consultar el estado de suministro y dispensación asociado a las prescripciones gestionadas por la EAPB.


Recomendaciones técnicas

  • Usar Content-Type: application/fhir+json.
  • Implementar HTTPS/TLS.
  • Usar autenticación mediante API Key.
  • Implementar trazabilidad y auditoría.
  • Representar parámetros complejos mediante Parameters.
  • Implementar paginación.
  • Implementar validación semántica y sintáctica.