HL7® Iniciativa Costa Rica

Guía de Implementación Core de Costa Rica
0.1.0 - ci-build Costa Rica bandera

Guía de Implementación Core de Costa Rica - Compilación local de desarrollo (v0.1.0), generada con las herramientas de compilación de FHIR (HL7® FHIR® Standard). Vea el directorio de versiones publicadas

Perfil de los recursos: Paciente

URL oficial: https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient Versión: 0.1.0
Standards status: Draft Nivel de madurez: 0 Nombre computable: CRPatient

Persona que recibe atención de salud en Costa Rica: su identificación (cédula, DIMEX, pasaporte o expediente del establecimiento), su nombre, su sexo asignado al nacer, su fecha de nacimiento, sus datos de contacto, sus direcciones y sus contactos. Implementa el modelo lógico del paciente.

Usos:

También puede consultar los usos en las estadísticas de IG de FHIR

Vistas formales del contenido del perfil

Descripción de perfiles, diferenciales, instantáneas y sus representaciones.

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Patient C 0..* Patient Paciente: persona que recibe atención de salud en Costa Rica
Constraints: cr-identificador-unico, cr-paciente-identificador-vigente, cr-paciente-documento-unico, cr-paciente-pasaporte-expediente, cr-persona-apatrida, cr-persona-residencia, cr-paciente-nombre-temporal
... id Σ 0..1 id Identificador lógico del recurso
... meta Σ 0..1 Meta Metadatos del recurso
... implicitRules ?!Σ 0..1 uri Reglas que rigen la interpretación del contenido del recurso
... text 0..1 Narrative Resumen narrativo del recurso para su interpretación humana
Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos
... contained 0..* Resource Recursos contenidos en línea
... Slices para extension 1..* Extension Extensiones: sexo asignado al nacer y nacionalidad
Slice: Sin orden, Abierto by value:url
.... extension:sexoAlNacer S 1..1 (Complejo) Sexo asignado al nacer; unknown si se desconoce
URL: http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-recorded-sex-or-gender
.... extension:nacionalidad S 0..* (Complejo) Nacionalidad: una por país
URL: http://hl7.org/fhir/StructureDefinition/patient-nationality perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-nationality
... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
... identifier SΣC 1..* Identifier Identificación del paciente: cédula, DIMEX, pasaporte, número CCSS o expediente
Constraints: cr-paciente-identificador-system, cr-paciente-identificador-tipo, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-expediente-system, cr-expediente-assigner, cr-paciente-identificador-uso
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official (temp para el expediente) si está vigente; old si es histórico
Vinculación: IdentifierUse (required)
.... type SΣ 1..1 CodeableConcept Tipo de documento
Vinculación: Tipos de identificación del paciente (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | ccss | pasaporte/{país} | expediente/{establecimiento}}
Ejemplo General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento, sin guiones ni espacios
Ejemplo General: 123456
.... period Σ 0..1 Period Periodo durante el cual el identificador es o fue válido
.... assigner SΣ 0..1 Reference(Organización) Establecimiento que asignó el expediente (obligatorio en el expediente)
... active ?!Σ 0..1 boolean Indica si el registro del paciente está en uso activo
... name SΣ 0..* CRNombrePaciente Nombre conocido o denominación temporal
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
... gender Σ 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para el paciente; no sustituye el sexo asignado al nacer
... birthDate SΣC 0..1 date Fecha de nacimiento conocida, con la precisión disponible
Constraints: cr-persona-fecha-nacimiento, cr-paciente-fecha-estimada
.... id 0..1 string Identificador XML (o equivalente en JSON) para referenciar este elemento
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:fechaEstimada S 0..1 boolean Fecha de nacimiento estimada
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada
.... value 0..1 date Valor primitivo de la fecha
... deceased[x] ?!Σ 0..1 Indica si la persona ha fallecido
.... deceasedBoolean boolean
.... deceasedDateTime dateTime
... address SΣC 0..* CRAddress Dirección en Costa Rica o en otro país
Constraints: cr-direccion-uso-persona
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
...... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
...... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
...... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
.... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
.... type Σ 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección: postal, física o ambas
Ejemplo General: both
.... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
.... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
.... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
.... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
.... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
.... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
.... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
.... period Σ 0..1 Period Periodo durante el cual la dirección se usa o se usó
Ejemplo General: {"start":"2010-03-23","end":"2010-07-01"}
... maritalStatus S 0..1 CodeableConcept Estado civil: soltero, casado, divorciado, viudo o unión de hecho
Vinculación: Estado civil (required)
... multipleBirth[x] 0..1 Indica si el paciente forma parte de un nacimiento múltiple
.... multipleBirthBoolean boolean
.... multipleBirthInteger integer
... photo 0..* Attachment Imagen del paciente
... contact SC 0..* BackboneElement Persona de contacto, familiar o enlace de una institución
Constraints: pat-1
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:sexoAlNacer S 0..1 Coding Sexo asignado al nacer del contacto
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer
Vinculación: Sexo asignado al nacer (required)
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... relationship S 1..* CodeableConcept Relación con el paciente: cónyuge, padre, madre, tutor, hijo, hermano u otro familiar
Vinculación: Tipo de relación con el paciente (extensible)
.... name SC 1..1 CRHumanName Nombre del contacto
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico del contacto
Constraints: cr-telefono
.... address SC 0..1 CRAddress Dirección del contacto
Constraints: cr-direccion-uso-persona
..... Slices para extension Contenido y reglas para todos los slices
...... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
....... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
....... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
....... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
..... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
..... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
..... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
..... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
..... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
..... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
..... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
..... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
.... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para la persona de contacto
.... organization SC 0..1 Reference(Organización) Institución en cuyo nombre actúa la persona de contacto
..... id 0..1 id Identificador para referenciar este elemento dentro del recurso
..... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... reference ΣC 0..1 string Referencia literal, relativa, interna o URL absoluta
..... type Σ 0..1 uri Tipo de recurso al que apunta la referencia
Vinculación: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
..... identifier SΣC 1..1 Identifier Cédula jurídica de la organización
Constraints: cr-referencia-cedula-juridica
..... display ΣC 0..1 string Texto alternativo para identificar el recurso referenciado
.... period S 0..1 Period Periodo en que el contacto es válido
... communication 0..* BackboneElement Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... language 1..1 CodeableConcept Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
Vinculación: AllLanguages (required): Código del idioma conforme a BCP 47
Vinculaciones adicionalesPropósito
CommonLanguages Inicial
CommonLanguages Inicial
.... preferred 0..1 boolean Indica si este es el idioma preferido
... generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Profesional o servicio de atención primaria designado por el paciente
... managingOrganization Σ 0..1 Reference(Organization) Organización responsable de custodiar el expediente del paciente
... link ?!Σ 0..* BackboneElement Vínculo con otro recurso Patient o RelatedPerson de la misma persona
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... other Σ 1..1 Reference(Patient | RelatedPerson) Otro recurso Patient o RelatedPerson al que apunta el vínculo
.... type Σ 1..1 code replaced-by | replaces | refer | seealso
Vinculación: LinkType (required): Tipo de vínculo entre los registros de la misma persona

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso Conjunto de valores Versión Fuente
Patient.language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.identifier.use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Patient.identifier.type Base required Tipos de identificación del paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.address.use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.address.type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.address.city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.maritalStatus Base required Estado civil 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.relationship Base extensible Tipo de relación con el paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.contact.address.​city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.contact.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.contact.organization.​type Base extensible Resource Types 📍5.0.0 Estándar FHIR
Patient.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.link.type Base required Link Type 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expresión
cr-cedula-nacional-value error Patient.identifier Una cédula nacional (system https://hl7.or.cr/fhir/sid/cedula-nacional) tiene 9 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' implies value.matches('^[1-9][0-9]{8}$')
cr-dimex-value error Patient.identifier Un DIMEX (system https://hl7.or.cr/fhir/sid/dimex) tiene 11 o 12 dígitos, sin ceros a la izquierda. system = 'https://hl7.or.cr/fhir/sid/dimex' implies value.matches('^[1-9][0-9]{10,11}$')
cr-direccion-uso-persona error Patient.address, Patient.contact.address La dirección de una persona es su residencia (home) o una dirección temporal (temp). use.empty() or use = 'home' or use = 'temp'
cr-expediente-assigner error Patient.identifier Un expediente indica el establecimiento que lo asignó (assigner). system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') implies assigner.exists()
cr-expediente-system error Patient.identifier Un expediente usa el system https://hl7.or.cr/fhir/sid/expediente/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.startsWith('https://hl7.or.cr/fhir/sid/expediente') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/expediente/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error Patient No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-paciente-documento-unico error Patient Entre los identificadores vigentes hay a lo sumo una cédula nacional, un DIMEX y un número CCSS, y la cédula y el DIMEX no están vigentes a la vez. identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/ccss').count() <= 1 and (identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').exists() and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').exists()).not()
cr-paciente-fecha-estimada error Patient.birthDate La condición de estimada solo se registra cuando existe un valor de fecha de nacimiento. extension('https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada').exists() implies $this.hasValue()
cr-paciente-identificador-system error Patient.identifier El identificador es una cédula nacional, un DIMEX, un número CCSS, un pasaporte o un expediente, con su system de https://hl7.or.cr/fhir/sid/. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' or system = 'https://hl7.or.cr/fhir/sid/dimex' or system = 'https://hl7.or.cr/fhir/sid/ccss' or system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')
cr-paciente-identificador-tipo error Patient.identifier Si se envía el tipo, sus códigos CR o HL7 v2-0203 son coherentes con el system del identificador. type.empty() or (system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'cedula-nacional') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NI')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/dimex' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'dimex') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PRC')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/ccss' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'ccss') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NH')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'pasaporte') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PPN')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'expediente-local') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'MR')).exists())
cr-paciente-identificador-uso error Patient.identifier Un identificador vigente es temp si es un expediente y official si es de otro tipo; uno que ya no está vigente es old. iif(system.startsWith('https://hl7.or.cr/fhir/sid/expediente/'), use = 'temp' or use = 'old', use = 'official' or use = 'old')
cr-paciente-identificador-vigente error Patient El paciente tiene al menos un identificador vigente (use distinto de old). identifier.where(use != 'old').exists()
cr-paciente-nombre-temporal error Patient El paciente tiene como máximo una denominación temporal y un nombre conocido. name.where(use = 'temp').count() <= 1 and name.where(use = 'official').count() <= 1
cr-paciente-pasaporte-expediente error Patient Los pasaportes vigentes son de países emisores distintos y los expedientes vigentes, de establecimientos distintos. identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/')).system.isDistinct() and identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')).system.isDistinct()
cr-pasaporte-system error Patient.identifier Un pasaporte usa el system https://hl7.or.cr/fhir/sid/pasaporte/ seguido del código ISO 3166-1 alfa-3 del país emisor, y su número tiene de 6 a 15 letras o dígitos. system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte') implies (system.matches('^https://hl7\\.or\\.cr/fhir/sid/pasaporte/[A-Z]{3}$') and value.matches('^[A-Za-z0-9]{6,15}$'))
cr-persona-apatrida error Patient Una persona apátrida (nacionalidad con data-absent-reason not-applicable) no tiene otra nacionalidad. extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').extension('code').value.extension('http://hl7.org/fhir/StructureDefinition/data-absent-reason').where(value = 'not-applicable').exists() implies extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').count() = 1
cr-persona-fecha-nacimiento error Patient.birthDate La fecha de nacimiento no es definitivamente posterior a hoy; se respeta la precisión disponible. $this.lowBoundary() <= today().lowBoundary()
cr-persona-residencia error Patient La persona tiene a lo sumo una dirección de residencia (home). address.where(use = 'home').count() <= 1
cr-referencia-cedula-juridica error Patient.contact.organization.identifier La organización se identifica con su cédula jurídica: system https://hl7.or.cr/fhir/sid/cedula-juridica y 10 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-juridica' and value.matches('^[1-9][0-9]{9}$')
cr-telefono error Patient.telecom, Patient.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 buena práctica Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **TODOS** los elementos All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **TODAS** las extensiones Must have either extensions or value[x], not both extension.exists() != value.exists()
pat-1 error Patient.contact SHALL at least contain a contact's details or a reference to an organization name.exists() or telecom.exists() or address.exists() or organization.exists()

