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 - Versión en desarrollo (v0.1.0): borrador de trabajo de la Iniciativa HL7® Costa Rica, que puede cambiar sin aviso.

Perfil de los recursos: Profesional de salud

URL oficial: https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner Versión: 0.1.0
Standards status: Draft Nombre computable: CRPractitioner

Persona que presta servicios de salud en Costa Rica, con su identificación y su habilitación para ejercer: las colegiaturas en su colegio profesional y las especialidades inscritas. Implementa el modelo lógico del profesional de salud.

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
.. Practitioner 0..* Practitioner Profesional de salud, con su identificación y su habilitación para ejercer
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
.... use ?!SΣ 1..1 code official si está vigente; old si se conserva solo como histórico
Vinculación: IdentifierUse (required)
.... type SΣ 0..1 CodeableConcept Tipo de documento (opcional: el system ya lo indica)
Vinculación: Tipos de identificación del profesional de salud (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | pasaporte/{país} | colegiado/{colegio}}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento o del código de colegiado
Example General: 123456
... active ?!SΣ 1..1 boolean Si el registro del profesional está activo
... name SΣ 1..1 CRHumanName Nombre oficial, según el documento de identidad
.... use ?!SΣ 1..1 code official: el nombre del documento de identidad
Vinculación: NameUse (required): The use of a human name.
Required Pattern: official
.... family SΣ 1..1 string Los dos apellidos, en el orden del documento de identidad (Mora Rojas)
..... Slices for extension 1..* Extension Cada apellido por separado, con su origen si se conoce
Slice: Sin orden, Abierto by value:url
...... extension:primerApellido S 1..1 (Complex) Primer apellido, por separado, con su origen si se conoce
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido
...... extension:segundoApellido S 0..1 (Complex) Segundo apellido, por separado, con su origen si se conoce (si lo tiene)
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido
.... given SΣ 1..2 string Primer y segundo nombre
This repeating element order: Given Names appear in the correct order for presenting the name
Max Length:50
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico personal
Constraints: cr-telefono
... gender SΣ 0..1 code Sexo asignado al nacer: female | male | unknown
Vinculación: Sexo asignado al nacer (required)
... birthDate SΣ 0..1 date Fecha de nacimiento
... Slices for qualification S 1..* BackboneElement Colegiaturas y especialidades inscritas
Slice: Sin orden, Abierto by value:code.coding.system
.... qualification:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 CodeableConcept Coded representation of the qualification
Vinculación: hl7VS-degreeLicenseCertificate (example): Specific qualification the practitioner has to provide a service.
.... qualification:colegiatura S 1..* BackboneElement Incorporación a un colegio profesional
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 1..1 Identifier Número de colegiado
Constraints: cr-colegiatura-system
...... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
...... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/colegiado/{código del colegio}
Example General: http://www.acme.com/identifiers/patient
...... value SΣC 1..1 string Número de colegiado, tal como lo asigna el colegio
Example General: 123456
..... code 1..1 CodeableConcept Profesión que la colegiatura habilita a ejercer
Vinculación: Profesiones de salud (required)
..... period S 0..1 Period Vigencia de la colegiatura (sin fin, está vigente)
..... issuer S 1..1 Reference(Organización) Colegio profesional
.... qualification:especialidad S 0..* BackboneElement Especialidad inscrita en el colegio
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 0..1 Identifier Número con que el colegio inscribió la especialidad, si asigna uno
Constraints: cr-especialidad-system
..... code 1..1 CodeableConcept Especialidad inscrita
Vinculación: Especialidades en salud (extensible)
..... period S 0..1 Period Vigencia de la inscripción de la especialidad
..... issuer S 1..1 Reference(Organización) Colegio que inscribió la especialidad
... communication S 0..* BackboneElement Idiomas en que puede atender
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... language S 1..1 CodeableConcept Idioma (código BCP 47: es, en)
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding
.... preferred S 0..1 boolean Si es su idioma preferido

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
Practitioner.identifier.​use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Practitioner.identifier.​type Base required Tipos de identificación del profesional de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.name.use Base required NameUse 📍5.0.0 Estándar FHIR
Practitioner.gender Base required Sexo asignado al nacer 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification.​code Base example hl7VS-degreeLicenseCertificate 📦3.0.0 THO v7.4
Practitioner.qualification:colegiatura.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
Practitioner.qualification:colegiatura.​code Base required Profesiones de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:especialidad.​code Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-cedula-nacional-value error Practitioner.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-colegiado-system error Practitioner.identifier Un código de colegiado usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.startsWith('https://hl7.or.cr/fhir/sid/colegiado') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-colegiatura-system error Practitioner.qualification:colegiatura.identifier El número de colegiado de una colegiatura usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-dimex-value error Practitioner.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-especialidad-system error Practitioner.qualification:especialidad.identifier El número de registro de una especialidad usa el system https://hl7.or.cr/fhir/sid/especialidad/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/especialidad/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-pasaporte-system error Practitioner.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-profesional-identificador-system error Practitioner.identifier El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, 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.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/colegiado/')
cr-telefono error Practitioner.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 Practitioner If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Practitioner 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 Practitioner 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 Practitioner If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Practitioner 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()

