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: Servicio de salud

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

Servicio de salud que ofrece una organización en Costa Rica en una o varias ubicaciones: qué se ofrece, con qué especialidad o modalidad de imagen, qué requisitos pide, en qué horario y cómo contactarlo. Implementa el modelo lógico del servicio 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
.. HealthcareService C 0..* HealthcareService Servicio de salud: qué se ofrece, dónde, en qué horario y con qué requisitos
Constraints: cr-servicio-especialidad, cr-servicio-modalidad, cr-identificador-unico
... 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 ?!Σ 0..1 code official (valor fijo)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Required Pattern: official
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/servicio/{código del establecimiento}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Código del servicio en el sistema de la organización
Constraints: cr-codigo-interno-value
Example General: 123456
Max Length:64
... active ?!SΣ 1..1 boolean Si el servicio se está ofreciendo
... providedBy SΣ 1..1 Reference(Organización) Organización que presta el servicio y responde por él
... type SΣ 1..* CodeableConcept Tipo de servicio del catálogo de Costa Rica
Vinculación: Tipos de servicio de salud (extensible)
... specialty SΣ 0..* CodeableConcept Especialidades del servicio
Vinculación: Especialidades en salud (extensible)
... location SΣ 1..* Reference(Ubicación) Ubicaciones donde se presta
... name SΣ 1..1 string Nombre del servicio (Consulta externa de cardiología)
Max Length:250
... comment SΣ 0..1 markdown Información para el paciente o quien refiere: preparación, avisos
... contact S 0..* ExtendedContactDetail Contacto de trabajo del servicio, por ejemplo para pedir citas
.... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos; extensión interna con ;ext=) o correo electrónico
Constraints: cr-telefono
..... use ?!Σ 0..1 code work (valor fijo)
Vinculación: ContactPointUse (required): Use of contact point.
Required Pattern: work
... eligibility S 0..* BackboneElement Requisitos de acceso: referencia, orden médica o cobertura
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code S 1..1 CodeableConcept Requisito (referencia | orden-medica | cobertura)
Vinculación: Requisitos de acceso (extensible)
.... comment S 0..1 markdown Detalle del requisito: qué cobertura se acepta, de qué nivel viene la referencia
... Slices for characteristic S 0..* CodeableConcept Modalidades de imagen DICOM del servicio
Slice: Sin orden, Abierto by value:coding.system
Vinculación: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
.... characteristic:modalidadImagen S 0..* CodeableConcept Modalidad de imagen DICOM: CT, MR, US, MG, DX, CR, NM, PT, XA, RF
Vinculación: Modality . (extensible)
... communication S 0..* CodeableConcept Idiomas en que se atiende, además del español
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding

... appointmentRequired S 0..1 boolean Si se atiende solo con cita previa
... availability S 0..1 Availability Horario del servicio
.... availableTime SΣC 0..* Element Bloque de días con el mismo horario
Constraints: av-1, cr-servicio-horario
..... daysOfWeek SΣ 1..* code Días del bloque: mon | tue | wed | thu | fri | sat | sun
Vinculación: DaysOfWeek (required): The purpose for which an extended contact detail should be used.
..... allDay SΣC 0..1 boolean Si atiende las 24 horas esos días
..... availableStartTime SΣC 0..1 time Hora de inicio, en hora de Costa Rica (UTC−6)
..... availableEndTime SΣC 0..1 time Hora de fin, en hora de Costa Rica (UTC−6)

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
HealthcareService.identifier.​use Base required IdentifierUse 📍5.0.0 Estándar FHIR
HealthcareService.type Base extensible Tipos de servicio de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.contact.​telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR
HealthcareService.eligibility.​code Base extensible Requisitos de acceso 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.characteristic Base example Service Mode 📍5.0.0 Estándar FHIR
HealthcareService.characteristic:modalidadImagen Base extensible Modality . ⏿2025.3.20250714 tx.fhir.org
HealthcareService.communication Base required All Languages 📍5.0.0 Estándar FHIR
HealthcareService.availability.​availableTime.daysOfWeek Base required Days Of Week 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
av-1 error HealthcareService.availability.availableTime Cannot include start/end times when selecting all day availability. allDay.exists().not() or (allDay implies availableStartTime.exists().not() and availableEndTime.exists().not())
cr-codigo-interno-value error HealthcareService.identifier.value Un código interno tiene de 1 a 64 caracteres, sin espacios. matches('^\\S{1,64}$')
cr-identificador-unico error HealthcareService No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-servicio-especialidad error HealthcareService Una consulta especializada indica su especialidad. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'consulta-especializada').exists() implies specialty.exists()
cr-servicio-horario error HealthcareService.availability.availableTime Un bloque de horario es de todo el día, sin horas, o tiene hora de inicio y de fin, con el inicio antes del fin. (allDay.where($this = true).exists() and availableStartTime.empty() and availableEndTime.empty()) or (allDay.where($this = true).empty() and availableStartTime.exists() and availableEndTime.exists() and availableStartTime < availableEndTime)
cr-servicio-modalidad error HealthcareService Un servicio de imágenes médicas indica sus modalidades de imagen DICOM, y solo él las lleva. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'imagenes-medicas').exists() = characteristic.coding.where(system = 'http://dicom.nema.org/resources/ontology/DCM').exists()
cr-servicio-system error HealthcareService.identifier El system del identificador es https://hl7.or.cr/fhir/sid/servicio/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/servicio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-telefono error HealthcareService.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
dom-2 error HealthcareService If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error HealthcareService 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 HealthcareService 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 HealthcareService If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice HealthcareService 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 HealthcareService .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. HealthcareService C 0..* HealthcareService Servicio de salud: qué se ofrece, dónde, en qué horario y con qué requisitos
Constraints: cr-servicio-especialidad, cr-servicio-modalidad, cr-identificador-unico
... identifier SC 0..* Identifier Código interno del servicio (agenda de citas)
Constraints: cr-servicio-system
.... use 0..1 code official (valor fijo)
Required Pattern: official
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/servicio/{código del establecimiento}
.... value SC 1..1 string Código del servicio en el sistema de la organización
Constraints: cr-codigo-interno-value
Max Length:64
... active S 1..1 boolean Si el servicio se está ofreciendo
... providedBy S 1..1 Reference(Organización) Organización que presta el servicio y responde por él
... specialty S 0..* CodeableConcept Especialidades del servicio
Vinculación: Especialidades en salud (extensible)
... location S 1..* Reference(Ubicación) Ubicaciones donde se presta
... name S 1..1 string Nombre del servicio (Consulta externa de cardiología)
Max Length:250
... comment S 0..1 markdown Información para el paciente o quien refiere: preparación, avisos
... contact S 0..* ExtendedContactDetail Contacto de trabajo del servicio, por ejemplo para pedir citas
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos; extensión interna con ;ext=) o correo electrónico
Constraints: cr-telefono
..... use 0..1 code work (valor fijo)
Required Pattern: work
... eligibility S 0..* BackboneElement Requisitos de acceso: referencia, orden médica o cobertura
.... code S 1..1 CodeableConcept Requisito (referencia | orden-medica | cobertura)
Vinculación: Requisitos de acceso (extensible)
.... comment S 0..1 markdown Detalle del requisito: qué cobertura se acepta, de qué nivel viene la referencia
... Slices for characteristic S 0..* CodeableConcept Modalidades de imagen DICOM del servicio
Slice: Sin orden, Abierto by value:coding.system
.... characteristic:modalidadImagen S 0..* CodeableConcept Modalidad de imagen DICOM: CT, MR, US, MG, DX, CR, NM, PT, XA, RF
Vinculación: Modality . (extensible)
..... coding
...... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: http://dicom.nema.org/resources/ontology/DCM
... communication S 0..* CodeableConcept Idiomas en que se atiende, además del español
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
Idiomas de Costa Rica UI Binding
... appointmentRequired S 0..1 boolean Si se atiende solo con cita previa
... availability S 0..1 Availability Horario del servicio
.... availableTime SC 0..* Element Bloque de días con el mismo horario
Constraints: cr-servicio-horario
..... daysOfWeek S 1..* code Días del bloque: mon | tue | wed | thu | fri | sat | sun
..... allDay S 0..1 boolean Si atiende las 24 horas esos días
..... availableStartTime S 0..1 time Hora de inicio, en hora de Costa Rica (UTC−6)
..... availableEndTime S 0..1 time Hora de fin, en hora de Costa Rica (UTC−6)

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso ValueSet Versión Fuente
HealthcareService.type Base extensible Tipos de servicio de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.eligibility.​code Base extensible Requisitos de acceso 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.characteristic:modalidadImagen Base extensible Modality . ⏿2025.3.20250714 tx.fhir.org
HealthcareService.communication Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-codigo-interno-value error HealthcareService.identifier.value Un código interno tiene de 1 a 64 caracteres, sin espacios. matches('^\\S{1,64}$')
cr-identificador-unico error HealthcareService No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-servicio-especialidad error HealthcareService Una consulta especializada indica su especialidad. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'consulta-especializada').exists() implies specialty.exists()
cr-servicio-horario error HealthcareService.availability.availableTime Un bloque de horario es de todo el día, sin horas, o tiene hora de inicio y de fin, con el inicio antes del fin. (allDay.where($this = true).exists() and availableStartTime.empty() and availableEndTime.empty()) or (allDay.where($this = true).empty() and availableStartTime.exists() and availableEndTime.exists() and availableStartTime < availableEndTime)
cr-servicio-modalidad error HealthcareService Un servicio de imágenes médicas indica sus modalidades de imagen DICOM, y solo él las lleva. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'imagenes-medicas').exists() = characteristic.coding.where(system = 'http://dicom.nema.org/resources/ontology/DCM').exists()
cr-servicio-system error HealthcareService.identifier El system del identificador es https://hl7.or.cr/fhir/sid/servicio/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/servicio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-telefono error HealthcareService.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. HealthcareService C 0..* HealthcareService Servicio de salud: qué se ofrece, dónde, en qué horario y con qué requisitos
Constraints: cr-servicio-especialidad, cr-servicio-modalidad, cr-identificador-unico
... 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
... language 0..1 code Language of the resource content
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
... 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 0..* Identifier Código interno del servicio (agenda de citas)
Constraints: cr-servicio-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 official (valor fijo)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Required Pattern: official
.... 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/servicio/{código del establecimiento}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Código del servicio en el sistema de la organización
Constraints: cr-codigo-interno-value
Example General: 123456
Max Length:64
.... 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 servicio se está ofreciendo
... providedBy SΣ 1..1 Reference(Organización) Organización que presta el servicio y responde por él
... offeredIn 0..* Reference(HealthcareService) The service within which this service is offered
... category Σ 0..* CodeableConcept Broad category of service being performed or delivered
Vinculación: ServiceCategory (example): A category of the service(s) that could be provided.
... type SΣ 1..* CodeableConcept Tipo de servicio del catálogo de Costa Rica
Vinculación: Tipos de servicio de salud (extensible)
... specialty SΣ 0..* CodeableConcept Especialidades del servicio
Vinculación: Especialidades en salud (extensible)
... location SΣ 1..* Reference(Ubicación) Ubicaciones donde se presta
... name SΣ 1..1 string Nombre del servicio (Consulta externa de cardiología)
Max Length:250
... comment SΣ 0..1 markdown Información para el paciente o quien refiere: preparación, avisos
... extraDetails 0..1 markdown Extra details about the service that can't be placed in the other fields
... photo Σ 0..1 Attachment Facilitates quick identification of the service
... contact S 0..* ExtendedContactDetail Contacto de trabajo del servicio, por ejemplo para pedir citas
.... 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
.... purpose Σ 0..1 CodeableConcept The type of contact
Vinculación: Contact entity type (preferred): The purpose for which an extended contact detail should be used.
.... name Σ 0..* HumanName Name of an individual to contact
.... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos; extensión interna con ;ext=) o correo electrónico
Constraints: cr-telefono
..... 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 ΣC 0..1 code phone | fax | email | pager | url | sms | other
Vinculación: ContactPointSystem (required): Telecommunications form for contact point.
..... value ΣC 0..1 string The actual contact point details
..... use ?!Σ 0..1 code work (valor fijo)
Vinculación: ContactPointUse (required): Use of contact point.
Required Pattern: work
..... rank Σ 0..1 positiveInt Specify preferred order of use (1 = highest)
..... period Σ 0..1 Period Time period when the contact point was/is in use
.... address Σ 0..1 Address Address for the contact
.... organization Σ 0..1 Reference(Organization) This contact detail is handled/monitored by a specific organization
.... period Σ 0..1 Period Period that this contact was valid for usage
... coverageArea 0..* Reference(Location) Location(s) service is intended for/available to
... serviceProvisionCode 0..* CodeableConcept Conditions under which service is available/offered
Vinculación: ServiceProvisionConditions (example): The code(s) that detail the conditions under which the healthcare service is available/offered.
... eligibility S 0..* BackboneElement Requisitos de acceso: referencia, orden médica o cobertura
.... 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
.... code S 1..1 CodeableConcept Requisito (referencia | orden-medica | cobertura)
Vinculación: Requisitos de acceso (extensible)
.... comment S 0..1 markdown Detalle del requisito: qué cobertura se acepta, de qué nivel viene la referencia
... program 0..* CodeableConcept Programs that this service is applicable to
Vinculación: Program (example): Government or local programs that this service applies to.
... Slices for characteristic S 0..* CodeableConcept Modalidades de imagen DICOM del servicio
Slice: Sin orden, Abierto by value:coding.system
Vinculación: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
.... characteristic:modalidadImagen S 0..* CodeableConcept Modalidad de imagen DICOM: CT, MR, US, MG, DX, CR, NM, PT, XA, RF
Vinculación: Modality . (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: http://dicom.nema.org/resources/ontology/DCM
...... 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
... communication S 0..* CodeableConcept Idiomas en que se atiende, además del español
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding

... referralMethod 0..* CodeableConcept Ways that the service accepts referrals
Vinculación: ReferralMethod (example): The methods of referral can be used when referring to a specific HealthcareService resource.
... appointmentRequired S 0..1 boolean Si se atiende solo con cita previa
... availability S 0..1 Availability Horario del servicio
.... 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
.... availableTime SΣC 0..* Element Bloque de días con el mismo horario
Constraints: av-1, cr-servicio-horario
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... daysOfWeek SΣ 1..* code Días del bloque: mon | tue | wed | thu | fri | sat | sun
Vinculación: DaysOfWeek (required): The purpose for which an extended contact detail should be used.
..... allDay SΣC 0..1 boolean Si atiende las 24 horas esos días
..... availableStartTime SΣC 0..1 time Hora de inicio, en hora de Costa Rica (UTC−6)
..... availableEndTime SΣC 0..1 time Hora de fin, en hora de Costa Rica (UTC−6)
.... notAvailableTime Σ 0..* Element Not available during this time due to provided reason
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... description Σ 0..1 string Reason presented to the user explaining why time not available
..... during Σ 0..1 Period Service not available during this period
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
HealthcareService.language Base required All Languages 📍5.0.0 Estándar FHIR
HealthcareService.identifier.​use Base required IdentifierUse 📍5.0.0 Estándar FHIR
HealthcareService.identifier.​type Base extensible Identifier Type Codes 📍5.0.0 Estándar FHIR
HealthcareService.category Base example Service Category 📍5.0.0 Estándar FHIR
HealthcareService.type Base extensible Tipos de servicio de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.contact.​purpose Base preferred Contact entity type 📦2.0.0 THO v7.4
HealthcareService.contact.​telecom.system Base required ContactPointSystem 📍5.0.0 Estándar FHIR
HealthcareService.contact.​telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR
HealthcareService.serviceProvisionCode Base example Service Provision Conditions 📍5.0.0 Estándar FHIR
HealthcareService.eligibility.​code Base extensible Requisitos de acceso 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.program Base example Program 📍5.0.0 Estándar FHIR
HealthcareService.characteristic Base example Service Mode 📍5.0.0 Estándar FHIR
HealthcareService.characteristic:modalidadImagen Base extensible Modality . ⏿2025.3.20250714 tx.fhir.org
HealthcareService.communication Base required All Languages 📍5.0.0 Estándar FHIR
HealthcareService.referralMethod Base example Referral Method 📍5.0.0 Estándar FHIR
HealthcareService.availability.​availableTime.daysOfWeek Base required Days Of Week 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
av-1 error HealthcareService.availability.availableTime Cannot include start/end times when selecting all day availability. allDay.exists().not() or (allDay implies availableStartTime.exists().not() and availableEndTime.exists().not())
cr-codigo-interno-value error HealthcareService.identifier.value Un código interno tiene de 1 a 64 caracteres, sin espacios. matches('^\\S{1,64}$')
cr-identificador-unico error HealthcareService No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-servicio-especialidad error HealthcareService Una consulta especializada indica su especialidad. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'consulta-especializada').exists() implies specialty.exists()
cr-servicio-horario error HealthcareService.availability.availableTime Un bloque de horario es de todo el día, sin horas, o tiene hora de inicio y de fin, con el inicio antes del fin. (allDay.where($this = true).exists() and availableStartTime.empty() and availableEndTime.empty()) or (allDay.where($this = true).empty() and availableStartTime.exists() and availableEndTime.exists() and availableStartTime < availableEndTime)
cr-servicio-modalidad error HealthcareService Un servicio de imágenes médicas indica sus modalidades de imagen DICOM, y solo él las lleva. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'imagenes-medicas').exists() = characteristic.coding.where(system = 'http://dicom.nema.org/resources/ontology/DCM').exists()
cr-servicio-system error HealthcareService.identifier El system del identificador es https://hl7.or.cr/fhir/sid/servicio/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/servicio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-telefono error HealthcareService.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
dom-2 error HealthcareService If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error HealthcareService 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 HealthcareService 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 HealthcareService If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice HealthcareService 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 HealthcareService .