Esta estructura se deriva de Patient .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Patient C 0..* Patient Paciente: persona que recibe atención de salud en Costa Rica
Constraints: cr-identificador-unico, cr-paciente-identificador-vigente, cr-paciente-documento-unico, cr-paciente-pasaporte-expediente, cr-persona-apatrida, cr-persona-residencia, cr-paciente-nombre-temporal
... id 0..1 id Identificador lógico del recurso
... meta 0..1 Meta Metadatos del recurso
... implicitRules 0..1 uri Reglas que rigen la interpretación del contenido del recurso
... text 0..1 Narrative Resumen narrativo del recurso para su interpretación humana
... contained 0..* Resource Recursos contenidos en línea
... Slices para extension 1..* Extension Extensiones: sexo asignado al nacer y nacionalidad
Slice: Sin orden, Abierto by value:url
.... extension:sexoAlNacer S 1..1 (Complejo) Sexo asignado al nacer; unknown si se desconoce
URL: http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-recorded-sex-or-gender
.... extension:nacionalidad S 0..* (Complejo) Nacionalidad: una por país
URL: http://hl7.org/fhir/StructureDefinition/patient-nationality perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-nationality
... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
... identifier SC 1..* Identifier Identificación del paciente: cédula, DIMEX, pasaporte, número CCSS o expediente
Constraints: cr-paciente-identificador-system, cr-paciente-identificador-tipo, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-expediente-system, cr-expediente-assigner, cr-paciente-identificador-uso
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... use S 1..1 code official (temp para el expediente) si está vigente; old si es histórico
Vinculación: IdentifierUse (required)
.... type S 1..1 CodeableConcept Tipo de documento
Vinculación: Tipos de identificación del paciente (required)
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | ccss | pasaporte/{país} | expediente/{establecimiento}}
.... value S 1..1 string Número del documento, sin guiones ni espacios
.... period 0..1 Period Periodo durante el cual el identificador es o fue válido
.... assigner S 0..1 Reference(Organización) Establecimiento que asignó el expediente (obligatorio en el expediente)
... active 0..1 boolean Indica si el registro del paciente está en uso activo
... name S 0..* CRNombrePaciente Nombre conocido o denominación temporal
... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para el paciente; no sustituye el sexo asignado al nacer
... birthDate SC 0..1 date Fecha de nacimiento conocida, con la precisión disponible
Constraints: cr-persona-fecha-nacimiento, cr-paciente-fecha-estimada
.... id 0..1 string Identificador XML (o equivalente en JSON) para referenciar este elemento
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:fechaEstimada S 0..1 boolean Fecha de nacimiento estimada
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada
.... value 0..1 date Valor primitivo de la fecha
... deceased[x] 0..1 boolean, dateTime Indica si la persona ha fallecido
... address SC 0..* CRAddress Dirección en Costa Rica o en otro país
Constraints: cr-direccion-uso-persona
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... use S 1..1 code home (residencia) | temp (temporal)
.... type 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección: postal, física o ambas
.... period 0..1 Period Periodo durante el cual la dirección se usa o se usó
... maritalStatus S 0..1 CodeableConcept Estado civil: soltero, casado, divorciado, viudo o unión de hecho
Vinculación: Estado civil (required)
... multipleBirth[x] 0..1 boolean, integer Indica si el paciente forma parte de un nacimiento múltiple
... photo 0..* Attachment Imagen del paciente
... contact S 0..* BackboneElement Persona de contacto, familiar o enlace de una institución
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:sexoAlNacer S 0..1 Coding Sexo asignado al nacer del contacto
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer
Vinculación: Sexo asignado al nacer (required)
.... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... relationship S 1..* CodeableConcept Relación con el paciente: cónyuge, padre, madre, tutor, hijo, hermano u otro familiar
Vinculación: Tipo de relación con el paciente (extensible)
.... name S 1..1 CRHumanName Nombre del contacto
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico del contacto
Constraints: cr-telefono
.... address SC 0..1 CRAddress Dirección del contacto
Constraints: cr-direccion-uso-persona
..... use S 1..1 code home (residencia) | temp (temporal)
.... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para la persona de contacto
.... organization S 0..1 Reference(Organización) Institución en cuyo nombre actúa la persona de contacto
..... id 0..1 id Identificador para referenciar este elemento dentro del recurso
..... extension 0..* Extension Contenido adicional definido por las implementaciones
..... reference 0..1 string Referencia literal, relativa, interna o URL absoluta
..... type 0..1 uri Tipo de recurso al que apunta la referencia
..... identifier SC 1..1 Identifier Cédula jurídica de la organización
Constraints: cr-referencia-cedula-juridica
..... display 0..1 string Texto alternativo para identificar el recurso referenciado
.... period S 0..1 Period Periodo en que el contacto es válido
... communication 0..* BackboneElement Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... language 1..1 CodeableConcept Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
Vinculación: AllLanguages (required): Código del idioma conforme a BCP 47
Vinculaciones adicionalesPropósito
CommonLanguages Inicial
.... preferred 0..1 boolean Indica si este es el idioma preferido
... generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Profesional o servicio de atención primaria designado por el paciente
... managingOrganization 0..1 Reference(Organization) Organización responsable de custodiar el expediente del paciente
... link 0..* BackboneElement Vínculo con otro recurso Patient o RelatedPerson de la misma persona
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... other 1..1 Reference(Patient | RelatedPerson) Otro recurso Patient o RelatedPerson al que apunta el vínculo
.... type 1..1 code replaced-by | replaces | refer | seealso
Vinculación: LinkType (required): Tipo de vínculo entre los registros de la misma persona

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso Conjunto de valores Versión Fuente
Patient.language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.identifier.use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Patient.identifier.type Base required Tipos de identificación del paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.address.type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.maritalStatus Base required Estado civil 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.relationship Base extensible Tipo de relación con el paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.link.type Base required Link Type 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expresión
cr-cedula-nacional-value error Patient.identifier Una cédula nacional (system https://hl7.or.cr/fhir/sid/cedula-nacional) tiene 9 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' implies value.matches('^[1-9][0-9]{8}$')
cr-dimex-value error Patient.identifier Un DIMEX (system https://hl7.or.cr/fhir/sid/dimex) tiene 11 o 12 dígitos, sin ceros a la izquierda. system = 'https://hl7.or.cr/fhir/sid/dimex' implies value.matches('^[1-9][0-9]{10,11}$')
cr-direccion-uso-persona error Patient.address, Patient.contact.address La dirección de una persona es su residencia (home) o una dirección temporal (temp). use.empty() or use = 'home' or use = 'temp'
cr-expediente-assigner error Patient.identifier Un expediente indica el establecimiento que lo asignó (assigner). system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') implies assigner.exists()
cr-expediente-system error Patient.identifier Un expediente usa el system https://hl7.or.cr/fhir/sid/expediente/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.startsWith('https://hl7.or.cr/fhir/sid/expediente') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/expediente/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error Patient No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-paciente-documento-unico error Patient Entre los identificadores vigentes hay a lo sumo una cédula nacional, un DIMEX y un número CCSS, y la cédula y el DIMEX no están vigentes a la vez. identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/ccss').count() <= 1 and (identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').exists() and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').exists()).not()
cr-paciente-fecha-estimada error Patient.birthDate La condición de estimada solo se registra cuando existe un valor de fecha de nacimiento. extension('https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada').exists() implies $this.hasValue()
cr-paciente-identificador-system error Patient.identifier El identificador es una cédula nacional, un DIMEX, un número CCSS, un pasaporte o un expediente, con su system de https://hl7.or.cr/fhir/sid/. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' or system = 'https://hl7.or.cr/fhir/sid/dimex' or system = 'https://hl7.or.cr/fhir/sid/ccss' or system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')
cr-paciente-identificador-tipo error Patient.identifier Si se envía el tipo, sus códigos CR o HL7 v2-0203 son coherentes con el system del identificador. type.empty() or (system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'cedula-nacional') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NI')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/dimex' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'dimex') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PRC')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/ccss' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'ccss') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NH')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'pasaporte') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PPN')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'expediente-local') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'MR')).exists())
cr-paciente-identificador-uso error Patient.identifier Un identificador vigente es temp si es un expediente y official si es de otro tipo; uno que ya no está vigente es old. iif(system.startsWith('https://hl7.or.cr/fhir/sid/expediente/'), use = 'temp' or use = 'old', use = 'official' or use = 'old')
cr-paciente-identificador-vigente error Patient El paciente tiene al menos un identificador vigente (use distinto de old). identifier.where(use != 'old').exists()
cr-paciente-nombre-temporal error Patient El paciente tiene como máximo una denominación temporal y un nombre conocido. name.where(use = 'temp').count() <= 1 and name.where(use = 'official').count() <= 1
cr-paciente-pasaporte-expediente error Patient Los pasaportes vigentes son de países emisores distintos y los expedientes vigentes, de establecimientos distintos. identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/')).system.isDistinct() and identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')).system.isDistinct()
cr-pasaporte-system error Patient.identifier Un pasaporte usa el system https://hl7.or.cr/fhir/sid/pasaporte/ seguido del código ISO 3166-1 alfa-3 del país emisor, y su número tiene de 6 a 15 letras o dígitos. system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte') implies (system.matches('^https://hl7\\.or\\.cr/fhir/sid/pasaporte/[A-Z]{3}$') and value.matches('^[A-Za-z0-9]{6,15}$'))
cr-persona-apatrida error Patient Una persona apátrida (nacionalidad con data-absent-reason not-applicable) no tiene otra nacionalidad. extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').extension('code').value.extension('http://hl7.org/fhir/StructureDefinition/data-absent-reason').where(value = 'not-applicable').exists() implies extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').count() = 1
cr-persona-fecha-nacimiento error Patient.birthDate La fecha de nacimiento no es definitivamente posterior a hoy; se respeta la precisión disponible. $this.lowBoundary() <= today().lowBoundary()
cr-persona-residencia error Patient La persona tiene a lo sumo una dirección de residencia (home). address.where(use = 'home').count() <= 1
cr-referencia-cedula-juridica error Patient.contact.organization.identifier La organización se identifica con su cédula jurídica: system https://hl7.or.cr/fhir/sid/cedula-juridica y 10 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-juridica' and value.matches('^[1-9][0-9]{9}$')
cr-telefono error Patient.telecom, Patient.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Patient C 0..* Patient Paciente: persona que recibe atención de salud en Costa Rica
Constraints: cr-identificador-unico, cr-paciente-identificador-vigente, cr-paciente-documento-unico, cr-paciente-pasaporte-expediente, cr-persona-apatrida, cr-persona-residencia, cr-paciente-nombre-temporal
... id Σ 0..1 id Identificador lógico del recurso
... meta Σ 0..1 Meta Metadatos del recurso
... implicitRules ?!Σ 0..1 uri Reglas que rigen la interpretación del contenido del recurso
... text 0..1 Narrative Resumen narrativo del recurso para su interpretación humana
Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos
... contained 0..* Resource Recursos contenidos en línea
... Slices para extension 1..* Extension Extensiones: sexo asignado al nacer y nacionalidad
Slice: Sin orden, Abierto by value:url
.... extension:sexoAlNacer S 1..1 (Complejo) Sexo asignado al nacer; unknown si se desconoce
URL: http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-recorded-sex-or-gender
.... extension:nacionalidad S 0..* (Complejo) Nacionalidad: una por país
URL: http://hl7.org/fhir/StructureDefinition/patient-nationality perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-nationality
... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
... identifier SΣC 1..* Identifier Identificación del paciente: cédula, DIMEX, pasaporte, número CCSS o expediente
Constraints: cr-paciente-identificador-system, cr-paciente-identificador-tipo, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-expediente-system, cr-expediente-assigner, cr-paciente-identificador-uso
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official (temp para el expediente) si está vigente; old si es histórico
Vinculación: IdentifierUse (required)
.... type SΣ 1..1 CodeableConcept Tipo de documento
Vinculación: Tipos de identificación del paciente (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | ccss | pasaporte/{país} | expediente/{establecimiento}}
Ejemplo General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento, sin guiones ni espacios
Ejemplo General: 123456
.... period Σ 0..1 Period Periodo durante el cual el identificador es o fue válido
.... assigner SΣ 0..1 Reference(Organización) Establecimiento que asignó el expediente (obligatorio en el expediente)
... active ?!Σ 0..1 boolean Indica si el registro del paciente está en uso activo
... name SΣ 0..* CRNombrePaciente Nombre conocido o denominación temporal
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
... gender Σ 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para el paciente; no sustituye el sexo asignado al nacer
... birthDate SΣC 0..1 date Fecha de nacimiento conocida, con la precisión disponible
Constraints: cr-persona-fecha-nacimiento, cr-paciente-fecha-estimada
.... id 0..1 string Identificador XML (o equivalente en JSON) para referenciar este elemento
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:fechaEstimada S 0..1 boolean Fecha de nacimiento estimada
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada
.... value 0..1 date Valor primitivo de la fecha
... deceased[x] ?!Σ 0..1 Indica si la persona ha fallecido
.... deceasedBoolean boolean
.... deceasedDateTime dateTime
... address SΣC 0..* CRAddress Dirección en Costa Rica o en otro país
Constraints: cr-direccion-uso-persona
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
...... id 0..1 id Identificador único para referenciar elementos entre sí
...... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
...... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
...... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
.... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
.... type Σ 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección: postal, física o ambas
Ejemplo General: both
.... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
.... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
.... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
.... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
.... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
.... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
.... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
.... period Σ 0..1 Period Periodo durante el cual la dirección se usa o se usó
Ejemplo General: {"start":"2010-03-23","end":"2010-07-01"}
... maritalStatus S 0..1 CodeableConcept Estado civil: soltero, casado, divorciado, viudo o unión de hecho
Vinculación: Estado civil (required)
... multipleBirth[x] 0..1 Indica si el paciente forma parte de un nacimiento múltiple
.... multipleBirthBoolean boolean
.... multipleBirthInteger integer
... photo 0..* Attachment Imagen del paciente
... contact SC 0..* BackboneElement Persona de contacto, familiar o enlace de una institución
Constraints: pat-1
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:sexoAlNacer S 0..1 Coding Sexo asignado al nacer del contacto
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer
Vinculación: Sexo asignado al nacer (required)
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... relationship S 1..* CodeableConcept Relación con el paciente: cónyuge, padre, madre, tutor, hijo, hermano u otro familiar
Vinculación: Tipo de relación con el paciente (extensible)
.... name SC 1..1 CRHumanName Nombre del contacto
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico del contacto
Constraints: cr-telefono
.... address SC 0..1 CRAddress Dirección del contacto
Constraints: cr-direccion-uso-persona
..... id 0..1 id Identificador único para referenciar elementos entre sí
..... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
...... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
....... id 0..1 id Identificador único para referenciar elementos entre sí
....... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
....... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
....... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
..... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
..... type Σ 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección (física o postal).
Ejemplo General: both
..... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
..... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
..... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
..... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
..... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
..... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
..... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
..... period Σ 0..1 Period Periodo durante el que se usa o se usó la dirección
Ejemplo General: {"start":"2010-03-23","end":"2010-07-01"}
.... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para la persona de contacto
.... organization SC 0..1 Reference(Organización) Institución en cuyo nombre actúa la persona de contacto
..... id 0..1 id Identificador para referenciar este elemento dentro del recurso
..... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... reference ΣC 0..1 string Referencia literal, relativa, interna o URL absoluta
..... type Σ 0..1 uri Tipo de recurso al que apunta la referencia
Vinculación: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
..... identifier SΣC 1..1 Identifier Cédula jurídica de la organización
Constraints: cr-referencia-cedula-juridica
..... display ΣC 0..1 string Texto alternativo para identificar el recurso referenciado
.... period S 0..1 Period Periodo en que el contacto es válido
... communication 0..* BackboneElement Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... language 1..1 CodeableConcept Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
Vinculación: AllLanguages (required): Código del idioma conforme a BCP 47
Vinculaciones adicionalesPropósito
CommonLanguages Inicial
CommonLanguages Inicial
.... preferred 0..1 boolean Indica si este es el idioma preferido
... generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Profesional o servicio de atención primaria designado por el paciente
... managingOrganization Σ 0..1 Reference(Organization) Organización responsable de custodiar el expediente del paciente
... link ?!Σ 0..* BackboneElement Vínculo con otro recurso Patient o RelatedPerson de la misma persona
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... other Σ 1..1 Reference(Patient | RelatedPerson) Otro recurso Patient o RelatedPerson al que apunta el vínculo
.... type Σ 1..1 code replaced-by | replaces | refer | seealso
Vinculación: LinkType (required): Tipo de vínculo entre los registros de la misma persona

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso Conjunto de valores Versión Fuente
Patient.language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.identifier.use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Patient.identifier.type Base required Tipos de identificación del paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.address.use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.address.type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.address.city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.maritalStatus Base required Estado civil 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.relationship Base extensible Tipo de relación con el paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.contact.address.​type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.contact.address.​city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.contact.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.contact.organization.​type Base extensible Resource Types 📍5.0.0 Estándar FHIR
Patient.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.link.type Base required Link Type 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expresión
cr-cedula-nacional-value error Patient.identifier Una cédula nacional (system https://hl7.or.cr/fhir/sid/cedula-nacional) tiene 9 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' implies value.matches('^[1-9][0-9]{8}$')
cr-dimex-value error Patient.identifier Un DIMEX (system https://hl7.or.cr/fhir/sid/dimex) tiene 11 o 12 dígitos, sin ceros a la izquierda. system = 'https://hl7.or.cr/fhir/sid/dimex' implies value.matches('^[1-9][0-9]{10,11}$')
cr-direccion-uso-persona error Patient.address, Patient.contact.address La dirección de una persona es su residencia (home) o una dirección temporal (temp). use.empty() or use = 'home' or use = 'temp'
cr-expediente-assigner error Patient.identifier Un expediente indica el establecimiento que lo asignó (assigner). system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') implies assigner.exists()
cr-expediente-system error Patient.identifier Un expediente usa el system https://hl7.or.cr/fhir/sid/expediente/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.startsWith('https://hl7.or.cr/fhir/sid/expediente') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/expediente/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error Patient No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-paciente-documento-unico error Patient Entre los identificadores vigentes hay a lo sumo una cédula nacional, un DIMEX y un número CCSS, y la cédula y el DIMEX no están vigentes a la vez. identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/ccss').count() <= 1 and (identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').exists() and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').exists()).not()
cr-paciente-fecha-estimada error Patient.birthDate La condición de estimada solo se registra cuando existe un valor de fecha de nacimiento. extension('https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada').exists() implies $this.hasValue()
cr-paciente-identificador-system error Patient.identifier El identificador es una cédula nacional, un DIMEX, un número CCSS, un pasaporte o un expediente, con su system de https://hl7.or.cr/fhir/sid/. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' or system = 'https://hl7.or.cr/fhir/sid/dimex' or system = 'https://hl7.or.cr/fhir/sid/ccss' or system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')
cr-paciente-identificador-tipo error Patient.identifier Si se envía el tipo, sus códigos CR o HL7 v2-0203 son coherentes con el system del identificador. type.empty() or (system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'cedula-nacional') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NI')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/dimex' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'dimex') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PRC')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/ccss' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'ccss') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NH')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'pasaporte') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PPN')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'expediente-local') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'MR')).exists())
cr-paciente-identificador-uso error Patient.identifier Un identificador vigente es temp si es un expediente y official si es de otro tipo; uno que ya no está vigente es old. iif(system.startsWith('https://hl7.or.cr/fhir/sid/expediente/'), use = 'temp' or use = 'old', use = 'official' or use = 'old')
cr-paciente-identificador-vigente error Patient El paciente tiene al menos un identificador vigente (use distinto de old). identifier.where(use != 'old').exists()
cr-paciente-nombre-temporal error Patient El paciente tiene como máximo una denominación temporal y un nombre conocido. name.where(use = 'temp').count() <= 1 and name.where(use = 'official').count() <= 1
cr-paciente-pasaporte-expediente error Patient Los pasaportes vigentes son de países emisores distintos y los expedientes vigentes, de establecimientos distintos. identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/')).system.isDistinct() and identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')).system.isDistinct()
cr-pasaporte-system error Patient.identifier Un pasaporte usa el system https://hl7.or.cr/fhir/sid/pasaporte/ seguido del código ISO 3166-1 alfa-3 del país emisor, y su número tiene de 6 a 15 letras o dígitos. system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte') implies (system.matches('^https://hl7\\.or\\.cr/fhir/sid/pasaporte/[A-Z]{3}$') and value.matches('^[A-Za-z0-9]{6,15}$'))
cr-persona-apatrida error Patient Una persona apátrida (nacionalidad con data-absent-reason not-applicable) no tiene otra nacionalidad. extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').extension('code').value.extension('http://hl7.org/fhir/StructureDefinition/data-absent-reason').where(value = 'not-applicable').exists() implies extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').count() = 1
cr-persona-fecha-nacimiento error Patient.birthDate La fecha de nacimiento no es definitivamente posterior a hoy; se respeta la precisión disponible. $this.lowBoundary() <= today().lowBoundary()
cr-persona-residencia error Patient La persona tiene a lo sumo una dirección de residencia (home). address.where(use = 'home').count() <= 1
cr-referencia-cedula-juridica error Patient.contact.organization.identifier La organización se identifica con su cédula jurídica: system https://hl7.or.cr/fhir/sid/cedula-juridica y 10 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-juridica' and value.matches('^[1-9][0-9]{9}$')
cr-telefono error Patient.telecom, Patient.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 buena práctica Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **TODOS** los elementos All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **TODAS** las extensiones Must have either extensions or value[x], not both extension.exists() != value.exists()
pat-1 error Patient.contact SHALL at least contain a contact's details or a reference to an organization name.exists() or telecom.exists() or address.exists() or organization.exists()

