Guía de Implementación Core de Costa Rica
0.1.0 - ci-build
Guía de Implementación Core de Costa Rica - Compilación local de desarrollo (v0.1.0), generada con las herramientas de compilación de FHIR (HL7® FHIR® Standard). Vea el directorio de versiones publicadas
| URL oficial: https://hl7.or.cr/fhir/core/StructureDefinition/cr-organization-affiliation | Versión: 0.1.0 | ||||
| Standards status: Draft | Nivel de madurez: 0 | Nombre computable: CROrganizationAffiliation | |||
Relación o asociación no jerárquica entre dos organizaciones de Costa Rica: prestación de servicios para otra entidad, administración por contrato o pertenencia a una red de proveedores, con su vigencia, el rol de la organización participante y dónde aplica. El recurso no sustituye el instrumento jurídico ni acredita por sí solo su validez. 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
Descripción de perfiles, diferenciales, instantáneas y sus representaciones.
| Nombre | Marcas | Card. | Tipo | Descripción y restricciones Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | OrganizationAffiliation | Relación entre organizaciones: contrato, compra de servicios o red de proveedores Constraints: cr-identificador-unico | ||||||
![]() ![]() |
Σ | 0..1 | id | Identificador lógico del recurso | ||||||
![]() ![]() |
Σ | 0..1 | Meta | Metadatos del recurso | ||||||
![]() ![]() |
?!Σ | 0..1 | uri | Reglas que rigen la interpretación del contenido del recurso | ||||||
![]() ![]() |
0..1 | code | Idioma del contenido del recurso Vinculación: AllLanguages (required): Etiqueta de idioma para un lenguaje humano, conforme a IETF BCP 47.
| |||||||
![]() ![]() |
0..1 | Narrative | Resumen narrativo del recurso para su interpretación humana Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos | |||||||
![]() ![]() |
0..* | Resource | Recursos contenidos en línea | |||||||
![]() ![]() |
0..* | Extension | Contenido adicional definido por las implementaciones | |||||||
![]() ![]() |
?!Σ | 0..* | Extension | Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan | ||||||
![]() ![]() |
SΣC | 0..* | Identifier | Número del contrato o convenio Constraints: cr-convenio-system | ||||||
![]() ![]() ![]() |
?!Σ | 0..1 | code | official (valor fijo) Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known . Patrón requerido: official | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | uri | https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal} Ejemplo General: http://www.acme.com/identifiers/patient | ||||||
![]() ![]() ![]() |
SΣC | 1..1 | string | Número del contrato o convenio Ejemplo General: 123456 Longitud máxima:64 | ||||||
![]() ![]() |
SΣ | 1..1 | boolean | Si la relación está activa para uso y publicación actual | ||||||
![]() ![]() |
SΣ | 0..1 | Period | Vigencia del contrato o convenio | ||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Inicio | ||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Vencimiento | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización principal: para quien se presta el servicio o que contrata | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización participante: la que opera o presta el servicio | ||||||
![]() ![]() |
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. | ||||||
![]() ![]() ![]() |
SΣ | 1..* | CodeableConcept | provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member Vinculación: OrganizationAffiliationRole (required) | ||||||
![]() ![]() ![]() |
SΣ | 0..1 | CodeableConcept | administracion-contrato | compra-servicios | red-proveedores Vinculación: Tipos de relación entre organizaciones (required) | ||||||
![]() ![]() |
SΣ | 0..* | CodeableConcept | Especialidades que cubre la relación Vinculación: Especialidades en salud (extensible) | ||||||
![]() ![]() |
SΣ | 0..* | Reference(Ubicación) | Ubicaciones físicas donde aplica la relación | ||||||
![]() ![]() |
SC | 0..* | ExtendedContactDetail | Contacto de trabajo para los asuntos de la relación Constraints: org-3, org-4 | ||||||
![]() ![]() ![]() |
SΣC | 0..* | ContactPoint | Teléfono (+506 y 8 dígitos) o correo electrónico Constraints: cr-telefono | ||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..1 | code | work (valor fijo) Vinculación: ContactPointUse (required): Use of contact point. Patrón requerido: work | ||||||
Documentación de este formato | ||||||||||
| Ruta | Estado | Uso | Conjunto de valores | 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.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 |
| Id | Nivel | Ruta(s) | Descripción | Expresión |
| 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 | buena práctica | 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 .
| Nombre | Marcas | Card. | Tipo | Descripción y restricciones Filter: ![]() ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | OrganizationAffiliation | Relación entre organizaciones: contrato, compra de servicios o red de proveedores Constraints: cr-identificador-unico | ||||
![]() ![]() |
0..1 | id | Identificador lógico del recurso | |||||
![]() ![]() |
0..1 | Meta | Metadatos del recurso | |||||
![]() ![]() |
0..1 | uri | Reglas que rigen la interpretación del contenido del recurso | |||||
![]() ![]() |
0..1 | code | Idioma del contenido del recurso Vinculación: AllLanguages (required): Etiqueta de idioma para un lenguaje humano, conforme a IETF BCP 47.
| |||||
![]() ![]() |
0..1 | Narrative | Resumen narrativo del recurso para su interpretación humana | |||||
![]() ![]() |
0..* | Resource | Recursos contenidos en línea | |||||
![]() ![]() |
0..* | Extension | Contenido adicional definido por las implementaciones | |||||
![]() ![]() |
0..* | Extension | Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan | |||||
![]() ![]() |
SC | 0..* | Identifier | Número del contrato o convenio Constraints: cr-convenio-system | ||||
![]() ![]() ![]() |
0..1 | code | official (valor fijo) Patrón requerido: official | |||||
![]() ![]() ![]() |
S | 1..1 | uri | https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal} | ||||
![]() ![]() ![]() |
S | 1..1 | string | Número del contrato o convenio Longitud máxima:64 | ||||
![]() ![]() |
S | 1..1 | boolean | Si la relación está activa para uso y publicación actual | ||||
![]() ![]() |
S | 0..1 | Period | Vigencia del contrato o convenio | ||||
![]() ![]() ![]() |
S | 0..1 | dateTime | Inicio | ||||
![]() ![]() ![]() |
S | 0..1 | dateTime | Vencimiento | ||||
![]() ![]() |
S | 1..1 | Reference(Organización) | Organización principal: para quien se presta el servicio o que contrata | ||||
![]() ![]() |
S | 1..1 | Reference(Organización) | Organización participante: la que opera o presta el servicio | ||||
![]() ![]() |
0..0 | No se usa en Core; prohibido por IHE mCSD | ||||||
![]() ![]() |
S | 1..* | CodeableConcept | Rol de la participante (HL7) y tipo de acuerdo (CR) Slice: Sin orden, Abierto by value:coding.system | ||||
![]() ![]() ![]() |
S | 1..* | CodeableConcept | provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member Vinculación: OrganizationAffiliationRole (required) | ||||
![]() ![]() ![]() ![]() |
||||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: http://hl7.org/fhir/organization-role | |||||
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | administracion-contrato | compra-servicios | red-proveedores Vinculación: Tipos de relación entre organizaciones (required) | ||||
![]() ![]() ![]() ![]() |
||||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion | |||||
![]() ![]() |
S | 0..* | CodeableConcept | Especialidades que cubre la relación Vinculación: Especialidades en salud (extensible) | ||||
![]() ![]() |
S | 0..* | Reference(Ubicación) | Ubicaciones físicas donde aplica la relación | ||||
![]() ![]() |
S | 0..* | ExtendedContactDetail | Contacto de trabajo para los asuntos de la relación | ||||
![]() ![]() ![]() |
SC | 0..* | ContactPoint | Teléfono (+506 y 8 dígitos) o correo electrónico Constraints: cr-telefono | ||||
![]() ![]() ![]() ![]() |
0..1 | code | work (valor fijo) Patrón requerido: work | |||||
Documentación de este formato | ||||||||
| Ruta | Estado | Uso | Conjunto de valores | Versión | Fuente |
| OrganizationAffiliation.language | Base | required | All Languages | 📍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 |
| Id | Nivel | Ruta(s) | Descripción | Expresión |
| 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})?$')))
|
| Nombre | Marcas | Card. | Tipo | Descripción y restricciones Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | OrganizationAffiliation | Relación entre organizaciones: contrato, compra de servicios o red de proveedores Constraints: cr-identificador-unico | ||||||
![]() ![]() |
Σ | 0..1 | id | Identificador lógico del recurso | ||||||
![]() ![]() |
Σ | 0..1 | Meta | Metadatos del recurso | ||||||
![]() ![]() |
?!Σ | 0..1 | uri | Reglas que rigen la interpretación del contenido del recurso | ||||||
![]() ![]() |
0..1 | code | Idioma del contenido del recurso Vinculación: AllLanguages (required): Etiqueta de idioma para un lenguaje humano, conforme a IETF BCP 47.
| |||||||
![]() ![]() |
0..1 | Narrative | Resumen narrativo del recurso para su interpretación humana Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos | |||||||
![]() ![]() |
0..* | Resource | Recursos contenidos en línea | |||||||
![]() ![]() |
0..* | Extension | Contenido adicional definido por las implementaciones | |||||||
![]() ![]() |
?!Σ | 0..* | Extension | Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan | ||||||
![]() ![]() |
SΣC | 0..* | Identifier | Número del contrato o convenio Constraints: cr-convenio-system | ||||||
![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() |
?!Σ | 0..1 | code | official (valor fijo) Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known . Patrón requerido: official | ||||||
![]() ![]() ![]() |
Σ | 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. | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | uri | https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal} Ejemplo General: http://www.acme.com/identifiers/patient | ||||||
![]() ![]() ![]() |
SΣC | 1..1 | string | Número del contrato o convenio Ejemplo General: 123456 Longitud máxima:64 | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Period | Time period when id is/was valid for use | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||||
![]() ![]() |
SΣ | 1..1 | boolean | Si la relación está activa para uso y publicación actual | ||||||
![]() ![]() |
SΣ | 0..1 | Period | Vigencia del contrato o convenio | ||||||
![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Inicio | ||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Vencimiento | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización principal: para quien se presta el servicio o que contrata | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización participante: la que opera o presta el servicio | ||||||
![]() ![]() |
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. | ||||||
![]() ![]() ![]() |
SΣ | 1..* | CodeableConcept | provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member Vinculación: OrganizationAffiliationRole (required) | ||||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() |
Σ | 0..* | Coding | Code defined by a terminology system | ||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: http://hl7.org/fhir/organization-role | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Version of the system - if relevant | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | code | Symbol in syntax defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | string | Representation defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | boolean | If this coding was chosen directly by the user | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Plain text representation of the concept | ||||||
![]() ![]() ![]() |
SΣ | 0..1 | CodeableConcept | administracion-contrato | compra-servicios | red-proveedores Vinculación: Tipos de relación entre organizaciones (required) | ||||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() |
Σ | 0..* | Coding | Code defined by a terminology system | ||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Version of the system - if relevant | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | code | Symbol in syntax defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | string | Representation defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | boolean | If this coding was chosen directly by the user | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Plain text representation of the concept | ||||||
![]() ![]() |
SΣ | 0..* | CodeableConcept | Especialidades que cubre la relación Vinculación: Especialidades en salud (extensible) | ||||||
![]() ![]() |
SΣ | 0..* | Reference(Ubicación) | Ubicaciones físicas donde aplica la relación | ||||||
![]() ![]() |
0..* | Reference(HealthcareService) | Healthcare services provided through the role | |||||||
![]() ![]() |
SC | 0..* | ExtendedContactDetail | Contacto de trabajo para los asuntos de la relación Constraints: org-3, org-4 | ||||||
![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() |
Σ | 0..1 | CodeableConcept | The type of contact Vinculación: Contact entity type (preferred): The purpose for which an extended contact detail should be used. | ||||||
![]() ![]() ![]() |
Σ | 0..* | HumanName | Name of an individual to contact | ||||||
![]() ![]() ![]() |
SΣC | 0..* | ContactPoint | Teléfono (+506 y 8 dígitos) o correo electrónico Constraints: cr-telefono | ||||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() |
ΣC | 0..1 | code | phone | fax | email | pager | url | sms | other Vinculación: ContactPointSystem (required): Telecommunications form for contact point. | ||||||
![]() ![]() ![]() ![]() |
ΣC | 0..1 | string | The actual contact point details | ||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..1 | code | work (valor fijo) Vinculación: ContactPointUse (required): Use of contact point. Patrón requerido: work | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | positiveInt | Specify preferred order of use (1 = highest) | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | Period | Time period when the contact point was/is in use | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Address | Address for the contact | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Reference(Organization) | This contact detail is handled/monitored by a specific organization | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Period | Period that this contact was valid for usage | ||||||
![]() ![]() |
0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for this role | |||||||
Documentación de este formato | ||||||||||
| Ruta | Estado | Uso | Conjunto de valores | 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 |
| Id | Nivel | Ruta(s) | Descripción | Expresión |
| 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 | buena práctica | 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)
Debe dar soporte a: 16 elementos
Prohibidos: 1 elemento
Estructuras
Esta estructura hace referencia a estas otras estructuras:
Slices
Esta estructura define los siguientes slices:
Maturity: 0
Vista de elementos clave
| Nombre | Marcas | Card. | Tipo | Descripción y restricciones Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | OrganizationAffiliation | Relación entre organizaciones: contrato, compra de servicios o red de proveedores Constraints: cr-identificador-unico | ||||||
![]() ![]() |
Σ | 0..1 | id | Identificador lógico del recurso | ||||||
![]() ![]() |
Σ | 0..1 | Meta | Metadatos del recurso | ||||||
![]() ![]() |
?!Σ | 0..1 | uri | Reglas que rigen la interpretación del contenido del recurso | ||||||
![]() ![]() |
0..1 | code | Idioma del contenido del recurso Vinculación: AllLanguages (required): Etiqueta de idioma para un lenguaje humano, conforme a IETF BCP 47.
| |||||||
![]() ![]() |
0..1 | Narrative | Resumen narrativo del recurso para su interpretación humana Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos | |||||||
![]() ![]() |
0..* | Resource | Recursos contenidos en línea | |||||||
![]() ![]() |
0..* | Extension | Contenido adicional definido por las implementaciones | |||||||
![]() ![]() |
?!Σ | 0..* | Extension | Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan | ||||||
![]() ![]() |
SΣC | 0..* | Identifier | Número del contrato o convenio Constraints: cr-convenio-system | ||||||
![]() ![]() ![]() |
?!Σ | 0..1 | code | official (valor fijo) Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known . Patrón requerido: official | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | uri | https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal} Ejemplo General: http://www.acme.com/identifiers/patient | ||||||
![]() ![]() ![]() |
SΣC | 1..1 | string | Número del contrato o convenio Ejemplo General: 123456 Longitud máxima:64 | ||||||
![]() ![]() |
SΣ | 1..1 | boolean | Si la relación está activa para uso y publicación actual | ||||||
![]() ![]() |
SΣ | 0..1 | Period | Vigencia del contrato o convenio | ||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Inicio | ||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Vencimiento | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización principal: para quien se presta el servicio o que contrata | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización participante: la que opera o presta el servicio | ||||||
![]() ![]() |
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. | ||||||
![]() ![]() ![]() |
SΣ | 1..* | CodeableConcept | provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member Vinculación: OrganizationAffiliationRole (required) | ||||||
![]() ![]() ![]() |
SΣ | 0..1 | CodeableConcept | administracion-contrato | compra-servicios | red-proveedores Vinculación: Tipos de relación entre organizaciones (required) | ||||||
![]() ![]() |
SΣ | 0..* | CodeableConcept | Especialidades que cubre la relación Vinculación: Especialidades en salud (extensible) | ||||||
![]() ![]() |
SΣ | 0..* | Reference(Ubicación) | Ubicaciones físicas donde aplica la relación | ||||||
![]() ![]() |
SC | 0..* | ExtendedContactDetail | Contacto de trabajo para los asuntos de la relación Constraints: org-3, org-4 | ||||||
![]() ![]() ![]() |
SΣC | 0..* | ContactPoint | Teléfono (+506 y 8 dígitos) o correo electrónico Constraints: cr-telefono | ||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..1 | code | work (valor fijo) Vinculación: ContactPointUse (required): Use of contact point. Patrón requerido: work | ||||||
Documentación de este formato | ||||||||||
| Ruta | Estado | Uso | Conjunto de valores | 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.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 |
| Id | Nivel | Ruta(s) | Descripción | Expresión |
| 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 | buena práctica | 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 .
| Nombre | Marcas | Card. | Tipo | Descripción y restricciones Filter: ![]() ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | OrganizationAffiliation | Relación entre organizaciones: contrato, compra de servicios o red de proveedores Constraints: cr-identificador-unico | ||||
![]() ![]() |
0..1 | id | Identificador lógico del recurso | |||||
![]() ![]() |
0..1 | Meta | Metadatos del recurso | |||||
![]() ![]() |
0..1 | uri | Reglas que rigen la interpretación del contenido del recurso | |||||
![]() ![]() |
0..1 | code | Idioma del contenido del recurso Vinculación: AllLanguages (required): Etiqueta de idioma para un lenguaje humano, conforme a IETF BCP 47.
| |||||
![]() ![]() |
0..1 | Narrative | Resumen narrativo del recurso para su interpretación humana | |||||
![]() ![]() |
0..* | Resource | Recursos contenidos en línea | |||||
![]() ![]() |
0..* | Extension | Contenido adicional definido por las implementaciones | |||||
![]() ![]() |
0..* | Extension | Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan | |||||
![]() ![]() |
SC | 0..* | Identifier | Número del contrato o convenio Constraints: cr-convenio-system | ||||
![]() ![]() ![]() |
0..1 | code | official (valor fijo) Patrón requerido: official | |||||
![]() ![]() ![]() |
S | 1..1 | uri | https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal} | ||||
![]() ![]() ![]() |
S | 1..1 | string | Número del contrato o convenio Longitud máxima:64 | ||||
![]() ![]() |
S | 1..1 | boolean | Si la relación está activa para uso y publicación actual | ||||
![]() ![]() |
S | 0..1 | Period | Vigencia del contrato o convenio | ||||
![]() ![]() ![]() |
S | 0..1 | dateTime | Inicio | ||||
![]() ![]() ![]() |
S | 0..1 | dateTime | Vencimiento | ||||
![]() ![]() |
S | 1..1 | Reference(Organización) | Organización principal: para quien se presta el servicio o que contrata | ||||
![]() ![]() |
S | 1..1 | Reference(Organización) | Organización participante: la que opera o presta el servicio | ||||
![]() ![]() |
0..0 | No se usa en Core; prohibido por IHE mCSD | ||||||
![]() ![]() |
S | 1..* | CodeableConcept | Rol de la participante (HL7) y tipo de acuerdo (CR) Slice: Sin orden, Abierto by value:coding.system | ||||
![]() ![]() ![]() |
S | 1..* | CodeableConcept | provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member Vinculación: OrganizationAffiliationRole (required) | ||||
![]() ![]() ![]() ![]() |
||||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: http://hl7.org/fhir/organization-role | |||||
![]() ![]() ![]() |
S | 0..1 | CodeableConcept | administracion-contrato | compra-servicios | red-proveedores Vinculación: Tipos de relación entre organizaciones (required) | ||||
![]() ![]() ![]() ![]() |
||||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion | |||||
![]() ![]() |
S | 0..* | CodeableConcept | Especialidades que cubre la relación Vinculación: Especialidades en salud (extensible) | ||||
![]() ![]() |
S | 0..* | Reference(Ubicación) | Ubicaciones físicas donde aplica la relación | ||||
![]() ![]() |
S | 0..* | ExtendedContactDetail | Contacto de trabajo para los asuntos de la relación | ||||
![]() ![]() ![]() |
SC | 0..* | ContactPoint | Teléfono (+506 y 8 dígitos) o correo electrónico Constraints: cr-telefono | ||||
![]() ![]() ![]() ![]() |
0..1 | code | work (valor fijo) Patrón requerido: work | |||||
Documentación de este formato | ||||||||
| Ruta | Estado | Uso | Conjunto de valores | Versión | Fuente |
| OrganizationAffiliation.language | Base | required | All Languages | 📍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 |
| Id | Nivel | Ruta(s) | Descripción | Expresión |
| 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
| Nombre | Marcas | Card. | Tipo | Descripción y restricciones Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | OrganizationAffiliation | Relación entre organizaciones: contrato, compra de servicios o red de proveedores Constraints: cr-identificador-unico | ||||||
![]() ![]() |
Σ | 0..1 | id | Identificador lógico del recurso | ||||||
![]() ![]() |
Σ | 0..1 | Meta | Metadatos del recurso | ||||||
![]() ![]() |
?!Σ | 0..1 | uri | Reglas que rigen la interpretación del contenido del recurso | ||||||
![]() ![]() |
0..1 | code | Idioma del contenido del recurso Vinculación: AllLanguages (required): Etiqueta de idioma para un lenguaje humano, conforme a IETF BCP 47.
| |||||||
![]() ![]() |
0..1 | Narrative | Resumen narrativo del recurso para su interpretación humana Este perfil no restringe el contenido de la narrativa, su idioma ni su correspondencia con los elementos de datos | |||||||
![]() ![]() |
0..* | Resource | Recursos contenidos en línea | |||||||
![]() ![]() |
0..* | Extension | Contenido adicional definido por las implementaciones | |||||||
![]() ![]() |
?!Σ | 0..* | Extension | Extensiones modificadoras que no deben ignorarse, aunque no se reconozcan | ||||||
![]() ![]() |
SΣC | 0..* | Identifier | Número del contrato o convenio Constraints: cr-convenio-system | ||||||
![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() |
?!Σ | 0..1 | code | official (valor fijo) Vinculación: IdentifierUse (required): Identifies the purpose for this identifier, if known . Patrón requerido: official | ||||||
![]() ![]() ![]() |
Σ | 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. | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | uri | https://hl7.or.cr/fhir/sid/convenio/{código del establecimiento de la organización principal} Ejemplo General: http://www.acme.com/identifiers/patient | ||||||
![]() ![]() ![]() |
SΣC | 1..1 | string | Número del contrato o convenio Ejemplo General: 123456 Longitud máxima:64 | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Period | Time period when id is/was valid for use | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text) | ||||||
![]() ![]() |
SΣ | 1..1 | boolean | Si la relación está activa para uso y publicación actual | ||||||
![]() ![]() |
SΣ | 0..1 | Period | Vigencia del contrato o convenio | ||||||
![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Inicio | ||||||
![]() ![]() ![]() |
SΣC | 0..1 | dateTime | Vencimiento | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización principal: para quien se presta el servicio o que contrata | ||||||
![]() ![]() |
SΣ | 1..1 | Reference(Organización) | Organización participante: la que opera o presta el servicio | ||||||
![]() ![]() |
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. | ||||||
![]() ![]() ![]() |
SΣ | 1..* | CodeableConcept | provider | diagnostics | supplier | payer | agency | research | HIE/HIO | member Vinculación: OrganizationAffiliationRole (required) | ||||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() |
Σ | 0..* | Coding | Code defined by a terminology system | ||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: http://hl7.org/fhir/organization-role | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Version of the system - if relevant | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | code | Symbol in syntax defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | string | Representation defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | boolean | If this coding was chosen directly by the user | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Plain text representation of the concept | ||||||
![]() ![]() ![]() |
SΣ | 0..1 | CodeableConcept | administracion-contrato | compra-servicios | red-proveedores Vinculación: Tipos de relación entre organizaciones (required) | ||||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() |
Σ | 0..* | Coding | Code defined by a terminology system | ||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | uri | Sistema de códigos del slice (valor fijo) Patrón requerido: https://hl7.or.cr/fhir/terminology/CodeSystem/cr-tipo-relacion-organizacion | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Version of the system - if relevant | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | code | Symbol in syntax defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
ΣC | 0..1 | string | Representation defined by the system | ||||||
![]() ![]() ![]() ![]() ![]() |
Σ | 0..1 | boolean | If this coding was chosen directly by the user | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | string | Plain text representation of the concept | ||||||
![]() ![]() |
SΣ | 0..* | CodeableConcept | Especialidades que cubre la relación Vinculación: Especialidades en salud (extensible) | ||||||
![]() ![]() |
SΣ | 0..* | Reference(Ubicación) | Ubicaciones físicas donde aplica la relación | ||||||
![]() ![]() |
0..* | Reference(HealthcareService) | Healthcare services provided through the role | |||||||
![]() ![]() |
SC | 0..* | ExtendedContactDetail | Contacto de trabajo para los asuntos de la relación Constraints: org-3, org-4 | ||||||
![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() |
Σ | 0..1 | CodeableConcept | The type of contact Vinculación: Contact entity type (preferred): The purpose for which an extended contact detail should be used. | ||||||
![]() ![]() ![]() |
Σ | 0..* | HumanName | Name of an individual to contact | ||||||
![]() ![]() ![]() |
SΣC | 0..* | ContactPoint | Teléfono (+506 y 8 dígitos) o correo electrónico Constraints: cr-telefono | ||||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Sin orden, Abierto by value:url | |||||||
![]() ![]() ![]() ![]() |
ΣC | 0..1 | code | phone | fax | email | pager | url | sms | other Vinculación: ContactPointSystem (required): Telecommunications form for contact point. | ||||||
![]() ![]() ![]() ![]() |
ΣC | 0..1 | string | The actual contact point details | ||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..1 | code | work (valor fijo) Vinculación: ContactPointUse (required): Use of contact point. Patrón requerido: work | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | positiveInt | Specify preferred order of use (1 = highest) | ||||||
![]() ![]() ![]() ![]() |
Σ | 0..1 | Period | Time period when the contact point was/is in use | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Address | Address for the contact | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Reference(Organization) | This contact detail is handled/monitored by a specific organization | ||||||
![]() ![]() ![]() |
Σ | 0..1 | Period | Period that this contact was valid for usage | ||||||
![]() ![]() |
0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for this role | |||||||
Documentación de este formato | ||||||||||
| Ruta | Estado | Uso | Conjunto de valores | 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 |
| Id | Nivel | Ruta(s) | Descripción | Expresión |
| 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 | buena práctica | 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)
Debe dar soporte a: 16 elementos
Prohibidos: 1 elemento
Estructuras
Esta estructura hace referencia a estas otras estructuras:
Slices
Esta estructura define los siguientes slices:
Maturity: 0
Otras representaciones de perfil: CSV, Excel, Schematron
Registro de establecimientos. Relaciones entre organizaciones: administración por contrato, compra de servicios y redes de proveedores.
OrganizationAffiliation registra una relación o asociación no jerárquica entre dos organizaciones. Puede describir un contrato, una prestación de servicios o una membresía de red, pero el recurso no reemplaza el contrato ni prueba su vigencia jurídica. La jerarquía institucional se expresa en Organization.partOf.
El rol estándar HIE/HIO se conserva como código HL7 posible en code[rol], pero Core no define por él la autorización, los endpoints o los requisitos de conexión. Esas reglas corresponden a la IG CR HIE.
FHIR R5 tiene un elemento OrganizationAffiliation.network que identifica la red donde la organización participante ofrece sus servicios. El perfil Core lo prohíbe para seguir IHE mCSD. Una relación de red de proveedores se expresa como afiliación par a par con la red en organization, la entidad en participatingOrganization, su función HL7 (por ejemplo diagnostics o member) y tipoRelacion = red-proveedores cuando aplique. Un caso que necesite declarar una red adicional distinta del par debe justificar un perfil derivado.
Organization.partOf se usa solo para la jerarquía estructural estable. OrganizationAffiliation representa un acuerdo entre organizaciones independientes, potencialmente temporal. Por ejemplo, un área de salud puede seguir siendo parte de la CCSS y, a la vez, ser operada por una cooperativa mediante una afiliación; una compra de servicios y una red de proveedores tampoco son jerarquías.
La afiliación describe el acuerdo y no reemplaza la identidad de la oferta o del espacio. En administración por contrato, el área de salud principal conserva su HealthcareService.providedBy y Location.managingOrganization; la cooperativa queda como operadora en la afiliación. En compra de servicios, el prestador participante publica su propio servicio y sus propias ubicaciones; la afiliación delimita para quién aplica el acuerdo.
Los slices de OrganizationAffiliation.code separan rol y tipoRelacion: el primero usa el catálogo HL7 para decir qué hace la organización participante; el segundo usa el catálogo CR para decir qué acuerdo las vincula. No son codificaciones equivalentes y por eso no se combinan como codings de un mismo concepto. No se usa una extensión porque el elemento nativo repetible code expresa ambos conceptos.
active indica si la relación está disponible para uso y publicación actual en el directorio. period conserva el intervalo contractual o histórico; una rescisión anticipada deja la relación inactiva sin borrar su periodo. La verificación jurídica requiere el contrato o fuente correspondiente.
Ver también Servicios del HIE.
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
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 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/_searchcuerpo: 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
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
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."
}
]
}
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\""
}
}
]
}