Bienvenida
Introducción
Todos los días, miles de profesionales de la salud formulan medicamentos para los pacientes en Colombia — pero durante años el país no pudo saber con certeza si esos medicamentos realmente llegaban a quien los necesitaba.
Fortalece la trazabilidad del ciclo de suministro de medicamentos financiados con la UPC (Unidad de Pago por Capitación), permitiendo conocer, de forma estructurada, cada etapa desde la fórmula hasta la entrega efectiva al paciente.
En este recorrido conocerá por qué fue necesario este modelo, su fundamento normativo, cómo funciona y qué papel desempeña cada actor.
Use las flechas ‹ › o las teclas ← y → para avanzar. Hay 50 secciones organizadas en cinco partes.
Cómo está organizada
El recorrido que vamos a hacer
Para no perdernos, dividimos todo en cinco partes que van de lo más simple a lo más concreto:
APor qué integrar la Gestión FarmacéuticaEl problema que resuelve y su fundamento normativo.
BEl reporte del ciclo de Gestión FarmacéuticaLos cuatro momentos, quiénes participan y un caso de ejemplo.
CLa información estandarizadaRDA, FHIR, terminologías, IUM/CUM y seguridad.
DFHIR e InteroperabilidadLos recursos y operaciones de cada paso.
ECierre, repaso y tallerGlosario, preguntas frecuentes, prueba y taller práctico.
Parte A · La idea central
¿Qué es la Gestión Farmacéutica en IHCE?
Es el intercambio seguro, oportuno y estandarizado de la información asociada al ciclo de suministro de medicamentos financiados con recursos de la Unidad de Pago por Capitación (UPC).
El proceso comprende el reporte posterior de cuatro momentos principales:
1. Prescripción
2. Direccionamiento
3. Programación
4. Dispensación
Este intercambio permite integrar la información generada durante las diferentes etapas dentro de IHCE y reconstruir el ciclo completo de gestión farmacéutica y generar información útil para el monitoreo, la planeación y la toma de decisiones del sistema de salud.
Mensaje clave
La Gestión Farmacéutica no crea un nuevo proceso asistencial; integra e intercambia la información del proceso que ya realizan los actores del sistema.
Parte A · Un detalle importante
¿Qué medicamentos deben ser reportados?
Se reportan todos los medicamentos financiados con recursos de la UPC (Unidad de Pago por Capitación), conforme al catálogo de medicamentos definido en la Resolución 2764 de 2025 (o la que la modifique o sustituya).
¿Qué es la UPC?
Es el dinero que el sistema destina, por cada persona afiliada, para cubrir sus servicios y tecnologías de salud. Los medicamentos pagados con esos recursos son los que entran en este proceso.
Ojo
No todos se deben reportar en la gestión farmacéutica en IHCE.
Toque cada tarjeta para ver el detalle de qué sí y qué no entra en este proceso.
Los medicamentos prescritos en Consulta Externa, Urgencias y Hospitalización, financiados con recursos de la UPC.
Medicamentos no financiados con UPC, los usos aprobados por la Lista UNIRS, y los antirretrovirales para VIH (que tienen un mecanismo especial de monitoreo). Estos siguen prescribiéndose por MIPRES, de conformidad con la normativa vigente.
Parte A · El problema que resuelve
¿Por qué fue necesario crear este modelo?
Colombia cuenta con información de compra, factura, entrega, gasto y consumo de medicamentos, sin embargo ¿Los medicamentos que se entregan, corresponden realmente a las necesidades de los pacientes?
El problema real:
No era posible conocer la demanda real de medicamentos ni contrastarla con lo que efectivamente se entregaba.
La demanda real corresponde al conjunto de medicamentos que han sido prescritos por los profesionales de la salud para atender las necesidades clínicas de los pacientes. Conocerla y consolidarla a nivel nacional permite contrastar la necesidad identificada por el profesional tratante con el suministro realizado al usuario.
Mensaje clave
La demanda real no se estima a partir de los medicamentos entregados; se identifica desde la prescripción realizada por el profesional de la salud.
Parte A · El valor
¿Por qué es importante capturar esta información?
Reportar el ciclo completo de la Gestión Farmacéutica en IHCE fortalece la disponibilidad de información y permite transformarla en herramienta para la gestión del sistema de salud para:
Planear el abastecimiento con base en las necesidades reales de la población
Identificar barreras que afectan el acceso oportuno a los tratamientos
Hacer seguimiento a la oportunidad en la entrega de los medicamentos
Detectar desabastecimiento o riesgo de interrupción de tratamientos
Fortalecer la toma de decisiones basada en evidencia
Generar información para el seguimiento de autoridades sanitarias y organismos de IVC
Mensaje clave
La información interoperable permite tomar decisiones más oportunas para fortalecer el acceso efectivo a los medicamentos y la garantía del derecho a la salud.
Parte A · Ideas para recordar
Ideas para recordar
Para responder a los desafíos identificados, el Ministerio de Salud y Protección Social incorporó el proceso de Gestión Farmacéutica dentro de la Historia Clínica Electrónica Interoperable (IHCE).
Lo que no cambia
Este modelo no modifica la forma en que los profesionales prescriben medicamentos ni cambia la atención que reciben los usuarios. Su propósito es fortalecer el intercambio de información para reconstruir el ciclo completo de gestión farmacéutica y generar información útil para la gestión, el monitoreo y la toma de decisiones.
En los siguientes módulos conocerá cada una de las etapas de este proceso y el papel que desempeñan los diferentes actores.
Parte A · El respaldo legal
¿Por qué el Estado debe monitorear el acceso?
El monitoreo del acceso a los medicamentos es un deber del Estado, dentro de la garantía del derecho fundamental a la salud. La Ley Estatutaria 1751 de 2015 establece que corresponde al Estado adoptar las medidas necesarias para asegurar el acceso efectivo, oportuno y continuo a las tecnologías en salud.
La Corte Constitucional ha reiterado, mediante diferentes sentencias y autos de seguimiento, la importancia de contar con información suficiente para evaluar el funcionamiento del sistema, identificar barreras de acceso y verificar el cumplimiento de las órdenes impartidas para garantizar el derecho a la salud.
Mensaje clave
La interoperabilidad de la información fortalece la capacidad del Estado para monitorear el acceso efectivo a los medicamentos y orientar la toma de decisiones basada en evidencia.
Parte A · El respaldo legal
¿Por qué el Estado debe monitorear el acceso?
Los principales pronunciamientos de la Corte Constitucional y su relación con la Gestión Farmacéutica:
| Pronunciamiento | ¿Qué destacó la Corte? | Relación con la Gestión Farmacéutica |
|---|
| Sentencia T-760 de 2008 | El acceso efectivo hace parte del núcleo del derecho a la salud. | Fundamenta la necesidad de monitorear el suministro de tecnologías en salud. |
| Auto 005 de 2024 | Evaluó el registro de servicios y tecnologías negados y evidenció la necesidad de mejorar la calidad de la información. | La trazabilidad del proceso aporta información para identificar situaciones en las que una prescripción no culmina en una entrega efectiva. |
| Auto 1281 de 2025 | Declaró un nivel de cumplimiento bajo frente al registro de negaciones y reiteró la necesidad de fortalecer la información disponible. | Refuerza la importancia de contar con información estructurada sobre el proceso de suministro. |
| Auto 1282 de 2025 | Evidenció problemas persistentes de acceso y abastecimiento de medicamentos y ordenó fortalecer un sistema unificado e interoperable de información. | Constituye uno de los principales fundamentos para fortalecer el monitoreo del ciclo de gestión farmacéutica mediante información interoperable. |
Parte B · El ciclo completo
4 momentos de la Gestión Farmacéutica en la IHCE
Que permiten llevar la trazabilidad de los medicamentos desde la prescripción hasta la entrega o administración al paciente. (Pase el cursor o toque cada tarjeta para ver el detalle.)
1. PrescripciónPrestador de salud
Registro de la necesidad clínica identificada por el profesional de la salud.
Responsable: Prestador de servicio de salud.
→
2. DireccionamientoERP
Reporte de la entidad responsable de realizar la dispensación.
Responsable: Entidad responsable de pago (ERP).
→
3. ProgramaciónGestor farm. / IPS
Reporte de la fecha, lugar o modalidad definida para realizar la entrega.
Responsable: Gestor farmacéutico o IPS que dispensa/administra.
→
4. DispensaciónGestor farm. / IPS
Registro de la entrega efectiva del medicamento al paciente.
Responsable: Gestor farmacéutico o IPS que dispensa/administra.
Mensaje clave
El suministro de un medicamento pasa por cuatro momentos, y cada actor los realiza en su propia operación, como siempre lo ha hecho. Lo nuevo es que, al terminar su parte, reporta esa información a IHCE de forma estandarizada; IHCE no ejecuta estos pasos: integra los reportes para reconstruir el ciclo completo.
En la operación: el paciente recibe sus medicamentos. · En el reporte a IHCE: los actores reportan los pasos a su cargo.
En las siguientes pantallas vemos cada paso en detalle, con su ejemplo cotidiano.
Parte B · Paso 1: Prescripción
Prescripción
La prescripción constituye el inicio del proceso de Gestión Farmacéutica, ya que registra la necesidad clínica identificada por el profesional y da origen al ciclo de suministro del medicamento.
¿Qué se reporta?
Todo inicia cuando el profesional de la salud autorizado para prescribir medicamentos identifica una necesidad clínica y determina el tratamiento farmacológico más adecuado.
Esta decisión hace parte de su autonomía profesional, reconocida en el artículo 17 de la Ley Estatutaria 1751 de 2015, y debe fundamentarse en la evidencia científica, el criterio clínico y las necesidades particulares de cada paciente.
La prescripción queda registrada de forma estructurada dentro del Resumen Digital de Atención (RDA). La prescripción queda queda registrada de forma estructurada dentro del Resumen Digital de Atención (RDA).
Según el Decreto 780 de 2016 (artículo 2.5.3.10.16), la prescripción debe incluir, además, una serie de datos mínimos cuando apliquen.
Una prescripción clara, completa y legible garantiza la seguridad del paciente y la correcta entrega del medicamento.
Parte B · Paso 1: Prescripción
Prescripción
La implementación de la gestión farmacéutica en IHCE no pretende modificar la operación de los actores de cara al personal médico y de dispensación.
Pretende recibir el reporte de la información estandarizada.
¿Cuál es el papel del IUM en la gestión farmacéutica en IHCE?
El reporte de los medicamentos prescritos debe realizarse por el código IUM de primer nivel siempre que este exista (la meta es avanzar en el reporte por IUM1 de todos los medicamentos).
El código IUM se requiere para la trazabilidad en las demás etápas del proceso como se explicará más adelante.
Parte B · Paso 2: Direccionamiento
Direccionamiento
La Entidad Responsable de Pago (ERP) define el prestador de servicios de salud o gestor farmacéutico responsable de suministrar el medicamento al paciente.(de acuerdo con los acuerdos de voluntades y la organización de la red de servicios.)
Esta etapa no modifica la decisión clínica del profesional tratante ni representa una nueva valoración médica; tampoco modifica los direccionamientos previamente acordados entre actores.
Actor responsable:
Entidad Responsable de Pago (ERP).
Resultado:
Queda reportado para interoperabilidad el prestador o proveedor responsable del suministro del medicamento prescrito.
El proceso no se modifica. Únicamente asigna la responsabilidad de reportar quién fue designado para continuar con el proceso de suministro.
Parte B · Paso 3: Programación
Programación
El prestador de servicios de salud o gestor farmacéutico responsable organiza la atención del paciente y programa la entrega o administración del medicamento.
Actor responsable:
Prestador de servicios de salud o gestor farmacéutico responsable del suministro.
Resultado:
El reporte de la programación de la entrega del medicamento queda cargado en la IHCE para monitoreo y trazabilidad.
¿Qué se reporta?
Se reporta la fecha, hora, lugar o modalidad mediante la cual se realizará el suministro
Permite coordinar la operación logística necesaria para garantizar que el tratamiento se entregue de manera oportuna y continua.
Mensaje clave
Se debe reportar la información de programación de entrega o administración que fue comunicada al usuario. Una vez se haga la programación, esta debe ser reportada en la IHCE.
Parte B · Paso 3: Programación
Programación: Escenarios
Para la programación de dispensaciones ambulatorias pueden ocurrir dos escenarios distintos:
Escenario 1 · Fórmula de una sola entrega
Se reportan programación y dispensación con la misma fecha y hora: el momento en que el paciente se acercó y recibió sus medicamentos.
→
→
(
+
)
Escenario 2 · Fórmula de más de una entrega
Se reporta la primera dispensación y su programación en el mismo momento.
Se programan las demás entregas y se reporta la programación.
Objetivo: garantizar el registro oportuno y completo de la información, según el tipo de entrega de la fórmula médica.
Parte B · Paso 4: Dispensación
Dispensación
El prestador de servicios de salud o gestor farmacéutico responsable realiza la entrega o administración del medicamento al paciente, según corresponda, y registra la información de los medicamentos efectivamente entregados o administrados y, cuando aplique, aquellos pendientes que no pudieron suministrarse junto con la causa correspondiente.
Ejemplo de entrega parcial
Se formularon 90 tabletas pero solo hay 30 disponibles. Se registran dos movimientos: una entrega efectiva de 30 con un pendiente. Cuando llegan las 60 faltantes, se registra la entrega del pendiente.
Mensaje clave
El reporte de dispensación o administración permite cerrar el ciclo de Gestión Farmacéutica y completar el monitoreo respectivo.
Parte B · Ideas clave
El reporte no es un trámite
Antes de seguir, un par de ideas que se repiten en todo el ciclo y conviene tener siempre presentes:
El reporte es POSTERIOR a la prestación
Se busca que se realice en tiempo real, o lo más cercano posible, pero nunca antes ni en lugar de la atención al paciente.
La atención del paciente siempre es lo primero. El registro de la información se realiza después , sin interferir en el proceso.
El reporte NO GENERA BARRERAS
El reporte no debe generar barreras administrativas, ni retrasos en la entrega o continuidad del tratamiento, sin condicionar la atención del paciente ni afectar la continuidad del servicio.
El reporte NO ESTA LIGADO A LA PRESTACIÓN DEL SERVICIO
El NO reporte de un paso anterior en IHCE no significa que ese paso no tenga validez, solo significa que no ha sido reportado y NO DEBE COMPROMETER LA CONTINUIDAD de la prestación del servicio al usuario.
Parte B · Ideas clave
Consultar y hacer seguimiento
Además de los cuatro pasos, las entidades autorizadas pueden consultar en cualquier momento el estado de las prescripciones, direccionamientos, programaciones y dispensaciones.
Como rastrear un envío
Igual que sigue un paquete en una app de mensajería, los actores del sistema pueden ver en qué punto del recorrido va cada medicamento, para hacer seguimiento y tomar decisiones. La interoperabilidad no detiene el envío ni reemplaza la gestión: simplemente muestra en qué estado se encuentra.
Parte B · Un caso real
El recorrido de una fórmula, paso a paso
Sigamos a Ana, que sale de consulta con una prescripción. Toque "Siguiente paso" para ver cómo avanza su medicamento.
Ana es atendida en una IPS. El médico le prescribe un medicamento y la fórmula queda registrada en su RDA.
Parte C · Las piezas por dentro
El RDA: el documento que lo contiene todo
RDA significa Resumen Digital de Atención en Salud. Es el documento donde queda registrada la atención, incluida la fórmula del medicamento.
Como una carpeta digital de la cita
Reúne en un solo lugar lo que pasó en la atención: el paciente, el diagnóstico, el profesional y lo que se formuló. La prescripción del medicamento viaja dentro de esta carpeta.
El RDA es la puerta de entrada de toda la gestión farmacéutica.
Parte C · Dos momentos, dos mecanismos
¿Cuándo se registra cada cosa?
No toda la información se registra de la misma manera: depende del momento en que ocurre cada actividad.
Durante la atención → RDA
Qué: la prescripción del medicamento.
Cuándo: durante la atención en salud (consulta externa, urgencias, hospitalización).
Por qué: la prescripción hace parte del acto asistencial.
Después de la atención → estructuras interoperables
Qué: direccionamiento, programación y dispensación.
Cuándo: después de que ocurre cada proceso.
Por qué: son actividades operativas del suministro, no parte de la atención clínica.
Ambos mecanismos se complementan para reflejar el ciclo completo de la Gestión Farmacéutica dentro de la IHCE.
Parte C · El idioma común
FHIR: para que todos se entiendan
Toda esta información se intercambia usando FHIR, un estándar internacional que funciona como un idioma común para los datos de salud.
¿Por qué es clave aquí?
Porque el prestador, la EPS y el gestor son sistemas distintos. FHIR hace que el dato de un medicamento signifique exactamente lo mismo para todos, sin malentendidos.
FHIR es el sobre y el idioma; lo que viaja dentro es la información de cada paso.
Parte C · Hablar con precisión
Las terminologías: el diccionario compartido
Para que "este medicamento" sea exactamente el mismo para todos, el sistema usa catálogos de códigos oficiales. Cada medicamento, diagnóstico o entidad tiene su código único.
Medicamentos
Catálogos que identifican el medicamento, su concentración y forma.
Diagnósticos
Códigos internacionales (CIE-10) y de enfermedades huérfanas.
Entidades
Registros oficiales de IPS, profesionales y puntos de entrega.
El sistema es estricto: el código y su nombre deben coincidir exactamente con el catálogo oficial.
Parte C · Un mismo medicamento, tres niveles
IUM: el Identificador Único del Medicamento
El IUM identifica un medicamento con distintos niveles de detalle. Ejemplo real: Paracetamol 500 mg tableta, marca Mejoral. Toque cada nivel:
Principio activo, concentración, forma farmacéutica y vía de administración. No identifica marca. Ejemplo: 1P100885 — Paracetamol 500 mg/1 U, tabletas de liberación no modificada, vía oral. Agrupa todos los medicamentos con esa misma descripción.
Toma el Nivel 1 y agrega la marca. Un mismo IUM de nivel 1 puede tener varios de nivel 2: uno por cada marca (por ejemplo, Kyofen, Memphis, Mejoral son todas marcas de ese mismo paracetamol 500 mg).
Agrega la unidad y cantidad de contenido y el empaque. Una misma marca (Mejoral) puede tener varios niveles 3: caja por 10, por 20 o por 100 tabletas, cada una con su propio código IUM de nivel 3.
En resumen: Nivel 1 = qué es · Nivel 2 = de qué marca · Nivel 3 = en qué presentación.
Parte C · El código del INVIMA
¿Qué es el CUM?
El Código Único de Medicamentos (CUM) es la identificación alfanumérica que el INVIMA asigna a cada presentación comercial autorizada de un medicamento.
¿Cómo está conformado?
Un número de expediente (el trámite del medicamento ante el INVIMA), un guion, y un consecutivo que identifica cada presentación autorizada dentro de ese expediente.
| Ejemplo | 20145940-1 |
| Expediente | 20145940 (Mejoral®, Paracetamol 500 mg) |
| Consecutivo | 1 → frasco por 24 tabletas (el -2 sería caja x100, el -3 caja x20, etc.) |
El CUM identifica la presentación comercial específica que se dispensa; por eso se usa cuando ya se conoce exactamente el producto entregado.
Parte C · Cuál se usa cuándo
¿Qué identificador se utiliza en cada etapa?
| Prescripción | IUM de primer nivel |
| Direccionamiento | IUM de primer nivel |
| Programación | IUM de primer nivel |
| Dispensación o administración | IUM de tercer nivel o CUM |
El IUM de primer nivel mantiene la trazabilidad de la necesidad clínica hasta la programación. En la entrega, cuando ya se conoce marca y presentación, se usa el IUM de tercer nivel o el CUM.
Parte C · Un caso especial
Caso especial: preparaciones magistrales
Una preparación magistral se elabora para atender la prescripción de un paciente individual y no tiene una composición estandarizable de antemano, así que no cuenta con un IUM que la identifique como producto terminado.
¿Cómo se identifica entonces?
Con tres catálogos oficiales del Ministerio (SISPRO): DCI (principio activo), UMM (concentración) y FFM (forma farmacéutica).
| Ejemplo | Crema analgésica para dolor neuropático |
| DCI | Lidocaína + Ketamina |
| UMM | 5% (p/p) · 10 mg/g |
| FFM | Crema (forma farmacéutica tópica semisólida) |
Para recordar: si el medicamento es una preparación magistral, no use IUM — reporte siempre DCI + UMM + FFM.
Parte C · Los controles de calidad
Validaciones: para que los datos sean confiables
Antes de aceptar la información, el sistema revisa que todo esté correcto. Son como filtros de calidad que evitan errores:
El paciente debe existir y coincidir
Sus datos (identificación, nombre, sexo, estado) se verifican contra el registro nacional para asegurar que es la persona correcta.
Las entidades deben estar habilitadas
La IPS, el profesional y los puntos de entrega deben estar activos y registrados oficialmente para poder participar.
Parte C · Cuando algo no cuadra
¿Qué pasa si hay un error?
El sistema no se queda callado: cuando algo falla, responde explicando qué pasó, para poder corregirlo. Las respuestas más comunes:
| Todo bien | Se acepta la información |
| Falta o sobra algo | Indica qué campo está mal |
| Sin permiso | No está autorizado a hacerlo |
| Repetido | Ese registro ya existía |
Estos mensajes ayudan a las entidades a arreglar el envío rápidamente.
Parte C · Privacidad y seguridad
¿Cómo se protege la información?
Se trata de datos de salud, así que la seguridad es prioritaria. El sistema exige varias capas de protección:
CredencialesCada entidad accede solo con permisos propios
CifradoTodo viaja y se guarda protegido
AuditoríaQueda registro de cada acción
RolesCada usuario ve solo lo que le corresponde
Todo se rige por la normativa colombiana de protección de datos y de historia clínica.
Parte C · Qué deben hacer las entidades
¿Hay que cambiar algo para participar?
Sí. Las entidades que ya intercambian información con IHCE, y las que se suman, deben ajustar sus sistemas para soportar este proceso.
Prestadores (IPS)
Adoptar los ajustes del anexo técnico: nuevos campos, terminologías estandarizadas y reglas de validación actualizadas.
EPS y gestores farmacéuticos
Ajustar su software y su operación para empezar a interoperar con los demás actores del sistema.
Parte D · FHIR e Interoperabilidad
Cada paso, por dentro
En las partes anteriores vimos qué pasa en cada momento. Ahora, sin complicarnos, veamos con qué se hace: detrás de cada paso hay una ficha de información (recurso FHIR) y una acción sobre ella (operación).
Una comparación sencilla
El recurso es como un formulario estandarizado que todos llenan igual. La operación es el botón que lo envía, lo consulta o lo anula. Nada viaja suelto: siempre es "un formulario + un botón".
Todo esto usa FHIR y las protecciones de la Parte C: credenciales, cifrado y auditoría en cada acción.
Parte D · Los formularios FHIR
Dos fichas hacen casi todo el trabajo
Aunque los pasos son cuatro, casi todo se apoya en dos formularios FHIR:
MedicationRequest
La solicitud sobre un medicamento. La comparten prescripción, direccionamiento y programación: cada actor la llena con su parte.
MedicationDispense
El registro de la entrega. Es el formulario propio de la dispensación.
Como un mismo formato que pasa de mano en mano
El médico, la EPS y el gestor no crean formularios distintos: usan el mismo MedicationRequest en tres momentos (con un "perfil" para cada uno). Solo al entregar se abre uno nuevo: el MedicationDispense.
Parte D · Las fichas de apoyo
El "casi": las fichas que acompañan
Ninguna de las dos fichas viaja sola. Como una fórmula de papel, que no dice solo el medicamento sino a quién, quién la firma y dónde se reclama, cada formulario apunta a otras fichas FHIR:
Toque cada ficha para descubrir qué guarda y cómo se valida.
El paciente. Se verifica contra EVOL: que exista, esté vivo y su documento esté vigente.
El profesional que prescribe. Debe estar habilitado en RETHUS.
La IPS, la EPS y el gestor farmacéutico. Verificados en REPS y NoReps.
La sede de la IPS y el punto de dispensación donde se entrega.
La carátula del RDA: el resumen de la atención donde nace la fórmula.
Nadie reescribe lo que ya existe
Estas fichas no se vuelven a llenar en cada paso: el formulario simplemente las referencia, igual que al citar un número de cédula en vez de volver a describir a la persona. Por eso los datos no se contradicen entre una entidad y otra.
Parte D · Los perfiles
Un formulario, cuatro versiones
Dijimos que MedicationRequest se usa en tres momentos. Lo que cambia en cada uno es el perfil: la versión del formulario que define qué casillas son obligatorias en ese momento.
PrescribirMedicationRequestRDA
DireccionarMedicationRequestAddressing
ProgramarMedicationRequestScheduling
DispensarMedicationDispenseRDA
¿Por qué no un formulario distinto para cada uno?
Porque así todo queda enganchado: el direccionamiento sabe de qué fórmula viene y la dispensación sabe a qué programación responde. Si cada actor inventara su propio formato, habría que volver a cruzar la información al final, que es justamente el problema que IHCE resuelve.
Los medicamentos que se administran dentro de la institución (por ejemplo, durante una hospitalización) usan otras fichas y no pasan por este ciclo de cuatro pasos.
Parte D · Paso 1 por dentro
Prescripción: dónde nace todo
La prescripción es distinta a los otros tres pasos: no se envía sola. Viaja dentro del RDA de la atención, como un renglón más del resumen de esa consulta.
Se envía junto con la atención
Consulta$enviar-rda-consulta
Urgencias$enviar-rda-urgencias
Hospital.$enviar-rda-hospitalizacion
El RDA Paciente no lleva prescripción: es un resumen básico, no una atención.
Qué trae la fórmula por dentro
El medicamento en código IUM (que ya incluye concentración y forma farmacéutica), el número de prescripción que genera el software de la IPS, la dosis e instrucciones para el paciente, la cantidad por entrega y cuántas repeticiones se autorizan.
Dos casos piden más datos: los medicamentos de control especial exigen dirección y teléfono del paciente y del prescriptor; y si el diagnóstico es una enfermedad huérfana se registran dos códigos, el CIE-10 y el de la enfermedad huérfana.
Parte D · Pasos 2 y 3 por dentro
Direccionamiento y programación
Ambos trabajan sobre el mismo MedicationRequest. Cada actor primero consulta lo que le corresponde y luego envía su parte:
Direccionamiento · lo hace la EPS
Consulta las fórmulas con prescripción y reporta a quién asignó para entregar.
Consulta$consultar-rda-con-prescripcion-eapb
Envía$enviar-direccionamiento
Estadoactive = direccionado · stopped = no direccionado
Programación · lo hace el gestor
Consulta lo que le direccionaron y define fechas y cantidades.
Consulta$consultar-direccionamiento-gf
Envía$enviar-programacion
Parte D · Paso 4 por dentro
Dispensación: el registro de la entrega
El gestor consulta sus programaciones y registra la entrega en un MedicationDispense:
Consulta$consultar-programacion-gf
Envía$enviar-dispensacion
¿Y si no se entrega todo de una vez?
Ejemplo: se formularon 90 tabletas pero solo hay 30 disponibles. Se registran dos movimientos —cada uno un MedicationDispense distinto—: una entrega efectiva de 30 con un pendiente. Cuando llegan las 60 faltantes, se registra la entrega del pendiente.
Parte D · Ver y hacer seguimiento
Abrir el detalle y seguir la pista
Las consultas devuelven listas resumidas, como la bandeja de entrada del correo. Cuando hace falta ver todo, hay dos formas de "abrir el mensaje":
$document
Sobre un RDA: trae el documento completo de la atención. Es como la EPS lee la fórmula original tal como la escribió el médico.
$everything
Sobre un MedicationRequest: trae la ficha con sus referencias ya resueltas (paciente, prescriptor, gestor), sin pedirlas una por una.
¿Y quién puede ver las entregas?
Las dispensaciones también se consultan, cada quien por lo suyo:
La EPS$consultar-dispensacion-eapb
El gestor$consultar-dispensacion-gf
La IPS$consultar-dispensacion-paciente
La IPS consulta las entregas de su paciente para asegurar la continuidad asistencial y hacer seguimiento a la adherencia al tratamiento.
Con esto se cierra el círculo: la EPS que direccionó puede comprobar si el medicamento terminó realmente en manos del paciente.
Parte D · El patrón que se repite
Consultar, enviar y anular
Los tres pasos siguen el mismo patrón. Si algo se registró por error, cada envío tiene su anulación uno a uno (el registro queda en estado cancelled):
Toque cada paso para ver sus tres operaciones.
Consultar$consultar-rda-con-prescripcion-eapb
Enviar$enviar-direccionamiento
Anular$anular-direccionamiento
Consultar$consultar-direccionamiento-gf
Enviar$enviar-programacion
Anular$anular-programacion
Consultar$consultar-programacion-gf
Enviar$enviar-dispensacion
Anular$anular-dispensacion
Las listas largas se recorren por páginas con /siguiente-pagina/{id}, como al bajar por una pantalla infinita.
Parte E · Repaso
Glosario rápido
Las siglas y palabras clave de toda la presentación, en una sola pantalla:
| IHCE | Interoperabilidad de Historia Clínica Electrónica |
| RDA | Resumen Digital de Atención en Salud |
| EAPB / EPS | Entidad que asegura al paciente |
| Gestor farmacéutico | Quien programa y entrega el medicamento |
| UPC | Recursos que financian el plan de salud |
| FHIR | Idioma común para datos de salud |
| IUM | Identificador Único del Medicamento (3 niveles) |
| CUM | Código Único de Medicamentos, asignado por el INVIMA |
| MIPRES | Herramienta para prescribir lo no financiado con UPC |
| UNIRS | Lista de usos no incluidos en el plan de beneficios (UPC) |
| Vital No Disponible | Medicamento autorizado por el INVIMA por esa vía especial |
Parte E · Preguntas frecuentes (1 de 2)
Alcance, reporte y momentos
No. No modifica el proceso asistencial ni añade trámites para el paciente. Solo registra e intercambia de forma estandarizada la información del suministro habitual.
No. Aplica a los financiados con UPC. Los no financiados con UPC, los usos de la Lista UNIRS y los medicamentos con monitoreo específico (antirretrovirales VIH) siguen por MIPRES.
En cualquier ámbito donde se prescriban estos medicamentos: consulta externa, urgencias, hospitalización, atención domiciliaria, hospital de día, diálisis o quimioterapia, entre otros.
Sí. Se registra durante la atención mediante el RDA correspondiente (consulta externa, urgencias u hospitalización).
No. Solo si ocurren como procesos independientes, en atenciones diferentes. Si la misma IPS prescribe y dispensa en la misma atención, esas etapas no existen y no se reportan.
Sí. Cuando el suministro ocurre en una atención distinta de la prescripción —incluso intramural, como quimioterapia, diálisis u hospital de día— deben reportarse las etapas que efectivamente se ejecuten.
No debe reportarse. Las estructuras interoperables solo se generan para actividades que efectivamente hacen parte del proceso de suministro.
Se reporta la cantidad entregada y la pendiente (o el total pendiente si no hubo entrega). Siempre se registra la fecha en que el paciente se presentó a reclamar, para medir la oportunidad del suministro.
Parte E · Preguntas frecuentes (2 de 2)
Identificadores y casos especiales
Si es un producto autorizado por el INVIMA o un Vital No Disponible, el IUM de primer nivel. Si es una preparación magistral, se registran DCI, UMM (concentración) y FFM (forma farmacéutica) con los catálogos oficiales.
Durante la dispensación o administración, cuando ya se conoce el producto y la presentación comercial efectivamente suministrados al paciente.
Si cuenta con autorización del INVIMA como Vital No Disponible, tiene un IUM de primer nivel y la prescripción se identifica con ese IUM, igual que los demás productos farmacéuticos autorizados.
Porque garantizan que todos los actores identifiquen los medicamentos con el mismo lenguaje estandarizado, lo que facilita la interoperabilidad, la trazabilidad y la calidad de la información.
Cada actor reporta únicamente la información de las actividades que realiza dentro de sus competencias. Ningún actor debe registrar información generada por otro.
No. MIPRES sigue usándose para lo no financiado con UPC, los usos de la Lista UNIRS y los medicamentos con monitoreo específico (antirretrovirales para VIH).
No. Las competencias siguen siendo las de la normatividad vigente y los acuerdos de voluntades. Solo define el intercambio estandarizado de la información.
Contar con información estandarizada e interoperable que permita reconstruir el ciclo completo del suministro, fortalecer el monitoreo del acceso, mejorar la trazabilidad y apoyar la toma de decisiones en salud.
Parte E · Taller práctico
Taller: hagamos el ciclo completo
Hasta aquí lo contamos. Ahora lo vamos a hacer. Con Postman —una herramienta que envía peticiones a una API sin programar nada— recorreremos los cuatro pasos contra el ambiente de pruebas de IHCE.
Qué necesita para participar
1Postman instalado o en el navegador, la versión gratuita basta. postman.co
2La colección InteropAPI Minsalud Sandbox | Taller, que puede descargar aquí mismo.
3Nada más: la colección ya trae las credenciales del sandbox y las tres peticiones de token.
Credenciales de prueba
Las credenciales incluidas son exclusivas del ambiente de pruebas y estarán vigentes hasta septiembre de 2026. No sirven en producción ni dan acceso a datos reales.
Tranquilidad: esto es un ensayo
El sandbox es un ambiente de pruebas. No contiene datos de pacientes reales y nada de lo que usted envíe afecta la operación ni la historia clínica de nadie. Equivocarse aquí es parte del ejercicio.
Parte E · El caso del taller
El caso: Juan Pérez
La historia
Juan Pérez, de 58 años, es hipertenso y recibe atención de control en la Fundación Santa Fe de Bogotá. El cardiólogo le prescribe Losartán 50 mg, 1 tableta cada 12 horas, durante 6 meses.
Ojo: en el sandbox nadie se llama Juan Pérez
El ambiente de pruebas solo acepta pacientes, prestadores y gestores que ya existen registrados en él. Por eso la colección trae datos de prueba que hacen el papel de cada personaje de la historia:
| Juan Pérez (paciente) | PacienteNumDoc |
| Fundación Santa Fe (IPS) | CodigoPrestador |
| Nueva EPS (EAPB) | CodigoEAPB |
| Audifarma (gestor) | NITGestorFarmaceutico |
| Sede de Usaquén | CodigoSedeGestor |
| El medicamento | MedicamentoIUM |
La historia que recorremos es la misma; solo cambian los nombres. Si algún día quiere usar los datos reales del caso, basta con cambiar esas variables.
Parte E · Antes de empezar
Tres llaves para tres actores
Como vimos en la Parte C, cada actor entra con su propia credencial. Por eso la colección trae tres peticiones de token, y hay que pedir cada una en su momento:
IPSToken IPS→ antes del paso 1
Nueva EPSToken EAPB→ antes de los pasos 2 y 3
AudifarmaToken GF→ antes de los pasos 4 a 7
No hay que tocar el JSON
Todo lo que cambia —paciente, medicamento, fechas, números— está en la pestaña Variables de la colección. Y los identificadores que genera el servidor (el del RDA, el del direccionamiento, el de la programación) se guardan solos: la colección los encadena de una petición a la siguiente, sin copiar y pegar.
Parte E · Taller · Primera mitad
Paso a paso (1 a 4)
1Ocurre la atenciónEn la Fundación Santa Fe se genera el RDA de consulta externa, con la prescripción dentro. Un solo envío crea la atención, el diagnóstico y la fórmula.
enviar-rda-consulta
2Opcional · Nueva EPS consultaLa EAPB lista las prescripciones que le corresponden.
listar-prescripciones-eapb
3Nueva EPS direccionaReconoce que Juan es de Bogotá y que el medicamento está contratado allí con Audifarma; define seis entregas mensuales hasta enero de 2027, le avisa a Juan por SMS y reporta la gestión.
enviar-direccionamiento
4Opcional · Audifarma consultaRevisa lo que le direccionaron y lo valida contra su inventario y sus fechas.
listar-direccionamiento-gf
Los pasos 2 y 4 son opcionales: son consultas, no cambian nada. Sirven para ver el proceso con los ojos de cada actor.
Parte E · Taller · Segunda mitad
Paso a paso (5 a 7)
5Audifarma programa la primera entrega30 tabletas para el 5 de julio en su sede de Usaquén; le avisa a Juan por correo y reporta la gestión.
enviar-programacion
6Juan reclama y se le entregaJuan pasa por la sede y recibe el medicamento. Audifarma registra la entrega.
enviar-dispensacion
7Y se programa la segunda entregaOtras 30 tabletas para el 5 de agosto, en la misma sede. Es la misma petición del paso 5, enviada otra vez.
enviar-programacion
El paso 7 tiene truco
Antes de repetir el envío, cambie NumeroProgramacion (por ejemplo, de PRG-123-03 a PRG-123-04) y la fecha. Si lo manda idéntico, el sistema lo detecta como duplicado y responde 409. No es un fallo: es exactamente lo que debe hacer para que una entrega no se cuente dos veces.
Parte E · Taller · Qué mirar
Cómo leer lo que responde el sistema
En cada envío, mire el código de respuesta. Es el sistema diciéndole qué pasó:
200 · Todo bien
Quedó registrado. El servidor devuelve el identificador del registro, y la colección lo guarda para el siguiente paso.
400 · Algo no cuadra
Falta un dato o una regla no se cumple. La respuesta trae un OperationOutcome que dice qué campo y por qué. Léalo: casi siempre se corrige con una variable.
409 · Duplicado
Ya existe un registro igual. Cambie el número del envío y reintente.
401 / 403 · Credencial
El token venció (dura ~1 hora) o está usando el del actor equivocado. Pida de nuevo el token que corresponde y reintente.
Si algo falla, no es un misterio: el sistema siempre explica el motivo. Ese es justamente el valor de tener reglas comunes.
Parte E · Cierre
Lo que hay que recordar
1La gestión farmacéutica conecta el medicamento desde la fórmula hasta la entrega.
2Tiene cuatro pasos: prescripción, direccionamiento, programación y dispensación.
3Participan IPS, EPS, gestores farmacéuticos y el Ministerio, cada uno con su rol.
4Todo viaja con FHIR, validado, codificado y protegido, para ser confiable y trazable.
En una frase: la Gestión Farmacéutica de IHCE hace que el medicamento llegue al paciente de forma conectada, segura y con seguimiento en cada paso.