Vista de elementos clave

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Patient C 0..* Patient Paciente: persona que recibe atención de salud en Costa Rica
Constraints: cr-identificador-unico, cr-paciente-identificador-vigente, cr-paciente-documento-unico, cr-paciente-pasaporte-expediente, cr-persona-apatrida, cr-persona-residencia, cr-paciente-nombre-temporal
... id Σ 0..1 id Identificador lógico del recurso
... meta Σ 0..1 Meta Metadatos del recurso
... implicitRules ?!Σ 0..1 uri Reglas que rigen la interpretación del contenido del recurso
... text 0..1 Narrative Resumen narrativo del recurso para su interpretación humana
Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos
... contained 0..* Resource Recursos contenidos en línea
... Slices para extension 1..* Extension Extensiones: sexo asignado al nacer y nacionalidad
Slice: Sin orden, Abierto by value:url
.... extension:sexoAlNacer S 1..1 (Complejo) Sexo asignado al nacer; unknown si se desconoce
URL: http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-recorded-sex-or-gender
.... extension:nacionalidad S 0..* (Complejo) Nacionalidad: una por país
URL: http://hl7.org/fhir/StructureDefinition/patient-nationality perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-nationality
... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
... identifier SΣC 1..* Identifier Identificación del paciente: cédula, DIMEX, pasaporte, número CCSS o expediente
Constraints: cr-paciente-identificador-system, cr-paciente-identificador-tipo, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-expediente-system, cr-expediente-assigner, cr-paciente-identificador-uso
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official (temp para el expediente) si está vigente; old si es histórico
Vinculación: IdentifierUse (required)
.... type SΣ 1..1 CodeableConcept Tipo de documento
Vinculación: Tipos de identificación del paciente (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | ccss | pasaporte/{país} | expediente/{establecimiento}}
Ejemplo General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento, sin guiones ni espacios
Ejemplo General: 123456
.... period Σ 0..1 Period Periodo durante el cual el identificador es o fue válido
.... assigner SΣ 0..1 Reference(Organización) Establecimiento que asignó el expediente (obligatorio en el expediente)
... active ?!Σ 0..1 boolean Indica si el registro del paciente está en uso activo
... name SΣ 0..* CRNombrePaciente Nombre conocido o denominación temporal
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
... gender Σ 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para el paciente; no sustituye el sexo asignado al nacer
... birthDate SΣC 0..1 date Fecha de nacimiento conocida, con la precisión disponible
Constraints: cr-persona-fecha-nacimiento, cr-paciente-fecha-estimada
.... id 0..1 string Identificador XML (o equivalente en JSON) para referenciar este elemento
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:fechaEstimada S 0..1 boolean Fecha de nacimiento estimada
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada
.... value 0..1 date Valor primitivo de la fecha
... deceased[x] ?!Σ 0..1 Indica si la persona ha fallecido
.... deceasedBoolean boolean
.... deceasedDateTime dateTime
... address SΣC 0..* CRAddress Dirección en Costa Rica o en otro país
Constraints: cr-direccion-uso-persona
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
...... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
...... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
...... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
.... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
.... type Σ 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección: postal, física o ambas
Ejemplo General: both
.... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
.... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
.... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
.... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
.... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
.... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
.... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
.... period Σ 0..1 Period Periodo durante el cual la dirección se usa o se usó
Ejemplo General: {"start":"2010-03-23","end":"2010-07-01"}
... maritalStatus S 0..1 CodeableConcept Estado civil: soltero, casado, divorciado, viudo o unión de hecho
Vinculación: Estado civil (required)
... multipleBirth[x] 0..1 Indica si el paciente forma parte de un nacimiento múltiple
.... multipleBirthBoolean boolean
.... multipleBirthInteger integer
... photo 0..* Attachment Imagen del paciente
... contact SC 0..* BackboneElement Persona de contacto, familiar o enlace de una institución
Constraints: pat-1
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:sexoAlNacer S 0..1 Coding Sexo asignado al nacer del contacto
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer
Vinculación: Sexo asignado al nacer (required)
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... relationship S 1..* CodeableConcept Relación con el paciente: cónyuge, padre, madre, tutor, hijo, hermano u otro familiar
Vinculación: Tipo de relación con el paciente (extensible)
.... name SC 1..1 CRHumanName Nombre del contacto
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico del contacto
Constraints: cr-telefono
.... address SC 0..1 CRAddress Dirección del contacto
Constraints: cr-direccion-uso-persona
..... Slices para extension Contenido y reglas para todos los slices
...... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
....... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
....... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
....... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
..... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
..... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
..... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
..... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
..... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
..... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
..... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
..... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
.... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para la persona de contacto
.... organization SC 0..1 Reference(Organización) Institución en cuyo nombre actúa la persona de contacto
..... id 0..1 id Identificador para referenciar este elemento dentro del recurso
..... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... reference ΣC 0..1 string Referencia literal, relativa, interna o URL absoluta
..... type Σ 0..1 uri Tipo de recurso al que apunta la referencia
Vinculación: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
..... identifier SΣC 1..1 Identifier Cédula jurídica de la organización
Constraints: cr-referencia-cedula-juridica
..... display ΣC 0..1 string Texto alternativo para identificar el recurso referenciado
.... period S 0..1 Period Periodo en que el contacto es válido
... communication 0..* BackboneElement Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... language 1..1 CodeableConcept Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
Vinculación: AllLanguages (required): Código del idioma conforme a BCP 47
Vinculaciones adicionalesPropósito
CommonLanguages Inicial
CommonLanguages Inicial
.... preferred 0..1 boolean Indica si este es el idioma preferido
... generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Profesional o servicio de atención primaria designado por el paciente
... managingOrganization Σ 0..1 Reference(Organization) Organización responsable de custodiar el expediente del paciente
... link ?!Σ 0..* BackboneElement Vínculo con otro recurso Patient o RelatedPerson de la misma persona
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... other Σ 1..1 Reference(Patient | RelatedPerson) Otro recurso Patient o RelatedPerson al que apunta el vínculo
.... type Σ 1..1 code replaced-by | replaces | refer | seealso
Vinculación: LinkType (required): Tipo de vínculo entre los registros de la misma persona

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso Conjunto de valores Versión Fuente
Patient.language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.identifier.use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Patient.identifier.type Base required Tipos de identificación del paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.address.use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.address.type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.address.city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.maritalStatus Base required Estado civil 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.relationship Base extensible Tipo de relación con el paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.contact.address.​city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.contact.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.contact.organization.​type Base extensible Resource Types 📍5.0.0 Estándar FHIR
Patient.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.link.type Base required Link Type 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expresión
cr-cedula-nacional-value error Patient.identifier Una cédula nacional (system https://hl7.or.cr/fhir/sid/cedula-nacional) tiene 9 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' implies value.matches('^[1-9][0-9]{8}$')
cr-dimex-value error Patient.identifier Un DIMEX (system https://hl7.or.cr/fhir/sid/dimex) tiene 11 o 12 dígitos, sin ceros a la izquierda. system = 'https://hl7.or.cr/fhir/sid/dimex' implies value.matches('^[1-9][0-9]{10,11}$')
cr-direccion-uso-persona error Patient.address, Patient.contact.address La dirección de una persona es su residencia (home) o una dirección temporal (temp). use.empty() or use = 'home' or use = 'temp'
cr-expediente-assigner error Patient.identifier Un expediente indica el establecimiento que lo asignó (assigner). system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') implies assigner.exists()
cr-expediente-system error Patient.identifier Un expediente usa el system https://hl7.or.cr/fhir/sid/expediente/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.startsWith('https://hl7.or.cr/fhir/sid/expediente') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/expediente/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error Patient No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-paciente-documento-unico error Patient Entre los identificadores vigentes hay a lo sumo una cédula nacional, un DIMEX y un número CCSS, y la cédula y el DIMEX no están vigentes a la vez. identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/ccss').count() <= 1 and (identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').exists() and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').exists()).not()
cr-paciente-fecha-estimada error Patient.birthDate La condición de estimada solo se registra cuando existe un valor de fecha de nacimiento. extension('https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada').exists() implies $this.hasValue()
cr-paciente-identificador-system error Patient.identifier El identificador es una cédula nacional, un DIMEX, un número CCSS, un pasaporte o un expediente, con su system de https://hl7.or.cr/fhir/sid/. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' or system = 'https://hl7.or.cr/fhir/sid/dimex' or system = 'https://hl7.or.cr/fhir/sid/ccss' or system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')
cr-paciente-identificador-tipo error Patient.identifier Si se envía el tipo, sus códigos CR o HL7 v2-0203 son coherentes con el system del identificador. type.empty() or (system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'cedula-nacional') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NI')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/dimex' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'dimex') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PRC')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/ccss' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'ccss') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NH')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'pasaporte') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PPN')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'expediente-local') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'MR')).exists())
cr-paciente-identificador-uso error Patient.identifier Un identificador vigente es temp si es un expediente y official si es de otro tipo; uno que ya no está vigente es old. iif(system.startsWith('https://hl7.or.cr/fhir/sid/expediente/'), use = 'temp' or use = 'old', use = 'official' or use = 'old')
cr-paciente-identificador-vigente error Patient El paciente tiene al menos un identificador vigente (use distinto de old). identifier.where(use != 'old').exists()
cr-paciente-nombre-temporal error Patient El paciente tiene como máximo una denominación temporal y un nombre conocido. name.where(use = 'temp').count() <= 1 and name.where(use = 'official').count() <= 1
cr-paciente-pasaporte-expediente error Patient Los pasaportes vigentes son de países emisores distintos y los expedientes vigentes, de establecimientos distintos. identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/')).system.isDistinct() and identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')).system.isDistinct()
cr-pasaporte-system error Patient.identifier Un pasaporte usa el system https://hl7.or.cr/fhir/sid/pasaporte/ seguido del código ISO 3166-1 alfa-3 del país emisor, y su número tiene de 6 a 15 letras o dígitos. system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte') implies (system.matches('^https://hl7\\.or\\.cr/fhir/sid/pasaporte/[A-Z]{3}$') and value.matches('^[A-Za-z0-9]{6,15}$'))
cr-persona-apatrida error Patient Una persona apátrida (nacionalidad con data-absent-reason not-applicable) no tiene otra nacionalidad. extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').extension('code').value.extension('http://hl7.org/fhir/StructureDefinition/data-absent-reason').where(value = 'not-applicable').exists() implies extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').count() = 1
cr-persona-fecha-nacimiento error Patient.birthDate La fecha de nacimiento no es definitivamente posterior a hoy; se respeta la precisión disponible. $this.lowBoundary() <= today().lowBoundary()
cr-persona-residencia error Patient La persona tiene a lo sumo una dirección de residencia (home). address.where(use = 'home').count() <= 1
cr-referencia-cedula-juridica error Patient.contact.organization.identifier La organización se identifica con su cédula jurídica: system https://hl7.or.cr/fhir/sid/cedula-juridica y 10 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-juridica' and value.matches('^[1-9][0-9]{9}$')
cr-telefono error Patient.telecom, Patient.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 buena práctica Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **TODOS** los elementos All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **TODAS** las extensiones Must have either extensions or value[x], not both extension.exists() != value.exists()
pat-1 error Patient.contact SHALL at least contain a contact's details or a reference to an organization name.exists() or telecom.exists() or address.exists() or organization.exists()