Resumen

Obligatorios: 5 elementos(5 nested mandatory elementos)
Must-Support: 25 elementos

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 HealthcareService.characteristic

Vista de elementos clave

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. HealthcareService C 0..* HealthcareService Servicio de salud: qué se ofrece, dónde, en qué horario y con qué requisitos
Constraints: cr-servicio-especialidad, cr-servicio-modalidad, cr-identificador-unico
... 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 ?!Σ 0..1 code official (valor fijo)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Required Pattern: official
.... system SΣ 1..1 uri https://hl7.or.cr/fhir/sid/servicio/{código del establecimiento}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Código del servicio en el sistema de la organización
Constraints: cr-codigo-interno-value
Example General: 123456
Max Length:64
... active ?!SΣ 1..1 boolean Si el servicio se está ofreciendo
... providedBy SΣ 1..1 Reference(Organización) Organización que presta el servicio y responde por él
... type SΣ 1..* CodeableConcept Tipo de servicio del catálogo de Costa Rica
Vinculación: Tipos de servicio de salud (extensible)
... specialty SΣ 0..* CodeableConcept Especialidades del servicio
Vinculación: Especialidades en salud (extensible)
... location SΣ 1..* Reference(Ubicación) Ubicaciones donde se presta
... name SΣ 1..1 string Nombre del servicio (Consulta externa de cardiología)
Max Length:250
... comment SΣ 0..1 markdown Información para el paciente o quien refiere: preparación, avisos
... contact S 0..* ExtendedContactDetail Contacto de trabajo del servicio, por ejemplo para pedir citas
.... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos; extensión interna con ;ext=) o correo electrónico
Constraints: cr-telefono
..... use ?!Σ 0..1 code work (valor fijo)
Vinculación: ContactPointUse (required): Use of contact point.
Required Pattern: work
... eligibility S 0..* BackboneElement Requisitos de acceso: referencia, orden médica o cobertura
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... code S 1..1 CodeableConcept Requisito (referencia | orden-medica | cobertura)
Vinculación: Requisitos de acceso (extensible)
.... comment S 0..1 markdown Detalle del requisito: qué cobertura se acepta, de qué nivel viene la referencia
... Slices for characteristic S 0..* CodeableConcept Modalidades de imagen DICOM del servicio
Slice: Sin orden, Abierto by value:coding.system
Vinculación: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
.... characteristic:modalidadImagen S 0..* CodeableConcept Modalidad de imagen DICOM: CT, MR, US, MG, DX, CR, NM, PT, XA, RF
Vinculación: Modality . (extensible)
... communication S 0..* CodeableConcept Idiomas en que se atiende, además del español
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding

... appointmentRequired S 0..1 boolean Si se atiende solo con cita previa
... availability S 0..1 Availability Horario del servicio
.... availableTime SΣC 0..* Element Bloque de días con el mismo horario
Constraints: av-1, cr-servicio-horario
..... daysOfWeek SΣ 1..* code Días del bloque: mon | tue | wed | thu | fri | sat | sun
Vinculación: DaysOfWeek (required): The purpose for which an extended contact detail should be used.
..... allDay SΣC 0..1 boolean Si atiende las 24 horas esos días
..... availableStartTime SΣC 0..1 time Hora de inicio, en hora de Costa Rica (UTC−6)
..... availableEndTime SΣC 0..1 time Hora de fin, en hora de Costa Rica (UTC−6)

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
HealthcareService.identifier.​use Base required IdentifierUse 📍5.0.0 Estándar FHIR
HealthcareService.type Base extensible Tipos de servicio de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.contact.​telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR
HealthcareService.eligibility.​code Base extensible Requisitos de acceso 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.characteristic Base example Service Mode 📍5.0.0 Estándar FHIR
HealthcareService.characteristic:modalidadImagen Base extensible Modality . ⏿2025.3.20250714 tx.fhir.org
HealthcareService.communication Base required All Languages 📍5.0.0 Estándar FHIR
HealthcareService.availability.​availableTime.daysOfWeek Base required Days Of Week 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
av-1 error HealthcareService.availability.availableTime Cannot include start/end times when selecting all day availability. allDay.exists().not() or (allDay implies availableStartTime.exists().not() and availableEndTime.exists().not())
cr-codigo-interno-value error HealthcareService.identifier.value Un código interno tiene de 1 a 64 caracteres, sin espacios. matches('^\\S{1,64}$')
cr-identificador-unico error HealthcareService No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-servicio-especialidad error HealthcareService Una consulta especializada indica su especialidad. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'consulta-especializada').exists() implies specialty.exists()
cr-servicio-horario error HealthcareService.availability.availableTime Un bloque de horario es de todo el día, sin horas, o tiene hora de inicio y de fin, con el inicio antes del fin. (allDay.where($this = true).exists() and availableStartTime.empty() and availableEndTime.empty()) or (allDay.where($this = true).empty() and availableStartTime.exists() and availableEndTime.exists() and availableStartTime < availableEndTime)
cr-servicio-modalidad error HealthcareService Un servicio de imágenes médicas indica sus modalidades de imagen DICOM, y solo él las lleva. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'imagenes-medicas').exists() = characteristic.coding.where(system = 'http://dicom.nema.org/resources/ontology/DCM').exists()
cr-servicio-system error HealthcareService.identifier El system del identificador es https://hl7.or.cr/fhir/sid/servicio/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/servicio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-telefono error HealthcareService.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
dom-2 error HealthcareService If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error HealthcareService 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 HealthcareService 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 HealthcareService If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice HealthcareService 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 HealthcareService .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. HealthcareService C 0..* HealthcareService Servicio de salud: qué se ofrece, dónde, en qué horario y con qué requisitos
Constraints: cr-servicio-especialidad, cr-servicio-modalidad, cr-identificador-unico
... identifier SC 0..* Identifier Código interno del servicio (agenda de citas)
Constraints: cr-servicio-system
.... use 0..1 code official (valor fijo)
Required Pattern: official
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/servicio/{código del establecimiento}
.... value SC 1..1 string Código del servicio en el sistema de la organización
Constraints: cr-codigo-interno-value
Max Length:64
... active S 1..1 boolean Si el servicio se está ofreciendo
... providedBy S 1..1 Reference(Organización) Organización que presta el servicio y responde por él
... specialty S 0..* CodeableConcept Especialidades del servicio
Vinculación: Especialidades en salud (extensible)
... location S 1..* Reference(Ubicación) Ubicaciones donde se presta
... name S 1..1 string Nombre del servicio (Consulta externa de cardiología)
Max Length:250
... comment S 0..1 markdown Información para el paciente o quien refiere: preparación, avisos
... contact S 0..* ExtendedContactDetail Contacto de trabajo del servicio, por ejemplo para pedir citas
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos; extensión interna con ;ext=) o correo electrónico
Constraints: cr-telefono
..... use 0..1 code work (valor fijo)
Required Pattern: work
... eligibility S 0..* BackboneElement Requisitos de acceso: referencia, orden médica o cobertura
.... code S 1..1 CodeableConcept Requisito (referencia | orden-medica | cobertura)
Vinculación: Requisitos de acceso (extensible)
.... comment S 0..1 markdown Detalle del requisito: qué cobertura se acepta, de qué nivel viene la referencia
... Slices for characteristic S 0..* CodeableConcept Modalidades de imagen DICOM del servicio
Slice: Sin orden, Abierto by value:coding.system
.... characteristic:modalidadImagen S 0..* CodeableConcept Modalidad de imagen DICOM: CT, MR, US, MG, DX, CR, NM, PT, XA, RF
Vinculación: Modality . (extensible)
..... coding
...... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: http://dicom.nema.org/resources/ontology/DCM
... communication S 0..* CodeableConcept Idiomas en que se atiende, además del español
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
Idiomas de Costa Rica UI Binding
... appointmentRequired S 0..1 boolean Si se atiende solo con cita previa
... availability S 0..1 Availability Horario del servicio
.... availableTime SC 0..* Element Bloque de días con el mismo horario
Constraints: cr-servicio-horario
..... daysOfWeek S 1..* code Días del bloque: mon | tue | wed | thu | fri | sat | sun
..... allDay S 0..1 boolean Si atiende las 24 horas esos días
..... availableStartTime S 0..1 time Hora de inicio, en hora de Costa Rica (UTC−6)
..... availableEndTime S 0..1 time Hora de fin, en hora de Costa Rica (UTC−6)

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso ValueSet Versión Fuente
HealthcareService.type Base extensible Tipos de servicio de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.eligibility.​code Base extensible Requisitos de acceso 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.characteristic:modalidadImagen Base extensible Modality . ⏿2025.3.20250714 tx.fhir.org
HealthcareService.communication Base required All Languages 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-codigo-interno-value error HealthcareService.identifier.value Un código interno tiene de 1 a 64 caracteres, sin espacios. matches('^\\S{1,64}$')
cr-identificador-unico error HealthcareService No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-servicio-especialidad error HealthcareService Una consulta especializada indica su especialidad. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'consulta-especializada').exists() implies specialty.exists()
cr-servicio-horario error HealthcareService.availability.availableTime Un bloque de horario es de todo el día, sin horas, o tiene hora de inicio y de fin, con el inicio antes del fin. (allDay.where($this = true).exists() and availableStartTime.empty() and availableEndTime.empty()) or (allDay.where($this = true).empty() and availableStartTime.exists() and availableEndTime.exists() and availableStartTime < availableEndTime)
cr-servicio-modalidad error HealthcareService Un servicio de imágenes médicas indica sus modalidades de imagen DICOM, y solo él las lleva. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'imagenes-medicas').exists() = characteristic.coding.where(system = 'http://dicom.nema.org/resources/ontology/DCM').exists()
cr-servicio-system error HealthcareService.identifier El system del identificador es https://hl7.or.cr/fhir/sid/servicio/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/servicio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-telefono error HealthcareService.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))

