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: Relación entre organizaciones

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

Acuerdo formal entre dos organizaciones de Costa Rica que no es de jerarquía: administración por contrato, compra de servicios o pertenencia a una red de proveedores, con su vigencia, el rol de la organización participante y dónde aplica. Implementa el modelo lógico de la relación entre organizaciones.

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
.. OrganizationAffiliation C 0..* OrganizationAffiliation Relación entre organizaciones: contrato, compra de servicios o red de proveedores
Constraints: 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/convenio/{código del establecimiento de la organización principal}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del contrato o convenio
Example General: 123456
Max Length:64
... active SΣ 1..1 boolean Si la relación está vigente
... period SΣ 0..1 Period Vigencia del contrato o convenio
.... start SΣC 0..1 dateTime Inicio
.... end SΣC 0..1 dateTime Vencimiento
... organization SΣ 1..1 Reference(Organización) Organización principal: para quien se presta el servicio o que contrata
... participatingOrganization SΣ 1..1 Reference(Organización) Organización participante: la que opera o presta el servicio
... Slices for code SΣ 1..* CodeableConcept Rol de la participante (HL7) y tipo de acuerdo (CR)
Slice: Sin orden, Abierto by value:coding.system
Vinculación: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.
.... code:rol SΣ 1..* CodeableConcept provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member
Vinculación: OrganizationAffiliationRole (required)
.... code:tipoRelacion SΣ 0..1 CodeableConcept administracion-contrato | compra-servicios | red-proveedores
Vinculación: Tipos de relación entre organizaciones (required)
... specialty SΣ 0..* CodeableConcept Especialidades que cubre la relación
Vinculación: Especialidades en salud (extensible)
... location SΣ 0..* Reference(Ubicación) Sedes donde aplica la relación
... contact SC 0..* ExtendedContactDetail Contacto de trabajo para los asuntos de la relación
Constraints: org-3, org-4
.... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) 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

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
OrganizationAffiliation.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code:rol Base required Organization Affiliation Role 📦5.0.0 Estándar FHIR
OrganizationAffiliation.​code:tipoRelacion Base required Tipos de relación entre organizaciones 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​contact.telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-convenio-system error OrganizationAffiliation.identifier El system del identificador es https://hl7.or.cr/fhir/sid/convenio/ seguido del código del establecimiento de la organización principal (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/convenio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error OrganizationAffiliation No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-telefono error OrganizationAffiliation.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 OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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 OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation 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()
org-3 error OrganizationAffiliation.contact The telecom of an organization can never be of use 'home' telecom.where(use = 'home').empty()
org-4 error OrganizationAffiliation.contact The address of an organization can never be of use 'home' address.where(use = 'home').empty()