Vista diferencial

Esta estructura se deriva de Patient .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Patient C 0..* Patient Paciente: persona que recibe atención de salud en Costa Rica
Constraints: cr-identificador-unico, cr-paciente-identificador-vigente, cr-paciente-documento-unico, cr-paciente-pasaporte-expediente, cr-persona-apatrida, cr-persona-residencia, cr-paciente-nombre-temporal
... id 0..1 id Identificador lógico del recurso
... meta 0..1 Meta Metadatos del recurso
... implicitRules 0..1 uri Reglas que rigen la interpretación del contenido del recurso
... text 0..1 Narrative Resumen narrativo del recurso para su interpretación humana
... contained 0..* Resource Recursos contenidos en línea
... Slices para extension 1..* Extension Extensiones: sexo asignado al nacer y nacionalidad
Slice: Sin orden, Abierto by value:url
.... extension:sexoAlNacer S 1..1 (Complejo) Sexo asignado al nacer; unknown si se desconoce
URL: http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-recorded-sex-or-gender
.... extension:nacionalidad S 0..* (Complejo) Nacionalidad: una por país
URL: http://hl7.org/fhir/StructureDefinition/patient-nationality perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-nationality
... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
... identifier SC 1..* Identifier Identificación del paciente: cédula, DIMEX, pasaporte, número CCSS o expediente
Constraints: cr-paciente-identificador-system, cr-paciente-identificador-tipo, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-expediente-system, cr-expediente-assigner, cr-paciente-identificador-uso
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... use S 1..1 code official (temp para el expediente) si está vigente; old si es histórico
Vinculación: IdentifierUse (required)
.... type S 1..1 CodeableConcept Tipo de documento
Vinculación: Tipos de identificación del paciente (required)
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | ccss | pasaporte/{país} | expediente/{establecimiento}}
.... value S 1..1 string Número del documento, sin guiones ni espacios
.... period 0..1 Period Periodo durante el cual el identificador es o fue válido
.... assigner S 0..1 Reference(Organización) Establecimiento que asignó el expediente (obligatorio en el expediente)
... active 0..1 boolean Indica si el registro del paciente está en uso activo
... name S 0..* CRNombrePaciente Nombre conocido o denominación temporal
... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para el paciente; no sustituye el sexo asignado al nacer
... birthDate SC 0..1 date Fecha de nacimiento conocida, con la precisión disponible
Constraints: cr-persona-fecha-nacimiento, cr-paciente-fecha-estimada
.... id 0..1 string Identificador XML (o equivalente en JSON) para referenciar este elemento
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:fechaEstimada S 0..1 boolean Fecha de nacimiento estimada
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada
.... value 0..1 date Valor primitivo de la fecha
... deceased[x] 0..1 boolean, dateTime Indica si la persona ha fallecido
... address SC 0..* CRAddress Dirección en Costa Rica o en otro país
Constraints: cr-direccion-uso-persona
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... use S 1..1 code home (residencia) | temp (temporal)
.... type 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección: postal, física o ambas
.... period 0..1 Period Periodo durante el cual la dirección se usa o se usó
... maritalStatus S 0..1 CodeableConcept Estado civil: soltero, casado, divorciado, viudo o unión de hecho
Vinculación: Estado civil (required)
... multipleBirth[x] 0..1 boolean, integer Indica si el paciente forma parte de un nacimiento múltiple
... photo 0..* Attachment Imagen del paciente
... contact S 0..* BackboneElement Persona de contacto, familiar o enlace de una institución
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:sexoAlNacer S 0..1 Coding Sexo asignado al nacer del contacto
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer
Vinculación: Sexo asignado al nacer (required)
.... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... relationship S 1..* CodeableConcept Relación con el paciente: cónyuge, padre, madre, tutor, hijo, hermano u otro familiar
Vinculación: Tipo de relación con el paciente (extensible)
.... name S 1..1 CRHumanName Nombre del contacto
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico del contacto
Constraints: cr-telefono
.... address SC 0..1 CRAddress Dirección del contacto
Constraints: cr-direccion-uso-persona
..... use S 1..1 code home (residencia) | temp (temporal)
.... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para la persona de contacto
.... organization S 0..1 Reference(Organización) Institución en cuyo nombre actúa la persona de contacto
..... id 0..1 id Identificador para referenciar este elemento dentro del recurso
..... extension 0..* Extension Contenido adicional definido por las implementaciones
..... reference 0..1 string Referencia literal, relativa, interna o URL absoluta
..... type 0..1 uri Tipo de recurso al que apunta la referencia
..... identifier SC 1..1 Identifier Cédula jurídica de la organización
Constraints: cr-referencia-cedula-juridica
..... display 0..1 string Texto alternativo para identificar el recurso referenciado
.... period S 0..1 Period Periodo en que el contacto es válido
... communication 0..* BackboneElement Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... language 1..1 CodeableConcept Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
Vinculación: AllLanguages (required): Código del idioma conforme a BCP 47
Vinculaciones adicionalesPropósito
CommonLanguages Inicial
.... preferred 0..1 boolean Indica si este es el idioma preferido
... generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Profesional o servicio de atención primaria designado por el paciente
... managingOrganization 0..1 Reference(Organization) Organización responsable de custodiar el expediente del paciente
... link 0..* BackboneElement Vínculo con otro recurso Patient o RelatedPerson de la misma persona
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... other 1..1 Reference(Patient | RelatedPerson) Otro recurso Patient o RelatedPerson al que apunta el vínculo
.... type 1..1 code replaced-by | replaces | refer | seealso
Vinculación: LinkType (required): Tipo de vínculo entre los registros de la misma persona

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso Conjunto de valores Versión Fuente
Patient.language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.identifier.use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Patient.identifier.type Base required Tipos de identificación del paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.address.type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.maritalStatus Base required Estado civil 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.relationship Base extensible Tipo de relación con el paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.link.type Base required Link Type 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expresión
cr-cedula-nacional-value error Patient.identifier Una cédula nacional (system https://hl7.or.cr/fhir/sid/cedula-nacional) tiene 9 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' implies value.matches('^[1-9][0-9]{8}$')
cr-dimex-value error Patient.identifier Un DIMEX (system https://hl7.or.cr/fhir/sid/dimex) tiene 11 o 12 dígitos, sin ceros a la izquierda. system = 'https://hl7.or.cr/fhir/sid/dimex' implies value.matches('^[1-9][0-9]{10,11}$')
cr-direccion-uso-persona error Patient.address, Patient.contact.address La dirección de una persona es su residencia (home) o una dirección temporal (temp). use.empty() or use = 'home' or use = 'temp'
cr-expediente-assigner error Patient.identifier Un expediente indica el establecimiento que lo asignó (assigner). system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') implies assigner.exists()
cr-expediente-system error Patient.identifier Un expediente usa el system https://hl7.or.cr/fhir/sid/expediente/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.startsWith('https://hl7.or.cr/fhir/sid/expediente') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/expediente/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error Patient No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-paciente-documento-unico error Patient Entre los identificadores vigentes hay a lo sumo una cédula nacional, un DIMEX y un número CCSS, y la cédula y el DIMEX no están vigentes a la vez. identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/ccss').count() <= 1 and (identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').exists() and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').exists()).not()
cr-paciente-fecha-estimada error Patient.birthDate La condición de estimada solo se registra cuando existe un valor de fecha de nacimiento. extension('https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada').exists() implies $this.hasValue()
cr-paciente-identificador-system error Patient.identifier El identificador es una cédula nacional, un DIMEX, un número CCSS, un pasaporte o un expediente, con su system de https://hl7.or.cr/fhir/sid/. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' or system = 'https://hl7.or.cr/fhir/sid/dimex' or system = 'https://hl7.or.cr/fhir/sid/ccss' or system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')
cr-paciente-identificador-tipo error Patient.identifier Si se envía el tipo, sus códigos CR o HL7 v2-0203 son coherentes con el system del identificador. type.empty() or (system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'cedula-nacional') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NI')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/dimex' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'dimex') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PRC')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/ccss' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'ccss') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NH')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'pasaporte') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PPN')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'expediente-local') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'MR')).exists())
cr-paciente-identificador-uso error Patient.identifier Un identificador vigente es temp si es un expediente y official si es de otro tipo; uno que ya no está vigente es old. iif(system.startsWith('https://hl7.or.cr/fhir/sid/expediente/'), use = 'temp' or use = 'old', use = 'official' or use = 'old')
cr-paciente-identificador-vigente error Patient El paciente tiene al menos un identificador vigente (use distinto de old). identifier.where(use != 'old').exists()
cr-paciente-nombre-temporal error Patient El paciente tiene como máximo una denominación temporal y un nombre conocido. name.where(use = 'temp').count() <= 1 and name.where(use = 'official').count() <= 1
cr-paciente-pasaporte-expediente error Patient Los pasaportes vigentes son de países emisores distintos y los expedientes vigentes, de establecimientos distintos. identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/')).system.isDistinct() and identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')).system.isDistinct()
cr-pasaporte-system error Patient.identifier Un pasaporte usa el system https://hl7.or.cr/fhir/sid/pasaporte/ seguido del código ISO 3166-1 alfa-3 del país emisor, y su número tiene de 6 a 15 letras o dígitos. system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte') implies (system.matches('^https://hl7\\.or\\.cr/fhir/sid/pasaporte/[A-Z]{3}$') and value.matches('^[A-Za-z0-9]{6,15}$'))
cr-persona-apatrida error Patient Una persona apátrida (nacionalidad con data-absent-reason not-applicable) no tiene otra nacionalidad. extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').extension('code').value.extension('http://hl7.org/fhir/StructureDefinition/data-absent-reason').where(value = 'not-applicable').exists() implies extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').count() = 1
cr-persona-fecha-nacimiento error Patient.birthDate La fecha de nacimiento no es definitivamente posterior a hoy; se respeta la precisión disponible. $this.lowBoundary() <= today().lowBoundary()
cr-persona-residencia error Patient La persona tiene a lo sumo una dirección de residencia (home). address.where(use = 'home').count() <= 1
cr-referencia-cedula-juridica error Patient.contact.organization.identifier La organización se identifica con su cédula jurídica: system https://hl7.or.cr/fhir/sid/cedula-juridica y 10 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-juridica' and value.matches('^[1-9][0-9]{9}$')
cr-telefono error Patient.telecom, Patient.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))

