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 del Documento Clínico - Descripciones detalladas

Estado de las normas de la página: Draft

Definiciones del cr-lm-documento-clinico modelo lógico.

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

0. CRLMDocumentoClinico
Definición

Documento clínico de un paciente: un conjunto de información clínica que un autor reúne, un profesional valida y una organización custodia, y que se intercambia como una unidad. Ejemplos: un informe de imágenes médicas, un informe de laboratorio, una epicrisis, una referencia, una nota de consulta o el resumen del paciente.


Base definition for all types defined in FHIR type system.

ResumenModelo Lógico del Documento ClínicoBase 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. CRLMDocumentoClinico.identificacion
Definición

Identificador del documento, el mismo en todas sus versiones.

ResumenIdentificador del documento, el mismo en todas sus versiones
Comentarios

Regla de negocio: Obligatorio. Lo asigna el establecimiento que emite el documento y no cambia cuando se emite una versión nueva: cada versión se distingue por la versión del recurso (Composition.version, ver elementos propios del recurso) y por el identificador del Bundle.

Regla de validación: No puede haber dos documentos distintos con el mismo establecimiento y número.

Comentarios: Es el identificador con que la referencia a documento (DocumentReference, modelo siguiente) indexa el documento en el HIE.

Control1..1
TipoBackboneElement
Requisitos