Vista instantáneaView

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. HealthcareService C 0..* HealthcareService Servicio de salud: qué se ofrece, dónde, en qué horario y con qué requisitos
Constraints: cr-servicio-especialidad, cr-servicio-modalidad, cr-identificador-unico
... 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
... language 0..1 code Language of the resource content
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
... 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 0..* Identifier Código interno del servicio (agenda de citas)
Constraints: cr-servicio-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 official (valor fijo)
Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Required Pattern: official
.... 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/servicio/{código del establecimiento}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Código del servicio en el sistema de la organización
Constraints: cr-codigo-interno-value
Example General: 123456
Max Length:64
.... 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 servicio se está ofreciendo
... providedBy SΣ 1..1 Reference(Organización) Organización que presta el servicio y responde por él
... offeredIn 0..* Reference(HealthcareService) The service within which this service is offered
... category Σ 0..* CodeableConcept Broad category of service being performed or delivered
Vinculación: ServiceCategory (example): A category of the service(s) that could be provided.
... type SΣ 1..* CodeableConcept Tipo de servicio del catálogo de Costa Rica
Vinculación: Tipos de servicio de salud (extensible)
... specialty SΣ 0..* CodeableConcept Especialidades del servicio
Vinculación: Especialidades en salud (extensible)
... location SΣ 1..* Reference(Ubicación) Ubicaciones donde se presta
... name SΣ 1..1 string Nombre del servicio (Consulta externa de cardiología)
Max Length:250
... comment SΣ 0..1 markdown Información para el paciente o quien refiere: preparación, avisos
... extraDetails 0..1 markdown Extra details about the service that can't be placed in the other fields
... photo Σ 0..1 Attachment Facilitates quick identification of the service
... contact S 0..* ExtendedContactDetail Contacto de trabajo del servicio, por ejemplo para pedir citas
.... 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
.... purpose Σ 0..1 CodeableConcept The type of contact
Vinculación: Contact entity type (preferred): The purpose for which an extended contact detail should be used.
.... name Σ 0..* HumanName Name of an individual to contact
.... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos; extensión interna con ;ext=) o correo electrónico
Constraints: cr-telefono
..... 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 ΣC 0..1 code phone | fax | email | pager | url | sms | other
Vinculación: ContactPointSystem (required): Telecommunications form for contact point.
..... value ΣC 0..1 string The actual contact point details
..... use ?!Σ 0..1 code work (valor fijo)
Vinculación: ContactPointUse (required): Use of contact point.
Required Pattern: work
..... rank Σ 0..1 positiveInt Specify preferred order of use (1 = highest)
..... period Σ 0..1 Period Time period when the contact point was/is in use
.... address Σ 0..1 Address Address for the contact
.... organization Σ 0..1 Reference(Organization) This contact detail is handled/monitored by a specific organization
.... period Σ 0..1 Period Period that this contact was valid for usage
... coverageArea 0..* Reference(Location) Location(s) service is intended for/available to
... serviceProvisionCode 0..* CodeableConcept Conditions under which service is available/offered
Vinculación: ServiceProvisionConditions (example): The code(s) that detail the conditions under which the healthcare service is available/offered.
... eligibility S 0..* BackboneElement Requisitos de acceso: referencia, orden médica o cobertura
.... 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
.... code S 1..1 CodeableConcept Requisito (referencia | orden-medica | cobertura)
Vinculación: Requisitos de acceso (extensible)
.... comment S 0..1 markdown Detalle del requisito: qué cobertura se acepta, de qué nivel viene la referencia
... program 0..* CodeableConcept Programs that this service is applicable to
Vinculación: Program (example): Government or local programs that this service applies to.
... Slices for characteristic S 0..* CodeableConcept Modalidades de imagen DICOM del servicio
Slice: Sin orden, Abierto by value:coding.system
Vinculación: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
.... characteristic:modalidadImagen S 0..* CodeableConcept Modalidad de imagen DICOM: CT, MR, US, MG, DX, CR, NM, PT, XA, RF
Vinculación: Modality . (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: http://dicom.nema.org/resources/ontology/DCM
...... 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
... communication S 0..* CodeableConcept Idiomas en que se atiende, además del español
Vinculación: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter
Idiomas de Costa Rica UI Binding

... referralMethod 0..* CodeableConcept Ways that the service accepts referrals
Vinculación: ReferralMethod (example): The methods of referral can be used when referring to a specific HealthcareService resource.
... appointmentRequired S 0..1 boolean Si se atiende solo con cita previa
... availability S 0..1 Availability Horario del servicio
.... 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
.... availableTime SΣC 0..* Element Bloque de días con el mismo horario
Constraints: av-1, cr-servicio-horario
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... daysOfWeek SΣ 1..* code Días del bloque: mon | tue | wed | thu | fri | sat | sun
Vinculación: DaysOfWeek (required): The purpose for which an extended contact detail should be used.
..... allDay SΣC 0..1 boolean Si atiende las 24 horas esos días
..... availableStartTime SΣC 0..1 time Hora de inicio, en hora de Costa Rica (UTC−6)
..... availableEndTime SΣC 0..1 time Hora de fin, en hora de Costa Rica (UTC−6)
.... notAvailableTime Σ 0..* Element Not available during this time due to provided reason
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... description Σ 0..1 string Reason presented to the user explaining why time not available
..... during Σ 0..1 Period Service not available during this period
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to electronic services operated for the healthcare service

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
HealthcareService.language Base required All Languages 📍5.0.0 Estándar FHIR
HealthcareService.identifier.​use Base required IdentifierUse 📍5.0.0 Estándar FHIR
HealthcareService.identifier.​type Base extensible Identifier Type Codes 📍5.0.0 Estándar FHIR
HealthcareService.category Base example Service Category 📍5.0.0 Estándar FHIR
HealthcareService.type Base extensible Tipos de servicio de salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.contact.​purpose Base preferred Contact entity type 📦2.0.0 THO v7.4
HealthcareService.contact.​telecom.system Base required ContactPointSystem 📍5.0.0 Estándar FHIR
HealthcareService.contact.​telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR
HealthcareService.serviceProvisionCode Base example Service Provision Conditions 📍5.0.0 Estándar FHIR
HealthcareService.eligibility.​code Base extensible Requisitos de acceso 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
HealthcareService.program Base example Program 📍5.0.0 Estándar FHIR
HealthcareService.characteristic Base example Service Mode 📍5.0.0 Estándar FHIR
HealthcareService.characteristic:modalidadImagen Base extensible Modality . ⏿2025.3.20250714 tx.fhir.org
HealthcareService.communication Base required All Languages 📍5.0.0 Estándar FHIR
HealthcareService.referralMethod Base example Referral Method 📍5.0.0 Estándar FHIR
HealthcareService.availability.​availableTime.daysOfWeek Base required Days Of Week 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
av-1 error HealthcareService.availability.availableTime Cannot include start/end times when selecting all day availability. allDay.exists().not() or (allDay implies availableStartTime.exists().not() and availableEndTime.exists().not())
cr-codigo-interno-value error HealthcareService.identifier.value Un código interno tiene de 1 a 64 caracteres, sin espacios. matches('^\\S{1,64}$')
cr-identificador-unico error HealthcareService No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-servicio-especialidad error HealthcareService Una consulta especializada indica su especialidad. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'consulta-especializada').exists() implies specialty.exists()
cr-servicio-horario error HealthcareService.availability.availableTime Un bloque de horario es de todo el día, sin horas, o tiene hora de inicio y de fin, con el inicio antes del fin. (allDay.where($this = true).exists() and availableStartTime.empty() and availableEndTime.empty()) or (allDay.where($this = true).empty() and availableStartTime.exists() and availableEndTime.exists() and availableStartTime < availableEndTime)
cr-servicio-modalidad error HealthcareService Un servicio de imágenes médicas indica sus modalidades de imagen DICOM, y solo él las lleva. type.coding.where(system = 'https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud' and code = 'imagenes-medicas').exists() = characteristic.coding.where(system = 'http://dicom.nema.org/resources/ontology/DCM').exists()
cr-servicio-system error HealthcareService.identifier El system del identificador es https://hl7.or.cr/fhir/sid/servicio/ seguido del código del establecimiento (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/servicio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-telefono error HealthcareService.contact.telecom Un teléfono está en formato E.164 (+ y de 8 a 15 dígitos, sin espacios ni guiones), con una extensión interna opcional después de ;ext=. En Costa Rica (+506) tiene 8 dígitos que empiezan de 2 a 8, o es un número 800 o 900 de 10 dígitos. (system = 'phone' or system = 'fax' or system = 'sms') implies (value.matches('^\\+[1-9][0-9]{7,14}(;ext=[0-9]{1,6})?$') and (value.startsWith('+506') implies value.matches('^\\+506([2-8][0-9]{7}|[89]00[0-9]{7})(;ext=[0-9]{1,6})?$')))
dom-2 error HealthcareService If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error HealthcareService 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 HealthcareService 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 HealthcareService If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice HealthcareService 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 HealthcareService .