Vista instantáneaView

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Patient C 0..* Patient Paciente: persona que recibe atención de salud en Costa Rica
Constraints: cr-identificador-unico, cr-paciente-identificador-vigente, cr-paciente-documento-unico, cr-paciente-pasaporte-expediente, cr-persona-apatrida, cr-persona-residencia, cr-paciente-nombre-temporal
... id Σ 0..1 id Identificador lógico del recurso
... meta Σ 0..1 Meta Metadatos del recurso
... implicitRules ?!Σ 0..1 uri Reglas que rigen la interpretación del contenido del recurso
... text 0..1 Narrative Resumen narrativo del recurso para su interpretación humana
Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos
... contained 0..* Resource Recursos contenidos en línea
... Slices para extension 1..* Extension Extensiones: sexo asignado al nacer y nacionalidad
Slice: Sin orden, Abierto by value:url
.... extension:sexoAlNacer S 1..1 (Complejo) Sexo asignado al nacer; unknown si se desconoce
URL: http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-recorded-sex-or-gender
.... extension:nacionalidad S 0..* (Complejo) Nacionalidad: una por país
URL: http://hl7.org/fhir/StructureDefinition/patient-nationality perfilado por https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-nationality
... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
... identifier SΣC 1..* Identifier Identificación del paciente: cédula, DIMEX, pasaporte, número CCSS o expediente
Constraints: cr-paciente-identificador-system, cr-paciente-identificador-tipo, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-expediente-system, cr-expediente-assigner, cr-paciente-identificador-uso
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official (temp para el expediente) si está vigente; old si es histórico
Vinculación: IdentifierUse (required)
.... type SΣ 1..1 CodeableConcept Tipo de documento
Vinculación: Tipos de identificación del paciente (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | ccss | pasaporte/{país} | expediente/{establecimiento}}
Ejemplo General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento, sin guiones ni espacios
Ejemplo General: 123456
.... period Σ 0..1 Period Periodo durante el cual el identificador es o fue válido
.... assigner SΣ 0..1 Reference(Organización) Establecimiento que asignó el expediente (obligatorio en el expediente)
... active ?!Σ 0..1 boolean Indica si el registro del paciente está en uso activo
... name SΣ 0..* CRNombrePaciente Nombre conocido o denominación temporal
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
... gender Σ 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para el paciente; no sustituye el sexo asignado al nacer
... birthDate SΣC 0..1 date Fecha de nacimiento conocida, con la precisión disponible
Constraints: cr-persona-fecha-nacimiento, cr-paciente-fecha-estimada
.... id 0..1 string Identificador XML (o equivalente en JSON) para referenciar este elemento
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:fechaEstimada S 0..1 boolean Fecha de nacimiento estimada
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada
.... value 0..1 date Valor primitivo de la fecha
... deceased[x] ?!Σ 0..1 Indica si la persona ha fallecido
.... deceasedBoolean boolean
.... deceasedDateTime dateTime
... address SΣC 0..* CRAddress Dirección en Costa Rica o en otro país
Constraints: cr-direccion-uso-persona
.... id 0..1 id Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
...... id 0..1 id Identificador único para referenciar elementos entre sí
...... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
...... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
...... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
.... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
.... type Σ 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección: postal, física o ambas
Ejemplo General: both
.... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
.... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
.... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
.... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
.... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
.... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
.... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
.... period Σ 0..1 Period Periodo durante el cual la dirección se usa o se usó
Ejemplo General: {"start":"2010-03-23","end":"2010-07-01"}
... maritalStatus S 0..1 CodeableConcept Estado civil: soltero, casado, divorciado, viudo o unión de hecho
Vinculación: Estado civil (required)
... multipleBirth[x] 0..1 Indica si el paciente forma parte de un nacimiento múltiple
.... multipleBirthBoolean boolean
.... multipleBirthInteger integer
... photo 0..* Attachment Imagen del paciente
... contact SC 0..* BackboneElement Persona de contacto, familiar o enlace de una institución
Constraints: pat-1
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... extension:sexoAlNacer S 0..1 Coding Sexo asignado al nacer del contacto
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer
Vinculación: Sexo asignado al nacer (required)
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... relationship S 1..* CodeableConcept Relación con el paciente: cónyuge, padre, madre, tutor, hijo, hermano u otro familiar
Vinculación: Tipo de relación con el paciente (extensible)
.... name SC 1..1 CRHumanName Nombre del contacto
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico del contacto
Constraints: cr-telefono
.... address SC 0..1 CRAddress Dirección del contacto
Constraints: cr-direccion-uso-persona
..... id 0..1 id Identificador único para referenciar elementos entre sí
..... Slices para extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
...... extension:barrioPoblado S 0..1 (Complejo) Barrio (zona urbana) o poblado (zona rural)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct
....... id 0..1 id Identificador único para referenciar elementos entre sí
....... extension 0..0 Extension
Slice: Sin orden, Abierto by value:url
....... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-precinct"
....... value[x] 1..1 string Nombre del barrio o del poblado
Longitud máxima:100
..... use ?!SΣ 1..1 code home (residencia) | temp (temporal)
Vinculación: AddressUse (required): Uso de la dirección (home, work, etc.).
Ejemplo General: home
..... type Σ 0..1 code postal | physical | both
Vinculación: AddressType (required): Tipo de dirección (física o postal).
Ejemplo General: both
..... text SΣ 0..1 string Dirección completa, con los nombres (no los códigos) de provincia, cantón y distrito
Ejemplo General: 137 Nowhere Street, Erewhon 9132
Longitud máxima:250
..... line SΣ 0..* string Señas (Costa Rica) o calle y número (otro país)
Orden de repetición de este elemento: The order in which lines should appear in an address label
Ejemplo General: 137 Nowhere Street
Longitud máxima:250
..... city SΣ 0..1 string Cantón (código de la DTA en Costa Rica) o ciudad
Vinculación: Cantones de Costa Rica (preferred): En Costa Rica (CRI), el código de cantón de la DTA es obligatorio y pertenece a la provincia (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
Ejemplo General: Erewhon
..... district SΣ 0..1 string Distrito (código de la DTA en Costa Rica)
Vinculación: Distritos de Costa Rica (preferred): En Costa Rica (CRI), el código de distrito de la DTA es obligatorio y pertenece al cantón (invariantes cr-direccion-dta y cr-direccion-concordancia).
Ejemplo General: Madison
..... state SΣ 0..1 string Provincia (código de la DTA en Costa Rica) o estado, región o departamento
Vinculación: Provincias de Costa Rica (preferred): En Costa Rica (CRI), el código de provincia de la DTA es obligatorio (invariantes cr-direccion-dta y cr-direccion-concordancia). En otro país, texto libre.
..... postalCode SΣ 0..1 string Código postal
Ejemplo General: 9132
..... country SΣ 1..1 string País, con código ISO 3166-1 alfa-3 (CRI para Costa Rica)
Vinculación: Iso316613 (required)
..... period Σ 0..1 Period Periodo durante el que se usa o se usó la dirección
Ejemplo General: {"start":"2010-03-23","end":"2010-07-01"}
.... gender 0..1 code male | female | other | unknown
Vinculación: AdministrativeGender (required): Sexo administrativo registrado para la persona de contacto
.... organization SC 0..1 Reference(Organización) Institución en cuyo nombre actúa la persona de contacto
..... id 0..1 id Identificador para referenciar este elemento dentro del recurso
..... extension 0..* Extension Contenido adicional definido por las implementaciones
Slice: Sin orden, Abierto by value:url
..... reference ΣC 0..1 string Referencia literal, relativa, interna o URL absoluta
..... type Σ 0..1 uri Tipo de recurso al que apunta la referencia
Vinculación: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
..... identifier SΣC 1..1 Identifier Cédula jurídica de la organización
Constraints: cr-referencia-cedula-juridica
..... display ΣC 0..1 string Texto alternativo para identificar el recurso referenciado
.... period S 0..1 Period Periodo en que el contacto es válido
... communication 0..* BackboneElement Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... language 1..1 CodeableConcept Idioma que puede utilizarse para comunicarse con el paciente sobre su salud
Vinculación: AllLanguages (required): Código del idioma conforme a BCP 47
Vinculaciones adicionalesPropósito
CommonLanguages Inicial
CommonLanguages Inicial
.... preferred 0..1 boolean Indica si este es el idioma preferido
... generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Profesional o servicio de atención primaria designado por el paciente
... managingOrganization Σ 0..1 Reference(Organization) Organización responsable de custodiar el expediente del paciente
... link ?!Σ 0..* BackboneElement Vínculo con otro recurso Patient o RelatedPerson de la misma persona
.... id 0..1 string Identificador para referenciar este elemento dentro del recurso
.... extension 0..* Extension Contenido adicional definido por las implementaciones
.... modifierExtension ?!Σ 0..* Extension Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan
.... other Σ 1..1 Reference(Patient | RelatedPerson) Otro recurso Patient o RelatedPerson al que apunta el vínculo
.... type Σ 1..1 code replaced-by | replaces | refer | seealso
Vinculación: LinkType (required): Tipo de vínculo entre los registros de la misma persona

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso Conjunto de valores Versión Fuente
Patient.language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.identifier.use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Patient.identifier.type Base required Tipos de identificación del paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.address.use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.address.type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.address.city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.address.country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.maritalStatus Base required Estado civil 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.relationship Base extensible Tipo de relación con el paciente 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​use Base required AddressUse 📍5.0.0 Estándar FHIR
Patient.contact.address.​type Base required AddressType 📍5.0.0 Estándar FHIR
Patient.contact.address.​city Base preferred Cantones de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​district Base preferred Distritos de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​state Base preferred Provincias de Costa Rica 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Patient.contact.address.​country Base required Iso 3166 Part 1: 3 Letter Codes 📦5.0.0 Estándar FHIR
Patient.contact.gender Base required AdministrativeGender 📍5.0.0 Estándar FHIR
Patient.contact.organization.​type Base extensible Resource Types 📍5.0.0 Estándar FHIR
Patient.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR
Patient.link.type Base required Link Type 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expresión
cr-cedula-nacional-value error Patient.identifier Una cédula nacional (system https://hl7.or.cr/fhir/sid/cedula-nacional) tiene 9 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' implies value.matches('^[1-9][0-9]{8}$')
cr-dimex-value error Patient.identifier Un DIMEX (system https://hl7.or.cr/fhir/sid/dimex) tiene 11 o 12 dígitos, sin ceros a la izquierda. system = 'https://hl7.or.cr/fhir/sid/dimex' implies value.matches('^[1-9][0-9]{10,11}$')
cr-direccion-uso-persona error Patient.address, Patient.contact.address La dirección de una persona es su residencia (home) o una dirección temporal (temp). use.empty() or use = 'home' or use = 'temp'
cr-expediente-assigner error Patient.identifier Un expediente indica el establecimiento que lo asignó (assigner). system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') implies assigner.exists()
cr-expediente-system error Patient.identifier Un expediente usa el system https://hl7.or.cr/fhir/sid/expediente/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.startsWith('https://hl7.or.cr/fhir/sid/expediente') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/expediente/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error Patient No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-paciente-documento-unico error Patient Entre los identificadores vigentes hay a lo sumo una cédula nacional, un DIMEX y un número CCSS, y la cédula y el DIMEX no están vigentes a la vez. identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').count() <= 1 and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/ccss').count() <= 1 and (identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/cedula-nacional').exists() and identifier.where(use != 'old' and system = 'https://hl7.or.cr/fhir/sid/dimex').exists()).not()
cr-paciente-fecha-estimada error Patient.birthDate La condición de estimada solo se registra cuando existe un valor de fecha de nacimiento. extension('https://hl7.or.cr/fhir/core/StructureDefinition/cr-fecha-nacimiento-estimada').exists() implies $this.hasValue()
cr-paciente-identificador-system error Patient.identifier El identificador es una cédula nacional, un DIMEX, un número CCSS, un pasaporte o un expediente, con su system de https://hl7.or.cr/fhir/sid/. system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' or system = 'https://hl7.or.cr/fhir/sid/dimex' or system = 'https://hl7.or.cr/fhir/sid/ccss' or system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')
cr-paciente-identificador-tipo error Patient.identifier Si se envía el tipo, sus códigos CR o HL7 v2-0203 son coherentes con el system del identificador. type.empty() or (system = 'https://hl7.or.cr/fhir/sid/cedula-nacional' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'cedula-nacional') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NI')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/dimex' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'dimex') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PRC')).exists()) or (system = 'https://hl7.or.cr/fhir/sid/ccss' and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'ccss') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'NH')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'pasaporte') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'PPN')).exists()) or (system.startsWith('https://hl7.or.cr/fhir/sid/expediente/') and type.coding.where((system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion' and code = 'expediente-local') or (system = 'http://terminology.hl7.org/CodeSystem/v2-0203' and code = 'MR')).exists())
cr-paciente-identificador-uso error Patient.identifier Un identificador vigente es temp si es un expediente y official si es de otro tipo; uno que ya no está vigente es old. iif(system.startsWith('https://hl7.or.cr/fhir/sid/expediente/'), use = 'temp' or use = 'old', use = 'official' or use = 'old')
cr-paciente-identificador-vigente error Patient El paciente tiene al menos un identificador vigente (use distinto de old). identifier.where(use != 'old').exists()
cr-paciente-nombre-temporal error Patient El paciente tiene como máximo una denominación temporal y un nombre conocido. name.where(use = 'temp').count() <= 1 and name.where(use = 'official').count() <= 1
cr-paciente-pasaporte-expediente error Patient Los pasaportes vigentes son de países emisores distintos y los expedientes vigentes, de establecimientos distintos. identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/')).system.isDistinct() and identifier.where(use != 'old' and system.startsWith('https://hl7.or.cr/fhir/sid/expediente/')).system.isDistinct()
cr-pasaporte-system error Patient.identifier Un pasaporte usa el system https://hl7.or.cr/fhir/sid/pasaporte/ seguido del código ISO 3166-1 alfa-3 del país emisor, y su número tiene de 6 a 15 letras o dígitos. system.startsWith('https://hl7.or.cr/fhir/sid/pasaporte') implies (system.matches('^https://hl7\\.or\\.cr/fhir/sid/pasaporte/[A-Z]{3}$') and value.matches('^[A-Za-z0-9]{6,15}$'))
cr-persona-apatrida error Patient Una persona apátrida (nacionalidad con data-absent-reason not-applicable) no tiene otra nacionalidad. extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').extension('code').value.extension('http://hl7.org/fhir/StructureDefinition/data-absent-reason').where(value = 'not-applicable').exists() implies extension('http://hl7.org/fhir/StructureDefinition/patient-nationality').count() = 1
cr-persona-fecha-nacimiento error Patient.birthDate La fecha de nacimiento no es definitivamente posterior a hoy; se respeta la precisión disponible. $this.lowBoundary() <= today().lowBoundary()
cr-persona-residencia error Patient La persona tiene a lo sumo una dirección de residencia (home). address.where(use = 'home').count() <= 1
cr-referencia-cedula-juridica error Patient.contact.organization.identifier La organización se identifica con su cédula jurídica: system https://hl7.or.cr/fhir/sid/cedula-juridica y 10 dígitos, sin guiones ni cero inicial. system = 'https://hl7.or.cr/fhir/sid/cedula-juridica' and value.matches('^[1-9][0-9]{9}$')
cr-telefono error Patient.telecom, Patient.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 buena práctica Patient A resource should have narrative for robust management text.`div`.exists()
ele-1 error **TODOS** los elementos All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **TODAS** las extensiones Must have either extensions or value[x], not both extension.exists() != value.exists()
pat-1 error Patient.contact SHALL at least contain a contact's details or a reference to an organization name.exists() or telecom.exists() or address.exists() or organization.exists()

 

Otras representaciones de perfil: CSV, Excel, Schematron

Notas:

Uso en el HIE

Registro de pacientes. Pacientes del MPI Nacional. Las uniones de registros se registran con Patient.link y con una procedencia (cr-provenance).

Identidad desconocida y denominación temporal

Una persona puede registrarse con un identificador local vigente aunque se desconozcan sus nombres, apellidos y fecha de nacimiento. El sexo asignado al nacer lleva unknown cuando se desconoce. Una denominación operativa opcional se representa en Patient.name con use = temp y text, separada del nombre conocido; no demuestra la identidad ni reemplaza el identificador.

Se registran todos los nombres de pila conocidos en orden. Los apellidos conocidos se registran en family y en la extensión correspondiente a su posición; si solo se conoce el segundo, se usa únicamente su extensión. El origen materno o paterno es independiente de la posición y puede ser igual en ambos apellidos. Omitir el segundo no distingue entre inexistente y desconocido. El uso official no prueba que el nombre haya sido verificado.

La fecha de nacimiento puede omitirse, ser parcial o estimada. Core rechaza una fecha definitivamente futura y no fija un límite máximo de edad; los servicios que calculan edad, emparejan pacientes o toman decisiones clínicas deben considerar la precisión y la condición de estimada.

Cada identificador lleva identifier.type y system. El tipo hace que la estructura sea autosuficiente para receptores que no conocen las convenciones nacionales de URI y debe coincidir con el sistema; no se acepta un tipo distinto.

Cuando se obtiene información de identidad, se actualiza el registro y se conservan los identificadores locales vigentes y la trazabilidad. Los posibles duplicados requieren revisión antes de vincular o fusionar registros; el servicio MPI debe definir y ejecutar ese proceso, su auditoría y la corrección de errores. Patient.link por sí solo no implementa el flujo.

Pacientes menores o legalmente dependientes

Al completar el registro de un paciente menor de edad o legalmente dependiente debe existir al menos un RelatedPerson con relación declarada de progenitor o tutor. Es una regla entre recursos: el perfil de Patient no puede verificarla de forma aislada. El flujo del registro/MPI debe comprobar los RelatedPerson asociados mediante RelatedPerson.patient. La relación declarada no demuestra por sí sola tutela ni facultad de consentir; el proceso de consentimiento necesita sus propias reglas y evidencia.

Alcance de los contactos del paciente

Patient.contact es opcional, pero cada contacto incluido debe nombrar a una persona con contact.name. contact.organization identifica la institución en cuyo nombre actúa esa persona; una referencia a organización sola no satisface CRPatient. FHIR R5 permite un contacto solo institucional, pero Core restringe el caso actual a personas nombradas. Si un caso nacional necesita ese patrón, debe revisarse la restricción base antes de derivar un perfil. El código GUARD en contact.relationship solo declara un vínculo para comunicación: no acredita tutela ni reemplaza a RelatedPerson cuando la persona debe identificarse formalmente. Si la persona ya figura como RelatedPerson, su telecom sirve para avisos de emergencia y no se duplica en Patient.contact.

Decisiones de modelado: extensiones

El sexo asignado al nacer se representa con la extensión estándar HL7 individual-recordedSexOrGender, tipificada con LOINC 76689-9 (Sex assigned at birth), porque ni Patient.gender ni otro elemento nativo expresan esta semántica. La extensión CR cr-contacto-sexo-al-nacer se conserva exclusivamente para Patient.contact: ese contexto no está autorizado por la extensión estándar. La fecha de nacimiento estimada y los apellidos por posición también requieren extensiones CR, pues FHIR R5 no tiene elementos nativos que indiquen la condición de estimada ni que distingan primer y segundo apellido con su origen. Para nacionalidad y barrio se reutilizan las extensiones estándar HL7 patient-nationality e iso21090-ADXP-precinct.

Ver también Servicios del HIE.

Consultas

Lo que el servidor debe responder para este perfil. En la forma, [base] es la URL base del servidor del servicio y lo que va entre llaves se reemplaza por un valor. Cada solicitud usa valores reales de los ejemplos de esta guía, y la respuesta trae los que coinciden; los cuerpos JSON se expanden al hacer clic. Todas las solicitudes llevan el token de acceso al HIE (Authorization: Bearer [token]). Las búsquedas de texto encuentran los valores que empiezan con el texto, sin distinguir mayúsculas ni tildes; las de fecha admiten los prefijos ge, gt, le y lt. En la URL los valores van codificados (| como %7C, + como %2B, un espacio como %20); aquí se muestran sin codificar para que se lean mejor.

Ir a: Leer · Buscar · Crear · Actualizar · Historial · Emparejar

Leer

Leer
Forma: GET [base]/Patient/{id}

Lee un paciente del MPI Nacional por su id, la parte final de su URL. Se usa para resolver una referencia que otro recurso hace a un paciente. En el ejemplo se lee «Costarricense adulta (C1)»; la segunda respuesta es la de un id que no existe.

Solicitud

GET [base]/Patient/ejemplo-paciente-nacional HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta si el recurso existe

HTTP/1.1 200 OK
ETag: W/"1"
Last-Modified: 2026-10-01T10:00:00-06:00
Content-Type: application/fhir+json
{
  "resourceType": "Patient",
  "id": "ejemplo-paciente-nacional",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
    ]
  },
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "code": "cedula-nacional",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Cédula Nacional"
          },
          {
            "code": "NI",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "National unique individual identifier"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
      "value": "114250387"
    }
  ],
  "name": [
    {
      "given": [
        "Laura",
        "Patricia"
      ],
      "use": "official",
      "family": "Solís Araya",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Solís"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "FTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "father"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Araya"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "MTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "mother"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "76689-9",
                "system": "http://loinc.org"
              }
            ]
          }
        },
        {
          "url": "value",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "female",
                "system": "http://hl7.org/fhir/administrative-gender"
              }
            ]
          }
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
    },
    {
      "extension": [
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "CRI",
                "system": "urn:iso:std:iso:3166"
              }
            ],
            "text": "Costa Rica"
          },
          "url": "code"
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
    }
  ],
  "maritalStatus": {
    "coding": [
      {
        "code": "M",
        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
        "display": "Married"
      }
    ],
    "text": "Casada"
  },
  "telecom": [
    {
      "system": "phone",
      "value": "+50688881234",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "laura.solis@correo-ejemplo.cr"
    }
  ],
  "address": [
    {
      "line": [
        "Del templo católico 300 metros norte, casa verde a mano derecha"
      ],
      "use": "home",
      "country": "CRI",
      "state": "4",
      "city": "402",
      "district": "40201",
      "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
    }
  ],
  "contact": [
    {
      "relationship": [
        {
          "coding": [
            {
              "code": "SPS",
              "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
              "display": "spouse"
            }
          ],
          "text": "Cónyuge"
        }
      ],
      "name": {
        "given": [
          "Andrés"
        ],
        "use": "official",
        "family": "Quesada Mora",
        "_family": {
          "extension": [
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Quesada"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "FTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "father"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
            },
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Mora"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "MTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "mother"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
            }
          ]
        }
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+50688885678"
        }
      ],
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
          "valueCoding": {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "male"
          }
        }
      ]
    }
  ],
  "active": true,
  "birthDate": "1990-04-12"
}