Esta estructura se deriva de OrganizationAffiliation .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. OrganizationAffiliation C 0..* OrganizationAffiliation Relación entre organizaciones: contrato, compra de servicios o red de proveedores
Constraints: cr-identificador-unico
... identifier SC 0..* Identifier Número del contrato o convenio
Constraints: cr-convenio-system
.... use 0..1 code official (valor fijo)
Required Pattern: official
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal}
.... value S 1..1 string Número del contrato o convenio
Max Length:64
... active S 1..1 boolean Si la relación está vigente
... period S 0..1 Period Vigencia del contrato o convenio
.... start S 0..1 dateTime Inicio
.... end S 0..1 dateTime Vencimiento
... participatingOrganization S 1..1 Reference(Organización) Organización participante: la que opera o presta el servicio
... network 0..0 No se usa: una red de proveedores es una relación más
... Slices for code S 1..* CodeableConcept Rol de la participante (HL7) y tipo de acuerdo (CR)
Slice: Sin orden, Abierto by value:coding.system
.... code:rol S 1..* CodeableConcept provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member
Vinculación: OrganizationAffiliationRole (required)
..... coding
...... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: http://hl7.org/fhir/organization-role
.... code:tipoRelacion S 0..1 CodeableConcept administracion-contrato | compra-servicios | red-proveedores
Vinculación: Tipos de relación entre organizaciones (required)
..... coding
...... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion
... specialty S 0..* CodeableConcept Especialidades que cubre la relación
Vinculación: Especialidades en salud (extensible)
... location S 0..* Reference(Ubicación) Sedes donde aplica la relación
... contact S 0..* ExtendedContactDetail Contacto de trabajo para los asuntos de la relación
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
..... use 0..1 code work (valor fijo)
Required Pattern: work

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso ValueSet Versión Fuente
OrganizationAffiliation.​code:rol Base required Organization Affiliation Role 📦5.0.0 Estándar FHIR
OrganizationAffiliation.​code:tipoRelacion Base required Tipos de relación entre organizaciones 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-convenio-system error OrganizationAffiliation.identifier El system del identificador es https://hl7.or.cr/fhir/sid/convenio/ seguido del código del establecimiento de la organización principal (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/convenio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error OrganizationAffiliation No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-telefono error OrganizationAffiliation.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
.. OrganizationAffiliation C 0..* OrganizationAffiliation Relación entre organizaciones: contrato, compra de servicios o red de proveedores
Constraints: 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
... 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 Número del contrato o convenio
Constraints: cr-convenio-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/convenio/{código del establecimiento de la organización principal}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del contrato o convenio
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 la relación está vigente
... period SΣ 0..1 Period Vigencia del contrato o convenio
.... 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
.... start SΣC 0..1 dateTime Inicio
.... end SΣC 0..1 dateTime Vencimiento
... organization SΣ 1..1 Reference(Organización) Organización principal: para quien se presta el servicio o que contrata
... participatingOrganization SΣ 1..1 Reference(Organización) Organización participante: la que opera o presta el servicio
... Slices for code SΣ 1..* CodeableConcept Rol de la participante (HL7) y tipo de acuerdo (CR)
Slice: Sin orden, Abierto by value:coding.system
Vinculación: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.
.... code:rol SΣ 1..* CodeableConcept provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member
Vinculación: OrganizationAffiliationRole (required)
..... id 0..1 id Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... coding Σ 0..* Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: http://hl7.org/fhir/organization-role
...... 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
.... code:tipoRelacion SΣ 0..1 CodeableConcept administracion-contrato | compra-servicios | red-proveedores
Vinculación: Tipos de relación entre organizaciones (required)
..... id 0..1 id Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... coding Σ 0..* Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion
...... 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
... specialty SΣ 0..* CodeableConcept Especialidades que cubre la relación
Vinculación: Especialidades en salud (extensible)
... location SΣ 0..* Reference(Ubicación) Sedes donde aplica la relación
... healthcareService 0..* Reference(HealthcareService) Healthcare services provided through the role
... contact SC 0..* ExtendedContactDetail Contacto de trabajo para los asuntos de la relación
Constraints: org-3, org-4
.... 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) 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
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for this role

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
OrganizationAffiliation.​language Base required All Languages 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​identifier.type Base extensible Identifier Type Codes 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code:rol Base required Organization Affiliation Role 📦5.0.0 Estándar FHIR
OrganizationAffiliation.​code:tipoRelacion Base required Tipos de relación entre organizaciones 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​contact.purpose Base preferred Contact entity type 📦2.0.0 THO v7.4
OrganizationAffiliation.​contact.telecom.system Base required ContactPointSystem 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​contact.telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-convenio-system error OrganizationAffiliation.identifier El system del identificador es https://hl7.or.cr/fhir/sid/convenio/ seguido del código del establecimiento de la organización principal (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/convenio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error OrganizationAffiliation No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-telefono error OrganizationAffiliation.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 OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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 OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation 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()
org-3 error OrganizationAffiliation.contact The telecom of an organization can never be of use 'home' telecom.where(use = 'home').empty()
org-4 error OrganizationAffiliation.contact The address of an organization can never be of use 'home' address.where(use = 'home').empty()

Esta estructura se deriva de OrganizationAffiliation .

Resumen

Obligatorios: 5 elementos(4 nested mandatory elementos)
Must-Support: 16 elementos
Prohibited: 1 elemento

Estructuras

Esta estructura hace referencia a estas otras estructuras:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of OrganizationAffiliation.code