Resumen

Obligatorios: 5 elementos(5 nested mandatory elementos)
Must-Support: 25 elementos

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 HealthcareService.characteristic

 

Otras representaciones de perfil: CSV, Excel, Schematron

Notas:

Uso en el HIE

Registro de establecimientos. Servicios de salud: qué se ofrece, dónde, en qué horario y con qué requisitos. Por cercanía: se buscan primero las ubicaciones con near.

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]/HealthcareService/{id}

Lee un servicio de salud del registro de establecimientos por su id, la parte final de su URL. Se usa para resolver una referencia que otro recurso hace a un servicio de salud. En el ejemplo se lee «Resonancia magnética de un hospital privado (S3)»; la segunda respuesta es la de un id que no existe.

Solicitud

GET [base]/HealthcareService/ejemplo-servicio-resonancia 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": "HealthcareService",
  "id": "ejemplo-servicio-resonancia",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
      "value": "IMG-RM"
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "type": [
    {
      "coding": [
        {
          "code": "imagenes-medicas",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
          "display": "Imágenes médicas"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "code": "06.05.01",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
          "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
        }
      ],
      "text": "Radiología e Imágenes Médicas"
    }
  ],
  "characteristic": [
    {
      "coding": [
        {
          "code": "MR",
          "system": "http://dicom.nema.org/resources/ontology/DCM",
          "display": "Magnetic Resonance"
        }
      ],
      "text": "Resonancia magnética"
    }
  ],
  "eligibility": [
    {
      "code": {
        "coding": [
          {
            "code": "orden-medica",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
            "display": "Orden médica"
          }
        ]
      }
    }
  ],
  "availability": [
    {
      "availableTime": [
        {
          "daysOfWeek": [
            "mon",
            "tue",
            "wed",
            "thu",
            "fri"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "19:00:00"
        },
        {
          "daysOfWeek": [
            "sat"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "12:00:00"
        }
      ]
    }
  ],
  "contact": [
    {
      "telecom": [
        {
          "system": "phone",
          "value": "+50622220000;ext=2105"
        },
        {
          "system": "email",
          "value": "citas.imagenes@hospital-ejemplo.cr"
        }
      ]
    }
  ],
  "active": true,
  "providedBy": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  },
  "name": "Resonancia magnética",
  "appointmentRequired": true,
  "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
}

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

Buscar por tipo de servicio
Forma: GET [base]/HealthcareService?service-type={sistema}|{código}

Busca servicios por tipo, por ejemplo dónde hay imágenes médicas o laboratorio clínico. Es la base de un directorio de servicios. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: service-type=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud|imagenes-medicas.

Solicitud

GET [base]/HealthcareService?service-type=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud|imagenes-medicas HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?service-type=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud|imagenes-medicas"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por especialidad
Forma: GET [base]/HealthcareService?specialty={sistema}|{código}

Busca servicios por especialidad; por ejemplo, dónde atiende un radiólogo, para referir a un paciente. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: specialty=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud|06.05.01.

Solicitud

GET [base]/HealthcareService?specialty=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud|06.05.01 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?specialty=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud|06.05.01"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por característica
Forma: GET [base]/HealthcareService?characteristic={sistema}|{código}

Busca servicios por una característica; por ejemplo, la modalidad de imagen (resonancia magnética) que ofrece. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: characteristic=http://dicom.nema.org/resources/ontology/DCM|MR.

Solicitud

GET [base]/HealthcareService?characteristic=http://dicom.nema.org/resources/ontology/DCM|MR HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?characteristic=http://dicom.nema.org/resources/ontology/DCM|MR"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por ubicación
Forma: GET [base]/HealthcareService?location=Location/{id}

Trae los servicios que se prestan en una ubicación. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: location=Location/ejemplo-ubicacion-radiologia.

Solicitud

GET [base]/HealthcareService?location=Location/ejemplo-ubicacion-radiologia HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?location=Location/ejemplo-ubicacion-radiologia"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por organización que lo presta
Forma: GET [base]/HealthcareService?organization=Organization/{id}

Trae los servicios que presta una organización. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: organization=Organization/ejemplo-establecimiento.

Solicitud