Respuesta si no existe

HTTP/1.1 404 Not Found
Content-Type: application/fhir+json
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "not-found",
      "diagnostics": "No existe el recurso Patient/no-existe."
    }
  ]
}

Leer una versión
Forma: GET [base]/Patient/{id}/_history/{versión}

Lee una versión anterior de un paciente. Sirve para ver los datos tal como estaban cuando otro recurso los citó; por ejemplo, cuando se firmó un documento. En el ejemplo se lee la versión 1 de «Costarricense adulta (C1)».

Solicitud

GET [base]/Patient/ejemplo-paciente-nacional/_history/1 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: la versión 1

HTTP/1.1 200 OK
ETag: W/"1"
Content-Type: application/fhir+json
{
  "resourceType": "Patient",
  "id": "ejemplo-paciente-nacional",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
    ]
  },
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "code": "cedula-nacional",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Cédula Nacional"
          },
          {
            "code": "NI",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "National unique individual identifier"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
      "value": "114250387"
    }
  ],
  "name": [
    {
      "given": [
        "Laura",
        "Patricia"
      ],
      "use": "official",
      "family": "Solís Araya",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Solís"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "FTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "father"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Araya"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "MTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "mother"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "76689-9",
                "system": "http://loinc.org"
              }
            ]
          }
        },
        {
          "url": "value",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "female",
                "system": "http://hl7.org/fhir/administrative-gender"
              }
            ]
          }
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
    },
    {
      "extension": [
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "CRI",
                "system": "urn:iso:std:iso:3166"
              }
            ],
            "text": "Costa Rica"
          },
          "url": "code"
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
    }
  ],
  "maritalStatus": {
    "coding": [
      {
        "code": "M",
        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
        "display": "Married"
      }
    ],
    "text": "Casada"
  },
  "telecom": [
    {
      "system": "phone",
      "value": "+50688881234",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "laura.solis@correo-ejemplo.cr"
    }
  ],
  "address": [
    {
      "line": [
        "Del templo católico 300 metros norte, casa verde a mano derecha"
      ],
      "use": "home",
      "country": "CRI",
      "state": "4",
      "city": "402",
      "district": "40201",
      "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
    }
  ],
  "contact": [
    {
      "relationship": [
        {
          "coding": [
            {
              "code": "SPS",
              "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
              "display": "spouse"
            }
          ],
          "text": "Cónyuge"
        }
      ],
      "name": {
        "given": [
          "Andrés"
        ],
        "use": "official",
        "family": "Quesada Mora",
        "_family": {
          "extension": [
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Quesada"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "FTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "father"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
            },
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Mora"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "MTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "mother"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
            }
          ]
        }
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+50688885678"
        }
      ],
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
          "valueCoding": {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "male"
          }
        }
      ]
    }
  ],
  "active": true,
  "birthDate": "1990-04-12"
}
Buscar