Vista de elementos clave

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. OrganizationAffiliation C 0..* OrganizationAffiliation Relación entre organizaciones: contrato, compra de servicios o red de proveedores
Constraints: 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/convenio/{código del establecimiento de la organización principal}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del contrato o convenio
Example General: 123456
Max Length:64
... active SΣ 1..1 boolean Si la relación está vigente
... period SΣ 0..1 Period Vigencia del contrato o convenio
.... start SΣC 0..1 dateTime Inicio
.... end SΣC 0..1 dateTime Vencimiento
... organization SΣ 1..1 Reference(Organización) Organización principal: para quien se presta el servicio o que contrata
... participatingOrganization SΣ 1..1 Reference(Organización) Organización participante: la que opera o presta el servicio
... Slices for code SΣ 1..* CodeableConcept Rol de la participante (HL7) y tipo de acuerdo (CR)
Slice: Sin orden, Abierto by value:coding.system
Vinculación: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.
.... code:rol SΣ 1..* CodeableConcept provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member
Vinculación: OrganizationAffiliationRole (required)
.... code:tipoRelacion SΣ 0..1 CodeableConcept administracion-contrato | compra-servicios | red-proveedores
Vinculación: Tipos de relación entre organizaciones (required)
... specialty SΣ 0..* CodeableConcept Especialidades que cubre la relación
Vinculación: Especialidades en salud (extensible)
... location SΣ 0..* Reference(Ubicación) Sedes donde aplica la relación
... contact SC 0..* ExtendedContactDetail Contacto de trabajo para los asuntos de la relación
Constraints: org-3, org-4
.... telecom SΣC 0..* ContactPoint Teléfono (+506 y 8 dígitos) 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

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
OrganizationAffiliation.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code:rol Base required Organization Affiliation Role 📦5.0.0 Estándar FHIR
OrganizationAffiliation.​code:tipoRelacion Base required Tipos de relación entre organizaciones 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​contact.telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-convenio-system error OrganizationAffiliation.identifier El system del identificador es https://hl7.or.cr/fhir/sid/convenio/ seguido del código del establecimiento de la organización principal (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/convenio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error OrganizationAffiliation No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-telefono error OrganizationAffiliation.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 OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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 OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation 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()
org-3 error OrganizationAffiliation.contact The telecom of an organization can never be of use 'home' telecom.where(use = 'home').empty()
org-4 error OrganizationAffiliation.contact The address of an organization can never be of use 'home' address.where(use = 'home').empty()

Vista diferencial

Esta estructura se deriva de OrganizationAffiliation .

NombreMarcasCard.TipoDescripción y restricciones    Filter: Filtersdoco
.. OrganizationAffiliation C 0..* OrganizationAffiliation Relación entre organizaciones: contrato, compra de servicios o red de proveedores
Constraints: cr-identificador-unico
... identifier SC 0..* Identifier Número del contrato o convenio
Constraints: cr-convenio-system
.... use 0..1 code official (valor fijo)
Required Pattern: official
.... system S 1..1 uri https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal}
.... value S 1..1 string Número del contrato o convenio
Max Length:64
... active S 1..1 boolean Si la relación está vigente
... period S 0..1 Period Vigencia del contrato o convenio
.... start S 0..1 dateTime Inicio
.... end S 0..1 dateTime Vencimiento
... participatingOrganization S 1..1 Reference(Organización) Organización participante: la que opera o presta el servicio
... network 0..0 No se usa: una red de proveedores es una relación más
... Slices for code S 1..* CodeableConcept Rol de la participante (HL7) y tipo de acuerdo (CR)
Slice: Sin orden, Abierto by value:coding.system
.... code:rol S 1..* CodeableConcept provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member
Vinculación: OrganizationAffiliationRole (required)
..... coding
...... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: http://hl7.org/fhir/organization-role
.... code:tipoRelacion S 0..1 CodeableConcept administracion-contrato | compra-servicios | red-proveedores
Vinculación: Tipos de relación entre organizaciones (required)
..... coding
...... system 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion
... specialty S 0..* CodeableConcept Especialidades que cubre la relación
Vinculación: Especialidades en salud (extensible)
... location S 0..* Reference(Ubicación) Sedes donde aplica la relación
... contact S 0..* ExtendedContactDetail Contacto de trabajo para los asuntos de la relación
.... telecom SC 0..* ContactPoint Teléfono (+506 y 8 dígitos) o correo electrónico
Constraints: cr-telefono
..... use 0..1 code work (valor fijo)
Required Pattern: work

doco Documentación de este formato

Vinculaciones terminológicas (diferencial)