GET [base]/HealthcareService?organization=Organization/ejemplo-establecimiento HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 2 resultados: Resonancia magnética de un hospital privado (S3); Emergencias 24 horas de un hospital privado (S2)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 2,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?organization=Organization/ejemplo-establecimiento"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-emergencias",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-emergencias",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-sede",
            "display": "Hospital Privado de Ejemplo, sede central"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "emergencias",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Emergencias"
              }
            ]
          }
        ],
        "communication": [
          {
            "coding": [
              {
                "code": "en",
                "system": "urn:ietf:bcp:47",
                "display": "inglés"
              }
            ]
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri",
                  "sat",
                  "sun"
                ],
                "allDay": true
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=1000"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Emergencias",
        "appointmentRequired": false
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por registro activo
Forma: GET [base]/HealthcareService?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 «Resonancia magnética de un hospital privado (S3)»: active=true.

Solicitud

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

Respuesta: 5 resultados, de 2 en 2 con _count; la primera página trae Resonancia magnética de un hospital privado (S3); Consulta de cardiología de la CCSS (S1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 5,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?active=true&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/HealthcareService?active=true&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-cardiologia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-cardiologia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-4000042147",
            "value": "CE-CARDIO-01"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-hospital-ccss",
            "display": "Hospital Regional de Ejemplo"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "consulta-especializada",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Consulta especializada"
              }
            ]
          }
        ],
        "specialty": [
          {
            "text": "Cardiología"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "referencia",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Referencia"
                }
              ]
            },
            "comment": "Referencia del primer nivel de atención o de otra especialidad."
          },
          {
            "code": {
              "coding": [
                {
                  "code": "cobertura",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Cobertura"
                }
              ]
            },
            "comment": "Seguro de salud de la CCSS."
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "16:00:00"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "name": "Consulta externa de cardiología",
        "appointmentRequired": true
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por identificador
Forma: GET [base]/HealthcareService?identifier={sistema}|{valor}

Encuentra un servicio por su código en la organización. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: identifier=https://hl7.or.cr/fhir/sid/servicio/cj-3101123456|IMG-RM.

Solicitud

GET [base]/HealthcareService?identifier=https://hl7.or.cr/fhir/sid/servicio/cj-3101123456|IMG-RM HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?identifier=https://hl7.or.cr/fhir/sid/servicio/cj-3101123456|IMG-RM"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

Busca servicios por su nombre, por ejemplo para mostrarlos en una lista. En el ejemplo se usa el dato de «Resonancia magnética de un hospital privado (S3)»: name=Resonancia magnética.

Solicitud

GET [base]/HealthcareService?name=Resonancia magnética HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?name=Resonancia magnética"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

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

Respuesta: 5 resultados, de 2 en 2 con _count; la primera página trae Resonancia magnética de un hospital privado (S3); Consulta de cardiología de la CCSS (S1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 5,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService?_lastUpdated=ge2026-10-01&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/HealthcareService?_lastUpdated=ge2026-10-01&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-cardiologia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-cardiologia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-4000042147",
            "value": "CE-CARDIO-01"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-hospital-ccss",
            "display": "Hospital Regional de Ejemplo"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "consulta-especializada",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Consulta especializada"
              }
            ]
          }
        ],
        "specialty": [
          {
            "text": "Cardiología"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "referencia",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Referencia"
                }
              ]
            },
            "comment": "Referencia del primer nivel de atención o de otra especialidad."
          },
          {
            "code": {
              "coding": [
                {
                  "code": "cobertura",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Cobertura"
                }
              ]
            },
            "comment": "Seguro de salud de la CCSS."
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "16:00:00"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "name": "Consulta externa de cardiología",
        "appointmentRequired": true
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por tipo de servicio, con POST
Forma: POST [base]/HealthcareService/_search
cuerpo: service-type={sistema}|{código}

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 tipo de servicio.

Solicitud

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

service-type=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud|imagenes-medicas

Respuesta: 1 resultado: Resonancia magnética de un hospital privado (S3), 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]/HealthcareService?service-type=https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud|imagenes-medicas"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}
Crear

Crear
Forma: POST [base]/HealthcareService

Registra un servicio de salud en el registro de establecimientos. El servidor valida el recurso contra el perfil, le asigna su id y devuelve su dirección. Es la alimentación del registro de establecimientos (IHE mCSD ITI-130). En el ejemplo se registra «Resonancia magnética de un hospital privado (S3)»; la segunda respuesta es el rechazo de un recurso que no cumple la invariante cr-servicio-especialidad (Una consulta especializada indica su especialidad).

Solicitud

POST [base]/HealthcareService HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
Content-Type: application/fhir+json
{
  "resourceType": "HealthcareService",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
      "value": "IMG-RM"
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "type": [
    {
      "coding": [
        {
          "code": "imagenes-medicas",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
          "display": "Imágenes médicas"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "code": "06.05.01",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
          "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
        }
      ],
      "text": "Radiología e Imágenes Médicas"
    }
  ],
  "characteristic": [
    {
      "coding": [
        {
          "code": "MR",
          "system": "http://dicom.nema.org/resources/ontology/DCM",
          "display": "Magnetic Resonance"
        }
      ],
      "text": "Resonancia magnética"
    }
  ],
  "eligibility": [
    {
      "code": {
        "coding": [
          {
            "code": "orden-medica",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
            "display": "Orden médica"
          }
        ]
      }
    }
  ],
  "availability": [
    {
      "availableTime": [
        {
          "daysOfWeek": [
            "mon",
            "tue",
            "wed",
            "thu",
            "fri"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "19:00:00"
        },
        {
          "daysOfWeek": [
            "sat"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "12:00:00"
        }
      ]
    }
  ],
  "contact": [
    {
      "telecom": [
        {
          "system": "phone",
          "value": "+50622220000;ext=2105"
        },
        {
          "system": "email",
          "value": "citas.imagenes@hospital-ejemplo.cr"
        }
      ]
    }
  ],
  "active": true,
  "providedBy": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  },
  "name": "Resonancia magnética",
  "appointmentRequired": true,
  "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
}

Respuesta si se crea

HTTP/1.1 201 Created
Location: [base]/HealthcareService/ejemplo-servicio-resonancia/_history/1
ETag: W/"1"
Last-Modified: 2026-10-01T10:00:00-06:00
Content-Type: application/fhir+json
{
  "resourceType": "HealthcareService",
  "id": "ejemplo-servicio-resonancia",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
      "value": "IMG-RM"
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "type": [
    {
      "coding": [
        {
          "code": "imagenes-medicas",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
          "display": "Imágenes médicas"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "code": "06.05.01",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
          "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
        }
      ],
      "text": "Radiología e Imágenes Médicas"
    }
  ],
  "characteristic": [
    {
      "coding": [
        {
          "code": "MR",
          "system": "http://dicom.nema.org/resources/ontology/DCM",
          "display": "Magnetic Resonance"
        }
      ],
      "text": "Resonancia magnética"
    }
  ],
  "eligibility": [
    {
      "code": {
        "coding": [
          {
            "code": "orden-medica",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
            "display": "Orden médica"
          }
        ]
      }
    }
  ],
  "availability": [
    {
      "availableTime": [
        {
          "daysOfWeek": [
            "mon",
            "tue",
            "wed",
            "thu",
            "fri"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "19:00:00"
        },
        {
          "daysOfWeek": [
            "sat"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "12:00:00"
        }
      ]
    }
  ],
  "contact": [
    {
      "telecom": [
        {
          "system": "phone",
          "value": "+50622220000;ext=2105"
        },
        {
          "system": "email",
          "value": "citas.imagenes@hospital-ejemplo.cr"
        }
      ]
    }
  ],
  "active": true,
  "providedBy": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  },
  "name": "Resonancia magnética",
  "appointmentRequired": true,
  "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
}

Respuesta si no cumple el perfil (invariante cr-servicio-especialidad)

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/fhir+json
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invariant",
      "diagnostics": "cr-servicio-especialidad: Una consulta especializada indica su especialidad.",
      "expression": [
        "HealthcareService"
      ]
    }
  ]
}
Actualizar

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