Esta estructura se deriva de Practitioner .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Practitioner 0..* Practitioner Profesional de salud, con su identificación y su habilitación para ejercer
... identifier SC 1..* Identifier Documento de identidad y código de colegiado
Constraints: cr-profesional-identificador-system, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-colegiado-system
.... use S 1..1 code official si está vigente; old si se conserva solo como histórico
Vinculación: IdentifierUse (required)
.... type S 0..1 CodeableConcept Tipo de documento (opcional: el system ya lo indica)
Vinculación: Tipos de identificación del profesional de salud (required)
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | pasaporte/{país} | colegiado/{colegio}}
.... value S 1..1 string Número del documento o del código de colegiado
... active S 1..1 boolean Si el registro del profesional está activo
... name S 1..1 CRHumanName Nombre oficial, según el documento de identidad
.... prefix 0..0 No se usa: el título se deduce de la profesión
... gender S 0..1 code Sexo asignado al nacer: female | male | unknown
Vinculación: Sexo asignado al nacer (required)
... birthDate S 0..1 date Fecha de nacimiento
... Slices for qualification S 1..* BackboneElement Colegiaturas y especialidades inscritas
Slice: Sin orden, Abierto by value:code.coding.system
.... qualification:colegiatura S 1..* BackboneElement Incorporación a un colegio profesional
..... identifier SC 1..1 Identifier Número de colegiado
Constraints: cr-colegiatura-system
...... system S 1..1 uri https://hl7.or.cr/fhir/sid/colegiado/{código del colegio}
...... value S 1..1 string Número de colegiado, tal como lo asigna el colegio
..... code 1..1 CodeableConcept Profesión que la colegiatura habilita a ejercer
Vinculación: Profesiones de salud (required)
...... coding
....... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud
..... period S 0..1 Period Vigencia de la colegiatura (sin fin, está vigente)
..... issuer S 1..1 Reference(Organización) Colegio profesional
.... qualification:especialidad S 0..* BackboneElement Especialidad inscrita en el colegio
..... identifier SC 0..1 Identifier Número con que el colegio inscribió la especialidad, si asigna uno
Constraints: cr-especialidad-system
..... code 1..1 CodeableConcept Especialidad inscrita
Vinculación: Especialidades en salud (extensible)
...... coding
....... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud
..... period S 0..1 Period Vigencia de la inscripción de la especialidad
..... issuer S 1..1 Reference(Organización) Colegio que inscribió la especialidad
... communication S 0..* BackboneElement Idiomas en que puede atender
.... language S 1..1 CodeableConcept Idioma (código BCP 47: es, en)
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
Idiomas de Costa Rica UI Binding
.... preferred S 0..1 boolean Si es su idioma preferido

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso ValueSet Versión Fuente
Practitioner.identifier.​use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Practitioner.identifier.​type Base required Tipos de identificación del profesional de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.gender Base required Sexo asignado al nacer 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:colegiatura.​code Base required Profesiones de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:especialidad.​code Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-cedula-nacional-value error Practitioner.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-colegiado-system error Practitioner.identifier Un código de colegiado usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.startsWith('https://hl7.or.cr/fhir/sid/colegiado') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-colegiatura-system error Practitioner.qualification:colegiatura.identifier El número de colegiado de una colegiatura usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-dimex-value error Practitioner.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-especialidad-system error Practitioner.qualification:especialidad.identifier El número de registro de una especialidad usa el system https://hl7.or.cr/fhir/sid/especialidad/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/especialidad/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-pasaporte-system error Practitioner.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-profesional-identificador-system error Practitioner.identifier El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, 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.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/colegiado/')
cr-telefono error Practitioner.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
.. Practitioner 0..* Practitioner Profesional de salud, con su identificación y su habilitación para ejercer
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... identifier SΣC 1..* Identifier Documento de identidad y código de colegiado
Constraints: cr-profesional-identificador-system, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-colegiado-system
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official si está vigente; old si se conserva solo como histórico
Vinculación: IdentifierUse (required)
.... type SΣ 0..1 CodeableConcept Tipo de documento (opcional: el system ya lo indica)
Vinculación: Tipos de identificación del profesional de salud (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | pasaporte/{país} | colegiado/{colegio}}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento o del código de colegiado
Example General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... active ?!SΣ 1..1 boolean Si el registro del profesional está activo
... name SΣ 1..1 CRHumanName Nombre oficial, según el documento de identidad
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official: el nombre del documento de identidad
Vinculación: NameUse (required): The use of a human name.
Required Pattern: official
.... text Σ 0..1 string Text representation of the full name
.... family SΣ 1..1 string Los dos apellidos, en el orden del documento de identidad (Mora Rojas)
..... id 0..1 string xml:id (or equivalent in JSON)
..... Slices for extension 1..* Extension Cada apellido por separado, con su origen si se conoce
Slice: Sin orden, Abierto by value:url
...... extension:primerApellido S 1..1 (Complex) Primer apellido, por separado, con su origen si se conoce
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido
...... extension:segundoApellido S 0..1 (Complex) Segundo apellido, por separado, con su origen si se conoce (si lo tiene)
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido
..... value 0..1 string Primitive value for string
Max Length:1048576
.... given SΣ 1..2 string Primer y segundo nombre
This repeating element order: Given Names appear in the correct order for presenting the name
Max Length:50
.... suffix Σ 0..* string Parts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ 0..1 Period Time period when name was/is in use
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico personal
Constraints: cr-telefono
... gender SΣ 0..1 code Sexo asignado al nacer: female | male | unknown
Vinculación: Sexo asignado al nacer (required)
... birthDate SΣ 0..1 date Fecha de nacimiento
... deceased[x] Σ 0..1 Indicates if the practitioner is deceased or not
.... deceasedBoolean boolean
.... deceasedDateTime dateTime
... address Σ 0..* Address Address(es) of the practitioner that are not role specific (typically home address)
... photo 0..* Attachment Image of the person
... Slices for qualification S 1..* BackboneElement Colegiaturas y especialidades inscritas
Slice: Sin orden, Abierto by value:code.coding.system
.... qualification:All Slices Content/Rules for all slices
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier 0..* Identifier An identifier for this qualification for the practitioner
..... code 1..1 CodeableConcept Coded representation of the qualification
Vinculación: hl7VS-degreeLicenseCertificate (example): Specific qualification the practitioner has to provide a service.
..... period 0..1 Period Period during which the qualification is valid
..... issuer 0..1 Reference(Organization) Organization that regulates and issues the qualification
.... qualification:colegiatura S 1..* BackboneElement Incorporación a un colegio profesional
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 1..1 Identifier Número de colegiado
Constraints: cr-colegiatura-system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
...... type Σ 0..1 CodeableConcept Description of identifier
Vinculación: IdentifierTypeCodes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
...... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/colegiado/{código del colegio}
Example General: http://www.acme.com/identifiers/patient
...... value SΣC 1..1 string Número de colegiado, tal como lo asigna el colegio
Example General: 123456
...... period Σ 0..1 Period Time period when id is/was valid for use
...... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
..... code 1..1 CodeableConcept Profesión que la colegiatura habilita a ejercer
Vinculación: Profesiones de salud (required)
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... coding Σ 0..* Coding Code defined by a terminology system
....... id 0..1 id Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
....... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud
....... version Σ 0..1 string Version of the system - if relevant
....... code ΣC 0..1 code Symbol in syntax defined by the system
....... display ΣC 0..1 string Representation defined by the system
....... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
...... text Σ 0..1 string Plain text representation of the concept
..... period S 0..1 Period Vigencia de la colegiatura (sin fin, está vigente)
..... issuer S 1..1 Reference(Organización) Colegio profesional
.... qualification:especialidad S 0..* BackboneElement Especialidad inscrita en el colegio
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 0..1 Identifier Número con que el colegio inscribió la especialidad, si asigna uno
Constraints: cr-especialidad-system
..... code 1..1 CodeableConcept Especialidad inscrita
Vinculación: Especialidades en salud (extensible)
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... coding Σ 0..* Coding Code defined by a terminology system
....... id 0..1 id Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
....... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud
....... version Σ 0..1 string Version of the system - if relevant
....... code ΣC 0..1 code Symbol in syntax defined by the system
....... display ΣC 0..1 string Representation defined by the system
....... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
...... text Σ 0..1 string Plain text representation of the concept
..... period S 0..1 Period Vigencia de la inscripción de la especialidad
..... issuer S 1..1 Reference(Organización) Colegio que inscribió la especialidad
... communication S 0..* BackboneElement Idiomas en que puede atender
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... language S 1..1 CodeableConcept Idioma (código BCP 47: es, en)
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding
.... preferred S 0..1 boolean Si es su idioma preferido

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
Practitioner.language Base required All Languages 📍5.0.0 Estándar FHIR
Practitioner.identifier.​use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Practitioner.identifier.​type Base required Tipos de identificación del profesional de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.name.use Base required NameUse 📍5.0.0 Estándar FHIR
Practitioner.gender Base required Sexo asignado al nacer 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification.​code Base example hl7VS-degreeLicenseCertificate 📦3.0.0 THO v7.4
Practitioner.qualification:colegiatura.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
Practitioner.qualification:colegiatura.​identifier.type Base extensible Identifier Type Codes 📍5.0.0 Estándar FHIR
Practitioner.qualification:colegiatura.​code Base required Profesiones de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:especialidad.​code Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-cedula-nacional-value error Practitioner.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-colegiado-system error Practitioner.identifier Un código de colegiado usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.startsWith('https://hl7.or.cr/fhir/sid/colegiado') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-colegiatura-system error Practitioner.qualification:colegiatura.identifier El número de colegiado de una colegiatura usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-dimex-value error Practitioner.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-especialidad-system error Practitioner.qualification:especialidad.identifier El número de registro de una especialidad usa el system https://hl7.or.cr/fhir/sid/especialidad/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/especialidad/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-pasaporte-system error Practitioner.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-profesional-identificador-system error Practitioner.identifier El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, 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.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/colegiado/')
cr-telefono error Practitioner.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 Practitioner If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Practitioner 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 Practitioner 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 Practitioner If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Practitioner 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()