Ruta Estado Uso ValueSet Versión Fuente
OrganizationAffiliation.​code:rol Base required Organization Affiliation Role 📦5.0.0 Estándar FHIR
OrganizationAffiliation.​code:tipoRelacion Base required Tipos de relación entre organizaciones 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-convenio-system error OrganizationAffiliation.identifier El system del identificador es https://hl7.or.cr/fhir/sid/convenio/ seguido del código del establecimiento de la organización principal (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/convenio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error OrganizationAffiliation No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-telefono error OrganizationAffiliation.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
.. OrganizationAffiliation C 0..* OrganizationAffiliation Relación entre organizaciones: contrato, compra de servicios o red de proveedores
Constraints: 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
... 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 Número del contrato o convenio
Constraints: cr-convenio-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/convenio/{código del establecimiento de la organización principal}
Example General: http://www.acme.com/identifiers/patient
.... value SΣC 1..1 string Número del contrato o convenio
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 la relación está vigente
... period SΣ 0..1 Period Vigencia del contrato o convenio
.... 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
.... start SΣC 0..1 dateTime Inicio
.... end SΣC 0..1 dateTime Vencimiento
... organization SΣ 1..1 Reference(Organización) Organización principal: para quien se presta el servicio o que contrata
... participatingOrganization SΣ 1..1 Reference(Organización) Organización participante: la que opera o presta el servicio
... Slices for code SΣ 1..* CodeableConcept Rol de la participante (HL7) y tipo de acuerdo (CR)
Slice: Sin orden, Abierto by value:coding.system
Vinculación: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.
.... code:rol SΣ 1..* CodeableConcept provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member
Vinculación: OrganizationAffiliationRole (required)
..... id 0..1 id Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... coding Σ 0..* Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: http://hl7.org/fhir/organization-role
...... 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
.... code:tipoRelacion SΣ 0..1 CodeableConcept administracion-contrato | compra-servicios | red-proveedores
Vinculación: Tipos de relación entre organizaciones (required)
..... id 0..1 id Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
..... coding Σ 0..* Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Sin orden, Abierto by value:url
...... system Σ 1..1 uri Sistema de códigos del slice (valor fijo)
Required Pattern: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion
...... 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
... specialty SΣ 0..* CodeableConcept Especialidades que cubre la relación
Vinculación: Especialidades en salud (extensible)
... location SΣ 0..* Reference(Ubicación) Sedes donde aplica la relación
... healthcareService 0..* Reference(HealthcareService) Healthcare services provided through the role
... contact SC 0..* ExtendedContactDetail Contacto de trabajo para los asuntos de la relación
Constraints: org-3, org-4
.... 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) 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
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for this role

doco Documentación de este formato

Vinculaciones terminológicas

Ruta Estado Uso ValueSet Versión Fuente
OrganizationAffiliation.​language Base required All Languages 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​identifier.use Base required IdentifierUse 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​identifier.type Base extensible Identifier Type Codes 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​code:rol Base required Organization Affiliation Role 📦5.0.0 Estándar FHIR
OrganizationAffiliation.​code:tipoRelacion Base required Tipos de relación entre organizaciones 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​specialty Base extensible Especialidades en salud 📦0.1.0 Guía de Implementación de Terminología de Costa Rica vnull
OrganizationAffiliation.​contact.purpose Base preferred Contact entity type 📦2.0.0 THO v7.4
OrganizationAffiliation.​contact.telecom.system Base required ContactPointSystem 📍5.0.0 Estándar FHIR
OrganizationAffiliation.​contact.telecom.use Base required ContactPointUse 📍5.0.0 Estándar FHIR

Restricciones

Id Nivel Ruta(s) Descripción Expression
cr-convenio-system error OrganizationAffiliation.identifier El system del identificador es https://hl7.or.cr/fhir/sid/convenio/ seguido del código del establecimiento de la organización principal (cj-, cn- o dimex- y el identificador del titular). system.matches('^https://hl7\\.or\\.cr/fhir/sid/convenio/(cj-[1-9][0-9]{9}|cn-[1-9][0-9]{8}|dimex-[1-9][0-9]{10,11})$')
cr-identificador-unico error OrganizationAffiliation No hay dos identificadores con el mismo system y el mismo valor. identifier.select(system & '|' & value).isDistinct()
cr-telefono error OrganizationAffiliation.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 OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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 OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation 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()
org-3 error OrganizationAffiliation.contact The telecom of an organization can never be of use 'home' telecom.where(use = 'home').empty()
org-4 error OrganizationAffiliation.contact The address of an organization can never be of use 'home' address.where(use = 'home').empty()

Esta estructura se deriva de OrganizationAffiliation .

Resumen

Obligatorios: 5 elementos(4 nested mandatory elementos)
Must-Support: 16 elementos
Prohibited: 1 elemento

Estructuras

Esta estructura hace referencia a estas otras estructuras:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of OrganizationAffiliation.code

 