Buscar por id
Forma: GET [base]/Patient?_id={id}

Lee al paciente por su id en el MPI, con la forma de una búsqueda. Sirve para combinarla con otros parámetros o para recibir el resultado en un Bundle. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: _id=ejemplo-paciente-nacional.

Solicitud

GET [base]/Patient?_id=ejemplo-paciente-nacional HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?_id=ejemplo-paciente-nacional"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por cédula u otro identificador
Forma: GET [base]/Patient?identifier={sistema}|{valor}

Encuentra al paciente por su cédula, DIMEX, pasaporte u otro identificador. Es lo primero que hace un sistema al atender a una persona: si el MPI ya la tiene, usa ese registro en lugar de crear otro (IHE PDQm ITI-78, PIXm ITI-83). En el ejemplo se usa el dato de «Costarricense adulta (C1)»: identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|114250387.

Solicitud

GET [base]/Patient?identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|114250387 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|114250387"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por registro activo
Forma: GET [base]/Patient?active={true o false}

Trae solo los registros activos del MPI, que son los que un sistema debe usar al atender a una persona. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: active=true.

Solicitud

GET [base]/Patient?active=true&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 5 resultados, de 2 en 2 con _count; la primera página trae Costarricense adulta (C1); Extranjero residente con DIMEX (C4)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 5,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?active=true&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/Patient?active=true&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-dimex",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-dimex",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "dimex",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "DIMEX"
                },
                {
                  "code": "PRC",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "Permanent Resident Card Number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/dimex",
            "value": "155812345678"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "pasaporte",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Número de Pasaporte"
                },
                {
                  "code": "PPN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "Passport number"
                }
              ]
            },
            "assigner": {
              "display": "Nicaragua"
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/pasaporte/NIC",
            "value": "C01234567"
          }
        ],
        "name": [
          {
            "given": [
              "José"
            ],
            "use": "official",
            "family": "Mendoza",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mendoza"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "male",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "NIC",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Nicaragua"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "telecom": [
          {
            "system": "phone",
            "value": "+50670001122"
          }
        ],
        "address": [
          {
            "line": [
              "Calle 3, 100 metros al este de la rotonda, apartamento 4"
            ],
            "use": "home",
            "country": "CRI",
            "state": "1",
            "city": "115",
            "district": "11501",
            "text": "Calle 3, 100 metros al este de la rotonda, apartamento 4, San Pedro, Montes de Oca, San José"
          }
        ],
        "active": true,
        "birthDate": "1984-11-02"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por apellidos
Forma: GET [base]/Patient?family={texto}

Busca por apellidos cuando no se tiene la identificación. family lleva los dos apellidos, así que se puede buscar por el primero o por los dos. Conviene combinarla con la fecha de nacimiento para acotar el resultado. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: family=Solís Araya.

Solicitud

GET [base]/Patient?family=Solís Araya HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?family=Solís Araya"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por nombre
Forma: GET [base]/Patient?given={texto}

Busca por nombre. Sola trae muchos resultados: se combina con los apellidos o con la fecha de nacimiento. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: given=Laura.

Solicitud

GET [base]/Patient?given=Laura HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?given=Laura"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por apellido de origen materno
Forma: GET [base]/Patient?mothers-family={texto}

Busca por el apellido que proviene de la madre, sin importar si es el primero o el segundo. Reemplaza el parámetro mothersMaidenName de IHE PDQm; R5 no lo trae y lo define esta guía. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: mothers-family=Araya.

Solicitud

GET [base]/Patient?mothers-family=Araya HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?mothers-family=Araya"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por fecha de nacimiento
Forma: GET [base]/Patient?birthdate={fecha}

Busca por fecha de nacimiento. Es el dato que más acota una búsqueda demográfica cuando no se tiene la identificación. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: birthdate=1990-04-12.

Solicitud

GET [base]/Patient?birthdate=1990-04-12 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?birthdate=1990-04-12"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por género administrativo
Forma: GET [base]/Patient?gender=…

Filtra por género administrativo cuando se conoce, sin inferirlo del sexo asignado al nacer.

Sin ejemplo: no se encontró un valor utilizable en los ejemplos de la guía.


Buscar por sexo asignado al nacer
Forma: GET [base]/Patient?sexo-al-nacer=…

Filtra por el sexo asignado al nacer registrado en la extensión nacional, incluido unknown.

Sin ejemplo: no se encontró un valor utilizable en los ejemplos de la guía.


Buscar por teléfono o correo
Forma: GET [base]/Patient?telecom={teléfono o correo}

Busca por teléfono o correo, por ejemplo para encontrar a la persona que llamó. El teléfono va en formato E.164, con el +506. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: telecom=+50688881234.

Solicitud

GET [base]/Patient?telecom=+50688881234 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?telecom=+50688881234"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por provincia
Forma: GET [base]/Patient?address-state={texto}

Trae los pacientes de una provincia, por su código de la División Territorial Administrativa (DTA). Sirve para reportes y para acotar una búsqueda. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: address-state=4.

Solicitud

GET [base]/Patient?address-state=4 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?address-state=4"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por cantón
Forma: GET [base]/Patient?address-city={texto}

Trae los pacientes de un cantón, por su código de la DTA. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: address-city=402.

Solicitud

GET [base]/Patient?address-city=402 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?address-city=402"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por distrito
Forma: GET [base]/Patient?address-district={texto}

Trae los pacientes de un distrito, por su código de la DTA. R5 no trae este parámetro: lo define esta guía. En el ejemplo se usa el dato de «Costarricense adulta (C1)»: address-district=40201.

Solicitud

GET [base]/Patient?address-district=40201 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Costarricense adulta (C1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?address-district=40201"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por fecha de actualización
Forma: GET [base]/Patient?_lastUpdated={prefijo}{fecha}

Trae los pacientes que cambiaron desde una fecha. La usa un sistema que guarda una copia del registro para traer solo lo nuevo, en lugar de descargarlo todo. En el ejemplo se piden los cambios desde el 2026-10-01 (prefijo ge: en esa fecha o después).

Solicitud

GET [base]/Patient?_lastUpdated=ge2026-10-01&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 13 resultados, de 2 en 2 con _count; la primera página trae Costarricense adulta (C1); Extranjero residente con DIMEX (C4)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 13,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?_lastUpdated=ge2026-10-01&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/Patient?_lastUpdated=ge2026-10-01&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-dimex",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-dimex",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "dimex",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "DIMEX"
                },
                {
                  "code": "PRC",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "Permanent Resident Card Number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/dimex",
            "value": "155812345678"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "pasaporte",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Número de Pasaporte"
                },
                {
                  "code": "PPN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "Passport number"
                }
              ]
            },
            "assigner": {
              "display": "Nicaragua"
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/pasaporte/NIC",
            "value": "C01234567"
          }
        ],
        "name": [
          {
            "given": [
              "José"
            ],
            "use": "official",
            "family": "Mendoza",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mendoza"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "male",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "NIC",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Nicaragua"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "telecom": [
          {
            "system": "phone",
            "value": "+50670001122"
          }
        ],
        "address": [
          {
            "line": [
              "Calle 3, 100 metros al este de la rotonda, apartamento 4"
            ],
            "use": "home",
            "country": "CRI",
            "state": "1",
            "city": "115",
            "district": "11501",
            "text": "Calle 3, 100 metros al este de la rotonda, apartamento 4, San Pedro, Montes de Oca, San José"
          }
        ],
        "active": true,
        "birthDate": "1984-11-02"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por cédula u otro identificador, con POST
Forma: POST [base]/Patient/_search
cuerpo: identifier={sistema}|{valor}

Hace cualquier búsqueda con POST: los parámetros van en el cuerpo, como un formulario, en lugar de la URL. Se usa cuando los valores son datos personales, como una cédula, para que no queden en los registros de los servidores ni en el historial; la respuesta es la misma que con GET. En el ejemplo se repite la búsqueda por cédula u otro identificador.

Solicitud

POST [base]/Patient/_search HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
Content-Type: application/x-www-form-urlencoded

identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|114250387

Respuesta: 1 resultado: Costarricense adulta (C1), igual que con GET

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Patient?identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|114250387"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}
Crear

Crear
Forma: POST [base]/Patient

Registra un paciente en el MPI Nacional. El servidor valida el recurso contra el perfil, le asigna su id y devuelve su dirección. Lo hace el sistema que atiende a la persona por primera vez. Antes de crearlo debe buscarlo por su identificación o con $match, para no duplicarlo en el MPI (IHE PIXm ITI-104 y PMIR ITI-93). En el ejemplo se registra «Costarricense adulta (C1)»; la segunda respuesta es el rechazo de un recurso que no cumple la invariante cr-identificador-unico (No hay dos identificadores con el mismo system y el mismo valor).

Solicitud

POST [base]/Patient HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
Content-Type: application/fhir+json
{
  "resourceType": "Patient",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
    ]
  },
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "code": "cedula-nacional",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Cédula Nacional"
          },
          {
            "code": "NI",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "National unique individual identifier"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
      "value": "114250387"
    }
  ],
  "name": [
    {
      "given": [
        "Laura",
        "Patricia"
      ],
      "use": "official",
      "family": "Solís Araya",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Solís"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "FTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "father"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Araya"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "MTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "mother"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "76689-9",
                "system": "http://loinc.org"
              }
            ]
          }
        },
        {
          "url": "value",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "female",
                "system": "http://hl7.org/fhir/administrative-gender"
              }
            ]
          }
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
    },
    {
      "extension": [
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "CRI",
                "system": "urn:iso:std:iso:3166"
              }
            ],
            "text": "Costa Rica"
          },
          "url": "code"
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
    }
  ],
  "maritalStatus": {
    "coding": [
      {
        "code": "M",
        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
        "display": "Married"
      }
    ],
    "text": "Casada"
  },
  "telecom": [
    {
      "system": "phone",
      "value": "+50688881234",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "laura.solis@correo-ejemplo.cr"
    }
  ],
  "address": [
    {
      "line": [
        "Del templo católico 300 metros norte, casa verde a mano derecha"
      ],
      "use": "home",
      "country": "CRI",
      "state": "4",
      "city": "402",
      "district": "40201",
      "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
    }
  ],
  "contact": [
    {
      "relationship": [
        {
          "coding": [
            {
              "code": "SPS",
              "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
              "display": "spouse"
            }
          ],
          "text": "Cónyuge"
        }
      ],
      "name": {
        "given": [
          "Andrés"
        ],
        "use": "official",
        "family": "Quesada Mora",
        "_family": {
          "extension": [
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Quesada"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "FTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "father"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
            },
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Mora"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "MTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "mother"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
            }
          ]
        }
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+50688885678"
        }
      ],
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
          "valueCoding": {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "male"
          }
        }
      ]
    }
  ],
  "active": true,
  "birthDate": "1990-04-12"
}

Respuesta si se crea