Esta estructura se deriva de Practitioner .

Resumen

Obligatorios: 12 elementos(3 nested mandatory elementos)
Must-Support: 24 elementos
Prohibited: 1 elemento

Estructuras

Esta estructura hace referencia a estas otras estructuras:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Practitioner.qualification

Vista de elementos clave

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Practitioner 0..* Practitioner Profesional de salud, con su identificación y su habilitación para ejercer
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
.... use ?!SΣ 1..1 code official si está vigente; old si se conserva solo como histórico
Vinculación: IdentifierUse (required)
.... type SΣ 0..1 CodeableConcept Tipo de documento (opcional: el system ya lo indica)
Vinculación: Tipos de identificación del profesional de salud (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | pasaporte/{país} | colegiado/{colegio}}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento o del código de colegiado
Example General: 123456
... active ?!SΣ 1..1 boolean Si el registro del profesional está activo
... name SΣ 1..1 CRHumanName Nombre oficial, según el documento de identidad
.... use ?!SΣ 1..1 code official: el nombre del documento de identidad
Vinculación: NameUse (required): The use of a human name.
Required Pattern: official
.... family SΣ 1..1 string Los dos apellidos, en el orden del documento de identidad (Mora Rojas)
..... Slices for extension 1..* Extension Cada apellido por separado, con su origen si se conoce
Slice: Sin orden, Abierto by value:url
...... extension:primerApellido S 1..1 (Complex) Primer apellido, por separado, con su origen si se conoce
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido
...... extension:segundoApellido S 0..1 (Complex) Segundo apellido, por separado, con su origen si se conoce (si lo tiene)
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido
.... given SΣ 1..2 string Primer y segundo nombre
This repeating element order: Given Names appear in the correct order for presenting the name
Max Length:50
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico personal
Constraints: cr-telefono
... gender SΣ 0..1 code Sexo asignado al nacer: female | male | unknown
Vinculación: Sexo asignado al nacer (required)
... birthDate SΣ 0..1 date Fecha de nacimiento
... Slices for qualification S 1..* BackboneElement Colegiaturas y especialidades inscritas
Slice: Sin orden, Abierto by value:code.coding.system
.... qualification:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 CodeableConcept Coded representation of the qualification
Vinculación: hl7VS-degreeLicenseCertificate (example): Specific qualification the practitioner has to provide a service.
.... qualification:colegiatura S 1..* BackboneElement Incorporación a un colegio profesional
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 1..1 Identifier Número de colegiado
Constraints: cr-colegiatura-system
...... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
...... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/colegiado/{código del colegio}
Example General: http://www.acme.com/identifiers/patient
...... value SΣC 1..1 string Número de colegiado, tal como lo asigna el colegio
Example General: 123456
..... code 1..1 CodeableConcept Profesión que la colegiatura habilita a ejercer
Vinculación: Profesiones de salud (required)
..... period S 0..1 Period Vigencia de la colegiatura (sin fin, está vigente)
..... issuer S 1..1 Reference(Organización) Colegio profesional
.... qualification:especialidad S 0..* BackboneElement Especialidad inscrita en el colegio
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 0..1 Identifier Número con que el colegio inscribió la especialidad, si asigna uno
Constraints: cr-especialidad-system
..... code 1..1 CodeableConcept Especialidad inscrita
Vinculación: Especialidades en salud (extensible)
..... period S 0..1 Period Vigencia de la inscripción de la especialidad
..... issuer S 1..1 Reference(Organización) Colegio que inscribió la especialidad
... communication S 0..* BackboneElement Idiomas en que puede atender
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... language S 1..1 CodeableConcept Idioma (código BCP 47: es, en)
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding
.... preferred S 0..1 boolean Si es su idioma preferido

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
Practitioner.identifier.​use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Practitioner.identifier.​type Base required Tipos de identificación del profesional de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.name.use Base required NameUse 📍5.0.0 Estándar FHIR
Practitioner.gender Base required Sexo asignado al nacer 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification.​code Base example hl7VS-degreeLicenseCertificate 📦3.0.0 THO v7.4
Practitioner.qualification:colegiatura.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
Practitioner.qualification:colegiatura.​code Base required Profesiones de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:especialidad.​code Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-cedula-nacional-value error Practitioner.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-colegiado-system error Practitioner.identifier Un código de colegiado usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.startsWith('https://hl7.or.cr/fhir/sid/colegiado') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-colegiatura-system error Practitioner.qualification:colegiatura.identifier El número de colegiado de una colegiatura usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-dimex-value error Practitioner.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-especialidad-system error Practitioner.qualification:especialidad.identifier El número de registro de una especialidad usa el system https://hl7.or.cr/fhir/sid/especialidad/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/especialidad/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-pasaporte-system error Practitioner.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-profesional-identificador-system error Practitioner.identifier El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, 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.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/colegiado/')
cr-telefono error Practitioner.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 Practitioner If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Practitioner 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 Practitioner 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 Practitioner If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Practitioner 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()