Otras representaciones de perfil: CSV, Excel, Schematron

Notas:

Uso en el HIE

Registro de establecimientos. Relaciones entre organizaciones: administración por contrato, compra de servicios y redes de proveedores.

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

Lee una relación entre organizaciones del registro de establecimientos por su id, la parte final de su URL. Se usa para resolver una referencia que otro recurso hace a una relación entre organizaciones. En el ejemplo se lee «Compra de servicios de imágenes de la CCSS (A2)»; la segunda respuesta es la de un id que no existe.

Solicitud

GET [base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios 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": "OrganizationAffiliation",
  "id": "ejemplo-relacion-compra-servicios",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
      "value": "2025CD-000456"
    }
  ],
  "period": {
    "start": "2025-03-01",
    "end": "2026-02-28"
  },
  "code": [
    {
      "coding": [
        {
          "code": "diagnostics",
          "system": "http://hl7.org/fhir/organization-role",
          "display": "Diagnostics"
        }
      ],
      "text": "Servicios de diagnóstico"
    },
    {
      "coding": [
        {
          "code": "compra-servicios",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
          "display": "Compra de servicios"
        }
      ]
    }
  ],
  "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"
        }
      ]
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "active": true,
  "organization": {
    "reference": "Organization/ejemplo-organizacion-hospital-ccss",
    "display": "Hospital Regional de Ejemplo"
  },
  "participatingOrganization": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  }
}

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

Buscar por organización principal
Forma: GET [base]/OrganizationAffiliation?primary-organization=Organization/{id}

Trae los acuerdos de una organización con otras: qué servicios compra, a quién administra o con quién tiene convenio. En el ejemplo se usa el dato de «Compra de servicios de imágenes de la CCSS (A2)»: primary-organization=Organization/ejemplo-organizacion-hospital-ccss.

Solicitud

GET [base]/OrganizationAffiliation?primary-organization=Organization/ejemplo-organizacion-hospital-ccss HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Compra de servicios de imágenes de la CCSS (A2)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?primary-organization=Organization/ejemplo-organizacion-hospital-ccss"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por organización participante
Forma: GET [base]/OrganizationAffiliation?participating-organization=Organization/{id}

Trae los acuerdos en que participa una organización; por ejemplo, a quién le vende servicios un hospital privado. En el ejemplo se usa el dato de «Compra de servicios de imágenes de la CCSS (A2)»: participating-organization=Organization/ejemplo-establecimiento.

Solicitud

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

Respuesta: 1 resultado: Compra de servicios de imágenes de la CCSS (A2)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?participating-organization=Organization/ejemplo-establecimiento"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por rol
Forma: GET [base]/OrganizationAffiliation?role={sistema}|{código}

Busca relaciones por su rol; por ejemplo, todos los proveedores de servicios de diagnóstico. En el ejemplo se usa el dato de «Compra de servicios de imágenes de la CCSS (A2)»: role=http://hl7.org/fhir/organization-role|diagnostics.

Solicitud

