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

Guía de Implementación Core de Costa Rica - Versión en desarrollo (v0.1.0): borrador de trabajo de la Iniciativa HL7® Costa Rica, que puede cambiar sin aviso.

Modelo lógico: Modelo Lógico de la Relación entre Organizaciones - Descripciones detalladas

Estado de las normas de la página: Draft

Definiciones del cr-lm-relacion-organizaciones modelo lógico.

Las indicaciones para interpretar el contenido de esta tabla estánaquí

0. CRLMRelacionOrganizaciones
Definición

Relación formal entre dos organizaciones que no es de jerarquía: un contrato, un convenio o la pertenencia a una red de proveedores. Se modela con el recurso OrganizationAffiliation de FHIR R5 y forma parte del registro de establecimientos de OpenHIE (IHE mCSD).


Base definition for all types defined in FHIR type system.

ResumenModelo Lógico de la Relación entre OrganizacionesBase for all types and resources
Control0..*
Es modificadorfalse
Modelo lógicoLas instancias de este modelo lógico no están marcadas como destino de una referencia
2. CRLMRelacionOrganizaciones.identificacion
Definición

Número del contrato o convenio que formaliza la relación.

ResumenNúmero del contrato o convenio que formaliza la relación
Comentarios

Regla de negocio: Opcional. Lo asigna la organización principal (por ejemplo, el número de contrato de la CCSS con la cooperativa).