Vista diferencial

Esta estructura se deriva de Practitioner .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. Practitioner 0..* Practitioner Profesional de salud, con su identificación y su habilitación para ejercer
... identifier SC 1..* Identifier Documento de identidad y código de colegiado
Constraints: cr-profesional-identificador-system, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-colegiado-system
.... use S 1..1 code official si está vigente; old si se conserva solo como histórico
Vinculación: IdentifierUse (required)
.... type S 0..1 CodeableConcept Tipo de documento (opcional: el system ya lo indica)
Vinculación: Tipos de identificación del profesional de salud (required)
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | pasaporte/{país} | colegiado/{colegio}}
.... value S 1..1 string Número del documento o del código de colegiado
... active S 1..1 boolean Si el registro del profesional está activo
... name S 1..1 CRHumanName Nombre oficial, según el documento de identidad
.... prefix 0..0 No se usa: el título se deduce de la profesión
... gender S 0..1 code Sexo asignado al nacer: female | male | unknown
Vinculación: Sexo asignado al nacer (required)
... birthDate S 0..1 date Fecha de nacimiento
... Slices for qualification S 1..* BackboneElement Colegiaturas y especialidades inscritas
Slice: Sin orden, Abierto by value:code.coding.system
.... qualification:colegiatura S 1..* BackboneElement Incorporación a un colegio profesional
..... identifier SC 1..1 Identifier Número de colegiado
Constraints: cr-colegiatura-system
...... system S 1..1 uri https://hl7.or.cr/fhir/sid/colegiado/{código del colegio}
...... value S 1..1 string Número de colegiado, tal como lo asigna el colegio
..... code 1..1 CodeableConcept Profesión que la colegiatura habilita a ejercer
Vinculación: Profesiones de salud (required)
...... coding
....... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud
..... period S 0..1 Period Vigencia de la colegiatura (sin fin, está vigente)
..... issuer S 1..1 Reference(Organización) Colegio profesional
.... qualification:especialidad S 0..* BackboneElement Especialidad inscrita en el colegio
..... identifier SC 0..1 Identifier Número con que el colegio inscribió la especialidad, si asigna uno
Constraints: cr-especialidad-system
..... code 1..1 CodeableConcept Especialidad inscrita
Vinculación: Especialidades en salud (extensible)
...... coding
....... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud
..... period S 0..1 Period Vigencia de la inscripción de la especialidad
..... issuer S 1..1 Reference(Organización) Colegio que inscribió la especialidad
... communication S 0..* BackboneElement Idiomas en que puede atender
.... language S 1..1 CodeableConcept Idioma (código BCP 47: es, en)
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
Idiomas de Costa Rica UI Binding
.... preferred S 0..1 boolean Si es su idioma preferido

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso ValueSet Versión Fuente
Practitioner.identifier.​use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Practitioner.identifier.​type Base required Tipos de identificación del profesional de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.gender Base required Sexo asignado al nacer 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:colegiatura.​code Base required Profesiones de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:especialidad.​code Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-cedula-nacional-value error Practitioner.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-colegiado-system error Practitioner.identifier Un código de colegiado usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.startsWith('https://hl7.or.cr/fhir/sid/colegiado') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-colegiatura-system error Practitioner.qualification:colegiatura.identifier El número de colegiado de una colegiatura usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-dimex-value error Practitioner.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-especialidad-system error Practitioner.qualification:especialidad.identifier El número de registro de una especialidad usa el system https://hl7.or.cr/fhir/sid/especialidad/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/especialidad/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-pasaporte-system error Practitioner.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-profesional-identificador-system error Practitioner.identifier El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, 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.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/colegiado/')
cr-telefono error Practitioner.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
.. Practitioner 0..* Practitioner Profesional de salud, con su identificación y su habilitación para ejercer
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... identifier SΣC 1..* Identifier Documento de identidad y código de colegiado
Constraints: cr-profesional-identificador-system, cr-cedula-nacional-value, cr-dimex-value, cr-pasaporte-system, cr-colegiado-system
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official si está vigente; old si se conserva solo como histórico
Vinculación: IdentifierUse (required)
.... type SΣ 0..1 CodeableConcept Tipo de documento (opcional: el system ya lo indica)
Vinculación: Tipos de identificación del profesional de salud (required)
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/{cedula-nacional | dimex | pasaporte/{país} | colegiado/{colegio}}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del documento o del código de colegiado
Example General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... active ?!SΣ 1..1 boolean Si el registro del profesional está activo
... name SΣ 1..1 CRHumanName Nombre oficial, según el documento de identidad
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
.... use ?!SΣ 1..1 code official: el nombre del documento de identidad
Vinculación: NameUse (required): The use of a human name.
Required Pattern: official
.... text Σ 0..1 string Text representation of the full name
.... family SΣ 1..1 string Los dos apellidos, en el orden del documento de identidad (Mora Rojas)
..... id 0..1 string xml:id (or equivalent in JSON)
..... Slices for extension 1..* Extension Cada apellido por separado, con su origen si se conoce
Slice: Sin orden, Abierto by value:url
...... extension:primerApellido S 1..1 (Complex) Primer apellido, por separado, con su origen si se conoce
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido
...... extension:segundoApellido S 0..1 (Complex) Segundo apellido, por separado, con su origen si se conoce (si lo tiene)
URL: https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido
..... value 0..1 string Primitive value for string
Max Length:1048576
.... given SΣ 1..2 string Primer y segundo nombre
This repeating element order: Given Names appear in the correct order for presenting the name
Max Length:50
.... suffix Σ 0..* string Parts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ 0..1 Period Time period when name was/is in use
... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico personal
Constraints: cr-telefono
... gender SΣ 0..1 code Sexo asignado al nacer: female | male | unknown
Vinculación: Sexo asignado al nacer (required)
... birthDate SΣ 0..1 date Fecha de nacimiento
... deceased[x] Σ 0..1 Indicates if the practitioner is deceased or not
.... deceasedBoolean boolean
.... deceasedDateTime dateTime
... address Σ 0..* Address Address(es) of the practitioner that are not role specific (typically home address)
... photo 0..* Attachment Image of the person
... Slices for qualification S 1..* BackboneElement Colegiaturas y especialidades inscritas
Slice: Sin orden, Abierto by value:code.coding.system
.... qualification:All Slices Content/Rules for all slices
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier 0..* Identifier An identifier for this qualification for the practitioner
..... code 1..1 CodeableConcept Coded representation of the qualification
Vinculación: hl7VS-degreeLicenseCertificate (example): Specific qualification the practitioner has to provide a service.
..... period 0..1 Period Period during which the qualification is valid
..... issuer 0..1 Reference(Organization) Organization that regulates and issues the qualification
.... qualification:colegiatura S 1..* BackboneElement Incorporación a un colegio profesional
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 1..1 Identifier Número de colegiado
Constraints: cr-colegiatura-system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
...... type Σ 0..1 CodeableConcept Description of identifier
Vinculación: IdentifierTypeCodes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
...... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/colegiado/{código del colegio}
Example General: http://www.acme.com/identifiers/patient
...... value SΣC 1..1 string Número de colegiado, tal como lo asigna el colegio
Example General: 123456
...... period Σ 0..1 Period Time period when id is/was valid for use
...... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
..... code 1..1 CodeableConcept Profesión que la colegiatura habilita a ejercer
Vinculación: Profesiones de salud (required)
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... coding Σ 0..* Coding Code defined by a terminology system
....... id 0..1 id Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
....... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud
....... version Σ 0..1 string Version of the system - if relevant
....... code ΣC 0..1 code Symbol in syntax defined by the system
....... display ΣC 0..1 string Representation defined by the system
....... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
...... text Σ 0..1 string Plain text representation of the concept
..... period S 0..1 Period Vigencia de la colegiatura (sin fin, está vigente)
..... issuer S 1..1 Reference(Organización) Colegio profesional
.... qualification:especialidad S 0..* BackboneElement Especialidad inscrita en el colegio
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... identifier SC 0..1 Identifier Número con que el colegio inscribió la especialidad, si asigna uno
Constraints: cr-especialidad-system
..... code 1..1 CodeableConcept Especialidad inscrita
Vinculación: Especialidades en salud (extensible)
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... coding Σ 0..* Coding Code defined by a terminology system
....... id 0..1 id Unique id for inter-element referencing
....... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
....... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud
....... version Σ 0..1 string Version of the system - if relevant
....... code ΣC 0..1 code Symbol in syntax defined by the system
....... display ΣC 0..1 string Representation defined by the system
....... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
...... text Σ 0..1 string Plain text representation of the concept
..... period S 0..1 Period Vigencia de la inscripción de la especialidad
..... issuer S 1..1 Reference(Organización) Colegio que inscribió la especialidad
... communication S 0..* BackboneElement Idiomas en que puede atender
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... language S 1..1 CodeableConcept Idioma (código BCP 47: es, en)
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding
.... preferred S 0..1 boolean Si es su idioma preferido

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
Practitioner.language Base required All Languages 📍5.0.0 Estándar FHIR
Practitioner.identifier.​use Base required IdentifierUse 📦5.0.0 Estándar FHIR
Practitioner.identifier.​type Base required Tipos de identificación del profesional de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.name.use Base required NameUse 📍5.0.0 Estándar FHIR
Practitioner.gender Base required Sexo asignado al nacer 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification.​code Base example hl7VS-degreeLicenseCertificate 📦3.0.0 THO v7.4
Practitioner.qualification:colegiatura.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
Practitioner.qualification:colegiatura.​identifier.type Base extensible Identifier Type Codes 📍5.0.0 Estándar FHIR
Practitioner.qualification:colegiatura.​code Base required Profesiones de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.qualification:especialidad.​code Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
Practitioner.communication.​language Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-cedula-nacional-value error Practitioner.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-colegiado-system error Practitioner.identifier Un código de colegiado usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.startsWith('https://hl7.or.cr/fhir/sid/colegiado') implies system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-colegiatura-system error Practitioner.qualification:colegiatura.identifier El número de colegiado de una colegiatura usa el system https://hl7.or.cr/fhir/sid/colegiado/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/colegiado/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-dimex-value error Practitioner.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-especialidad-system error Practitioner.qualification:especialidad.identifier El número de registro de una especialidad usa el system https://hl7.or.cr/fhir/sid/especialidad/ seguido del código de un colegio profesional. system.matches('^https://hl7\\.or\\.cr/fhir/sid/especialidad/(cmc|ccd|cfc|cmqc|cecr|cpp|cpn|ctcr)$')
cr-pasaporte-system error Practitioner.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-profesional-identificador-system error Practitioner.identifier El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, 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.startsWith('https://hl7.or.cr/fhir/sid/pasaporte/') or system.startsWith('https://hl7.or.cr/fhir/sid/colegiado/')
cr-telefono error Practitioner.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 Practitioner If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Practitioner 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 Practitioner 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 Practitioner If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Practitioner 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()

