Guía de Implementación ''cl core'' FHIR R4, (Versión Evolutiva)
1.8.10 - ci-build Chile flag

This page is part of the Chile Core (v1.8.10: STU2 Draft) based on FHIR (HL7® FHIR® Standard) R4. . For a full list of available versions, see the Directory of published versions

Resource Profile: CL Paciente

Official URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/CorePacienteCl Version: 1.8.10
Active as of 2024-03-19 Computable Name: PacienteCl

Copyright/Legal: Usado con el permiso de HL7 International, todos los derechos resevados en los Licencias de HL7 Internacional.

Este Perfil ha sido desarrollado para cubrir las necesidades del Caso de Uso de Receta Electrónica. Sin embargo, se ha modelado con el fin de cubrir las necesidades nacionales de un Recurso Paciente para un Historial Clínico Nacional

Ejemplos de uso en Diferentes Escenarios


  • Búsqueda de Datos demográficos de un paciente, haciendo uso de su identificación como RUN o Documento de Identificación
  • Búsquedas varias para datos demográficos específicos de Pacientes como Apellidos, Nombres o Dirección
  • Busqueda de Id de recurso por medio de algún parámetro de búsqueda, para busqueda de documentos o datos clínicos asociados al paciente.



Elementos Mandatorios y Must Support


El perfil presenta una serie de elementos de datos que siempre deben estar presentes en cada recurso que se genere desde este perfil. Estos elementos denominados como Mandatorios se pueden observar en elperfil con cardinalidad de valor inicial 1. Los elementos que deben ser Soportados, si la data esta presente en el recuso generado, se denominan (Must Support), y estos se expresan mediante la letra S en cada elemento o FhirPath que tiene esta categoría. Un elemento Must Support implica:

  • El sistema que recibe un recurso con un elemento Must Support debe almacearlo.
  • El sistema que recibe un recurso con un elemento Must Support debe poder hacer procesamiento de este elemento
  • El sistema que genera un recurso, no se ve obligado a definir los elementos Must Support a menos que estos sean Mandatorios
  • Un elemento Must Support no implica que sus rutas derivadas lo sea por herencia

La definición formal del Perfil en la legueta Text Summary indica cuantos de estos elementos hay distribuidos como elementos o rutas de estos.

Notas Adicionales


Consideraciones para la implementación:

  • Nacionalidad se agrega como una extensión local que figura como un slice de nombre CodigoPaises .
    • system para esta extensión corresponde a uno local creado con la ISO-3166-N
    • ValueSet para código es una expansión completa del CodeSystem
  • Considerar para el identifier.
    • El elemento identifier considera en type la declaración del tipo de documento.
      • Dado que uno de los tipos de documetos corresponde a una Cédula Nacional, se debió generar una extensión CodigoPaises para determinar la procedencia del documento.
    • Por motivos de no complicar el elemento no se desarrolló un slice para diferenciar el RUN. Sin embargo, es recomendable considerar el RUN como uno de los identificadores declarados.
  • Para el elemento name se agrega la extensión externa de 2o apellido y considear un slice que diferencia:
    • Nombres oficial
    • Nombre social, el cual elimina elementos como el apellido
  • El elemento address considera la creación de un nuevo tipo de datos denominado ClAddress, que contiene lo mismo que el tipo original más las extensiones para codificar comunas, provincias, regiones y países.
  • El elemento contact consiera una extsión para poder darle identificación al contacto.
  • El perfil posee todos los elementos que lo hacen compatible con un Paciente IPS.

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from Patient

NameFlagsCard.TypeDescription & Constraintsdoco
.. Patient Patient
... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... IdentidadDeGenero S0..1CodeableConceptIdentidad De Genero
URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/IdentidadDeGenero
Binding: Identidad de Genero (required)
... SexoBiologico S0..1CodeableConceptSexo Biologico del paciente
URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/SexoBiologico
Binding: AdministrativeGender (required)
... identifier S0..*IdentifierListados de Id de Paciente. De poseer una CI con RUN vigente, este DEBE ser ingresado
.... extension S0..*ExtensionExtension
.... use S0..1codeusual | official | temp | secondary | old (If known)
.... type S0..1CodeableConceptTipo de documento de Id (Extensible)
Binding: Tipos de Documentos (extensible): Value Set de Tipos de Documentos y CI Nacionales