GET [base]/OrganizationAffiliation?role=http://hl7.org/fhir/organization-role|diagnostics HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 2 resultados: Compra de servicios de imágenes de la CCSS (A2); Laboratorio en la red de proveedores del INS (A3)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 2,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?role=http://hl7.org/fhir/organization-role|diagnostics"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-red-proveedores",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-red-proveedores",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000001902",
            "value": "RP-LAB-0789"
          }
        ],
        "period": {
          "start": "2023-07-01"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "red-proveedores",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Red de proveedores"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-laboratorio",
            "display": "Laboratorio Clínico de Ejemplo, San Pedro"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-ins",
          "display": "Instituto Nacional de Seguros"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-organizacion-laboratorio",
          "display": "Laboratorio Clínico de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por registro activo
Forma: GET [base]/OrganizationAffiliation?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 «Compra de servicios de imágenes de la CCSS (A2)»: active=true.

Solicitud

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

Respuesta: 3 resultados, de 2 en 2 con _count; la primera página trae Compra de servicios de imágenes de la CCSS (A2); Área de salud administrada por una cooperativa (A1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 3,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?active=true&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/OrganizationAffiliation?active=true&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-administracion",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-administracion",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2024LN-000123"
          }
        ],
        "period": {
          "start": "2024-01-01",
          "end": "2028-12-31"
        },
        "participatingOrganization": {
          "identifier": {
            "system": "https://hl7.or.cr/fhir/sid/cedula-juridica",
            "value": "3004123456"
          },
          "display": "Cooperativa de Salud de Ejemplo R.L."
        },
        "code": [
          {
            "coding": [
              {
                "code": "provider",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Provider"
              }
            ],
            "text": "Prestador de servicios de salud"
          },
          {
            "coding": [
              {
                "code": "administracion-contrato",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Administración por contrato"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-area-salud",
            "display": "Sede del Área de Salud de Ejemplo"
          },
          {
            "reference": "Location/ejemplo-ubicacion-ebais",
            "display": "Sede del EBAIS de Ejemplo"
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "email",
                "value": "contratos@cooperativa-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-area-salud",
          "display": "Área de Salud de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por fecha
Forma: GET [base]/OrganizationAffiliation?date={fecha}

Trae los acuerdos vigentes en una fecha, para saber si una organización podía atender por cuenta de otra ese día. En el ejemplo se usa el dato de «Compra de servicios de imágenes de la CCSS (A2)»: date=2025-03-01.

Solicitud

GET [base]/OrganizationAffiliation?date=2025-03-01&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 3 resultados, de 2 en 2 con _count; la primera página trae Compra de servicios de imágenes de la CCSS (A2); Área de salud administrada por una cooperativa (A1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 3,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?date=2025-03-01&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/OrganizationAffiliation?date=2025-03-01&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-administracion",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-administracion",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2024LN-000123"
          }
        ],
        "period": {
          "start": "2024-01-01",
          "end": "2028-12-31"
        },
        "participatingOrganization": {
          "identifier": {
            "system": "https://hl7.or.cr/fhir/sid/cedula-juridica",
            "value": "3004123456"
          },
          "display": "Cooperativa de Salud de Ejemplo R.L."
        },
        "code": [
          {
            "coding": [
              {
                "code": "provider",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Provider"
              }
            ],
            "text": "Prestador de servicios de salud"
          },
          {
            "coding": [
              {
                "code": "administracion-contrato",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Administración por contrato"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-area-salud",
            "display": "Sede del Área de Salud de Ejemplo"
          },
          {
            "reference": "Location/ejemplo-ubicacion-ebais",
            "display": "Sede del EBAIS de Ejemplo"
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "email",
                "value": "contratos@cooperativa-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-area-salud",
          "display": "Área de Salud de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

Encuentra un acuerdo por su número de convenio o contrato. En el ejemplo se usa el dato de «Compra de servicios de imágenes de la CCSS (A2)»: identifier=https://hl7.or.cr/fhir/sid/convenio/cj-4000042147|2025CD-000456.

Solicitud

GET [base]/OrganizationAffiliation?identifier=https://hl7.or.cr/fhir/sid/convenio/cj-4000042147|2025CD-000456 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 1 resultado: Compra de servicios de imágenes de la CCSS (A2)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?identifier=https://hl7.or.cr/fhir/sid/convenio/cj-4000042147|2025CD-000456"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

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

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

Respuesta: 3 resultados, de 2 en 2 con _count; la primera página trae Compra de servicios de imágenes de la CCSS (A2); Área de salud administrada por una cooperativa (A1)

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 3,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation?_lastUpdated=ge2026-10-01&_count=2"
    },
    {
      "relation": "next",
      "url": "[base]/OrganizationAffiliation?_lastUpdated=ge2026-10-01&_count=2&_offset=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-administracion",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-administracion",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2024LN-000123"
          }
        ],
        "period": {
          "start": "2024-01-01",
          "end": "2028-12-31"
        },
        "participatingOrganization": {
          "identifier": {
            "system": "https://hl7.or.cr/fhir/sid/cedula-juridica",
            "value": "3004123456"
          },
          "display": "Cooperativa de Salud de Ejemplo R.L."
        },
        "code": [
          {
            "coding": [
              {
                "code": "provider",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Provider"
              }
            ],
            "text": "Prestador de servicios de salud"
          },
          {
            "coding": [
              {
                "code": "administracion-contrato",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Administración por contrato"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-area-salud",
            "display": "Sede del Área de Salud de Ejemplo"
          },
          {
            "reference": "Location/ejemplo-ubicacion-ebais",
            "display": "Sede del EBAIS de Ejemplo"
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "email",
                "value": "contratos@cooperativa-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-area-salud",
          "display": "Área de Salud de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}

Buscar por organización principal, con POST
Forma: POST [base]/OrganizationAffiliation/_search
cuerpo: primary-organization=Organization/{id}

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 organización principal.

Solicitud

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

primary-organization=Organization/ejemplo-organizacion-hospital-ccss

Respuesta: 1 resultado: Compra de servicios de imágenes de la CCSS (A2), 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]/OrganizationAffiliation?primary-organization=Organization/ejemplo-organizacion-hospital-ccss"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "search": {
        "mode": "match"
      }
    }
  ]
}
Crear

Crear
Forma: POST [base]/OrganizationAffiliation

Registra una relación entre organizaciones 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 «Compra de servicios de imágenes de la CCSS (A2)»; la segunda respuesta es el rechazo de un recurso que no cumple la invariante cr-identificador-unico (No hay dos identificadores con el mismo system y el mismo valor).

Solicitud

POST [base]/OrganizationAffiliation HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
Content-Type: application/fhir+json
{
  "resourceType": "OrganizationAffiliation",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
      "value": "2025CD-000456"
    }
  ],
  "period": {
    "start": "2025-03-01",
    "end": "2026-02-28"
  },
  "code": [
    {
      "coding": [
        {
          "code": "diagnostics",
          "system": "http://hl7.org/fhir/organization-role",
          "display": "Diagnostics"
        }
      ],
      "text": "Servicios de diagnóstico"
    },
    {
      "coding": [
        {
          "code": "compra-servicios",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
          "display": "Compra de servicios"
        }
      ]
    }
  ],
  "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"
        }
      ]
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "active": true,
  "organization": {
    "reference": "Organization/ejemplo-organizacion-hospital-ccss",
    "display": "Hospital Regional de Ejemplo"
  },
  "participatingOrganization": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  }
}