Esta estructura se deriva de Practitioner .

Resumen

Obligatorios: 12 elementos(3 nested mandatory elementos)
Must-Support: 24 elementos
Prohibited: 1 elemento

Estructuras

Esta estructura hace referencia a estas otras estructuras:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Practitioner.qualification

 

Otras representaciones de perfil: CSV, Excel, Schematron

Notas:

Uso en el HIE

Registro de profesionales. Profesionales de salud, con su identificación, sus colegiaturas y sus especialidades inscritas.

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

Leer

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

Lee un profesional de salud del registro de profesionales por su id, la parte final de su URL. Se usa para resolver una referencia que otro recurso hace a un profesional de salud. En el ejemplo se lee «Médica general costarricense»; la segunda respuesta es la de un id que no existe.

Solicitud

GET [base]/Practitioner/ejemplo-profesional-medicina 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": "Practitioner",
  "id": "ejemplo-profesional-medicina",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
    ]
  },
  "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": "112340567"
    },
    {
      "type": {
        "coding": [
          {
            "code": "codigo-colegiado",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Código de colegiado"
          },
          {
            "code": "LN",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "License number"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
      "value": "12345"
    }
  ],
  "name": [
    {
      "given": [
        "Ana"
      ],
      "use": "official",
      "family": "Mora Rojas",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Mora"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Rojas"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "telecom": [
    {
      "system": "email",
      "value": "ana.mora@correo-ejemplo.cr"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
          "value": "12345"
        }
      ],
      "period": {
        "start": "2011-03-10"
      },
      "code": {
        "coding": [
          {
            "code": "medicina",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
            "display": "Medicina"
          }
        ]
      },
      "issuer": {
        "reference": "Organization/ejemplo-organizacion-cmc",
        "display": "Colegio de Médicos y Cirujanos de Costa Rica"
      }
    }
  ],
  "communication": [
    {
      "language": {
        "coding": [
          {
            "code": "es",
            "system": "urn:ietf:bcp:47",
            "display": "español"
          }
        ]
      },
      "preferred": true
    }
  ],
  "active": true,
  "gender": "female",
  "birthDate": "1985-06-15"
}

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 Practitioner/no-existe."
    }
  ]
}
Buscar