Regla de validación: No puede haber dos ocurrencias con el mismo establecimiento y número. Invariante cr-identificador-unico (compartida por la ubicación, el rol, el servicio y la relación entre organizaciones): `identifier.select(system & '

Control0..*
TipoBackboneElement
Requisitos

Permite citar el contrato o convenio concreto que respalda la relación, por ejemplo al conciliar la facturación entre la CCSS y un proveedor. Es opcional porque no todas las relaciones tienen un número formal.

Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. CRLMRelacionOrganizaciones.identificacion.id
Definición

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

ResumenUnique id for inter-element referencing
Control0..1
Este elemento está afectado por las siguientes invariantes: ele-1
Tipoidstring
Es modificadorfalse
Formato XMLEn el formato XML, esta propiedad se representa como un atributo.
Resumenfalse
6. CRLMRelacionOrganizaciones.identificacion.extension
Definición

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

ResumenAdditional content defined by implementations
Comentarios

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TipoExtension
Es modificadorfalse
Resumenfalse
Nombres alternativosextensions, user content
Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
SlicingEste elemento introduce un conjunto de slices en CRLMRelacionOrganizaciones.identificacion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
  • value @ url
  • 8. CRLMRelacionOrganizaciones.identificacion.modifierExtension
    Definición

    May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

    Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

    ResumenExtensions that cannot be ignored even if unrecognized
    Comentarios

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TipoExtension
    Es modificadortrue porque Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
    Resumentrue
    Requisitos

    Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

    Nombres alternativosextensions, user content, modifiers
    Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    10. CRLMRelacionOrganizaciones.identificacion.numero
    Definición

    Número del contrato o convenio, tal como lo registra la organización principal.

    ResumenNúmero del contrato o convenio, tal como lo registra la organización principal
    Comentarios

    Regla de validación: De 1 a 64 caracteres.

    Control1..1
    Tipostring
    Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
    Requisitos

    Es el número con que la organización principal registra el contrato o convenio.

    12. CRLMRelacionOrganizaciones.identificacion.establecimiento
    Definición

    Código de la organización que asignó el número.

    ResumenCódigo de la organización que asignó el número
    Comentarios

    Regla de negocio: Es el codigo-establecimiento de la organización principal o, si es una unidad sin identificador propio, el de su organización superior. Si la organización principal no asigna expedientes y no tiene código de establecimiento (por ejemplo, una aseguradora), se usa cj- + su cédula jurídica.

    Regla de validación: Invariante cr-convenio-system: 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})$').

    Control1..1
    Tipostring
    Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
    Requisitos

    Cada organización numera sus contratos por su cuenta. El establecimiento hace único el número y dice a quién pedir el contrato.

    14. CRLMRelacionOrganizaciones.vigencia
    Definición

    Periodo del contrato o convenio.

    ResumenPeriodo del contrato o convenio
    Comentarios

    Regla de negocio: Al renovarse un contrato con otro número o condiciones, se registra una relación nueva y la anterior se cierra; si se prorroga el mismo contrato, se extiende la fecha de fin.

    Regla de validación: Si hay fecha de inicio y de fin, el inicio no puede ser posterior al fin. No puede haber dos relaciones activas con las mismas organizaciones, el mismo tipo de relación y periodos que se traslapen.

    Control0..1
    TipoBackboneElement
    Requisitos

    Dice si la relación estaba vigente en una fecha dada, por ejemplo si la cooperativa operaba el área de salud el día de una atención.

    Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    16. CRLMRelacionOrganizaciones.vigencia.id
    Definición

    Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

    ResumenUnique id for inter-element referencing
    Control0..1
    Este elemento está afectado por las siguientes invariantes: ele-1
    Tipoidstring
    Es modificadorfalse
    Formato XMLEn el formato XML, esta propiedad se representa como un atributo.
    Resumenfalse
    18. CRLMRelacionOrganizaciones.vigencia.extension
    Definición

    May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

    ResumenAdditional content defined by implementations
    Comentarios

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TipoExtension
    Es modificadorfalse
    Resumenfalse
    Nombres alternativosextensions, user content
    Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    SlicingEste elemento introduce un conjunto de slices en CRLMRelacionOrganizaciones.vigencia.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
    • value @ url
    • 20. CRLMRelacionOrganizaciones.vigencia.modifierExtension
      Definición

      May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

      Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

      ResumenExtensions that cannot be ignored even if unrecognized
      Comentarios

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TipoExtension
      Es modificadortrue porque Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
      Resumentrue
      Requisitos

      Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

      Nombres alternativosextensions, user content, modifiers
      Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
      22. CRLMRelacionOrganizaciones.vigencia.inicio
      Definición

      Fecha de inicio del contrato o convenio.

      ResumenFecha de inicio del contrato o convenio
      Control0..1
      Tipodate
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Marca desde cuándo rige el contrato o convenio.

      24. CRLMRelacionOrganizaciones.vigencia.fin
      Definición

      Fecha de vencimiento del contrato o convenio.

      ResumenFecha de vencimiento del contrato o convenio
      Control0..1
      Tipodate
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Marca cuándo vence el contrato o convenio.

      26. CRLMRelacionOrganizaciones.organizacionPrincipal
      Definición

      Organización para la cual se presta el servicio o que contrata: la que es responsable ante el paciente o el asegurado.

      ResumenOrganización para la cual se presta el servicio o que contrata
      Comentarios

      Regla de negocio: Obligatoria. Es la organización más específica que corresponda: en la administración por contrato, el área de salud que se administra, no la CCSS; en la compra de servicios, la unidad que contrata; en una red de proveedores, la aseguradora.

      Regla de validación: Referencia a un Organization que cumpla el modelo de organización. Debe ser distinta de la organización participante. Si el tipo de relación es red-proveedores, su categoria debe incluir ins (aseguradora) o pay (pagador).

      Comentarios: Que las dos organizaciones sean distintas y que la aseguradora tenga la categoría correcta se valida en el servidor, porque hay que resolver las referencias.

      Control1..1
      TipoReference(Modelo Lógico de la Organización)
      Requisitos

      Es quien responde ante el paciente o el asegurado. Sin ella no se sabe para quién se presta el servicio ni a quién pertenecen los expedientes.

      28. CRLMRelacionOrganizaciones.organizacionParticipante
      Definición

      Organización que opera o presta el servicio para la organización principal.

      ResumenOrganización que opera o presta el servicio para la organización principal
      Comentarios

      Regla de negocio: Obligatoria. En la administración por contrato, la cooperativa o el proveedor que opera el área de salud; en la compra de servicios y en las redes de proveedores, el establecimiento que presta el servicio. Debe ser una organización independiente de la principal: una unidad de la misma institución no se relaciona por contrato, sino por partOf.

      Regla de validación: Referencia a un Organization activo que cumpla el modelo de organización, con identificador propio (cédula jurídica o código de establecimiento).

      Control1..1
      TipoReference(Modelo Lógico de la Organización)
      Requisitos

      Es quien opera o presta el servicio. Permite saber, por ejemplo, qué cooperativa administra un área de salud o a qué centro privado le compra estudios la CCSS.

      30. CRLMRelacionOrganizaciones.rol
      Definición

      Qué hace la organización participante para la principal. Valores: 1. Prestador de servicios de salud (provider) 2. Servicios de diagnóstico (diagnostics) 3. Proveedor de insumos (supplier) 4. Pagador (payer) 5. Agencia (agency) 6. Investigación (research) 7. Intercambio de información en salud (HIE/HIO) 8. Miembro (member)

      ResumenQué hace la organización participante para la principal
      Comentarios

      Regla de negocio: Obligatorio. Un participante puede tener varios roles en la misma relación (por ejemplo, un hospital privado que presta consulta y servicios de diagnóstico a una aseguradora).

      Regla de validación: Debe pertenecer al ValueSet HL7 rol de la organización.

      Control1..*
      VinculaciónLos códigos DEBEN tomarse de OrganizationAffiliationRole
      (required to http://hl7.org/fhir/ValueSet/organization-role)
      TipoCodeableConcept
      Requisitos

      Dice qué hace la participante para la principal (prestar servicios, diagnóstico, insumos), con el catálogo de HL7 que usa IHE mCSD para buscar relaciones.

      32. CRLMRelacionOrganizaciones.tipoRelacion
      Definición

      Naturaleza del acuerdo entre las dos organizaciones. Valores: 1. Administración por contrato (administracion-contrato) 2. Compra de servicios (compra-servicios) 3. Red de proveedores (red-proveedores)

      ResumenNaturaleza del acuerdo entre las dos organizaciones
      Comentarios

      Regla de negocio: Administración por contrato: la participante administra y opera establecimientos de la principal (por ejemplo, una cooperativa que administra un área de salud de la CCSS). Los pacientes, los expedientes y la responsabilidad siguen siendo de la principal. Compra de servicios: la principal compra servicios puntuales a la participante (estudios, cirugías, análisis); cada servicio lo presta y documenta la participante. Red de proveedores: la participante está habilitada para atender a los asegurados de la principal (una aseguradora).

      Regla de validación: Debe pertenecer al catálogo tipo de relación entre organizaciones. Si el acuerdo es de otro tipo, no se registra este dato: la relación lleva solo el rol de HL7 y el nombre del acuerdo en su texto.

      Comentarios: El HL7 organization-role dice qué hace la participante, pero no qué tipo de acuerdo la une a la principal; para eso hace falta el catálogo CR. Se empieza con estos tres tipos (pregunta 1).

      Control0..1
      VinculaciónLos códigos DEBEN tomarse de Tipos de relación entre organizaciones
      (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-tipo-relacion-organizacion)
      TipoCodeableConcept
      Requisitos

      El rol no dice qué acuerdo une a las dos organizaciones. El tipo distingue la administración por contrato, la compra de servicios y la red de proveedores, que tienen consecuencias distintas sobre quién responde (decisión 1).

      34. CRLMRelacionOrganizaciones.especialidad
      Definición

      Especialidades que cubre la relación (por ejemplo, la CCSS compra cirugías de ortopedia a un hospital privado).

      ResumenEspecialidades que cubre la relación
      Comentarios

      Regla de negocio: Opcional. Si no se registra, la relación cubre todos los servicios del rol.

      Regla de validación: Debe pertenecer al catálogo especialidad en salud.

      Comentarios: El catálogo está pendiente de los colegios profesionales (pregunta 4 del profesional de salud).

      Control0..*
      VinculaciónSalvo que no sean adecuados, estos códigos DEBEN tomarse de Especialidades en salud
      (extensible to https://hl7.or.cr/fhir/terminology/ValueSet/cr-especialidad-salud)
      TipoCodeableConcept
      Requisitos

      Acota la relación a ciertas especialidades, por ejemplo cuando la CCSS compra solo cirugías de ortopedia a un hospital privado.

      36. CRLMRelacionOrganizaciones.ubicacion
      Definición

      Sedes o servicios donde aplica la relación.

      ResumenSedes o servicios donde aplica la relación
      Comentarios

      Regla de negocio: En la administración por contrato, las sedes que opera la participante (las de los EBAIS del área de salud); en la compra de servicios y en las redes de proveedores, las sedes de la participante donde se presta el servicio. Si no se registra, aplica en todas las ubicaciones de la participante.

      Regla de validación: Referencias a Location que cumplan el modelo de ubicación.

      Control0..*
      TipoReference(Modelo Lógico de la Ubicación)
      Requisitos

      Acota la relación a las sedes donde aplica, por ejemplo los EBAIS que opera una cooperativa.

      38. CRLMRelacionOrganizaciones.telefono
      Definición

      Teléfono de contacto para asuntos de la relación (por ejemplo, la administración del contrato).

      ResumenTeléfono de contacto para asuntos de la relación
      Comentarios

      Regla de negocio: Opcional.

      Regla de validación: Igual que en el paciente.

      Control0..*
      Tipostring
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Permite contactar a quien administra el contrato o convenio.

      40. CRLMRelacionOrganizaciones.correoElectronico
      Definición

      Correo de contacto para asuntos de la relación.

      ResumenCorreo de contacto para asuntos de la relación
      Comentarios

      Regla de negocio: Opcional.

      Regla de validación: Igual que en el paciente.

      Control0..*
      Tipostring
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Sirve para las comunicaciones formales sobre el contrato o convenio.

      Las indicaciones para interpretar el contenido de esta tabla estánaquí

      0. CRLMRelacionOrganizaciones
      Definición

      Relación formal entre dos organizaciones que no es de jerarquía: un contrato, un convenio o la pertenencia a una red de proveedores. Se modela con el recurso OrganizationAffiliation de FHIR R5 y forma parte del registro de establecimientos de OpenHIE (IHE mCSD).

      ResumenModelo Lógico de la Relación entre Organizaciones
      Modelo lógicoLas instancias de este modelo lógico no están marcadas como destino de una referencia
      2. CRLMRelacionOrganizaciones.identificacion
      Definición

      Número del contrato o convenio que formaliza la relación.

      ResumenNúmero del contrato o convenio que formaliza la relación
      Comentarios

      Regla de negocio: Opcional. Lo asigna la organización principal (por ejemplo, el número de contrato de la CCSS con la cooperativa).

      Regla de validación: No puede haber dos ocurrencias con el mismo establecimiento y número. Invariante cr-identificador-unico (compartida por la ubicación, el rol, el servicio y la relación entre organizaciones): `identifier.select(system & '

      Control0..*
      TipoBackboneElement
      Requisitos

      Permite citar el contrato o convenio concreto que respalda la relación, por ejemplo al conciliar la facturación entre la CCSS y un proveedor. Es opcional porque no todas las relaciones tienen un número formal.

      4. CRLMRelacionOrganizaciones.identificacion.numero
      Definición

      Número del contrato o convenio, tal como lo registra la organización principal.

      ResumenNúmero del contrato o convenio, tal como lo registra la organización principal
      Comentarios

      Regla de validación: De 1 a 64 caracteres.

      Control1..1
      Tipostring
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Es el número con que la organización principal registra el contrato o convenio.

      6. CRLMRelacionOrganizaciones.identificacion.establecimiento
      Definición

      Código de la organización que asignó el número.

      ResumenCódigo de la organización que asignó el número
      Comentarios

      Regla de negocio: Es el codigo-establecimiento de la organización principal o, si es una unidad sin identificador propio, el de su organización superior. Si la organización principal no asigna expedientes y no tiene código de establecimiento (por ejemplo, una aseguradora), se usa cj- + su cédula jurídica.

      Regla de validación: Invariante cr-convenio-system: 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})$').

      Control1..1
      Tipostring
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Cada organización numera sus contratos por su cuenta. El establecimiento hace único el número y dice a quién pedir el contrato.

      8. CRLMRelacionOrganizaciones.vigencia
      Definición

      Periodo del contrato o convenio.

      ResumenPeriodo del contrato o convenio
      Comentarios

      Regla de negocio: Al renovarse un contrato con otro número o condiciones, se registra una relación nueva y la anterior se cierra; si se prorroga el mismo contrato, se extiende la fecha de fin.

      Regla de validación: Si hay fecha de inicio y de fin, el inicio no puede ser posterior al fin. No puede haber dos relaciones activas con las mismas organizaciones, el mismo tipo de relación y periodos que se traslapen.

      Control0..1
      TipoBackboneElement
      Requisitos

      Dice si la relación estaba vigente en una fecha dada, por ejemplo si la cooperativa operaba el área de salud el día de una atención.

      10. CRLMRelacionOrganizaciones.vigencia.inicio
      Definición

      Fecha de inicio del contrato o convenio.

      ResumenFecha de inicio del contrato o convenio
      Control0..1
      Tipodate
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Marca desde cuándo rige el contrato o convenio.

      12. CRLMRelacionOrganizaciones.vigencia.fin
      Definición

      Fecha de vencimiento del contrato o convenio.

      ResumenFecha de vencimiento del contrato o convenio
      Control0..1
      Tipodate
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Marca cuándo vence el contrato o convenio.

      14. CRLMRelacionOrganizaciones.organizacionPrincipal
      Definición

      Organización para la cual se presta el servicio o que contrata: la que es responsable ante el paciente o el asegurado.

      ResumenOrganización para la cual se presta el servicio o que contrata
      Comentarios

      Regla de negocio: Obligatoria. Es la organización más específica que corresponda: en la administración por contrato, el área de salud que se administra, no la CCSS; en la compra de servicios, la unidad que contrata; en una red de proveedores, la aseguradora.

      Regla de validación: Referencia a un Organization que cumpla el modelo de organización. Debe ser distinta de la organización participante. Si el tipo de relación es red-proveedores, su categoria debe incluir ins (aseguradora) o pay (pagador).

      Comentarios: Que las dos organizaciones sean distintas y que la aseguradora tenga la categoría correcta se valida en el servidor, porque hay que resolver las referencias.

      Control1..1
      TipoReference(Modelo Lógico de la Organización)
      Requisitos

      Es quien responde ante el paciente o el asegurado. Sin ella no se sabe para quién se presta el servicio ni a quién pertenecen los expedientes.

      16. CRLMRelacionOrganizaciones.organizacionParticipante
      Definición

      Organización que opera o presta el servicio para la organización principal.

      ResumenOrganización que opera o presta el servicio para la organización principal
      Comentarios

      Regla de negocio: Obligatoria. En la administración por contrato, la cooperativa o el proveedor que opera el área de salud; en la compra de servicios y en las redes de proveedores, el establecimiento que presta el servicio. Debe ser una organización independiente de la principal: una unidad de la misma institución no se relaciona por contrato, sino por partOf.

      Regla de validación: Referencia a un Organization activo que cumpla el modelo de organización, con identificador propio (cédula jurídica o código de establecimiento).

      Control1..1
      TipoReference(Modelo Lógico de la Organización)
      Requisitos

      Es quien opera o presta el servicio. Permite saber, por ejemplo, qué cooperativa administra un área de salud o a qué centro privado le compra estudios la CCSS.

      18. CRLMRelacionOrganizaciones.rol
      Definición

      Qué hace la organización participante para la principal. Valores: 1. Prestador de servicios de salud (provider) 2. Servicios de diagnóstico (diagnostics) 3. Proveedor de insumos (supplier) 4. Pagador (payer) 5. Agencia (agency) 6. Investigación (research) 7. Intercambio de información en salud (HIE/HIO) 8. Miembro (member)

      ResumenQué hace la organización participante para la principal
      Comentarios

      Regla de negocio: Obligatorio. Un participante puede tener varios roles en la misma relación (por ejemplo, un hospital privado que presta consulta y servicios de diagnóstico a una aseguradora).

      Regla de validación: Debe pertenecer al ValueSet HL7 rol de la organización.

      Control1..*
      VinculaciónLos códigos DEBEN tomarse de OrganizationAffiliationRole
      (required to http://hl7.org/fhir/ValueSet/organization-role)
      TipoCodeableConcept
      Requisitos

      Dice qué hace la participante para la principal (prestar servicios, diagnóstico, insumos), con el catálogo de HL7 que usa IHE mCSD para buscar relaciones.

      20. CRLMRelacionOrganizaciones.tipoRelacion
      Definición

      Naturaleza del acuerdo entre las dos organizaciones. Valores: 1. Administración por contrato (administracion-contrato) 2. Compra de servicios (compra-servicios) 3. Red de proveedores (red-proveedores)

      ResumenNaturaleza del acuerdo entre las dos organizaciones
      Comentarios

      Regla de negocio: Administración por contrato: la participante administra y opera establecimientos de la principal (por ejemplo, una cooperativa que administra un área de salud de la CCSS). Los pacientes, los expedientes y la responsabilidad siguen siendo de la principal. Compra de servicios: la principal compra servicios puntuales a la participante (estudios, cirugías, análisis); cada servicio lo presta y documenta la participante. Red de proveedores: la participante está habilitada para atender a los asegurados de la principal (una aseguradora).

      Regla de validación: Debe pertenecer al catálogo tipo de relación entre organizaciones. Si el acuerdo es de otro tipo, no se registra este dato: la relación lleva solo el rol de HL7 y el nombre del acuerdo en su texto.

      Comentarios: El HL7 organization-role dice qué hace la participante, pero no qué tipo de acuerdo la une a la principal; para eso hace falta el catálogo CR. Se empieza con estos tres tipos (pregunta 1).

      Control0..1
      VinculaciónLos códigos DEBEN tomarse de Tipos de relación entre organizaciones
      (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-tipo-relacion-organizacion)
      TipoCodeableConcept
      Requisitos

      El rol no dice qué acuerdo une a las dos organizaciones. El tipo distingue la administración por contrato, la compra de servicios y la red de proveedores, que tienen consecuencias distintas sobre quién responde (decisión 1).

      22. CRLMRelacionOrganizaciones.especialidad
      Definición

      Especialidades que cubre la relación (por ejemplo, la CCSS compra cirugías de ortopedia a un hospital privado).

      ResumenEspecialidades que cubre la relación
      Comentarios

      Regla de negocio: Opcional. Si no se registra, la relación cubre todos los servicios del rol.

      Regla de validación: Debe pertenecer al catálogo especialidad en salud.

      Comentarios: El catálogo está pendiente de los colegios profesionales (pregunta 4 del profesional de salud).

      Control0..*
      VinculaciónSalvo que no sean adecuados, estos códigos DEBEN tomarse de Especialidades en salud
      (extensible to https://hl7.or.cr/fhir/terminology/ValueSet/cr-especialidad-salud)
      TipoCodeableConcept
      Requisitos

      Acota la relación a ciertas especialidades, por ejemplo cuando la CCSS compra solo cirugías de ortopedia a un hospital privado.

      24. CRLMRelacionOrganizaciones.ubicacion
      Definición

      Sedes o servicios donde aplica la relación.

      ResumenSedes o servicios donde aplica la relación
      Comentarios

      Regla de negocio: En la administración por contrato, las sedes que opera la participante (las de los EBAIS del área de salud); en la compra de servicios y en las redes de proveedores, las sedes de la participante donde se presta el servicio. Si no se registra, aplica en todas las ubicaciones de la participante.

      Regla de validación: Referencias a Location que cumplan el modelo de ubicación.

      Control0..*
      TipoReference(Modelo Lógico de la Ubicación)
      Requisitos

      Acota la relación a las sedes donde aplica, por ejemplo los EBAIS que opera una cooperativa.

      26. CRLMRelacionOrganizaciones.telefono
      Definición

      Teléfono de contacto para asuntos de la relación (por ejemplo, la administración del contrato).

      ResumenTeléfono de contacto para asuntos de la relación
      Comentarios

      Regla de negocio: Opcional.

      Regla de validación: Igual que en el paciente.

      Control0..*
      Tipostring
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Permite contactar a quien administra el contrato o convenio.

      28. CRLMRelacionOrganizaciones.correoElectronico
      Definición

      Correo de contacto para asuntos de la relación.

      ResumenCorreo de contacto para asuntos de la relación
      Comentarios

      Regla de negocio: Opcional.

      Regla de validación: Igual que en el paciente.

      Control0..*
      Tipostring
      Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
      Requisitos

      Sirve para las comunicaciones formales sobre el contrato o convenio.

      Las indicaciones para interpretar el contenido de esta tabla estánaquí

      0. CRLMRelacionOrganizaciones
      Definición

      Relación formal entre dos organizaciones que no es de jerarquía: un contrato, un convenio o la pertenencia a una red de proveedores. Se modela con el recurso OrganizationAffiliation de FHIR R5 y forma parte del registro de establecimientos de OpenHIE (IHE mCSD).

      ResumenModelo Lógico de la Relación entre Organizaciones
      Control0..*
      Es modificadorfalse
      Modelo lógicoLas instancias de este modelo lógico no están marcadas como destino de una referencia
      2. CRLMRelacionOrganizaciones.identificacion
      Definición

      Número del contrato o convenio que formaliza la relación.

      ResumenNúmero del contrato o convenio que formaliza la relación
      Comentarios

      Regla de negocio: Opcional. Lo asigna la organización principal (por ejemplo, el número de contrato de la CCSS con la cooperativa).

      Regla de validación: No puede haber dos ocurrencias con el mismo establecimiento y número. Invariante cr-identificador-unico (compartida por la ubicación, el rol, el servicio y la relación entre organizaciones): `identifier.select(system & '

      Control0..*
      TipoBackboneElement
      Requisitos

      Permite citar el contrato o convenio concreto que respalda la relación, por ejemplo al conciliar la facturación entre la CCSS y un proveedor. Es opcional porque no todas las relaciones tienen un número formal.

      Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      4. CRLMRelacionOrganizaciones.identificacion.id
      Definición

      Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

      ResumenUnique id for inter-element referencing
      Control0..1
      Este elemento está afectado por las siguientes invariantes: ele-1
      Tipoid
      Es modificadorfalse
      Formato XMLEn el formato XML, esta propiedad se representa como un atributo.
      Resumenfalse
      6. CRLMRelacionOrganizaciones.identificacion.extension
      Definición

      May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

      ResumenAdditional content defined by implementations
      Comentarios

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TipoExtension
      Es modificadorfalse
      Resumenfalse
      Nombres alternativosextensions, user content
      Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
      SlicingEste elemento introduce un conjunto de slices en CRLMRelacionOrganizaciones.identificacion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
      • value @ url
      • 8. CRLMRelacionOrganizaciones.identificacion.modifierExtension
        Definición

        May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

        Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

        ResumenExtensions that cannot be ignored even if unrecognized
        Comentarios

        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

        Control0..*
        TipoExtension
        Es modificadortrue porque Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
        Resumentrue
        Requisitos

        Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

        Nombres alternativosextensions, user content, modifiers
        Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        10. CRLMRelacionOrganizaciones.identificacion.numero
        Definición

        Número del contrato o convenio, tal como lo registra la organización principal.

        ResumenNúmero del contrato o convenio, tal como lo registra la organización principal
        Comentarios

        Regla de validación: De 1 a 64 caracteres.

        Control1..1
        Tipostring
        Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
        Requisitos

        Es el número con que la organización principal registra el contrato o convenio.

        12. CRLMRelacionOrganizaciones.identificacion.establecimiento
        Definición

        Código de la organización que asignó el número.

        ResumenCódigo de la organización que asignó el número
        Comentarios

        Regla de negocio: Es el codigo-establecimiento de la organización principal o, si es una unidad sin identificador propio, el de su organización superior. Si la organización principal no asigna expedientes y no tiene código de establecimiento (por ejemplo, una aseguradora), se usa cj- + su cédula jurídica.

        Regla de validación: Invariante cr-convenio-system: 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})$').

        Control1..1
        Tipostring
        Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
        Requisitos

        Cada organización numera sus contratos por su cuenta. El establecimiento hace único el número y dice a quién pedir el contrato.

        14. CRLMRelacionOrganizaciones.vigencia
        Definición

        Periodo del contrato o convenio.

        ResumenPeriodo del contrato o convenio
        Comentarios

        Regla de negocio: Al renovarse un contrato con otro número o condiciones, se registra una relación nueva y la anterior se cierra; si se prorroga el mismo contrato, se extiende la fecha de fin.

        Regla de validación: Si hay fecha de inicio y de fin, el inicio no puede ser posterior al fin. No puede haber dos relaciones activas con las mismas organizaciones, el mismo tipo de relación y periodos que se traslapen.

        Control0..1
        TipoBackboneElement
        Requisitos

        Dice si la relación estaba vigente en una fecha dada, por ejemplo si la cooperativa operaba el área de salud el día de una atención.

        Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        16. CRLMRelacionOrganizaciones.vigencia.id
        Definición

        Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

        ResumenUnique id for inter-element referencing
        Control0..1
        Este elemento está afectado por las siguientes invariantes: ele-1
        Tipoid
        Es modificadorfalse
        Formato XMLEn el formato XML, esta propiedad se representa como un atributo.
        Resumenfalse
        18. CRLMRelacionOrganizaciones.vigencia.extension
        Definición

        May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

        ResumenAdditional content defined by implementations
        Comentarios

        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

        Control0..*
        TipoExtension
        Es modificadorfalse
        Resumenfalse
        Nombres alternativosextensions, user content
        Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        SlicingEste elemento introduce un conjunto de slices en CRLMRelacionOrganizaciones.vigencia.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
        • value @ url
        • 20. CRLMRelacionOrganizaciones.vigencia.modifierExtension
          Definición

          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

          ResumenExtensions that cannot be ignored even if unrecognized
          Comentarios

          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

          Control0..*
          TipoExtension
          Es modificadortrue porque Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
          Resumentrue
          Requisitos

          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

          Nombres alternativosextensions, user content, modifiers
          Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
          22. CRLMRelacionOrganizaciones.vigencia.inicio
          Definición

          Fecha de inicio del contrato o convenio.

          ResumenFecha de inicio del contrato o convenio
          Control0..1
          Tipodate
          Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
          Requisitos

          Marca desde cuándo rige el contrato o convenio.

          24. CRLMRelacionOrganizaciones.vigencia.fin
          Definición

          Fecha de vencimiento del contrato o convenio.

          ResumenFecha de vencimiento del contrato o convenio
          Control0..1
          Tipodate
          Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
          Requisitos

          Marca cuándo vence el contrato o convenio.

          26. CRLMRelacionOrganizaciones.organizacionPrincipal
          Definición

          Organización para la cual se presta el servicio o que contrata: la que es responsable ante el paciente o el asegurado.

          ResumenOrganización para la cual se presta el servicio o que contrata
          Comentarios

          Regla de negocio: Obligatoria. Es la organización más específica que corresponda: en la administración por contrato, el área de salud que se administra, no la CCSS; en la compra de servicios, la unidad que contrata; en una red de proveedores, la aseguradora.

          Regla de validación: Referencia a un Organization que cumpla el modelo de organización. Debe ser distinta de la organización participante. Si el tipo de relación es red-proveedores, su categoria debe incluir ins (aseguradora) o pay (pagador).

          Comentarios: Que las dos organizaciones sean distintas y que la aseguradora tenga la categoría correcta se valida en el servidor, porque hay que resolver las referencias.

          Control1..1
          TipoReference(Modelo Lógico de la Organización)
          Requisitos

          Es quien responde ante el paciente o el asegurado. Sin ella no se sabe para quién se presta el servicio ni a quién pertenecen los expedientes.

          28. CRLMRelacionOrganizaciones.organizacionParticipante
          Definición

          Organización que opera o presta el servicio para la organización principal.

          ResumenOrganización que opera o presta el servicio para la organización principal
          Comentarios

          Regla de negocio: Obligatoria. En la administración por contrato, la cooperativa o el proveedor que opera el área de salud; en la compra de servicios y en las redes de proveedores, el establecimiento que presta el servicio. Debe ser una organización independiente de la principal: una unidad de la misma institución no se relaciona por contrato, sino por partOf.

          Regla de validación: Referencia a un Organization activo que cumpla el modelo de organización, con identificador propio (cédula jurídica o código de establecimiento).

          Control1..1
          TipoReference(Modelo Lógico de la Organización)
          Requisitos

          Es quien opera o presta el servicio. Permite saber, por ejemplo, qué cooperativa administra un área de salud o a qué centro privado le compra estudios la CCSS.

          30. CRLMRelacionOrganizaciones.rol
          Definición

          Qué hace la organización participante para la principal. Valores: 1. Prestador de servicios de salud (provider) 2. Servicios de diagnóstico (diagnostics) 3. Proveedor de insumos (supplier) 4. Pagador (payer) 5. Agencia (agency) 6. Investigación (research) 7. Intercambio de información en salud (HIE/HIO) 8. Miembro (member)

          ResumenQué hace la organización participante para la principal
          Comentarios

          Regla de negocio: Obligatorio. Un participante puede tener varios roles en la misma relación (por ejemplo, un hospital privado que presta consulta y servicios de diagnóstico a una aseguradora).

          Regla de validación: Debe pertenecer al ValueSet HL7 rol de la organización.

          Control1..*
          VinculaciónLos códigos DEBEN tomarse de OrganizationAffiliationRole
          (required to http://hl7.org/fhir/ValueSet/organization-role)
          TipoCodeableConcept
          Requisitos

          Dice qué hace la participante para la principal (prestar servicios, diagnóstico, insumos), con el catálogo de HL7 que usa IHE mCSD para buscar relaciones.

          32. CRLMRelacionOrganizaciones.tipoRelacion
          Definición

          Naturaleza del acuerdo entre las dos organizaciones. Valores: 1. Administración por contrato (administracion-contrato) 2. Compra de servicios (compra-servicios) 3. Red de proveedores (red-proveedores)

          ResumenNaturaleza del acuerdo entre las dos organizaciones
          Comentarios

          Regla de negocio: Administración por contrato: la participante administra y opera establecimientos de la principal (por ejemplo, una cooperativa que administra un área de salud de la CCSS). Los pacientes, los expedientes y la responsabilidad siguen siendo de la principal. Compra de servicios: la principal compra servicios puntuales a la participante (estudios, cirugías, análisis); cada servicio lo presta y documenta la participante. Red de proveedores: la participante está habilitada para atender a los asegurados de la principal (una aseguradora).

          Regla de validación: Debe pertenecer al catálogo tipo de relación entre organizaciones. Si el acuerdo es de otro tipo, no se registra este dato: la relación lleva solo el rol de HL7 y el nombre del acuerdo en su texto.

          Comentarios: El HL7 organization-role dice qué hace la participante, pero no qué tipo de acuerdo la une a la principal; para eso hace falta el catálogo CR. Se empieza con estos tres tipos (pregunta 1).

          Control0..1
          VinculaciónLos códigos DEBEN tomarse de Tipos de relación entre organizaciones
          (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-tipo-relacion-organizacion)
          TipoCodeableConcept
          Requisitos

          El rol no dice qué acuerdo une a las dos organizaciones. El tipo distingue la administración por contrato, la compra de servicios y la red de proveedores, que tienen consecuencias distintas sobre quién responde (decisión 1).

          34. CRLMRelacionOrganizaciones.especialidad
          Definición

          Especialidades que cubre la relación (por ejemplo, la CCSS compra cirugías de ortopedia a un hospital privado).

          ResumenEspecialidades que cubre la relación
          Comentarios

          Regla de negocio: Opcional. Si no se registra, la relación cubre todos los servicios del rol.

          Regla de validación: Debe pertenecer al catálogo especialidad en salud.

          Comentarios: El catálogo está pendiente de los colegios profesionales (pregunta 4 del profesional de salud).

          Control0..*
          VinculaciónSalvo que no sean adecuados, estos códigos DEBEN tomarse de Especialidades en salud
          (extensible to https://hl7.or.cr/fhir/terminology/ValueSet/cr-especialidad-salud)
          TipoCodeableConcept
          Requisitos

          Acota la relación a ciertas especialidades, por ejemplo cuando la CCSS compra solo cirugías de ortopedia a un hospital privado.

          36. CRLMRelacionOrganizaciones.ubicacion
          Definición

          Sedes o servicios donde aplica la relación.

          ResumenSedes o servicios donde aplica la relación
          Comentarios

          Regla de negocio: En la administración por contrato, las sedes que opera la participante (las de los EBAIS del área de salud); en la compra de servicios y en las redes de proveedores, las sedes de la participante donde se presta el servicio. Si no se registra, aplica en todas las ubicaciones de la participante.

          Regla de validación: Referencias a Location que cumplan el modelo de ubicación.

          Control0..*
          TipoReference(Modelo Lógico de la Ubicación)
          Requisitos

          Acota la relación a las sedes donde aplica, por ejemplo los EBAIS que opera una cooperativa.

          38. CRLMRelacionOrganizaciones.telefono
          Definición

          Teléfono de contacto para asuntos de la relación (por ejemplo, la administración del contrato).

          ResumenTeléfono de contacto para asuntos de la relación
          Comentarios

          Regla de negocio: Opcional.

          Regla de validación: Igual que en el paciente.

          Control0..*
          Tipostring
          Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
          Requisitos

          Permite contactar a quien administra el contrato o convenio.

          40. CRLMRelacionOrganizaciones.correoElectronico
          Definición

          Correo de contacto para asuntos de la relación.

          ResumenCorreo de contacto para asuntos de la relación
          Comentarios

          Regla de negocio: Opcional.

          Regla de validación: Igual que en el paciente.

          Control0..*
          Tipostring
          Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
          Requisitos

          Sirve para las comunicaciones formales sobre el contrato o convenio.