HTTP/1.1 201 Created
Location: [base]/Patient/ejemplo-paciente-nacional/_history/1
ETag: W/"1"
Last-Modified: 2026-10-01T10:00:00-06:00
Content-Type: application/fhir+json
{
  "resourceType": "Patient",
  "id": "ejemplo-paciente-nacional",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
    ]
  },
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "code": "cedula-nacional",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Cédula Nacional"
          },
          {
            "code": "NI",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "National unique individual identifier"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
      "value": "114250387"
    }
  ],
  "name": [
    {
      "given": [
        "Laura",
        "Patricia"
      ],
      "use": "official",
      "family": "Solís Araya",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Solís"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "FTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "father"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Araya"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "MTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "mother"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "76689-9",
                "system": "http://loinc.org"
              }
            ]
          }
        },
        {
          "url": "value",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "female",
                "system": "http://hl7.org/fhir/administrative-gender"
              }
            ]
          }
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
    },
    {
      "extension": [
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "CRI",
                "system": "urn:iso:std:iso:3166"
              }
            ],
            "text": "Costa Rica"
          },
          "url": "code"
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
    }
  ],
  "maritalStatus": {
    "coding": [
      {
        "code": "M",
        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
        "display": "Married"
      }
    ],
    "text": "Casada"
  },
  "telecom": [
    {
      "system": "phone",
      "value": "+50688881234",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "laura.solis@correo-ejemplo.cr"
    }
  ],
  "address": [
    {
      "line": [
        "Del templo católico 300 metros norte, casa verde a mano derecha"
      ],
      "use": "home",
      "country": "CRI",
      "state": "4",
      "city": "402",
      "district": "40201",
      "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
    }
  ],
  "contact": [
    {
      "relationship": [
        {
          "coding": [
            {
              "code": "SPS",
              "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
              "display": "spouse"
            }
          ],
          "text": "Cónyuge"
        }
      ],
      "name": {
        "given": [
          "Andrés"
        ],
        "use": "official",
        "family": "Quesada Mora",
        "_family": {
          "extension": [
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Quesada"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "FTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "father"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
            },
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Mora"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "MTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "mother"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
            }
          ]
        }
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+50688885678"
        }
      ],
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
          "valueCoding": {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "male"
          }
        }
      ]
    }
  ],
  "active": true,
  "birthDate": "1990-04-12"
}

Respuesta si no cumple el perfil (invariante cr-identificador-unico)

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/fhir+json
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invariant",
      "diagnostics": "cr-identificador-unico: No hay dos identificadores con el mismo system y el mismo valor.",
      "expression": [
        "Patient"
      ]
    }
  ]
}
Actualizar

Actualizar
Forma: PUT [base]/Patient/{id}
If-Match: W/"{versión}"

Reemplaza un paciente con una versión nueva completa, por ejemplo para corregir un dato. If-Match lleva la versión que se leyó: si otro sistema hizo un cambio mientras tanto, el servidor rechaza este, y así nadie pisa el trabajo de otro sin darse cuenta. En el ejemplo se actualiza «Costarricense adulta (C1)» sobre su versión 1; la segunda respuesta es el rechazo cuando otra persona ya la había cambiado.

Solicitud

PUT [base]/Patient/ejemplo-paciente-nacional HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
If-Match: W/"1"
Content-Type: application/fhir+json
{
  "resourceType": "Patient",
  "id": "ejemplo-paciente-nacional",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
    ]
  },
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "code": "cedula-nacional",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Cédula Nacional"
          },
          {
            "code": "NI",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "National unique individual identifier"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
      "value": "114250387"
    }
  ],
  "name": [
    {
      "given": [
        "Laura",
        "Patricia"
      ],
      "use": "official",
      "family": "Solís Araya",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Solís"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "FTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "father"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Araya"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "MTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "mother"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "76689-9",
                "system": "http://loinc.org"
              }
            ]
          }
        },
        {
          "url": "value",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "female",
                "system": "http://hl7.org/fhir/administrative-gender"
              }
            ]
          }
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
    },
    {
      "extension": [
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "CRI",
                "system": "urn:iso:std:iso:3166"
              }
            ],
            "text": "Costa Rica"
          },
          "url": "code"
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
    }
  ],
  "maritalStatus": {
    "coding": [
      {
        "code": "M",
        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
        "display": "Married"
      }
    ],
    "text": "Casada"
  },
  "telecom": [
    {
      "system": "phone",
      "value": "+50688881234",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "laura.solis@correo-ejemplo.cr"
    }
  ],
  "address": [
    {
      "line": [
        "Del templo católico 300 metros norte, casa verde a mano derecha"
      ],
      "use": "home",
      "country": "CRI",
      "state": "4",
      "city": "402",
      "district": "40201",
      "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
    }
  ],
  "contact": [
    {
      "relationship": [
        {
          "coding": [
            {
              "code": "SPS",
              "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
              "display": "spouse"
            }
          ],
          "text": "Cónyuge"
        }
      ],
      "name": {
        "given": [
          "Andrés"
        ],
        "use": "official",
        "family": "Quesada Mora",
        "_family": {
          "extension": [
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Quesada"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "FTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "father"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
            },
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Mora"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "MTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "mother"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
            }
          ]
        }
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+50688885678"
        }
      ],
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
          "valueCoding": {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "male"
          }
        }
      ]
    }
  ],
  "active": true,
  "birthDate": "1990-04-12"
}

Respuesta si se actualiza

HTTP/1.1 200 OK
ETag: W/"2"
Last-Modified: 2026-10-02T08:15:00-06:00
Content-Type: application/fhir+json
{
  "resourceType": "Patient",
  "id": "ejemplo-paciente-nacional",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2026-10-02T08:15:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
    ]
  },
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "code": "cedula-nacional",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Cédula Nacional"
          },
          {
            "code": "NI",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "National unique individual identifier"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
      "value": "114250387"
    }
  ],
  "name": [
    {
      "given": [
        "Laura",
        "Patricia"
      ],
      "use": "official",
      "family": "Solís Araya",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Solís"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "FTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "father"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Araya"
              },
              {
                "url": "origen",
                "valueCoding": {
                  "code": "MTH",
                  "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                  "display": "mother"
                }
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "76689-9",
                "system": "http://loinc.org"
              }
            ]
          }
        },
        {
          "url": "value",
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "female",
                "system": "http://hl7.org/fhir/administrative-gender"
              }
            ]
          }
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
    },
    {
      "extension": [
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "code": "CRI",
                "system": "urn:iso:std:iso:3166"
              }
            ],
            "text": "Costa Rica"
          },
          "url": "code"
        }
      ],
      "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
    }
  ],
  "maritalStatus": {
    "coding": [
      {
        "code": "M",
        "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
        "display": "Married"
      }
    ],
    "text": "Casada"
  },
  "telecom": [
    {
      "system": "phone",
      "value": "+50688881234",
      "use": "mobile"
    },
    {
      "system": "email",
      "value": "laura.solis@correo-ejemplo.cr"
    }
  ],
  "address": [
    {
      "line": [
        "Del templo católico 300 metros norte, casa verde a mano derecha"
      ],
      "use": "home",
      "country": "CRI",
      "state": "4",
      "city": "402",
      "district": "40201",
      "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
    }
  ],
  "contact": [
    {
      "relationship": [
        {
          "coding": [
            {
              "code": "SPS",
              "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
              "display": "spouse"
            }
          ],
          "text": "Cónyuge"
        }
      ],
      "name": {
        "given": [
          "Andrés"
        ],
        "use": "official",
        "family": "Quesada Mora",
        "_family": {
          "extension": [
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Quesada"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "FTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "father"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
            },
            {
              "extension": [
                {
                  "url": "valor",
                  "valueString": "Mora"
                },
                {
                  "url": "origen",
                  "valueCoding": {
                    "code": "MTH",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "mother"
                  }
                }
              ],
              "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
            }
          ]
        }
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+50688885678"
        }
      ],
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
          "valueCoding": {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "male"
          }
        }
      ]
    }
  ],
  "active": true,
  "birthDate": "1990-04-12"
}

Respuesta si otra persona lo modificó antes (la versión ya no es la 1)

HTTP/1.1 412 Precondition Failed
Content-Type: application/fhir+json
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "conflict",
      "diagnostics": "La versión actual de Patient/ejemplo-paciente-nacional no es la 1: léalo de nuevo y repita el cambio."
    }
  ]
}
Historial

Historial del recurso
Forma: GET [base]/Patient/{id}/_history

Trae todas las versiones de un paciente, de la más reciente a la más antigua: qué cambió y cuándo, por ejemplo para revisar una corrección de datos o una unión de registros. En el ejemplo, «Costarricense adulta (C1)» tiene dos versiones: la creación y la actualización anterior.

Solicitud

GET [base]/Patient/ejemplo-paciente-nacional/_history HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: las dos versiones, después de la actualización anterior

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "history",
  "total": 2,
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "2",
          "lastUpdated": "2026-10-02T08:15:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "request": {
        "method": "PUT",
        "url": "Patient/ejemplo-paciente-nacional"
      },
      "response": {
        "status": "200 OK",
        "etag": "W/\"2\""
      }
    },
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "request": {
        "method": "POST",
        "url": "Patient"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    }
  ]
}
Emparejar

Emparejar (IHE PDQm ITI-119)
Forma: POST [base]/Patient/$match

Busca al paciente con los datos que tiene el sistema (nombre, sexo, fecha de nacimiento) cuando no tiene su identificación. El MPI devuelve los candidatos con un puntaje y un grado de coincidencia; el sistema o la persona usuaria decide cuál es (IHE PDQm ITI-119). En el ejemplo se busca con el nombre, el sexo y la fecha de nacimiento de «Costarricense adulta (C1)».

Solicitud

POST [base]/Patient/$match HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
Content-Type: application/fhir+json
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "resource",
      "resource": {
        "resourceType": "Patient",
        "meta": {
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya"
          }
        ],
        "extension": [],
        "birthDate": "1990-04-12"
      }
    },
    {
      "name": "onlyCertainMatches",
      "valueBoolean": false
    },
    {
      "name": "count",
      "valueInteger": 3
    }
  ]
}

Respuesta: un candidato probable, con su puntaje

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "[base]/Patient/ejemplo-paciente-nacional",
      "resource": {
        "resourceType": "Patient",
        "id": "ejemplo-paciente-nacional",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient"
          ]
        },
        "identifier": [
          {
            "type": {
              "coding": [
                {
                  "code": "cedula-nacional",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Cédula Nacional"
                },
                {
                  "code": "NI",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "National unique individual identifier"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/cedula-nacional",
            "value": "114250387"
          }
        ],
        "name": [
          {
            "given": [
              "Laura",
              "Patricia"
            ],
            "use": "official",
            "family": "Solís Araya",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Solís"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "FTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "father"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Araya"
                    },
                    {
                      "url": "origen",
                      "valueCoding": {
                        "code": "MTH",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "display": "mother"
                      }
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "extension": [
          {
            "extension": [
              {
                "url": "type",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "76689-9",
                      "system": "http://loinc.org"
                    }
                  ]
                }
              },
              {
                "url": "value",
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "female",
                      "system": "http://hl7.org/fhir/administrative-gender"
                    }
                  ]
                }
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender"
          },
          {
            "extension": [
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "code": "CRI",
                      "system": "urn:iso:std:iso:3166"
                    }
                  ],
                  "text": "Costa Rica"
                },
                "url": "code"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/patient-nationality"
          }
        ],
        "maritalStatus": {
          "coding": [
            {
              "code": "M",
              "system": "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus",
              "display": "Married"
            }
          ],
          "text": "Casada"
        },
        "telecom": [
          {
            "system": "phone",
            "value": "+50688881234",
            "use": "mobile"
          },
          {
            "system": "email",
            "value": "laura.solis@correo-ejemplo.cr"
          }
        ],
        "address": [
          {
            "line": [
              "Del templo católico 300 metros norte, casa verde a mano derecha"
            ],
            "use": "home",
            "country": "CRI",
            "state": "4",
            "city": "402",
            "district": "40201",
            "text": "Del templo católico 300 metros norte, casa verde a mano derecha, Barva, Barva, Heredia"
          }
        ],
        "contact": [
          {
            "relationship": [
              {
                "coding": [
                  {
                    "code": "SPS",
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                    "display": "spouse"
                  }
                ],
                "text": "Cónyuge"
              }
            ],
            "name": {
              "given": [
                "Andrés"
              ],
              "use": "official",
              "family": "Quesada Mora",
              "_family": {
                "extension": [
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Quesada"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "FTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "father"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                  },
                  {
                    "extension": [
                      {
                        "url": "valor",
                        "valueString": "Mora"
                      },
                      {
                        "url": "origen",
                        "valueCoding": {
                          "code": "MTH",
                          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                          "display": "mother"
                        }
                      }
                    ],
                    "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                  }
                ]
              }
            },
            "telecom": [
              {
                "system": "phone",
                "value": "+50688885678"
              }
            ],
            "extension": [
              {
                "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-contacto-sexo-al-nacer",
                "valueCoding": {
                  "system": "http://hl7.org/fhir/administrative-gender",
                  "code": "male"
                }
              }
            ]
          }
        ],
        "active": true,
        "birthDate": "1990-04-12"
      },
      "search": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/match-grade",
            "valueCode": "probable"
          }
        ],
        "mode": "match",
        "score": 0.9
      }
    }
  ]
}