Buscar por cédula o código de colegiado
Forma: GET [base]/Practitioner?identifier={sistema}|{valor}

Encuentra a un profesional por su cédula o por su código de colegiado. Así se verifica que quien firma un documento está registrado. En el ejemplo se usa el dato de «Médica general costarricense»: identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|112340567.

Solicitud

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

Respuesta: 1 resultado: Médica general costarricense

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner?identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|112340567"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por nombre
Forma: GET [base]/Practitioner?name={texto}

Busca profesionales por cualquier parte de su nombre. En el ejemplo se usa el dato de «Médica general costarricense»: name=Mora Rojas.

Solicitud

GET [base]/Practitioner?name=Mora Rojas HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Médica general costarricense

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner?name=Mora Rojas"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

Busca profesionales por sus apellidos. En el ejemplo se usa el dato de «Médica general costarricense»: family=Mora Rojas.

Solicitud

GET [base]/Practitioner?family=Mora Rojas HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Médica general costarricense

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner?family=Mora Rojas"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

Busca profesionales por su nombre; se combina con los apellidos. En el ejemplo se usa el dato de «Médica general costarricense»: given=Ana.

Solicitud

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

Respuesta: 1 resultado: Médica general costarricense

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner?given=Ana"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

Trae solo los registros activos, que son los que un sistema debe ofrecer al usuario; los inactivos se conservan porque otros datos los siguen citando. En el ejemplo se usa el dato de «Médica general costarricense»: active=true.

Solicitud

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