Respuesta si se crea

HTTP/1.1 201 Created
Location: [base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios/_history/1
ETag: W/"1"
Last-Modified: 2026-10-01T10:00:00-06:00
Content-Type: application/fhir+json
{
  "resourceType": "OrganizationAffiliation",
  "id": "ejemplo-relacion-compra-servicios",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2026-10-01T10:00:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
      "value": "2025CD-000456"
    }
  ],
  "period": {
    "start": "2025-03-01",
    "end": "2026-02-28"
  },
  "code": [
    {
      "coding": [
        {
          "code": "diagnostics",
          "system": "http://hl7.org/fhir/organization-role",
          "display": "Diagnostics"
        }
      ],
      "text": "Servicios de diagnóstico"
    },
    {
      "coding": [
        {
          "code": "compra-servicios",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
          "display": "Compra de servicios"
        }
      ]
    }
  ],
  "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"
        }
      ]
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "active": true,
  "organization": {
    "reference": "Organization/ejemplo-organizacion-hospital-ccss",
    "display": "Hospital Regional de Ejemplo"
  },
  "participatingOrganization": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  }
}

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

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

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

Reemplaza una relación entre organizaciones 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 «Compra de servicios de imágenes de la CCSS (A2)» sobre su versión 1; la segunda respuesta es el rechazo cuando otra persona ya la había cambiado.

Solicitud

PUT [base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]
If-Match: W/"1"
Content-Type: application/fhir+json
{
  "resourceType": "OrganizationAffiliation",
  "id": "ejemplo-relacion-compra-servicios",
  "meta": {
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
      "value": "2025CD-000456"
    }
  ],
  "period": {
    "start": "2025-03-01",
    "end": "2026-02-28"
  },
  "code": [
    {
      "coding": [
        {
          "code": "diagnostics",
          "system": "http://hl7.org/fhir/organization-role",
          "display": "Diagnostics"
        }
      ],
      "text": "Servicios de diagnóstico"
    },
    {
      "coding": [
        {
          "code": "compra-servicios",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
          "display": "Compra de servicios"
        }
      ]
    }
  ],
  "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"
        }
      ]
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "active": true,
  "organization": {
    "reference": "Organization/ejemplo-organizacion-hospital-ccss",
    "display": "Hospital Regional de Ejemplo"
  },
  "participatingOrganization": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  }
}

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": "OrganizationAffiliation",
  "id": "ejemplo-relacion-compra-servicios",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2026-10-02T08:15:00-06:00",
    "profile": [
      "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
    ]
  },
  "identifier": [
    {
      "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
      "value": "2025CD-000456"
    }
  ],
  "period": {
    "start": "2025-03-01",
    "end": "2026-02-28"
  },
  "code": [
    {
      "coding": [
        {
          "code": "diagnostics",
          "system": "http://hl7.org/fhir/organization-role",
          "display": "Diagnostics"
        }
      ],
      "text": "Servicios de diagnóstico"
    },
    {
      "coding": [
        {
          "code": "compra-servicios",
          "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
          "display": "Compra de servicios"
        }
      ]
    }
  ],
  "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"
        }
      ]
    }
  ],
  "location": [
    {
      "reference": "Location/ejemplo-ubicacion-radiologia",
      "display": "Servicio de Radiología"
    }
  ],
  "active": true,
  "organization": {
    "reference": "Organization/ejemplo-organizacion-hospital-ccss",
    "display": "Hospital Regional de Ejemplo"
  },
  "participatingOrganization": {
    "reference": "Organization/ejemplo-establecimiento",
    "display": "Hospital Privado de Ejemplo"
  }
}

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

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

