Paciente (Patient) ADRES - Guía de Implmentación FHIR ADRES (Core) v0.1.0

Guía de Implmentación FHIR ADRES (Core)
0.1.0 - ci-build CO

Guía de Implmentación FHIR ADRES (Core) - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: Paciente (Patient) ADRES

Official URL: https://adres.fhir.guide/core/StructureDefinition/PatientADRES		Version: 0.1.0
Active as of 2025-12-18	Realm:	Computable Name: PatientADRES
Copyright/Legal: ADRES, CC BY-NC-SA 4.0, 2025+

Perfil FHIR para la representación estandarizada de la información del de las personas que desempeñan el rol de pacientes en el contexto de las siguientes bases de datos administradas por la Administradora de los Recursos del Sistema General de Seguridad Social en Salud (ADRES):

Base de Datos Única de Afiliados (BDUA)
Base de Datos de los Regímenes de Excepción y Especial (BDEX).
Base de Datos de los Planes Voluntarios de Salud (PVS).
Base de Datos del Instituto Nacional Penitenciario y Carcelario (BDINPEC).

Incluye los datos de identificación, demográficos y administrativos sobre el usuario del sistema de salud, para el seguimiento de la información a través de todos los procesos de atención en salud.

Ámbito

Este perfil define las restricciones y extensiones aplicables al recurso FHIR Patient (paciente), con el objetivo de estandarizar y representar información sobre una persona que desempeña el rol de paciente o usuario del sistema de salud, para aquellas entidades deben reportar a la Administradora de los Recursos del Sistema General de Seguridad Social en Salud (ADRES) para la actualización de las Base de Datos BDUA, BDEX, PVS y BDINPEC.

Ha sido diseñado a partir de los lineamientos normativos definidos por ADRES, de acuerdo con la Resolución 762 de 2023, y está armonizado con la Guía de Implementación de Resumen Digital de Atención en Salud (RDA) y la Guía de Implementación FHIR Core Colombia.

Uso previsto

Este perfil está diseñado para ser implementado por:

Entidades Promotoras de Salud de los Regímenes Contributivo y Subsidiado.
Entidades Adaptadas en Salud (EAS).
Municipios, Distritos, y Departamentos que tengan a su cargo áreas no municipalizadas.
Administradores de los regímenes Especial y de Excepción.
Entidades que oferten Planes Voluntarios de Salud.
Instituto Nacional Penitenciario y Carcelario (INPEC).
Sistema de Afiliación Transaccional - SAT.
Administradora de los Recursos del Sistema General de Seguridad Social en Salud -ADRES.

De acuerdo con lo establecido en el artículo 4° de la Resolución 1133 de 2021, se espera que sea utilizado para la operación de consulta de las bases de datos de afiliación.

Cuando ADRES lo defina, este recurso FHIR y las operaciones asociadas podrán emplearse para otros casos de uso como el reporte de novedades y la actualización de las bases de datos de afiliación que opera ADRES, y otros procesos relacionados con la gestión de la información de afiliación en el Sistema General de Seguridad Social en Salud.

Restricciones y extensiones clave

Se requiere el uso de terminologías controladas nacionales.
Se aplican restricciones sobre elementos obligatorios y cardinalidad.
Utiliza extensiones para representar información adicional relevante para el contexto colombiano.

Relación con otras guías o perfiles

Este perfil se basa en:

Consideraciones adicionales

Este perfil no sustituye las obligaciones legales sobre el registro clínico.
Se recomienda verificar la conformidad de su implementación.

Usages:

This Profile is not used by any profiles in this Implementation Guide

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Patient		0..*	Patient	Information about an individual or animal receiving health care services
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ExtensionPatientNationality	S	0..*	Coding	Nacionalidad del paciente URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionPatientNationality Binding: ValueSet: Iso 3166 Part 1 Numeric Codes (required)
extension:ExtensionBirthPlace	S	0..1	Address	Lugar de nacimiento del paciente URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionBirthPlace
extension:ExtensionPatientEthnicity	S	0..1	Coding	Grupo étnico del paciente URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionPatientEthnicity Binding: ValueSet: Colombian Ethnic Group Codes (required)
extension:ExtensionPatientEthnicCommunity	S	0..1	string	Comunidad étnica del paciente URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionPatientEthnicCommunity
extension:ExtensionPatientDisability	S	0..*	Coding	Clasificación general de la(s) discapacidad(es) del paciente URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionPatientDisability Binding: ValueSet: Colombian Disability ClassificationCodes (required)
extension:ExtensionPatientGenderIdentity	S	0..1	Coding	Identidad de género del paciente URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionPatientGenderIdentity Binding: ValueSet: Colombian Gender Identity Codes (required)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	1..*	Identifier	Identificadores de la persona Slice: Unordered, Open by value:id
identifier:NationalPersonIdentifier	SΣ	0..1	Identifier	Identificación del paciente
id		1..1	string	Unique id for inter-element referencing Required Pattern: NationalPersonIdentifier-0
use	?!Σ	1..1	code	usual \| official \| temp \| secondary \| old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . Fixed Value: official
type	Σ	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Slices for coding	Σ	2..2	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:InternationalCode	Σ	1..1	Coding	Code defined by a terminology system Binding: Identifier Type Codes (extensible)
system	Σ	1..1	uri	Sistema de codificación internacional Fixed Value: http://terminology.hl7.org/CodeSystem/v2-0203
code	Σ	1..1	code	Symbol in syntax defined by the system Fixed Value: PN
display	Σ	1..1	string	Representation defined by the system Fixed Value: Person number
coding:ColombianCode	Σ	1..1	Coding	Code defined by a terminology system Binding: ValueSet: Colombian Person Identifier Codes (required)
system	Σ	1..1	uri	Sistema de codificación colombiano Fixed Value: https://adres.fhir.guide/core/CodeSystem/ColombianPersonIdentifier
code	SΣ	1..1	code	CN \| RC \| TI \| CC \| PA \| CD \| CE \| SC \| PE \| PT \| PPT \| AS \| MS \| SI
display	Σ	1..1	string	Cédula de ciudadanía \| Tarjeta de identidad \| Registro civil +
system	Σ	0..1	uri	The namespace for the identifier value Required Pattern: https://fhir.minsalud.gov.co/rda/NamingSystem/RNEC
value	SΣ	1..1	string	Número de documento de identificación Example General: 123456
active	?!SΣ	1..1	boolean	true \| false
Slices for name	Σ	1..1	HumanName	Nombre(s) del paciente Slice: Unordered, Open by value:use
name:OfficialPatientName	Σ	1..1	HumanName	Nombre oficial del paciente
use	?!Σ	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Binding: NameUse (required): The use of a human name. Fixed Value: official
family	SΣ	1..1	string	Apellidos del paciente
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:FathersFamilyName	S	0..1	string	Primer apellido URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionFathersFamilyName
extension:MothersFamilyName	S	0..1	string	Segundo apellido URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionMothersFamilyName
given	SΣ	1..2	string	Primer y segundo nombre del paciente This repeating element order: Given Names appear in the correct order for presenting the name
gender	SΣ	0..1	code	male \| female \| other \| unknown Binding: AdministrativeGender (required)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ExtensionBiologicalGender	S	1..1	Coding	Hombre \| Mujer \| Indeterminado o Intersexual URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionBiologicalGender Binding: ValueSet: Colombian Gender group Codes (required)
birthDate	SΣ	1..1	date	Fecha de nacimiento (AAAA-MM-DD)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ExtensionBirthTime	S	0..1	time	Hora de nacimiento (HH:MM:SS) URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionBirthTime
deceased[x]	?!Σ	0..1		Indicates if the individual is deceased or not
deceasedBoolean			boolean
deceasedDateTime			dateTime
Slices for address	Σ	1..*	Address	Dirección de residencia del paciente Slice: Unordered, Open by value:id
address:HomeAddress	Σ	1..1	Address	An address for the individual
id		1..1	string	Unique id for inter-element referencing Required Pattern: HomeAddress-0
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ExtensionResidenceZone	S	1..1	Coding	Urbana \| Rural URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionResidenceZone Binding: ValueSet: Colombian Residence Zone Codes (required)
use	?!Σ	1..1	code	home \| work \| temp \| old \| billing - purpose of this address Binding: AddressUse (required): The use of an address. Fixed Value: home
type	Σ	1..1	code	postal \| physical \| both Binding: AddressType (required): The type of an address (physical / postal). Fixed Value: physical
city	SΣ	1..1	string	Municipio Example General: Erewhon
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ExtensionDivipolaMunicipality	S	0..1	Coding	Código del municipio de residencia habitual URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionDivipolaMunicipality Binding: ValueSet: DIVIPOLA Municipalities (required)
country	SΣ	1..1	string	País
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ExtensionCountryCode	S	1..1	Coding	Código País de residencia habitual URL: https://adres.fhir.guide/core/StructureDefinition/ExtensionCountryCode Binding: ValueSet: Iso 3166 Part 1 Numeric Codes (required)
managingOrganization	SΣ	0..1	Reference(Entidad Administradora de Planes de Beneficios en Salud - EAPBS (Organization))	Entidad Administradora de Planes de Beneficios en Salud (EAPBS)
Documentation for this format

Terminology Bindings

Path Conformance ValueSet / Code URI

Patient.identifier:NationalPersonIdentifier.use

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Patient	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Patient	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference \| %resource.descendants().as(canonical) \| %resource.descendants().as(uri) \| %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Patient	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Patient	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Patient	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	ALL elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	ALL extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Path	Conformance	ValueSet	URI
Patient.identifier:NationalPersonIdentifier.type.coding:InternationalCode	extensible	Identifier Type Codes `http://hl7.org/fhir/ValueSet/identifier-type` From the FHIR Standard
Patient.identifier:NationalPersonIdentifier.type.coding:ColombianCode	required	ColombianPersonIdentifierCodes `https://adres.fhir.guide/core/ValueSet/ColombianPersonIdentifierCodes` From this IG
Patient.gender	required	AdministrativeGender `http://hl7.org/fhir/ValueSet/administrative-gender` From the FHIR Standard

Resource Profile: Paciente (Patient) ADRES

Ámbito

Uso previsto

Restricciones y extensiones clave

Relación con otras guías o perfiles

Consideraciones adicionales

Formal Views of Profile Content

Terminology Bindings

Constraints

Terminology Bindings (Differential)

Terminology Bindings

Constraints

Terminology Bindings

Constraints

Terminology Bindings (Differential)

Terminology Bindings

Constraints