Recursos FHIR para Colombia: Mapeo de RIPS, Receta Electrónica y Datos de Identificación Ciudadana

La interoperabilidad en salud en Colombia ha dado un salto cualitativo sin precedentes con la entrada en vigencia de la Resolución 2275 de 2023 y la reglamentación de la Historia Clínica Electrónica Interoperable (Ley 2015 de 2020). La época en la que las Instituciones Prestadoras de Salud (IPS) consolidaban archivos planos delimitados por comas (.TXT) para remitir el Registro Individual de Prestación de Servicios de Salud (RIPS) a las EPS y al Ministerio de Salud ha llegado a su fin.

El nuevo estándar técnico exige que la información clínica y de facturación viaje estructurada mediante modelos semánticos compatibles con HL7 FHIR R4. Sin embargo, implementar FHIR en el contexto colombiano requiere comprender con precisión quirúrgica cómo mapear las particularidades locales: los tipos de documento de identidad de la Registraduría Nacional, los códigos de procedimientos (CUPS), los diagnósticos (CIE-10), los medicamentos regulados (códigos CUM) y la Factura Electrónica de Venta en Salud (FEV).

💡 Resumen Ejecutivo: El ecosistema de salud digital en Colombia adopta perfiles específicos de HL7 FHIR R4 para articular los RIPS y la receta electrónica con la Factura Electrónica de Salud. La modelación exige extensiones nacionales para tipos de documento (CC, TI, CE, PPT), vinculación estricta a catálogos oficiales (CUPS, CIE-10, CUM) y empaquetamiento en Bundles transaccionales validados contra las mallas normativas de MinSalud.

1. De Archivos Planos a FHIR R4: La Transformación de los RIPS

Durante más de dos décadas, el reporte de RIPS bajo la Resolución 3374 de 2000 se basó en una constelación de archivos planos independientes: AC (consultas), AP (procedimientos), AM (medicamentos), US (usuarios), AF (transacciones). Este esquema carecía de validación sintáctica en tiempo real, generaba inconsistencias referenciales masivas y propiciaba millones de glosas administrativas entre prestadores y aseguradores.

La siguiente tabla resume la evolución estructural:

Parámetro de Comparación	RIPS Tradicional (.TXT)	RIPS Transicional (JSON Res. 2275)	Ecosistema Avanzado FHIR R4
Formato de Transporte	Archivos planos ASCII delimitados por comas	Objeto JSON jerárquico único	Recursos RESTful atómicos y Bundles
Validación Semántica	Manual o mediante validador de escritorio	En línea contra la plataforma del Ministerio	Instantánea mediante JSON Schemas y FHIR Validators
Vinculación con Factura (FEV)	Desacoplada (papel o XML separado)	Estrictamente enlazado con CUFE de la DIAN	Integrado con el recurso `Invoice` / `Claim`
Capacidad de Interoperabilidad	Nula fuera del sistema local	Exclusiva para reporte fiscal en Colombia	Global: compatible con apps de pacientes y EMRs

2. Identificación Ciudadana: Mapeo en `Patient.identifier`

Uno de los errores más graves en proyectos de salud en Colombia es utilizar el campo genérico Patient.id del servidor para almacenar el número de cédula del paciente. El estándar internacional establece que el número de identidad oficial debe modelarse dentro del array Patient.identifier, vinculándolo al CodeSystem oficial de tipos de documento:

Tipos de Documento Oficiales en Colombia:

CC: Cédula de Ciudadanía.
TI: Tarjeta de Identidad.
CE: Cédula de Extranjería.
RC: Registro Civil de Nacimiento.
PPT: Permiso por Protección Temporal (población migrante).
PA: Pasaporte.

Representación JSON Estándar en FHIR R4:

{
  "resourceType": "Patient",
  "id": "col-pat-99120",
  "identifier": [
    {
      "use": "official",
      "type": {
        "coding": [
          {
            "system": "https://minsalud.gov.co/fhir/CodeSystem/TipoDocumentoIdentidad",
            "code": "CC",
            "display": "Cédula de Ciudadanía"
          }
        ]
      },
      "system": "urn:oid:1.3.6.1.4.1.58300.1",
      "value": "1032456789"
    }
  ],
  "name": [
    {
      "use": "official",
      "family": "Morales",
      "given": ["Sofía", "Elena"]
    }
  ],
  "gender": "female",
  "birthDate": "1992-04-18"
}

3. Receta Médica y Prescripción Electrónica: `MedicationRequest`

En Colombia, la prescripción digital de medicamentos ambulatorios e intrahospitalarios se articula mediante el recurso MedicationRequest (la orden médica emitida por el facultativo) y su correspondiente dispensación en farmacia con MedicationDispense.

Para que la receta electrónica cumpla con los estándares de interoperabilidad de MinSalud, el principio activo y la presentación comercial deben estar codificados con el Código Único de Medicamentos (CUM) emitido por el INVIMA, complementado con la clasificación anatómica y terapéutica internacional (ATC):

{
  "resourceType": "MedicationRequest",
  "id": "rx-col-2026-0042",
  "status": "active",
  "intent": "order",
  "medicationCodeableConcept": {
    "coding": [
      {
        "system": "https://invima.gov.co/CodeSystem/CUM",
        "code": "19984321-01",
        "display": "Amoxicilina 500 mg Cápsula"
      },
      {
        "system": "http://www.whocc.no/atc",
        "code": "J01CA04",
        "display": "amoxicillin"
      }
    ]
  },
  "subject": {
    "reference": "Patient/col-pat-99120"
  },
  "authoredOn": "2026-08-24T10:15:00-05:00",
  "requester": {
    "reference": "Practitioner/rethus-doc-7810"
  },
  "dosageInstruction": [
    {
      "text": "Tomar 1 cápsula cada 8 horas durante 7 días por vía oral con las comidas",
      "timing": {
        "repeat": {
          "frequency": 3,
          "period": 1,
          "periodUnit": "d"
        }
      },
      "doseAndRate": [
        {
          "doseQuantity": {
            "value": 500,
            "unit": "mg",
            "system": "http://unitsofmeasure.org",
            "code": "mg"
          }
        }
      ]
    }
  ]
}

4. Mapeo de una Atención de Consulta Externa (RIPS Tipo AC)

La clásica consulta médica ambulatoria se modela a través de tres recursos íntimamente correlacionados:

Encounter: El episodio asistencial (fecha, hora, modalidad de atención: presencial o telemedicina).
Condition: El diagnóstico principal y diagnósticos relacionados codificados estrictamente bajo el catálogo CIE-10 (ej. E119 - Diabetes mellitus tipo 2 sin mención de complicación).
Procedure: El servicio prestado codificado con la Clasificación Única de Procedimientos en Salud (CUPS, ej. 890201 - Consulta médica general ambulatoria).

5. Implementación en TypeScript: Constructor y Validador de RIPS FHIR

El siguiente módulo demuestra cómo construir de manera tipada y validar un recurso de procedimiento ambulatorio antes de su transmisión a las plataformas de validación:

import { z } from 'zod';

// Esquema de validación para procedimientos CUPS en Colombia
export const ColombianProcedureSchema = z.object({
  patientNationalId: z.string().min(5),
  idType: z.enum(['CC', 'TI', 'CE', 'PPT', 'PA']),
  cupsCode: z.string().length(6), // En Colombia los CUPS tienen 6 dígitos
  cupsDescription: z.string(),
  serviceDate: z.string().datetime(),
  practitionerRethus: z.string(),
});

export type ColombianProcedureData = z.infer<typeof ColombianProcedureSchema>;