Reemplaza un servicio 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 «Resonancia magnética de un hospital privado (S3)» sobre su versión 1; la segunda respuesta es el rechazo cuando otra persona ya la había cambiado.

Solicitud

PUT [base]/HealthcareService/ejemplo-servicio-resonancia HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
If-Match: W/"1"
Content-Type: application/fhir+json
{
  "resourceType": "HealthcareService",
  "id": "ejemplo-servicio-resonancia",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
      "value": "IMG-RM"
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "type": [
    {
      "coding": [
        {
          "code": "imagenes-medicas",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
          "display": "Imágenes médicas"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "code": "06.05.01",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
          "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
        }
      ],
      "text": "Radiología e Imágenes Médicas"
    }
  ],
  "characteristic": [
    {
      "coding": [
        {
          "code": "MR",
          "system": "http://dicom.nema.org/resources/ontology/DCM",
          "display": "Magnetic Resonance"
        }
      ],
      "text": "Resonancia magnética"
    }
  ],
  "eligibility": [
    {
      "code": {
        "coding": [
          {
            "code": "orden-medica",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
            "display": "Orden médica"
          }
        ]
      }
    }
  ],
  "availability": [
    {
      "availableTime": [
        {
          "daysOfWeek": [
            "mon",
            "tue",
            "wed",
            "thu",
            "fri"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "19:00:00"
        },
        {
          "daysOfWeek": [
            "sat"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "12:00:00"
        }
      ]
    }
  ],
  "contact": [
    {
      "telecom": [
        {
          "system": "phone",
          "value": "+50622220000;ext=2105"
        },
        {
          "system": "email",
          "value": "citas.imagenes@hospital-ejemplo.cr"
        }
      ]
    }
  ],
  "active": true,
  "providedBy": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  },
  "name": "Resonancia magnética",
  "appointmentRequired": true,
  "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
}

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": "HealthcareService",
  "id": "ejemplo-servicio-resonancia",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2026-10-02T08:15:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
      "value": "IMG-RM"
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "type": [
    {
      "coding": [
        {
          "code": "imagenes-medicas",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
          "display": "Imágenes médicas"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "code": "06.05.01",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
          "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
        }
      ],
      "text": "Radiología e Imágenes Médicas"
    }
  ],
  "characteristic": [
    {
      "coding": [
        {
          "code": "MR",
          "system": "http://dicom.nema.org/resources/ontology/DCM",
          "display": "Magnetic Resonance"
        }
      ],
      "text": "Resonancia magnética"
    }
  ],
  "eligibility": [
    {
      "code": {
        "coding": [
          {
            "code": "orden-medica",
            "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
            "display": "Orden médica"
          }
        ]
      }
    }
  ],
  "availability": [
    {
      "availableTime": [
        {
          "daysOfWeek": [
            "mon",
            "tue",
            "wed",
            "thu",
            "fri"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "19:00:00"
        },
        {
          "daysOfWeek": [
            "sat"
          ],
          "availableStartTime": "07:00:00",
          "availableEndTime": "12:00:00"
        }
      ]
    }
  ],
  "contact": [
    {
      "telecom": [
        {
          "system": "phone",
          "value": "+50622220000;ext=2105"
        },
        {
          "system": "email",
          "value": "citas.imagenes@hospital-ejemplo.cr"
        }
      ]
    }
  ],
  "active": true,
  "providedBy": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  },
  "name": "Resonancia magnética",
  "appointmentRequired": true,
  "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
}

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

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

Trae los servicios de salud que se crearon o cambiaron en el registro de establecimientos 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]/HealthcareService/_history?_since=2026-10-01T00:00:00-06:00&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 5 cambios, de 2 en 2 con _count

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "history",
  "total": 5,
  "link": [
    {
      "relation": "self",
      "url": "[base]/HealthcareService/_history?_since=2026-10-01T00:00:00-06:00&_count=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-resonancia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-resonancia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-3101123456",
            "value": "IMG-RM"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "imagenes-medicas",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Imágenes médicas"
              }
            ]
          }
        ],
        "specialty": [
          {
            "coding": [
              {
                "code": "06.05.01",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-especialidad-salud",
                "display": "Medicina con especialidad en Radiología e Imágenes Médicas"
              }
            ],
            "text": "Radiología e Imágenes Médicas"
          }
        ],
        "characteristic": [
          {
            "coding": [
              {
                "code": "MR",
                "system": "http://dicom.nema.org/resources/ontology/DCM",
                "display": "Magnetic Resonance"
              }
            ],
            "text": "Resonancia magnética"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "orden-medica",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Orden médica"
                }
              ]
            }
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "19:00:00"
              },
              {
                "daysOfWeek": [
                  "sat"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "12:00:00"
              }
            ]
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "phone",
                "value": "+50622220000;ext=2105"
              },
              {
                "system": "email",
                "value": "citas.imagenes@hospital-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        },
        "name": "Resonancia magnética",
        "appointmentRequired": true,
        "comment": "Retirar objetos metálicos antes del estudio. Si lleva marcapasos o implantes, avisar al pedir la cita."
      },
      "request": {
        "method": "POST",
        "url": "HealthcareService"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    },
    {
      "fullUrl": "[base]/HealthcareService/ejemplo-servicio-cardiologia",
      "resource": {
        "resourceType": "HealthcareService",
        "id": "ejemplo-servicio-cardiologia",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-healthcare-service"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/servicio/cj-4000042147",
            "value": "CE-CARDIO-01"
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-hospital-ccss",
            "display": "Hospital Regional de Ejemplo"
          }
        ],
        "type": [
          {
            "coding": [
              {
                "code": "consulta-especializada",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-servicio-salud",
                "display": "Consulta especializada"
              }
            ]
          }
        ],
        "specialty": [
          {
            "text": "Cardiología"
          }
        ],
        "eligibility": [
          {
            "code": {
              "coding": [
                {
                  "code": "referencia",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Referencia"
                }
              ]
            },
            "comment": "Referencia del primer nivel de atención o de otra especialidad."
          },
          {
            "code": {
              "coding": [
                {
                  "code": "cobertura",
                  "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-requisito-acceso",
                  "display": "Cobertura"
                }
              ]
            },
            "comment": "Seguro de salud de la CCSS."
          }
        ],
        "availability": [
          {
            "availableTime": [
              {
                "daysOfWeek": [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ],
                "availableStartTime": "07:00:00",
                "availableEndTime": "16:00:00"
              }
            ]
          }
        ],
        "active": true,
        "providedBy": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "name": "Consulta externa de cardiología",
        "appointmentRequired": true
      },
      "request": {
        "method": "POST",
        "url": "HealthcareService"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    }
  ]
}