Respuesta: 4 resultados, de 2 en 2 con _count; la primera página trae Médica general costarricense; Médico especialista en medicina interna

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 4,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner?active=true&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/Practitioner?active=true&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina-interna",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina-interna",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "109870654"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "9876"
          }
        ],
        "name": [
          {
            "given": [
              "Ricardo"
            ],
            "use": "official",
            "family": "Castro Brenes",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Castro"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Brenes"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "9876"
              }
            ],
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          },
          {
            "code": {
              "text": "Medicina Interna"
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "active": true,
        "gender": "male"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

Trae los profesionales de salud 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]/Practitioner?_lastUpdated=ge2026-10-01&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 4 resultados, de 2 en 2 con _count; la primera página trae Médica general costarricense; Médico especialista en medicina interna

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 4,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner?_lastUpdated=ge2026-10-01&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/Practitioner?_lastUpdated=ge2026-10-01&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina-interna",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina-interna",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "109870654"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "9876"
          }
        ],
        "name": [
          {
            "given": [
              "Ricardo"
            ],
            "use": "official",
            "family": "Castro Brenes",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Castro"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Brenes"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "9876"
              }
            ],
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          },
          {
            "code": {
              "text": "Medicina Interna"
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "active": true,
        "gender": "male"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por cédula o código de colegiado, con POST
Forma: POST [base]/Practitioner/_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 o código de colegiado.

Solicitud

POST [base]/Practitioner/_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|112340567

Respuesta: 1 resultado: Médica general costarricense, 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]/Practitioner?identifier=https://hl7.or.cr/fhir/sid/cedula-nacional|112340567"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}
Crear

Crear
Forma: POST [base]/Practitioner

Registra un profesional de salud en el registro de profesionales. El servidor valida el recurso contra el perfil, le asigna su id y devuelve su dirección. Lo ideal es que lo hagan los colegios profesionales, que son la fuente de las colegiaturas (IHE mCSD ITI-130). En el ejemplo se registra «Médica general costarricense»; la segunda respuesta es el rechazo de un recurso que no cumple la invariante cr-profesional-identificador-system (El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, con su system de https://hl7.or.cr/fhir/sid/).

Solicitud

POST [base]/Practitioner HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
Content-Type: application/fhir+json
{
  "resourceType": "Practitioner",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
    ]
  },
  "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": "112340567"
    },
    {
      "type": {
        "coding": [
          {
            "code": "codigo-colegiado",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Código de colegiado"
          },
          {
            "code": "LN",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "License number"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
      "value": "12345"
    }
  ],
  "name": [
    {
      "given": [
        "Ana"
      ],
      "use": "official",
      "family": "Mora Rojas",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Mora"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Rojas"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "telecom": [
    {
      "system": "email",
      "value": "ana.mora@correo-ejemplo.cr"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
          "value": "12345"
        }
      ],
      "period": {
        "start": "2011-03-10"
      },
      "code": {
        "coding": [
          {
            "code": "medicina",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
            "display": "Medicina"
          }
        ]
      },
      "issuer": {
        "reference": "Organization/ejemplo-organizacion-cmc",
        "display": "Colegio de Médicos y Cirujanos de Costa Rica"
      }
    }
  ],
  "communication": [
    {
      "language": {
        "coding": [
          {
            "code": "es",
            "system": "urn:ietf:bcp:47",
            "display": "español"
          }
        ]
      },
      "preferred": true
    }
  ],
  "active": true,
  "gender": "female",
  "birthDate": "1985-06-15"
}

Respuesta si se crea

HTTP/1.1 201 Created
Location: [base]/Practitioner/ejemplo-profesional-medicina/_history/1
ETag: W/"1"
Last-Modified: 2026-10-01T10:00:00-06:00
Content-Type: application/fhir+json
{
  "resourceType": "Practitioner",
  "id": "ejemplo-profesional-medicina",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
    ]
  },
  "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": "112340567"
    },
    {
      "type": {
        "coding": [
          {
            "code": "codigo-colegiado",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Código de colegiado"
          },
          {
            "code": "LN",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "License number"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
      "value": "12345"
    }
  ],
  "name": [
    {
      "given": [
        "Ana"
      ],
      "use": "official",
      "family": "Mora Rojas",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Mora"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Rojas"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "telecom": [
    {
      "system": "email",
      "value": "ana.mora@correo-ejemplo.cr"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
          "value": "12345"
        }
      ],
      "period": {
        "start": "2011-03-10"
      },
      "code": {
        "coding": [
          {
            "code": "medicina",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
            "display": "Medicina"
          }
        ]
      },
      "issuer": {
        "reference": "Organization/ejemplo-organizacion-cmc",
        "display": "Colegio de Médicos y Cirujanos de Costa Rica"
      }
    }
  ],
  "communication": [
    {
      "language": {
        "coding": [
          {
            "code": "es",
            "system": "urn:ietf:bcp:47",
            "display": "español"
          }
        ]
      },
      "preferred": true
    }
  ],
  "active": true,
  "gender": "female",
  "birthDate": "1985-06-15"
}

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

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/fhir+json
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invariant",
      "diagnostics": "cr-profesional-identificador-system: El identificador es una cédula nacional, un DIMEX, un pasaporte o un código de colegiado, con su system de https://hl7.or.cr/fhir/sid/.",
      "expression": [
        "Practitioner.identifier"
      ]
    }
  ]
}
Actualizar

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

Reemplaza un profesional de salud 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 «Médica general costarricense» sobre su versión 1; la segunda respuesta es el rechazo cuando otra persona ya la había cambiado.

Solicitud

