Guía de Implmentación FHIR ADRES (Core)
1.0.0 - ci-build
Colombia
Guía de Implmentación FHIR ADRES (Core)
1.0.0 - ci-build
Colombia
Guía de Implmentación FHIR ADRES (Core) - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
$bdua $bduaDocumento técnico de referencia
Fecha de elaboración: 1 de julio de 2026
Fuentes oficiales consultadas: ADRES - página BDUA y ADRES - Consulta Afiliados BDUA
La Base de Datos Única de Afiliados (BDUA) es la base administrada por la ADRES que contiene la información de los afiliados plenamente identificados de los distintos regímenes del Sistema General de Seguridad Social en Salud (SGSSS).
De acuerdo con la información publicada por ADRES, la BDUA incluye afiliados de:
En términos funcionales, la BDUA permite consolidar y consultar la información básica de afiliación de las personas al sistema de salud colombiano, a partir de los reportes realizados por las entidades responsables del aseguramiento en salud.
El objetivo principal de la BDUA es servir como fuente centralizada de información sobre la afiliación al SGSSS, permitiendo identificar la entidad responsable del aseguramiento de una persona, su régimen de afiliación y el estado de la información reportada por las entidades competentes.
La BDUA cumple una función estratégica para:
La información registrada en la consulta pública de afiliados es el resultado de los reportes realizados por las EPS y demás entidades responsables, de acuerdo con los tiempos y reglas establecidos para el reporte de novedades de afiliación.
ADRES indica que las entidades que administran las afiliaciones en los distintos regímenes son responsables de la veracidad y calidad de la información reportada a la BDUA.
Por lo tanto, estas entidades deben velar por la actualización o corrección oportuna de los datos de afiliación, conforme a los principios de administración de datos aplicables en Colombia.
Esto significa que ADRES opera y administra la base, pero la fuente primaria de muchas novedades de afiliación corresponde a las entidades responsables del aseguramiento, que deben reportar y mantener actualizada la información.
ADRES dispone un servicio público de Consulta de Afiliados BDUA, mediante el cual una persona puede consultar información sobre su afiliación en el Régimen Subsidiado o en el Régimen Contributivo.
La página de consulta informa que los resultados reflejan los reportes realizados por las EPS, de acuerdo con los tiempos establecidos para las entidades responsables del aseguramiento en salud.
El servicio web público permite ingresar el tipo y número de documento de identificación para obtener la información disponible sobre la afiliación. ADRES recomienda el uso del navegador Google Chrome y la configuración adecuada de ventanas emergentes para obtener un resultado óptimo de la consulta.
Según la página oficial de BDUA de ADRES, esta base se rige por el marco normativo establecido por el Ministerio de Salud y Protección Social mediante la Resolución 4622 de 2016, por la cual se establece el reporte de los datos de afiliación al SGSSS.
La página de Consulta de Afiliados BDUA también referencia las siguientes normas relacionadas con el reporte y actualización de las bases de datos de afiliación operadas por ADRES:
Estas normas adoptan o desarrollan anexos técnicos, lineamientos y especificaciones técnicas y operativas para el reporte y actualización de las bases de datos de afiliación que opera ADRES.
Además, la página oficial de BDUA recuerda que la administración de los datos debe observar los principios previstos en el artículo 4 de la Ley 1266 de 2008 y las normas que la modifiquen, adicionen o sustituyan.
La Guía de Implementación FHIR de ADRES contiene los artefactos técnicos necesarios para habilitar una operación interoperable de consulta de afiliados en BDUA mediante HL7 FHIR.
En particular, la guía define los componentes necesarios para una operación FHIR denominada $bdua, orientada a que las organizaciones del sector salud puedan consultar información de afiliación en la BDUA de forma estandarizada.
Estos componentes incluyen:
$bdua.El propósito de esta guía es transformar la consulta de afiliados BDUA en un servicio interoperable, trazable y reutilizable por actores autorizados del sector salud.
El servicio FHIR BDUA puede entenderse como una interfaz de consulta basada en HL7 FHIR que permite a una organización autorizada enviar una solicitud estructurada para verificar la información de afiliación de una persona en la BDUA.
La operación $bdua funcionaría como una operación FHIR especializada, invocada sobre el servidor FHIR de ADRES o sobre el punto de interoperabilidad definido por la entidad.
De manera conceptual, el flujo de operación sería el siguiente:
La implementación de un servicio FHIR para consulta de afiliados BDUA ofrece beneficios importantes para el ecosistema de salud colombiano:
El servicio FHIR BDUA está orientado a organizaciones del sector salud que requieran verificar información de afiliación, siempre bajo las condiciones de autorización, seguridad, privacidad y uso legítimo definidas por ADRES y por la normativa aplicable.
Entre los posibles usuarios institucionales se encuentran:
La consulta de información de afiliación debe operar bajo principios de protección de datos personales, seguridad de la información, minimización de datos y control de acceso.
Por tanto, una operación FHIR $bdua debería contemplar, como mínimo:
La consulta pública de afiliados BDUA disponible en el portal de ADRES está orientada principalmente a que ciudadanos y usuarios consulten información básica de afiliación mediante una interfaz web.
El servicio FHIR BDUA, en cambio, está orientado a la interoperabilidad entre sistemas. Su propósito no es reemplazar la consulta pública, sino ofrecer un mecanismo estandarizado para que sistemas autorizados puedan realizar consultas estructuradas y procesables automáticamente.
En síntesis:
| Elemento | Consulta pública BDUA | Servicio FHIR $bdua |
|---|---|---|
| Usuario principal | Ciudadanos o usuarios individuales | Organizaciones y sistemas autorizados |
| Interfaz | Formulario web | API HL7 FHIR |
| Entrada | Tipo y número de documento | Parámetros FHIR definidos en la guía |
| Salida | Resultado visible en página o impresión | Respuesta FHIR estructurada |
| Finalidad | Consulta informativa individual | Integración interoperable entre sistemas |
| Validación técnica | No orientada a validación FHIR | Validable contra perfiles y reglas de la guía |
La BDUA es una fuente central del SGSSS para consolidar información de afiliación en salud. Su valor operativo depende de la calidad, oportunidad y actualización de los datos reportados por las entidades responsables del aseguramiento.
La Guía de Implementación FHIR de ADRES para BDUA permite llevar esta capacidad de consulta a un modelo moderno de interoperabilidad basado en HL7 FHIR, mediante la operación $bdua. Esta operación facilita que organizaciones del sector salud consulten información de afiliación de forma estandarizada, codificada, validable y alineada con el marco normativo colombiano.
ADRES. BDUA - Base de Datos Única de Afiliados. Página oficial consultada el 2 de julio de 2026.
https://www.adres.gov.co/eps/bdua
ADRES. Consulta Afiliados BDUA. Página oficial consultada el 2 de julio de 2026; fecha de actualización visible en la página: 22 de junio de 2026.
https://servicios.adres.gov.co/BDUA/Consulta-Afiliados-BDUA
IG © 2026+ Administradora de los Recursos del Sistema General de Seguridad Social en Salud - ADRES. Package adres.fhir.core#1.0.0 based on FHIR 4.0.1. Generated 2026-07-09
Links: Table of Contents
| 