export class ColombiaFhirRipsBuilder {
  public static buildProcedureResource(data: ColombianProcedureData) {
    // Validar esquema de entrada
    const validated = ColombianProcedureSchema.parse(data);

    return {
      resourceType: 'Procedure',
      status: 'completed',
      category: {
        coding: [
          {
            system: 'https://minsalud.gov.co/fhir/CodeSystem/TipoPrestacion',
            code: '02',
            display: 'Procedimiento de Consulta Externa'
          }
        ]
      },
      code: {
        coding: [
          {
            system: 'https://minsalud.gov.co/fhir/CodeSystem/CUPS',
            code: validated.cupsCode,
            display: validated.cupsDescription,
          },
        ],
      },
      subject: {
        identifier: {
          system: 'https://minsalud.gov.co/fhir/CodeSystem/TipoDocumentoIdentidad',
          value: `${validated.idType}|${validated.patientNationalId}`,
        },
      },
      performedDateTime: validated.serviceDate,
      performer: [
        {
          actor: {
            identifier: {
              system: 'https://minsalud.gov.co/fhir/CodeSystem/RETHUS',
              value: validated.practitionerRethus,
            },
          },
        },
      ],
    };
  }
}

6. Errores Críticos que Generan Glosas y Rechazos de MinSalud

Uso de Versiones Desactualizadas de CUPS: Las tablas de procedimientos se actualizan periódicamente mediante resolución ministerial. Enviar un código en desuso genera rechazo fulminante en el validador oficial.
Discrepancia entre la Factura Electrónica y el RIPS: El valor monetario, el NIT de la IPS prestadora y el número de factura reportado en el JSON del RIPS deben coincidir exactamente con el XML validado previamente por la DIAN.
Inconsistencia de Género y Diagnóstico: Enviar un diagnóstico obstétrico o ginecológico asociado a un paciente registrado como sexo masculino (gender: "male") sin la correspondiente justificación clínica de excepción activa la malla validadora de glosas.

Preguntas Frecuentes (FAQ)

¿Qué rol juega el RETHUS en la interoperabilidad de salud en Colombia?

El Registro del Talento Humano en Salud (RETHUS) es la base de datos nacional que certifica que un médico, odontólogo o enfermero cuenta con licencia válida para ejercer. En FHIR R4, todo recurso asistencial (Encounter, Procedure, MedicationRequest) debe asociar el número de registro del profesional en el atributo Practitioner.identifier.

¿Los medicamentos regulados por MIPRES cómo se integran con FHIR?

Las prescripciones que no están cubiertas por el Plan de Beneficios en Salud (no financiado con UPC) requieren el número de prescripción MIPRES. En FHIR R4, este valor se mapea como un identificador secundario dentro del recurso MedicationRequest.

¿Se pueden emitir recetas electrónicas válidas sin firma digital?

No. La normativa colombiana exige que las prescripciones electrónicas cuenten con mecanismos de autenticación robusta y trazabilidad inmutable que garanticen la autoría del profesional tratante para evitar fraudes en farmacias.

¿Cuál es la fecha límite para la adopción definitiva de RIPS en formato JSON?

La Resolución 2275 de 2023 y sus actos modificatorios establecieron un calendario de obligatoriedad que ya está plenamente vigente para todas las IPS y profesionales independientes en el territorio nacional.

Conclusión y Asesoría Especializada

El tránsito hacia el estándar HL7 FHIR R4 en Colombia no es solo un requerimiento administrativo para radicar cuentas médicas: es el cimiento tecnológico que permitirá una atención en salud más segura, coordinada y eficiente para millones de ciudadanos. Dominar el modelado semántico de RIPS y receta digital es la ventaja competitiva definitiva para cualquier software médico o institución hospitalaria en el país.

💬 ¿Necesitas Implementar Recursos FHIR y RIPS en tu Software Médico o IPS? En DoneAPI proveemos consultoría experta, validadores automatizados y conectores de interoperabilidad listos para operar con MinSalud:

👉 Hablar con un Consultor Especializado por WhatsApp (+57 320 817 3939)