PUT [base]/Practitioner/ejemplo-profesional-medicina HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
If-Match: W/"1"
Content-Type: application/fhir+json
{
  "resourceType": "Practitioner",
  "id": "ejemplo-profesional-medicina",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
    ]
  },
  "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": "112340567"
    },
    {
      "type": {
        "coding": [
          {
            "code": "codigo-colegiado",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Código de colegiado"
          },
          {
            "code": "LN",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "License number"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
      "value": "12345"
    }
  ],
  "name": [
    {
      "given": [
        "Ana"
      ],
      "use": "official",
      "family": "Mora Rojas",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Mora"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Rojas"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "telecom": [
    {
      "system": "email",
      "value": "ana.mora@correo-ejemplo.cr"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
          "value": "12345"
        }
      ],
      "period": {
        "start": "2011-03-10"
      },
      "code": {
        "coding": [
          {
            "code": "medicina",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
            "display": "Medicina"
          }
        ]
      },
      "issuer": {
        "reference": "Organization/ejemplo-organizacion-cmc",
        "display": "Colegio de Médicos y Cirujanos de Costa Rica"
      }
    }
  ],
  "communication": [
    {
      "language": {
        "coding": [
          {
            "code": "es",
            "system": "urn:ietf:bcp:47",
            "display": "español"
          }
        ]
      },
      "preferred": true
    }
  ],
  "active": true,
  "gender": "female",
  "birthDate": "1985-06-15"
}

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": "Practitioner",
  "id": "ejemplo-profesional-medicina",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2026-10-02T08:15:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
    ]
  },
  "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": "112340567"
    },
    {
      "type": {
        "coding": [
          {
            "code": "codigo-colegiado",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
            "display": "Código de colegiado"
          },
          {
            "code": "LN",
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "display": "License number"
          }
        ]
      },
      "use": "official",
      "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
      "value": "12345"
    }
  ],
  "name": [
    {
      "given": [
        "Ana"
      ],
      "use": "official",
      "family": "Mora Rojas",
      "_family": {
        "extension": [
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Mora"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
          },
          {
            "extension": [
              {
                "url": "valor",
                "valueString": "Rojas"
              }
            ],
            "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
          }
        ]
      }
    }
  ],
  "telecom": [
    {
      "system": "email",
      "value": "ana.mora@correo-ejemplo.cr"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
          "value": "12345"
        }
      ],
      "period": {
        "start": "2011-03-10"
      },
      "code": {
        "coding": [
          {
            "code": "medicina",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
            "display": "Medicina"
          }
        ]
      },
      "issuer": {
        "reference": "Organization/ejemplo-organizacion-cmc",
        "display": "Colegio de Médicos y Cirujanos de Costa Rica"
      }
    }
  ],
  "communication": [
    {
      "language": {
        "coding": [
          {
            "code": "es",
            "system": "urn:ietf:bcp:47",
            "display": "español"
          }
        ]
      },
      "preferred": true
    }
  ],
  "active": true,
  "gender": "female",
  "birthDate": "1985-06-15"
}

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 Practitioner/ejemplo-profesional-medicina no es la 1: léalo de nuevo y repita el cambio."
    }
  ]
}
Historial

Cambios desde una fecha (IHE mCSD ITI-91)
Forma: GET [base]/Practitioner/_history?_since={fecha y hora}

Trae los profesionales de salud que se crearon o cambiaron en el registro de profesionales desde una fecha y hora. La usa un sistema que guarda una copia del registro para mantenerla al día (IHE mCSD ITI-91). En el ejemplo se piden los cambios desde el 2026-10-01, de 2 en 2.

Solicitud

GET [base]/Practitioner/_history?_since=2026-10-01T00:00:00-06:00&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 4 cambios, de 2 en 2 con _count

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "history",
  "total": 4,
  "link": [
    {
      "relation": "self",
      "url": "[base]/Practitioner/_history?_since=2026-10-01T00:00:00-06:00&_count=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "112340567"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "12345"
          }
        ],
        "name": [
          {
            "given": [
              "Ana"
            ],
            "use": "official",
            "family": "Mora Rojas",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Mora"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Rojas"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "telecom": [
          {
            "system": "email",
            "value": "ana.mora@correo-ejemplo.cr"
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "12345"
              }
            ],
            "period": {
              "start": "2011-03-10"
            },
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "communication": [
          {
            "language": {
              "coding": [
                {
                  "code": "es",
                  "system": "urn:ietf:bcp:47",
                  "display": "español"
                }
              ]
            },
            "preferred": true
          }
        ],
        "active": true,
        "gender": "female",
        "birthDate": "1985-06-15"
      },
      "request": {
        "method": "POST",
        "url": "Practitioner"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    },
    {
      "fullUrl": "[base]/Practitioner/ejemplo-profesional-medicina-interna",
      "resource": {
        "resourceType": "Practitioner",
        "id": "ejemplo-profesional-medicina-interna",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-practitioner"
          ]
        },
        "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": "109870654"
          },
          {
            "type": {
              "coding": [
                {
                  "code": "codigo-colegiado",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-identificacion",
                  "display": "Código de colegiado"
                },
                {
                  "code": "LN",
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "display": "License number"
                }
              ]
            },
            "use": "official",
            "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
            "value": "9876"
          }
        ],
        "name": [
          {
            "given": [
              "Ricardo"
            ],
            "use": "official",
            "family": "Castro Brenes",
            "_family": {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Castro"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-primer-apellido"
                },
                {
                  "extension": [
                    {
                      "url": "valor",
                      "valueString": "Brenes"
                    }
                  ],
                  "url": "https://hl7.or.cr/fhir/core/StructureDefinition/cr-segundo-apellido"
                }
              ]
            }
          }
        ],
        "qualification": [
          {
            "identifier": [
              {
                "system": "https://hl7.or.cr/fhir/sid/colegiado/cmc",
                "value": "9876"
              }
            ],
            "code": {
              "coding": [
                {
                  "code": "medicina",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-profesion-salud",
                  "display": "Medicina"
                }
              ]
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          },
          {
            "code": {
              "text": "Medicina Interna"
            },
            "issuer": {
              "reference": "Organization/ejemplo-organizacion-cmc",
              "display": "Colegio de Médicos y Cirujanos de Costa Rica"
            }
          }
        ],
        "active": true,
        "gender": "male"
      },
      "request": {
        "method": "POST",
        "url": "Practitioner"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    }
  ]
}