..... extension 0..*ExtensionPaís de Origen del Documento de Id
..... paises S0..1CodeableConceptCodigo de Identificación de países
URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/CodigoPaises
..... coding S0..*CodingCode defined by a terminology system
...... system S0..1uriSistema de identificación de tipos de documentos
...... code S0..1codeCódigo de Tipo de Documento
...... display S0..1stringGlosa del Código Documento
.... value 0..1stringNúmero o valor de identificación
... Slices for name 0..*HumanNameNombres y Apellidos del Paciente considerando, según el caso: 1er Nombre, Nombres, 1er Apellido y 2o Apellido
Slice: Unordered, Open by value:use
.... name:NombreOficial S0..1HumanNameDeterminación del nombre registrado oficialmente del Paciente
..... use S1..1codeuso del nombre del paciente
Required Pattern: official
..... family S0..1string1er Apellido
...... Slices for extension 0..*ExtensionExtensión para el segundo apellido
Slice: Unordered, Open by value:url
...... segundoApellido S0..1stringSegundo Apellido
URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/SegundoApellido
..... given S0..*stringPrimer nombre y nombres del Paciente
.... name:NombreSocial S0..1HumanNamenombre recurrente que usa el paciente
..... use S1..1codeuso que se le da al nombre
Required Pattern: usual
..... text 0..0
..... family 0..0
..... given S1..*stringNombre Social
..... prefix 0..0
..... suffix 0..0
..... period 0..0
... telecom S0..*ContactPointDetalles de contacto del Paciente
.... system S0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): Tipo de contacto para HL7 FHIR

.... value S0..1stringDato del contato del paciente descrito
.... use S0..1codehome | work | temp | old | mobile
Binding: ContactPointUse (required)
... gender S0..1codeSexo Registrado. (male | female | other | unknown (requerido))
... birthDate S0..1dateFecha de nacimiento del Paciente.
... address S0..*ClAddressTipo de dato para agragar la dirección de un paciente
... contact S0..*BackboneElementContacto, tutor legal o representante del Paciente
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... IdContacto S0..*(Complex)Identificación del Contacto
URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/IdContacto
.... relationship S0..*CodeableConceptRelación legal o de paretezco entre el contacto y el paciente
Binding: PatientContactRelationship (required): VS FHIR para relación del contacto con el Paciente

..... coding S0..*CodingCode defined by a terminology system
.... name S0..1HumanNameNombre del Contacto
..... use S0..1codeuso del nombre del paciente
Required Pattern: official
..... family S0..1string1er Apellido
...... Slices for extension 0..*ExtensionExtensión para 2o apellido
Slice: Unordered, Open by value:url
...... segundoApellido S0..1stringSegundo Apellido
URL: https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/SegundoApellido
..... given S0..*stringPrimer nombre y nombres del Contacto o Representante Legal
... communication S0..*BackboneElementLenguaje en el cual se puede comunicar con el paciente
.... language S1..1CodeableConceptLenguaje específico
Binding: Codigos Lenguaje (required): Value Set de HL7, # de elementos es muy grande para poder visualizarlo

... generalPractitioner S0..*Reference(Organization | Practitioner)Proveedor de Salud designado como principal
.... reference S0..1stringURI de referencia a la Organización o a un Médico
.... display S0..1stringTexto alternativo a la referencia

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Patient.identifier.typeextensibleVSTiposDocumentos
https://hl7chile.cl/fhir/ig/clcore/ValueSet/VSTiposDocumentos
from this IG
Patient.telecom.systemrequiredContactPointSystem
http://hl7.org/fhir/ValueSet/contact-point-system
from the FHIR Standard
Patient.telecom.userequiredContactPointUse
http://hl7.org/fhir/ValueSet/contact-point-use
from the FHIR Standard
Patient.contact.relationshiprequiredPatientContactRelationship
http://hl7.org/fhir/ValueSet/patient-contactrelationship
from the FHIR Standard
Patient.communication.languagerequiredVSCodigoslenguaje (a valid code from Codigos Lenguaje)
https://hl7chile.cl/fhir/ig/clcore/ValueSet/VSCodigoslenguaje
from this IG

 

Other representations of profile: CSV, Excel, Schematron

Notes:

Notas de Implementación


Se describe abajo un resumen de las interacciones de un Server RESTful FHIR con este perfil, como lo son los parámetors de búsqueda y el soporte para este perfil de uso nacional.

Search Parameters Mandatorios


Elemento Nota Search Param Ejemplo
id Se debe soportar búsqueda sobre el id de recurso GET [base]/Patient[id] GET [base]/Patient/1032702
GET [base]/Patient?_id=1032702
identification Se debe poder buscar paciente por medio del identificador GET [base]/Patient?identifier= [value] GET [base]/Patient?identifier=19222444-1
name Se debe poder buscar pacientes por nombre, lo que aplica a cualquier elemento en la ruta GET [base]/Patient?name=[string]
GET [base]/Patient?name.family=[string]
GET [base]/Patient?name=Ordenes
GET [base]/Patient?name.family=Ordenes