Trae las relaciones entre organizaciones 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]/OrganizationAffiliation/_history?_since=2026-10-01T00:00:00-06:00&_count=2 HTTP/1.1
Accept: application/fhir+json
Authorization: Bearer [token]

Respuesta: 3 cambios, de 2 en 2 con _count

HTTP/1.1 200 OK
Content-Type: application/fhir+json
{
  "resourceType": "Bundle",
  "type": "history",
  "total": 3,
  "link": [
    {
      "relation": "self",
      "url": "[base]/OrganizationAffiliation/_history?_since=2026-10-01T00:00:00-06:00&_count=2"
    }
  ],
  "entry": [
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-compra-servicios",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-compra-servicios",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2025CD-000456"
          }
        ],
        "period": {
          "start": "2025-03-01",
          "end": "2026-02-28"
        },
        "code": [
          {
            "coding": [
              {
                "code": "diagnostics",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Diagnostics"
              }
            ],
            "text": "Servicios de diagnóstico"
          },
          {
            "coding": [
              {
                "code": "compra-servicios",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Compra de servicios"
              }
            ]
          }
        ],
        "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"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-radiologia",
            "display": "Servicio de Radiología"
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-hospital-ccss",
          "display": "Hospital Regional de Ejemplo"
        },
        "participatingOrganization": {
          "reference": "Organization/ejemplo-establecimiento",
          "display": "Hospital Privado de Ejemplo"
        }
      },
      "request": {
        "method": "POST",
        "url": "OrganizationAffiliation"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    },
    {
      "fullUrl": "[base]/OrganizationAffiliation/ejemplo-relacion-administracion",
      "resource": {
        "resourceType": "OrganizationAffiliation",
        "id": "ejemplo-relacion-administracion",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-10-01T10:00:00-06:00",
          "profile": [
            "https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation"
          ]
        },
        "identifier": [
          {
            "system": "https://hl7.or.cr/fhir/sid/convenio/cj-4000042147",
            "value": "2024LN-000123"
          }
        ],
        "period": {
          "start": "2024-01-01",
          "end": "2028-12-31"
        },
        "participatingOrganization": {
          "identifier": {
            "system": "https://hl7.or.cr/fhir/sid/cedula-juridica",
            "value": "3004123456"
          },
          "display": "Cooperativa de Salud de Ejemplo R.L."
        },
        "code": [
          {
            "coding": [
              {
                "code": "provider",
                "system": "http://hl7.org/fhir/organization-role",
                "display": "Provider"
              }
            ],
            "text": "Prestador de servicios de salud"
          },
          {
            "coding": [
              {
                "code": "administracion-contrato",
                "system": "https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion",
                "display": "Administración por contrato"
              }
            ]
          }
        ],
        "location": [
          {
            "reference": "Location/ejemplo-ubicacion-area-salud",
            "display": "Sede del Área de Salud de Ejemplo"
          },
          {
            "reference": "Location/ejemplo-ubicacion-ebais",
            "display": "Sede del EBAIS de Ejemplo"
          }
        ],
        "contact": [
          {
            "telecom": [
              {
                "system": "email",
                "value": "contratos@cooperativa-ejemplo.cr"
              }
            ]
          }
        ],
        "active": true,
        "organization": {
          "reference": "Organization/ejemplo-organizacion-area-salud",
          "display": "Área de Salud de Ejemplo"
        }
      },
      "request": {
        "method": "POST",
        "url": "OrganizationAffiliation"
      },
      "response": {
        "status": "201 Created",
        "etag": "W/\"1\""
      }
    }
  ]
}