Reúne todas las versiones de un documento: una corrección o una adenda lleva el mismo identificador, y así se sabe que es el mismo documento (decisión 7).

Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. CRLMDocumentoClinico.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. CRLMDocumentoClinico.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 CRLMDocumentoClinico.identificacion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
  • value @ url
  • 8. CRLMDocumentoClinico.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. CRLMDocumentoClinico.identificacion.numero
    Definición

    Número del documento en el sistema del establecimiento.

    ResumenNúmero del documento en el sistema del establecimiento
    Comentarios

    Regla de negocio: Lo define cada establecimiento.

    Regla de validación: De 1 a 64 caracteres, sin espacios (invariante común cr-codigo-interno-value).

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

    Es el número con que el sistema del establecimiento reconoce el documento.

    12. CRLMDocumentoClinico.identificacion.establecimiento
    Definición

    Código del establecimiento que asignó el número.

    ResumenCódigo del establecimiento que asignó el número
    Comentarios

    Regla de negocio: Es el codigo-establecimiento del custodio o, si es una unidad sin identificador propio, el de su organización superior.

    Regla de validación: Invariante cr-documento-system, sobre el identificador: system.matches('^https://hl7\\.or\\.cr/fhir/sid/documento/(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 establecimiento numera sus documentos por su cuenta. El establecimiento hace único el número, igual que en el expediente del paciente.

    14. CRLMDocumentoClinico.tipo
    Definición

    Clase de documento según LOINC: informe de imágenes, informe de laboratorio, epicrisis, referencia, nota de consulta, resumen del paciente, etc. (lista inicial en la sección 5).

    ResumenClase de documento según LOINC
    Comentarios

    Regla de negocio: Obligatorio. Cada guía de dominio fija el tipo de sus documentos (por ejemplo, la IG de imágenes médicas fija 18748-4).

    Regla de validación: Debe pertenecer al catálogo tipo de documento clínico.

    Comentarios: Se usa LOINC porque es lo que usan IPS, RACSEL e IHE. LOINC es de uso gratuito con aviso de copyright.

    Control1..1
    VinculaciónSalvo que no sean adecuados, estos códigos DEBEN tomarse de Tipo de documento clínico
    (extensible to https://hl7.or.cr/fhir/terminology/ValueSet/cr-tipo-documento-clinico)
    TipoCodeableConcept
    Requisitos

    Dice qué clase de documento es (informe de imágenes, epicrisis, referencia) con un código LOINC. Permite buscar, filtrar y aplicar a cada tipo las reglas de su guía de dominio.

    16. CRLMDocumentoClinico.titulo
    Definición

    Título del documento como lo ve quien lo lee: "Informe de resonancia magnética de rodilla derecha", "Epicrisis".

    ResumenTítulo del documento como lo ve quien lo lee
    Comentarios

    Regla de negocio: En español.

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

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

    Es lo que ve quien busca o abre el documento, más específico que el tipo, por ejemplo Informe de resonancia magnética de rodilla derecha.

    18. CRLMDocumentoClinico.paciente
    Definición

    Paciente del que trata el documento.

    ResumenPaciente del que trata el documento
    Comentarios

    Regla de negocio: Obligatorio y uno solo.

    Regla de validación: Referencia a un Patient que cumpla el modelo de paciente y que esté incluido en el Bundle.

    Control1..1
    TipoReference(Modelo Lógico del Paciente)
    Requisitos

    Un documento trata siempre de un paciente. Sin él no se puede ubicar el documento en su historia ni controlar quién lo puede ver.

    20. CRLMDocumentoClinico.atencion
    Definición

    Atención en que se generó el documento.

    ResumenAtención en que se generó el documento
    Comentarios

    Regla de negocio: Obligatoria cuando el documento resulta de una atención (informes, epicrisis, referencias, notas). No se registra en documentos que resumen varias atenciones, como el resumen del paciente. Cada guía de dominio puede hacerla obligatoria.

    Regla de validación: Referencia a un Encounter que cumpla el modelo de atención, del mismo paciente, incluido en el Bundle.

    Control0..1
    TipoReference(Modelo Lógico de la Atención)
    Requisitos

    Da el contexto en que se generó el documento: dónde, cuándo, de qué modalidad y con qué profesionales.

    22. CRLMDocumentoClinico.fecha
    Definición

    Momento en que el autor terminó de redactar esta versión del documento.

    ResumenMomento en que el autor terminó de redactar esta versión del documento
    Comentarios

    Regla de negocio: Obligatoria. No puede ser futura (invariante cr-documento-fecha-no-futura: $this {= now()) ni anterior al inicio de la atención (invariante cr-documento-fecha-atencion: encounter.exists() implies (encounter.resolve().actualPeriod.start.empty() or date }= encounter.resolve().actualPeriod.start), que el validador evalúa dentro del Bundle).

    Regla de validación: Fecha y hora con zona horaria (UTC−6 en Costa Rica). Invariante cr-documento-fecha-hora: toString().contains('T').

    Comentarios: No es la fecha de validación (dato validación) ni la del ensamblado del Bundle (Bundle.timestamp).

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

    Ubica el documento en la historia del paciente y dice cuándo se redactó esta versión.

    24. CRLMDocumentoClinico.autor
    Definición

    Quien redacta el documento.

    ResumenQuien redacta el documento
    Comentarios

    Regla de negocio: Un profesional, en su rol, cuando el documento lo redacta una persona. La organización, cuando lo genera un sistema sin intervención de un profesional (por ejemplo, el resumen del paciente que arma el HIE).

    Regla de validación: Referencia a un PractitionerRole, Practitioner u Organization que cumpla su modelo, incluido en el Bundle.

    Control1..*
    TipoReference(Modelo Lógico del Rol del Profesional, Modelo Lógico del Profesional de Salud, Modelo Lógico de la Organización)
    Requisitos

    Dice quién redactó el documento, un profesional en su rol o un sistema, para saber de quién es el contenido y a quién preguntar por él.

    26. CRLMDocumentoClinico.validacion
    Definición

    Quién valida el documento, de qué forma y cuándo.

    ResumenQuién valida el documento, de qué forma y cuándo
    Comentarios

    Regla de negocio: Un documento final, corrected o appended redactado por un profesional lleva la validación legal del profesional que responde por su contenido (el radiólogo que firma el informe, el médico que firma la epicrisis). Pueden agregarse otras: por ejemplo, la validación professional de un residente.

    Regla de validación: Invariante cr-documento-validacion-legal (error): status in ('final' | 'corrected' | 'appended') and author.all(resolve() is PractitionerRole or resolve() is Practitioner) implies attester.where(mode.coding.where(system = 'http://hl7.org/fhir/composition-attestation-mode' and code = 'legal').exists()).exists().

    Comentarios: Este dato dice quién responde por el documento; la firma digital de esa persona va en el Bundle (Bundle.signature, pregunta 1), no aquí.

    Control0..*
    TipoBackboneElement
    Requisitos

    Dice quién responde por el contenido. Sin la validación legal de un profesional, el documento no tiene valor clínico ni legal (principio de responsabilidad).

    Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    28. CRLMDocumentoClinico.validacion.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
    30. CRLMDocumentoClinico.validacion.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 CRLMDocumentoClinico.validacion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
    • value @ url
    • 32. CRLMDocumentoClinico.validacion.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())
      34. CRLMDocumentoClinico.validacion.modo
      Definición

      Forma de la validación: 1. Legal (legal): el profesional responde legalmente por el contenido 2. Profesional (professional): un profesional lo revisa sin responder legalmente 3. Oficial (official): la organización lo valida 4. Personal (personal): el paciente u otra persona lo valida.

      ResumenForma de la validación
      Comentarios

      Regla de negocio: Ver la regla de negocio del dato validación.

      Regla de validación: Debe pertenecer al catálogo modo de validación.

      Control1..1
      VinculaciónLos códigos DEBEN tomarse de CompositionAttestationMode
      (required to http://hl7.org/fhir/ValueSet/composition-attestation-mode)
      TipoCodeableConcept
      Requisitos

      Distingue la validación legal, que hace responsable al profesional, de una revisión profesional, oficial o personal, que no tiene el mismo efecto.

      36. CRLMDocumentoClinico.validacion.fecha
      Definición

      Momento de la validación.

      ResumenMomento de la validación
      Comentarios

      Regla de negocio: No puede ser anterior a la fecha del documento (invariante cr-documento-validacion-fecha: attester.all(time.empty() or time >= %resource.date)).

      Regla de validación: Fecha y hora con zona horaria (invariante cr-documento-fecha-hora).

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

      Dice cuándo se validó el documento, que puede ser después de redactarlo.

      38. CRLMDocumentoClinico.validacion.responsable
      Definición

      Quien valida.

      ResumenQuien valida
      Comentarios

      Regla de negocio: Para legal y professional, un profesional en su rol; para official, la organización.

      Regla de validación: Referencia a un PractitionerRole, Practitioner u Organization que cumpla su modelo, incluido en el Bundle.

      Control1..1
      TipoReference(Modelo Lógico del Rol del Profesional, Modelo Lógico del Profesional de Salud, Modelo Lógico de la Organización)
      Requisitos

      Es quien valida: el profesional, en su rol, o la organización. En la validación legal, es quien firma el documento.

      40. CRLMDocumentoClinico.custodio
      Definición

      Organización que conserva el documento y responde por su acceso.

      ResumenOrganización que conserva el documento y responde por su acceso
      Comentarios

      Regla de negocio: Obligatorio. Es la entidad que emite el documento: el establecimiento concreto, no la institución a la que pertenece. Para la CCSS, el hospital, el área de salud o el EBAIS que emite el documento, no la CCSS (pregunta 3).

      Regla de validación: Referencia a un Organization que cumpla el modelo de organización, incluido en el Bundle.

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

      Dice qué organización conserva el documento y responde por su acceso. Es a quien se le pide el original y quien responde ante el paciente (decisión 3).

      42. CRLMDocumentoClinico.confidencialidad
      Definición

      Nivel de confidencialidad del documento: 1. Normal (N) 2. Restringido (R) 3. Muy restringido (V).

      ResumenNivel de confidencialidad del documento
      Comentarios

      Regla de negocio: Por defecto N. La información de salud es siempre un dato sensible según la Ley 8968; este nivel sirve para restringir más el acceso a documentos que lo requieren. Si el documento tiene una sensibilidad, el nivel es al menos R. Es el nivel más alto entre el documento y sus entradas ("marca de agua alta").

      Regla de validación: Debe pertenecer al catálogo confidencialidad. Invariante cr-documento-sensibilidad (error) en el dato sensibilidad.

      Control1..1
      VinculaciónLos códigos DEBEN tomarse de Confidencialidad
      (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-confidencialidad)
      TipoCoding
      Requisitos

      Permite restringir más el acceso a los documentos que lo requieren, además de la protección que ya tiene toda información de salud por la Ley 8968.

      44. CRLMDocumentoClinico.documentoRelacionado
      Definición

      Relación de esta versión con otro documento: la versión que corrige, el documento al que agrega una adenda, o el documento del que se transformó.

      ResumenRelación de esta versión con otro documento
      Comentarios

      Regla de negocio: Toda versión nueva (corrected, appended o entered-in-error) referencia la versión anterior.

      Regla de validación: Invariante cr-documento-relacion (error): status in ('corrected' | 'appended' | 'entered-in-error') implies relatesTo.where(type in ('replaces' | 'appends')).exists().

      Control0..*
      TipoBackboneElement
      Requisitos

      Enlaza una corrección, una adenda o una transformación con el documento del que sale, para reconstruir la historia de sus versiones.

      Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      46. CRLMDocumentoClinico.documentoRelacionado.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
      48. CRLMDocumentoClinico.documentoRelacionado.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 CRLMDocumentoClinico.documentoRelacionado.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
      • value @ url
      • 50. CRLMDocumentoClinico.documentoRelacionado.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())
        52. CRLMDocumentoClinico.documentoRelacionado.relacion
        Definición

        Tipo de relación: 1. Sustituye (replaces): corrección o anulación de la versión anterior 2. Agrega (appends): adenda a un documento 3. Transformado de (transforms): el mismo contenido en otro formato (por ejemplo, desde un CDA).

        ResumenTipo de relación
        Comentarios

        Regla de validación: Debe pertenecer al catálogo relación entre documentos.

        Control1..1
        VinculaciónLos códigos DEBEN tomarse de Relación entre documentos
        (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-relacion-documento)
        Tipocode
        Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
        Requisitos

        Dice si la versión sustituye a la anterior, le agrega una adenda o es el mismo contenido en otro formato, que se tratan distinto al mostrar el documento.

        54. CRLMDocumentoClinico.documentoRelacionado.documento
        Definición

        Documento relacionado.

        ResumenDocumento relacionado
        Comentarios

        Regla de negocio: Se referencia por su identificación y versión, porque la versión anterior no tiene por qué estar en el Bundle.

        Regla de validación: Referencia lógica: identifier con el system y el número del documento relacionado.

        Control1..1
        TipoReference(Modelo Lógico del Documento Clínico)
        Requisitos

        Es el documento relacionado, citado por su identificador y versión porque la versión anterior no tiene que viajar en el mismo Bundle.

        56. CRLMDocumentoClinico.seccion
        Definición

        Parte del documento con un tema: hallazgos, conclusión, antecedentes, medicamentos al egreso, etc.

        ResumenParte del documento con un tema
        Comentarios

        Regla de negocio: Las secciones de cada tipo de documento las define su guía de dominio. Una sección puede tener subsecciones con la misma estructura.

        Regla de validación: Reglas de FHIR: una sección tiene texto, entradas o subsecciones (cmp-1), y solo tiene motivo de sección vacía si no tiene entradas (cmp-2).

        Control0..*
        TipoBackboneElement
        Requisitos

        Divide el contenido en partes con un tema (hallazgos, conclusión), para leerlo, buscarlo y que cada guía de dominio fije las secciones de su documento.

        Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        58. CRLMDocumentoClinico.seccion.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
        60. CRLMDocumentoClinico.seccion.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 CRLMDocumentoClinico.seccion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
        • value @ url
        • 62. CRLMDocumentoClinico.seccion.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())
          64. CRLMDocumentoClinico.seccion.titulo
          Definición

          Título de la sección como lo ve quien lee: "Hallazgos", "Conclusión".

          ResumenTítulo de la sección como lo ve quien lee
          Comentarios

          Regla de negocio: En español.

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

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

          Es lo que ve quien lee la sección.

          66. CRLMDocumentoClinico.seccion.codigo
          Definición

          Código LOINC de la sección.

          ResumenCódigo LOINC de la sección
          Comentarios

          Regla de negocio: Lo fija la guía de dominio para cada sección.

          Regla de validación: Código de sección de LOINC.

          Control0..1
          VinculaciónPara códigos de ejemplo, vea DocumentSectionCodes
          (example to http://hl7.org/fhir/ValueSet/doc-section-codes)
          TipoCodeableConcept
          Requisitos

          Identifica la sección con un código LOINC, para que un sistema la encuentre sin depender del título.

          68. CRLMDocumentoClinico.seccion.texto
          Definición

          Contenido legible de la sección, en XHTML. Es lo que el profesional lee y lo que se valida.

          ResumenContenido legible de la sección, en XHTML
          Comentarios

          Regla de negocio: Obligatorio. Si la sección tiene entradas, el texto las presenta de forma legible. Si está vacía, el texto lo dice ("Sin medicamentos al egreso").

          Regla de validación: Narrativa FHIR (status = generated, extensions o additional).

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

          Es lo que el profesional lee y lo que se valida y firma. Garantiza que el documento se pueda leer aunque un sistema no entienda sus entradas (principio de legibilidad).

          70. CRLMDocumentoClinico.seccion.entrada
          Definición

          Datos estructurados de la sección: observaciones, condiciones, medicamentos, imágenes, etc.

          ResumenDatos estructurados de la sección
          Comentarios

          Regla de negocio: Los recursos que se pueden referenciar en cada sección los fija la guía de dominio.

          Regla de validación: Referencia a recursos incluidos en el Bundle.

          Control0..*
          TipoReference
          Requisitos

          Lleva los datos estructurados de la sección (observaciones, medicamentos, imágenes), para que un sistema los procese sin interpretar el texto.

          72. CRLMDocumentoClinico.seccion.motivoVacia
          Definición

          Por qué una sección no tiene entradas: sin información, no se consultó, no aplica, etc.

          ResumenPor qué una sección no tiene entradas
          Comentarios

          Regla de negocio: Solo si la sección no tiene entradas (cmp-2).

          Regla de validación: Debe pertenecer al catálogo motivo de lista vacía.

          Control0..1
          VinculaciónLos códigos DEBERÍAN tomarse de ListEmptyReasons
          (preferred to http://hl7.org/fhir/ValueSet/list-empty-reason)
          TipoCodeableConcept
          Requisitos

          Distingue una sección vacía porque no hay información de una que no se consultó o no aplica, que significan cosas distintas para quien lee.

          74. CRLMDocumentoClinico.sensibilidad
          Definición

          Etiqueta de seguridad que dice por qué el documento es sensible: 1. Salud mental (PSY) 2. Notas de psicoterapia (PSYTHPN) 3. VIH/sida (HIV) 4. Infecciones de transmisión sexual (STD) 5. Violencia sexual, doméstica o abuso (SDV) 6. Salud sexual y reproductiva (SEX) 7. Consumo de sustancias (SUD) 8. Enfermedad genética (GDIS). Ver la propuesta para Costa Rica abajo.

          ResumenEtiqueta de seguridad que dice por qué el documento es sensible
          Comentarios

          Regla de negocio: La asigna el autor o el sistema que genera el documento, según su contenido. Una sensibilidad exige confidencialidad R o V. Las entradas del documento que la tienen la llevan también en su propio meta.security, y el documento lleva todas las de sus entradas. Las etiquetas no deciden por sí solas quién accede: lo decide la política de acceso del HIE, que las usa como insumo.

          Regla de validación: Debe pertenecer al catálogo sensibilidad de la información. Invariante cr-documento-sensibilidad (error): meta.security.where(system = 'http://terminology.hl7.org/CodeSystem/v3-ActCode').exists() implies meta.security.where(system = 'http://terminology.hl7.org/CodeSystem/v3-Confidentiality' and code in ('R' | 'V')).exists().

          Comentarios: La lista y la confidencialidad mínima de cada categoría son una propuesta de la IG (pregunta 6).

          Control0..*
          VinculaciónLos códigos DEBEN tomarse de Sensibilidad de la información
          (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-sensibilidad-informacion)
          TipoCoding
          Requisitos

          Dice por qué el documento es sensible (salud mental, VIH, violencia), para que la política de acceso del HIE le aplique la protección que corresponde (decisión 6).

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

          0. CRLMDocumentoClinico
          Definición

          Documento clínico de un paciente: un conjunto de información clínica que un autor reúne, un profesional valida y una organización custodia, y que se intercambia como una unidad. Ejemplos: un informe de imágenes médicas, un informe de laboratorio, una epicrisis, una referencia, una nota de consulta o el resumen del paciente.

          ResumenModelo Lógico del Documento Clínico
          Modelo lógicoLas instancias de este modelo lógico no están marcadas como destino de una referencia
          2. CRLMDocumentoClinico.identificacion
          Definición

          Identificador del documento, el mismo en todas sus versiones.

          ResumenIdentificador del documento, el mismo en todas sus versiones
          Comentarios

          Regla de negocio: Obligatorio. Lo asigna el establecimiento que emite el documento y no cambia cuando se emite una versión nueva: cada versión se distingue por la versión del recurso (Composition.version, ver elementos propios del recurso) y por el identificador del Bundle.

          Regla de validación: No puede haber dos documentos distintos con el mismo establecimiento y número.

          Comentarios: Es el identificador con que la referencia a documento (DocumentReference, modelo siguiente) indexa el documento en el HIE.

          Control1..1
          TipoBackboneElement
          Requisitos

          Reúne todas las versiones de un documento: una corrección o una adenda lleva el mismo identificador, y así se sabe que es el mismo documento (decisión 7).

          4. CRLMDocumentoClinico.identificacion.numero
          Definición

          Número del documento en el sistema del establecimiento.

          ResumenNúmero del documento en el sistema del establecimiento
          Comentarios

          Regla de negocio: Lo define cada establecimiento.

          Regla de validación: De 1 a 64 caracteres, sin espacios (invariante común cr-codigo-interno-value).

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

          Es el número con que el sistema del establecimiento reconoce el documento.

          6. CRLMDocumentoClinico.identificacion.establecimiento
          Definición

          Código del establecimiento que asignó el número.

          ResumenCódigo del establecimiento que asignó el número
          Comentarios

          Regla de negocio: Es el codigo-establecimiento del custodio o, si es una unidad sin identificador propio, el de su organización superior.

          Regla de validación: Invariante cr-documento-system, sobre el identificador: system.matches('^https://hl7\\.or\\.cr/fhir/sid/documento/(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 establecimiento numera sus documentos por su cuenta. El establecimiento hace único el número, igual que en el expediente del paciente.

          8. CRLMDocumentoClinico.tipo
          Definición

          Clase de documento según LOINC: informe de imágenes, informe de laboratorio, epicrisis, referencia, nota de consulta, resumen del paciente, etc. (lista inicial en la sección 5).

          ResumenClase de documento según LOINC
          Comentarios

          Regla de negocio: Obligatorio. Cada guía de dominio fija el tipo de sus documentos (por ejemplo, la IG de imágenes médicas fija 18748-4).

          Regla de validación: Debe pertenecer al catálogo tipo de documento clínico.

          Comentarios: Se usa LOINC porque es lo que usan IPS, RACSEL e IHE. LOINC es de uso gratuito con aviso de copyright.

          Control1..1
          VinculaciónSalvo que no sean adecuados, estos códigos DEBEN tomarse de Tipo de documento clínico
          (extensible to https://hl7.or.cr/fhir/terminology/ValueSet/cr-tipo-documento-clinico)
          TipoCodeableConcept
          Requisitos

          Dice qué clase de documento es (informe de imágenes, epicrisis, referencia) con un código LOINC. Permite buscar, filtrar y aplicar a cada tipo las reglas de su guía de dominio.

          10. CRLMDocumentoClinico.titulo
          Definición

          Título del documento como lo ve quien lo lee: "Informe de resonancia magnética de rodilla derecha", "Epicrisis".

          ResumenTítulo del documento como lo ve quien lo lee
          Comentarios

          Regla de negocio: En español.

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

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

          Es lo que ve quien busca o abre el documento, más específico que el tipo, por ejemplo Informe de resonancia magnética de rodilla derecha.

          12. CRLMDocumentoClinico.paciente
          Definición

          Paciente del que trata el documento.

          ResumenPaciente del que trata el documento
          Comentarios

          Regla de negocio: Obligatorio y uno solo.

          Regla de validación: Referencia a un Patient que cumpla el modelo de paciente y que esté incluido en el Bundle.

          Control1..1
          TipoReference(Modelo Lógico del Paciente)
          Requisitos

          Un documento trata siempre de un paciente. Sin él no se puede ubicar el documento en su historia ni controlar quién lo puede ver.

          14. CRLMDocumentoClinico.atencion
          Definición

          Atención en que se generó el documento.

          ResumenAtención en que se generó el documento
          Comentarios

          Regla de negocio: Obligatoria cuando el documento resulta de una atención (informes, epicrisis, referencias, notas). No se registra en documentos que resumen varias atenciones, como el resumen del paciente. Cada guía de dominio puede hacerla obligatoria.

          Regla de validación: Referencia a un Encounter que cumpla el modelo de atención, del mismo paciente, incluido en el Bundle.

          Control0..1
          TipoReference(Modelo Lógico de la Atención)
          Requisitos

          Da el contexto en que se generó el documento: dónde, cuándo, de qué modalidad y con qué profesionales.

          16. CRLMDocumentoClinico.fecha
          Definición

          Momento en que el autor terminó de redactar esta versión del documento.

          ResumenMomento en que el autor terminó de redactar esta versión del documento
          Comentarios

          Regla de negocio: Obligatoria. No puede ser futura (invariante cr-documento-fecha-no-futura: $this {= now()) ni anterior al inicio de la atención (invariante cr-documento-fecha-atencion: encounter.exists() implies (encounter.resolve().actualPeriod.start.empty() or date }= encounter.resolve().actualPeriod.start), que el validador evalúa dentro del Bundle).

          Regla de validación: Fecha y hora con zona horaria (UTC−6 en Costa Rica). Invariante cr-documento-fecha-hora: toString().contains('T').

          Comentarios: No es la fecha de validación (dato validación) ni la del ensamblado del Bundle (Bundle.timestamp).

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

          Ubica el documento en la historia del paciente y dice cuándo se redactó esta versión.

          18. CRLMDocumentoClinico.autor
          Definición

          Quien redacta el documento.

          ResumenQuien redacta el documento
          Comentarios

          Regla de negocio: Un profesional, en su rol, cuando el documento lo redacta una persona. La organización, cuando lo genera un sistema sin intervención de un profesional (por ejemplo, el resumen del paciente que arma el HIE).

          Regla de validación: Referencia a un PractitionerRole, Practitioner u Organization que cumpla su modelo, incluido en el Bundle.

          Control1..*
          TipoReference(Modelo Lógico del Rol del Profesional, Modelo Lógico del Profesional de Salud, Modelo Lógico de la Organización)
          Requisitos

          Dice quién redactó el documento, un profesional en su rol o un sistema, para saber de quién es el contenido y a quién preguntar por él.

          20. CRLMDocumentoClinico.validacion
          Definición

          Quién valida el documento, de qué forma y cuándo.

          ResumenQuién valida el documento, de qué forma y cuándo
          Comentarios

          Regla de negocio: Un documento final, corrected o appended redactado por un profesional lleva la validación legal del profesional que responde por su contenido (el radiólogo que firma el informe, el médico que firma la epicrisis). Pueden agregarse otras: por ejemplo, la validación professional de un residente.

          Regla de validación: Invariante cr-documento-validacion-legal (error): status in ('final' | 'corrected' | 'appended') and author.all(resolve() is PractitionerRole or resolve() is Practitioner) implies attester.where(mode.coding.where(system = 'http://hl7.org/fhir/composition-attestation-mode' and code = 'legal').exists()).exists().

          Comentarios: Este dato dice quién responde por el documento; la firma digital de esa persona va en el Bundle (Bundle.signature, pregunta 1), no aquí.

          Control0..*
          TipoBackboneElement
          Requisitos

          Dice quién responde por el contenido. Sin la validación legal de un profesional, el documento no tiene valor clínico ni legal (principio de responsabilidad).

          22. CRLMDocumentoClinico.validacion.modo
          Definición

          Forma de la validación: 1. Legal (legal): el profesional responde legalmente por el contenido 2. Profesional (professional): un profesional lo revisa sin responder legalmente 3. Oficial (official): la organización lo valida 4. Personal (personal): el paciente u otra persona lo valida.

          ResumenForma de la validación
          Comentarios

          Regla de negocio: Ver la regla de negocio del dato validación.

          Regla de validación: Debe pertenecer al catálogo modo de validación.

          Control1..1
          VinculaciónLos códigos DEBEN tomarse de CompositionAttestationMode
          (required to http://hl7.org/fhir/ValueSet/composition-attestation-mode)
          TipoCodeableConcept
          Requisitos

          Distingue la validación legal, que hace responsable al profesional, de una revisión profesional, oficial o personal, que no tiene el mismo efecto.

          24. CRLMDocumentoClinico.validacion.fecha
          Definición

          Momento de la validación.

          ResumenMomento de la validación
          Comentarios

          Regla de negocio: No puede ser anterior a la fecha del documento (invariante cr-documento-validacion-fecha: attester.all(time.empty() or time >= %resource.date)).

          Regla de validación: Fecha y hora con zona horaria (invariante cr-documento-fecha-hora).

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

          Dice cuándo se validó el documento, que puede ser después de redactarlo.

          26. CRLMDocumentoClinico.validacion.responsable
          Definición

          Quien valida.

          ResumenQuien valida
          Comentarios

          Regla de negocio: Para legal y professional, un profesional en su rol; para official, la organización.

          Regla de validación: Referencia a un PractitionerRole, Practitioner u Organization que cumpla su modelo, incluido en el Bundle.

          Control1..1
          TipoReference(Modelo Lógico del Rol del Profesional, Modelo Lógico del Profesional de Salud, Modelo Lógico de la Organización)
          Requisitos

          Es quien valida: el profesional, en su rol, o la organización. En la validación legal, es quien firma el documento.

          28. CRLMDocumentoClinico.custodio
          Definición

          Organización que conserva el documento y responde por su acceso.

          ResumenOrganización que conserva el documento y responde por su acceso
          Comentarios

          Regla de negocio: Obligatorio. Es la entidad que emite el documento: el establecimiento concreto, no la institución a la que pertenece. Para la CCSS, el hospital, el área de salud o el EBAIS que emite el documento, no la CCSS (pregunta 3).

          Regla de validación: Referencia a un Organization que cumpla el modelo de organización, incluido en el Bundle.

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

          Dice qué organización conserva el documento y responde por su acceso. Es a quien se le pide el original y quien responde ante el paciente (decisión 3).

          30. CRLMDocumentoClinico.confidencialidad
          Definición

          Nivel de confidencialidad del documento: 1. Normal (N) 2. Restringido (R) 3. Muy restringido (V).

          ResumenNivel de confidencialidad del documento
          Comentarios

          Regla de negocio: Por defecto N. La información de salud es siempre un dato sensible según la Ley 8968; este nivel sirve para restringir más el acceso a documentos que lo requieren. Si el documento tiene una sensibilidad, el nivel es al menos R. Es el nivel más alto entre el documento y sus entradas ("marca de agua alta").

          Regla de validación: Debe pertenecer al catálogo confidencialidad. Invariante cr-documento-sensibilidad (error) en el dato sensibilidad.

          Control1..1
          VinculaciónLos códigos DEBEN tomarse de Confidencialidad
          (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-confidencialidad)
          TipoCoding
          Requisitos

          Permite restringir más el acceso a los documentos que lo requieren, además de la protección que ya tiene toda información de salud por la Ley 8968.

          32. CRLMDocumentoClinico.documentoRelacionado
          Definición

          Relación de esta versión con otro documento: la versión que corrige, el documento al que agrega una adenda, o el documento del que se transformó.

          ResumenRelación de esta versión con otro documento
          Comentarios

          Regla de negocio: Toda versión nueva (corrected, appended o entered-in-error) referencia la versión anterior.

          Regla de validación: Invariante cr-documento-relacion (error): status in ('corrected' | 'appended' | 'entered-in-error') implies relatesTo.where(type in ('replaces' | 'appends')).exists().

          Control0..*
          TipoBackboneElement
          Requisitos

          Enlaza una corrección, una adenda o una transformación con el documento del que sale, para reconstruir la historia de sus versiones.

          34. CRLMDocumentoClinico.documentoRelacionado.relacion
          Definición

          Tipo de relación: 1. Sustituye (replaces): corrección o anulación de la versión anterior 2. Agrega (appends): adenda a un documento 3. Transformado de (transforms): el mismo contenido en otro formato (por ejemplo, desde un CDA).

          ResumenTipo de relación
          Comentarios

          Regla de validación: Debe pertenecer al catálogo relación entre documentos.

          Control1..1
          VinculaciónLos códigos DEBEN tomarse de Relación entre documentos
          (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-relacion-documento)
          Tipocode
          Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
          Requisitos

          Dice si la versión sustituye a la anterior, le agrega una adenda o es el mismo contenido en otro formato, que se tratan distinto al mostrar el documento.

          36. CRLMDocumentoClinico.documentoRelacionado.documento
          Definición

          Documento relacionado.

          ResumenDocumento relacionado
          Comentarios

          Regla de negocio: Se referencia por su identificación y versión, porque la versión anterior no tiene por qué estar en el Bundle.

          Regla de validación: Referencia lógica: identifier con el system y el número del documento relacionado.

          Control1..1
          TipoReference(Modelo Lógico del Documento Clínico)
          Requisitos

          Es el documento relacionado, citado por su identificador y versión porque la versión anterior no tiene que viajar en el mismo Bundle.

          38. CRLMDocumentoClinico.seccion
          Definición

          Parte del documento con un tema: hallazgos, conclusión, antecedentes, medicamentos al egreso, etc.

          ResumenParte del documento con un tema
          Comentarios

          Regla de negocio: Las secciones de cada tipo de documento las define su guía de dominio. Una sección puede tener subsecciones con la misma estructura.

          Regla de validación: Reglas de FHIR: una sección tiene texto, entradas o subsecciones (cmp-1), y solo tiene motivo de sección vacía si no tiene entradas (cmp-2).

          Control0..*
          TipoBackboneElement
          Requisitos

          Divide el contenido en partes con un tema (hallazgos, conclusión), para leerlo, buscarlo y que cada guía de dominio fije las secciones de su documento.

          40. CRLMDocumentoClinico.seccion.titulo
          Definición

          Título de la sección como lo ve quien lee: "Hallazgos", "Conclusión".

          ResumenTítulo de la sección como lo ve quien lee
          Comentarios

          Regla de negocio: En español.

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

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

          Es lo que ve quien lee la sección.

          42. CRLMDocumentoClinico.seccion.codigo
          Definición

          Código LOINC de la sección.

          ResumenCódigo LOINC de la sección
          Comentarios

          Regla de negocio: Lo fija la guía de dominio para cada sección.

          Regla de validación: Código de sección de LOINC.

          Control0..1
          VinculaciónPara códigos de ejemplo, vea DocumentSectionCodes
          (example to http://hl7.org/fhir/ValueSet/doc-section-codes)
          TipoCodeableConcept
          Requisitos

          Identifica la sección con un código LOINC, para que un sistema la encuentre sin depender del título.

          44. CRLMDocumentoClinico.seccion.texto
          Definición

          Contenido legible de la sección, en XHTML. Es lo que el profesional lee y lo que se valida.

          ResumenContenido legible de la sección, en XHTML
          Comentarios

          Regla de negocio: Obligatorio. Si la sección tiene entradas, el texto las presenta de forma legible. Si está vacía, el texto lo dice ("Sin medicamentos al egreso").

          Regla de validación: Narrativa FHIR (status = generated, extensions o additional).

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

          Es lo que el profesional lee y lo que se valida y firma. Garantiza que el documento se pueda leer aunque un sistema no entienda sus entradas (principio de legibilidad).

          46. CRLMDocumentoClinico.seccion.entrada
          Definición

          Datos estructurados de la sección: observaciones, condiciones, medicamentos, imágenes, etc.

          ResumenDatos estructurados de la sección
          Comentarios

          Regla de negocio: Los recursos que se pueden referenciar en cada sección los fija la guía de dominio.

          Regla de validación: Referencia a recursos incluidos en el Bundle.

          Control0..*
          TipoReference
          Requisitos

          Lleva los datos estructurados de la sección (observaciones, medicamentos, imágenes), para que un sistema los procese sin interpretar el texto.

          48. CRLMDocumentoClinico.seccion.motivoVacia
          Definición

          Por qué una sección no tiene entradas: sin información, no se consultó, no aplica, etc.

          ResumenPor qué una sección no tiene entradas
          Comentarios

          Regla de negocio: Solo si la sección no tiene entradas (cmp-2).

          Regla de validación: Debe pertenecer al catálogo motivo de lista vacía.

          Control0..1
          VinculaciónLos códigos DEBERÍAN tomarse de ListEmptyReasons
          (preferred to http://hl7.org/fhir/ValueSet/list-empty-reason)
          TipoCodeableConcept
          Requisitos

          Distingue una sección vacía porque no hay información de una que no se consultó o no aplica, que significan cosas distintas para quien lee.

          50. CRLMDocumentoClinico.sensibilidad
          Definición

          Etiqueta de seguridad que dice por qué el documento es sensible: 1. Salud mental (PSY) 2. Notas de psicoterapia (PSYTHPN) 3. VIH/sida (HIV) 4. Infecciones de transmisión sexual (STD) 5. Violencia sexual, doméstica o abuso (SDV) 6. Salud sexual y reproductiva (SEX) 7. Consumo de sustancias (SUD) 8. Enfermedad genética (GDIS). Ver la propuesta para Costa Rica abajo.

          ResumenEtiqueta de seguridad que dice por qué el documento es sensible
          Comentarios

          Regla de negocio: La asigna el autor o el sistema que genera el documento, según su contenido. Una sensibilidad exige confidencialidad R o V. Las entradas del documento que la tienen la llevan también en su propio meta.security, y el documento lleva todas las de sus entradas. Las etiquetas no deciden por sí solas quién accede: lo decide la política de acceso del HIE, que las usa como insumo.

          Regla de validación: Debe pertenecer al catálogo sensibilidad de la información. Invariante cr-documento-sensibilidad (error): meta.security.where(system = 'http://terminology.hl7.org/CodeSystem/v3-ActCode').exists() implies meta.security.where(system = 'http://terminology.hl7.org/CodeSystem/v3-Confidentiality' and code in ('R' | 'V')).exists().

          Comentarios: La lista y la confidencialidad mínima de cada categoría son una propuesta de la IG (pregunta 6).

          Control0..*
          VinculaciónLos códigos DEBEN tomarse de Sensibilidad de la información
          (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-sensibilidad-informacion)
          TipoCoding
          Requisitos

          Dice por qué el documento es sensible (salud mental, VIH, violencia), para que la política de acceso del HIE le aplique la protección que corresponde (decisión 6).

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

          0. CRLMDocumentoClinico
          Definición

          Documento clínico de un paciente: un conjunto de información clínica que un autor reúne, un profesional valida y una organización custodia, y que se intercambia como una unidad. Ejemplos: un informe de imágenes médicas, un informe de laboratorio, una epicrisis, una referencia, una nota de consulta o el resumen del paciente.

          ResumenModelo Lógico del Documento Clínico
          Control0..*
          Es modificadorfalse
          Modelo lógicoLas instancias de este modelo lógico no están marcadas como destino de una referencia
          2. CRLMDocumentoClinico.identificacion
          Definición

          Identificador del documento, el mismo en todas sus versiones.

          ResumenIdentificador del documento, el mismo en todas sus versiones
          Comentarios

          Regla de negocio: Obligatorio. Lo asigna el establecimiento que emite el documento y no cambia cuando se emite una versión nueva: cada versión se distingue por la versión del recurso (Composition.version, ver elementos propios del recurso) y por el identificador del Bundle.

          Regla de validación: No puede haber dos documentos distintos con el mismo establecimiento y número.

          Comentarios: Es el identificador con que la referencia a documento (DocumentReference, modelo siguiente) indexa el documento en el HIE.

          Control1..1
          TipoBackboneElement
          Requisitos

          Reúne todas las versiones de un documento: una corrección o una adenda lleva el mismo identificador, y así se sabe que es el mismo documento (decisión 7).

          Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          4. CRLMDocumentoClinico.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. CRLMDocumentoClinico.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 CRLMDocumentoClinico.identificacion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
          • value @ url
          • 8. CRLMDocumentoClinico.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. CRLMDocumentoClinico.identificacion.numero
            Definición

            Número del documento en el sistema del establecimiento.

            ResumenNúmero del documento en el sistema del establecimiento
            Comentarios

            Regla de negocio: Lo define cada establecimiento.

            Regla de validación: De 1 a 64 caracteres, sin espacios (invariante común cr-codigo-interno-value).

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

            Es el número con que el sistema del establecimiento reconoce el documento.

            12. CRLMDocumentoClinico.identificacion.establecimiento
            Definición

            Código del establecimiento que asignó el número.

            ResumenCódigo del establecimiento que asignó el número
            Comentarios

            Regla de negocio: Es el codigo-establecimiento del custodio o, si es una unidad sin identificador propio, el de su organización superior.

            Regla de validación: Invariante cr-documento-system, sobre el identificador: system.matches('^https://hl7\\.or\\.cr/fhir/sid/documento/(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 establecimiento numera sus documentos por su cuenta. El establecimiento hace único el número, igual que en el expediente del paciente.

            14. CRLMDocumentoClinico.tipo
            Definición

            Clase de documento según LOINC: informe de imágenes, informe de laboratorio, epicrisis, referencia, nota de consulta, resumen del paciente, etc. (lista inicial en la sección 5).

            ResumenClase de documento según LOINC
            Comentarios

            Regla de negocio: Obligatorio. Cada guía de dominio fija el tipo de sus documentos (por ejemplo, la IG de imágenes médicas fija 18748-4).

            Regla de validación: Debe pertenecer al catálogo tipo de documento clínico.

            Comentarios: Se usa LOINC porque es lo que usan IPS, RACSEL e IHE. LOINC es de uso gratuito con aviso de copyright.

            Control1..1
            VinculaciónSalvo que no sean adecuados, estos códigos DEBEN tomarse de Tipo de documento clínico
            (extensible to https://hl7.or.cr/fhir/terminology/ValueSet/cr-tipo-documento-clinico)
            TipoCodeableConcept
            Requisitos

            Dice qué clase de documento es (informe de imágenes, epicrisis, referencia) con un código LOINC. Permite buscar, filtrar y aplicar a cada tipo las reglas de su guía de dominio.

            16. CRLMDocumentoClinico.titulo
            Definición

            Título del documento como lo ve quien lo lee: "Informe de resonancia magnética de rodilla derecha", "Epicrisis".

            ResumenTítulo del documento como lo ve quien lo lee
            Comentarios

            Regla de negocio: En español.

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

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

            Es lo que ve quien busca o abre el documento, más específico que el tipo, por ejemplo Informe de resonancia magnética de rodilla derecha.

            18. CRLMDocumentoClinico.paciente
            Definición

            Paciente del que trata el documento.

            ResumenPaciente del que trata el documento
            Comentarios

            Regla de negocio: Obligatorio y uno solo.

            Regla de validación: Referencia a un Patient que cumpla el modelo de paciente y que esté incluido en el Bundle.

            Control1..1
            TipoReference(Modelo Lógico del Paciente)
            Requisitos

            Un documento trata siempre de un paciente. Sin él no se puede ubicar el documento en su historia ni controlar quién lo puede ver.

            20. CRLMDocumentoClinico.atencion
            Definición

            Atención en que se generó el documento.

            ResumenAtención en que se generó el documento
            Comentarios

            Regla de negocio: Obligatoria cuando el documento resulta de una atención (informes, epicrisis, referencias, notas). No se registra en documentos que resumen varias atenciones, como el resumen del paciente. Cada guía de dominio puede hacerla obligatoria.

            Regla de validación: Referencia a un Encounter que cumpla el modelo de atención, del mismo paciente, incluido en el Bundle.

            Control0..1
            TipoReference(Modelo Lógico de la Atención)
            Requisitos

            Da el contexto en que se generó el documento: dónde, cuándo, de qué modalidad y con qué profesionales.

            22. CRLMDocumentoClinico.fecha
            Definición

            Momento en que el autor terminó de redactar esta versión del documento.

            ResumenMomento en que el autor terminó de redactar esta versión del documento
            Comentarios

            Regla de negocio: Obligatoria. No puede ser futura (invariante cr-documento-fecha-no-futura: $this {= now()) ni anterior al inicio de la atención (invariante cr-documento-fecha-atencion: encounter.exists() implies (encounter.resolve().actualPeriod.start.empty() or date }= encounter.resolve().actualPeriod.start), que el validador evalúa dentro del Bundle).

            Regla de validación: Fecha y hora con zona horaria (UTC−6 en Costa Rica). Invariante cr-documento-fecha-hora: toString().contains('T').

            Comentarios: No es la fecha de validación (dato validación) ni la del ensamblado del Bundle (Bundle.timestamp).

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

            Ubica el documento en la historia del paciente y dice cuándo se redactó esta versión.

            24. CRLMDocumentoClinico.autor
            Definición

            Quien redacta el documento.

            ResumenQuien redacta el documento
            Comentarios

            Regla de negocio: Un profesional, en su rol, cuando el documento lo redacta una persona. La organización, cuando lo genera un sistema sin intervención de un profesional (por ejemplo, el resumen del paciente que arma el HIE).

            Regla de validación: Referencia a un PractitionerRole, Practitioner u Organization que cumpla su modelo, incluido en el Bundle.

            Control1..*
            TipoReference(Modelo Lógico del Rol del Profesional, Modelo Lógico del Profesional de Salud, Modelo Lógico de la Organización)
            Requisitos

            Dice quién redactó el documento, un profesional en su rol o un sistema, para saber de quién es el contenido y a quién preguntar por él.

            26. CRLMDocumentoClinico.validacion
            Definición

            Quién valida el documento, de qué forma y cuándo.

            ResumenQuién valida el documento, de qué forma y cuándo
            Comentarios

            Regla de negocio: Un documento final, corrected o appended redactado por un profesional lleva la validación legal del profesional que responde por su contenido (el radiólogo que firma el informe, el médico que firma la epicrisis). Pueden agregarse otras: por ejemplo, la validación professional de un residente.

            Regla de validación: Invariante cr-documento-validacion-legal (error): status in ('final' | 'corrected' | 'appended') and author.all(resolve() is PractitionerRole or resolve() is Practitioner) implies attester.where(mode.coding.where(system = 'http://hl7.org/fhir/composition-attestation-mode' and code = 'legal').exists()).exists().

            Comentarios: Este dato dice quién responde por el documento; la firma digital de esa persona va en el Bundle (Bundle.signature, pregunta 1), no aquí.

            Control0..*
            TipoBackboneElement
            Requisitos

            Dice quién responde por el contenido. Sin la validación legal de un profesional, el documento no tiene valor clínico ni legal (principio de responsabilidad).

            Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            28. CRLMDocumentoClinico.validacion.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
            30. CRLMDocumentoClinico.validacion.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 CRLMDocumentoClinico.validacion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
            • value @ url
            • 32. CRLMDocumentoClinico.validacion.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())
              34. CRLMDocumentoClinico.validacion.modo
              Definición

              Forma de la validación: 1. Legal (legal): el profesional responde legalmente por el contenido 2. Profesional (professional): un profesional lo revisa sin responder legalmente 3. Oficial (official): la organización lo valida 4. Personal (personal): el paciente u otra persona lo valida.

              ResumenForma de la validación
              Comentarios

              Regla de negocio: Ver la regla de negocio del dato validación.

              Regla de validación: Debe pertenecer al catálogo modo de validación.

              Control1..1
              VinculaciónLos códigos DEBEN tomarse de CompositionAttestationMode
              (required to http://hl7.org/fhir/ValueSet/composition-attestation-mode)
              TipoCodeableConcept
              Requisitos

              Distingue la validación legal, que hace responsable al profesional, de una revisión profesional, oficial o personal, que no tiene el mismo efecto.

              36. CRLMDocumentoClinico.validacion.fecha
              Definición

              Momento de la validación.

              ResumenMomento de la validación
              Comentarios

              Regla de negocio: No puede ser anterior a la fecha del documento (invariante cr-documento-validacion-fecha: attester.all(time.empty() or time >= %resource.date)).

              Regla de validación: Fecha y hora con zona horaria (invariante cr-documento-fecha-hora).

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

              Dice cuándo se validó el documento, que puede ser después de redactarlo.

              38. CRLMDocumentoClinico.validacion.responsable
              Definición

              Quien valida.

              ResumenQuien valida
              Comentarios

              Regla de negocio: Para legal y professional, un profesional en su rol; para official, la organización.

              Regla de validación: Referencia a un PractitionerRole, Practitioner u Organization que cumpla su modelo, incluido en el Bundle.

              Control1..1
              TipoReference(Modelo Lógico del Rol del Profesional, Modelo Lógico del Profesional de Salud, Modelo Lógico de la Organización)
              Requisitos

              Es quien valida: el profesional, en su rol, o la organización. En la validación legal, es quien firma el documento.

              40. CRLMDocumentoClinico.custodio
              Definición

              Organización que conserva el documento y responde por su acceso.

              ResumenOrganización que conserva el documento y responde por su acceso
              Comentarios

              Regla de negocio: Obligatorio. Es la entidad que emite el documento: el establecimiento concreto, no la institución a la que pertenece. Para la CCSS, el hospital, el área de salud o el EBAIS que emite el documento, no la CCSS (pregunta 3).

              Regla de validación: Referencia a un Organization que cumpla el modelo de organización, incluido en el Bundle.

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

              Dice qué organización conserva el documento y responde por su acceso. Es a quien se le pide el original y quien responde ante el paciente (decisión 3).

              42. CRLMDocumentoClinico.confidencialidad
              Definición

              Nivel de confidencialidad del documento: 1. Normal (N) 2. Restringido (R) 3. Muy restringido (V).

              ResumenNivel de confidencialidad del documento
              Comentarios

              Regla de negocio: Por defecto N. La información de salud es siempre un dato sensible según la Ley 8968; este nivel sirve para restringir más el acceso a documentos que lo requieren. Si el documento tiene una sensibilidad, el nivel es al menos R. Es el nivel más alto entre el documento y sus entradas ("marca de agua alta").

              Regla de validación: Debe pertenecer al catálogo confidencialidad. Invariante cr-documento-sensibilidad (error) en el dato sensibilidad.

              Control1..1
              VinculaciónLos códigos DEBEN tomarse de Confidencialidad
              (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-confidencialidad)
              TipoCoding
              Requisitos

              Permite restringir más el acceso a los documentos que lo requieren, además de la protección que ya tiene toda información de salud por la Ley 8968.

              44. CRLMDocumentoClinico.documentoRelacionado
              Definición

              Relación de esta versión con otro documento: la versión que corrige, el documento al que agrega una adenda, o el documento del que se transformó.

              ResumenRelación de esta versión con otro documento
              Comentarios

              Regla de negocio: Toda versión nueva (corrected, appended o entered-in-error) referencia la versión anterior.

              Regla de validación: Invariante cr-documento-relacion (error): status in ('corrected' | 'appended' | 'entered-in-error') implies relatesTo.where(type in ('replaces' | 'appends')).exists().

              Control0..*
              TipoBackboneElement
              Requisitos

              Enlaza una corrección, una adenda o una transformación con el documento del que sale, para reconstruir la historia de sus versiones.

              Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              46. CRLMDocumentoClinico.documentoRelacionado.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
              48. CRLMDocumentoClinico.documentoRelacionado.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 CRLMDocumentoClinico.documentoRelacionado.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
              • value @ url
              • 50. CRLMDocumentoClinico.documentoRelacionado.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())
                52. CRLMDocumentoClinico.documentoRelacionado.relacion
                Definición

                Tipo de relación: 1. Sustituye (replaces): corrección o anulación de la versión anterior 2. Agrega (appends): adenda a un documento 3. Transformado de (transforms): el mismo contenido en otro formato (por ejemplo, desde un CDA).

                ResumenTipo de relación
                Comentarios

                Regla de validación: Debe pertenecer al catálogo relación entre documentos.

                Control1..1
                VinculaciónLos códigos DEBEN tomarse de Relación entre documentos
                (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-relacion-documento)
                Tipocode
                Valor primitivoEste elemento primitivo puede estar presente, ausente o reemplazado por una extensión
                Requisitos

                Dice si la versión sustituye a la anterior, le agrega una adenda o es el mismo contenido en otro formato, que se tratan distinto al mostrar el documento.

                54. CRLMDocumentoClinico.documentoRelacionado.documento
                Definición

                Documento relacionado.

                ResumenDocumento relacionado
                Comentarios

                Regla de negocio: Se referencia por su identificación y versión, porque la versión anterior no tiene por qué estar en el Bundle.

                Regla de validación: Referencia lógica: identifier con el system y el número del documento relacionado.

                Control1..1
                TipoReference(Modelo Lógico del Documento Clínico)
                Requisitos

                Es el documento relacionado, citado por su identificador y versión porque la versión anterior no tiene que viajar en el mismo Bundle.

                56. CRLMDocumentoClinico.seccion
                Definición

                Parte del documento con un tema: hallazgos, conclusión, antecedentes, medicamentos al egreso, etc.

                ResumenParte del documento con un tema
                Comentarios

                Regla de negocio: Las secciones de cada tipo de documento las define su guía de dominio. Una sección puede tener subsecciones con la misma estructura.

                Regla de validación: Reglas de FHIR: una sección tiene texto, entradas o subsecciones (cmp-1), y solo tiene motivo de sección vacía si no tiene entradas (cmp-2).

                Control0..*
                TipoBackboneElement
                Requisitos

                Divide el contenido en partes con un tema (hallazgos, conclusión), para leerlo, buscarlo y que cada guía de dominio fije las secciones de su documento.

                Invariantesele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                58. CRLMDocumentoClinico.seccion.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
                60. CRLMDocumentoClinico.seccion.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 CRLMDocumentoClinico.seccion.extension. Los slices sonSin orden y Open, y se distinguen con los siguientes discriminadores:
                • value @ url
                • 62. CRLMDocumentoClinico.seccion.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())
                  64. CRLMDocumentoClinico.seccion.titulo
                  Definición

                  Título de la sección como lo ve quien lee: "Hallazgos", "Conclusión".

                  ResumenTítulo de la sección como lo ve quien lee
                  Comentarios

                  Regla de negocio: En español.

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

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

                  Es lo que ve quien lee la sección.

                  66. CRLMDocumentoClinico.seccion.codigo
                  Definición

                  Código LOINC de la sección.

                  ResumenCódigo LOINC de la sección
                  Comentarios

                  Regla de negocio: Lo fija la guía de dominio para cada sección.

                  Regla de validación: Código de sección de LOINC.

                  Control0..1
                  VinculaciónPara códigos de ejemplo, vea DocumentSectionCodes
                  (example to http://hl7.org/fhir/ValueSet/doc-section-codes)
                  TipoCodeableConcept
                  Requisitos

                  Identifica la sección con un código LOINC, para que un sistema la encuentre sin depender del título.

                  68. CRLMDocumentoClinico.seccion.texto
                  Definición

                  Contenido legible de la sección, en XHTML. Es lo que el profesional lee y lo que se valida.

                  ResumenContenido legible de la sección, en XHTML
                  Comentarios

                  Regla de negocio: Obligatorio. Si la sección tiene entradas, el texto las presenta de forma legible. Si está vacía, el texto lo dice ("Sin medicamentos al egreso").

                  Regla de validación: Narrativa FHIR (status = generated, extensions o additional).

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

                  Es lo que el profesional lee y lo que se valida y firma. Garantiza que el documento se pueda leer aunque un sistema no entienda sus entradas (principio de legibilidad).

                  70. CRLMDocumentoClinico.seccion.entrada
                  Definición

                  Datos estructurados de la sección: observaciones, condiciones, medicamentos, imágenes, etc.

                  ResumenDatos estructurados de la sección
                  Comentarios

                  Regla de negocio: Los recursos que se pueden referenciar en cada sección los fija la guía de dominio.

                  Regla de validación: Referencia a recursos incluidos en el Bundle.

                  Control0..*
                  TipoReference
                  Requisitos

                  Lleva los datos estructurados de la sección (observaciones, medicamentos, imágenes), para que un sistema los procese sin interpretar el texto.

                  72. CRLMDocumentoClinico.seccion.motivoVacia
                  Definición

                  Por qué una sección no tiene entradas: sin información, no se consultó, no aplica, etc.

                  ResumenPor qué una sección no tiene entradas
                  Comentarios

                  Regla de negocio: Solo si la sección no tiene entradas (cmp-2).

                  Regla de validación: Debe pertenecer al catálogo motivo de lista vacía.

                  Control0..1
                  VinculaciónLos códigos DEBERÍAN tomarse de ListEmptyReasons
                  (preferred to http://hl7.org/fhir/ValueSet/list-empty-reason)
                  TipoCodeableConcept
                  Requisitos

                  Distingue una sección vacía porque no hay información de una que no se consultó o no aplica, que significan cosas distintas para quien lee.

                  74. CRLMDocumentoClinico.sensibilidad
                  Definición

                  Etiqueta de seguridad que dice por qué el documento es sensible: 1. Salud mental (PSY) 2. Notas de psicoterapia (PSYTHPN) 3. VIH/sida (HIV) 4. Infecciones de transmisión sexual (STD) 5. Violencia sexual, doméstica o abuso (SDV) 6. Salud sexual y reproductiva (SEX) 7. Consumo de sustancias (SUD) 8. Enfermedad genética (GDIS). Ver la propuesta para Costa Rica abajo.

                  ResumenEtiqueta de seguridad que dice por qué el documento es sensible
                  Comentarios

                  Regla de negocio: La asigna el autor o el sistema que genera el documento, según su contenido. Una sensibilidad exige confidencialidad R o V. Las entradas del documento que la tienen la llevan también en su propio meta.security, y el documento lleva todas las de sus entradas. Las etiquetas no deciden por sí solas quién accede: lo decide la política de acceso del HIE, que las usa como insumo.

                  Regla de validación: Debe pertenecer al catálogo sensibilidad de la información. Invariante cr-documento-sensibilidad (error): meta.security.where(system = 'http://terminology.hl7.org/CodeSystem/v3-ActCode').exists() implies meta.security.where(system = 'http://terminology.hl7.org/CodeSystem/v3-Confidentiality' and code in ('R' | 'V')).exists().

                  Comentarios: La lista y la confidencialidad mínima de cada categoría son una propuesta de la IG (pregunta 6).

                  Control0..*
                  VinculaciónLos códigos DEBEN tomarse de Sensibilidad de la información
                  (required to https://hl7.or.cr/fhir/terminology/ValueSet/cr-sensibilidad-informacion)
                  TipoCoding
                  Requisitos

                  Dice por qué el documento es sensible (salud mental, VIH, violencia), para que la política de acceso del HIE le aplique la protección que corresponde (decisión 6).