# Paciente - HL7 FHIR Costa Rica - Core v0.0.1-ballot

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Paciente**

## Resource Profile: Paciente 

| | | |
| :--- | :--- | :--- |
| *Official URL*:https://hl7.or.cr/fhir/core/StructureDefinition/cr-core-patient | *Version*:0.0.1-ballot | |
| * Standards status: *[Draft](http://hl7.org/fhir/R5/versions.html#std-process) | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 0 | *Computable Name*:CRCorePatient |
| **Copyright/Legal**: Usado con el permiso de HL7 International, todos los derechos resevados en los Licencias de HL7 Internacional. | | |

 
Perfil Patient para representar pacientes en Costa Rica, incluyendo identificadores oficiales y metadatos específicos del paciente. 

### Alcance y uso

El perfil base de paciente para Costas Rica pretende encapsular el modelo de datos más común y básico de pacientes en los sistemas de salud costarricense, abarcando tanto el sector primario como el secundario (médicos especialistas y hospitales) y los casos regionales. Por lo tanto, el perfil debería ser utilizable en la mayoría de los contextos costarricenses. Cabe destacar que el perfil es útil para quienes reciben atención en salud y social en las diferentes regiones del país.

### Identificadores de pacientes

Actualmente, este perfil de paciente solo refleja el uso de los identificadores nacionales de Costa Ruca de pacientes establecidos. A este punto, se soporta solo tres tipos de identificación:

1. [Cédula de identidad](https://www.tse.go.cr/cedula.html)
1. [DIMEX](https://migracion.go.cr/dimex/)
1. [Pasaporte](https://migracion.go.cr/pasaportes-y-permisos-de-salida/)

### Uso de la etiqueta de seguridad en pacientes

Si un proyecto de implementación necesita proteger el nombre y la dirección de un ciudadano costarricense, se recomienda incluir la etiqueta de seguridad de la siguiente manera:

```
{
  "resourceType" : "Bundle",
  "type" : "searchset",
  ... otros headers etc.....
  "entry" : [
     ... otroe entries ....
     {
       "resource": {
         "id" : "1",
         "meta" : {
           "security" : [{
             "system" : "http://terminology.hl7.org/CodeSystem/v3-ActCode",
             "code" : "R",
             "display" : "Restricted"
           }]
         }
         ... otros content etc.....
       }
     },
     ... otros entries ....
  ]
}

```

El uso de esta etiqueta debe interpretarse de acuerdo con la ley, lo que significa en términos generales que solo el personal que utiliza sistemas en asuntos públicos/oficiales puede ver el nombre y la dirección del paciente/ciudadano.

**Usages:**

* Refer to this Profile: [Alergia e Intolerancia](StructureDefinition-cr-core-allergy-intolerance.md), [Descripción Clínica](StructureDefinition-cr-core-composition.md), [Condición o Diagnóstico Clínico](StructureDefinition-cr-core-condition.md), [Inmunización](StructureDefinition-cr-core-immunization.md) and [Procedencia](StructureDefinition-cr-core-provenance.md)
* Examples for this Profile: [Patient/CRPatientCedula](Patient-CRPatientCedula.md), [Patient/CRPatientDeceasedBoolean](Patient-CRPatientDeceasedBoolean.md), [Patient/CRPatientDeceasedWithDate](Patient-CRPatientDeceasedWithDate.md), [Patient/CRPatientDimex](Patient-CRPatientDimex.md)... Show 10 more, [Patient/CRPatientInvalidTwoCedulas](Patient-CRPatientInvalidTwoCedulas.md), [Patient/CRPatientMultipleId](Patient-CRPatientMultipleId.md), [Patient/CRPatientPassport](Patient-CRPatientPassport.md), [Patient/CRPatientWithAddress](Patient-CRPatientWithAddress.md), [Patient/CRPatientWithCalculatedAge](Patient-CRPatientWithCalculatedAge.md), [Patient/CRPatientWithContactEmergency](Patient-CRPatientWithContactEmergency.md), [Patient/CRPatientWithContactMother](Patient-CRPatientWithContactMother.md), [Patient/CRPatientWithContactSpouse](Patient-CRPatientWithContactSpouse.md), [Patient/CRPatientWithReligion](Patient-CRPatientWithReligion.md) and [Patient/CRPatientWithSecurityTag](Patient-CRPatientWithSecurityTag.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.cr.core|current/StructureDefinition/cr-core-patient)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-cr-core-patient.csv), [Excel](StructureDefinition-cr-core-patient.xlsx), [Schematron](StructureDefinition-cr-core-patient.sch) 

### Notes:

Nota: los comentarios son bienvenidos y deben dirigirse al repositorio de Github (https://github.com/HL7-cr/core).



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "cr-core-patient",
  "language" : "es",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 0
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "draft"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "cgp"
  }],
  "url" : "https://hl7.or.cr/fhir/core/StructureDefinition/cr-core-patient",
  "version" : "0.0.1-ballot",
  "name" : "CRCorePatient",
  "title" : "Paciente",
  "status" : "draft",
  "experimental" : false,
  "date" : "2025-11-08",
  "publisher" : "Iniciativa HL7 Costa Rica",
  "contact" : [{
    "name" : "Iniciativa HL7 Costa Rica",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.or.cr"
    },
    {
      "system" : "email",
      "value" : "info@hl7.or.cr"
    }]
  },
  {
    "name" : "Iniciativa HL7 Costa Rica",
    "telecom" : [{
      "system" : "email",
      "value" : "info@hl7.or.cr",
      "use" : "work"
    },
    {
      "system" : "url",
      "value" : "https://hl7.or.cr",
      "use" : "work"
    }]
  }],
  "description" : "Perfil Patient para representar pacientes en Costa Rica, incluyendo identificadores oficiales y metadatos específicos del paciente.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "CR",
      "display" : "Costa Rica"
    }]
  }],
  "copyright" : "Usado con el permiso de HL7 International, todos los derechos resevados en los Licencias de HL7 Internacional.",
  "fhirVersion" : "5.0.0",
  "mapping" : [{
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "interface",
    "uri" : "http://hl7.org/fhir/interface",
    "name" : "Interface Pattern"
  },
  {
    "identity" : "cda",
    "uri" : "http://hl7.org/v3/cda",
    "name" : "CDA (R2)"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 V2 Mapping"
  },
  {
    "identity" : "loinc",
    "uri" : "http://loinc.org",
    "name" : "LOINC code for the element"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Patient",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Patient|5.0.0",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Patient",
      "path" : "Patient",
      "constraint" : [{
        "key" : "only-one-cedula",
        "severity" : "error",
        "human" : "El paciente no puede tener más de una cédula costarricense.",
        "expression" : "identifier.where(type.coding.code='cedula').count() <= 1",
        "source" : "https://hl7.or.cr/fhir/core/StructureDefinition/cr-core-patient|0.0.1-ballot"
      },
      {
        "key" : "only-one-dimex",
        "severity" : "error",
        "human" : "El paciente no puede tener más de un DIMEX.",
        "expression" : "identifier.where(type.coding.code='dimex').count() <= 1",
        "source" : "https://hl7.or.cr/fhir/core/StructureDefinition/cr-core-patient|0.0.1-ballot"
      }]
    },
    {
      "id" : "Patient.meta.security",
      "path" : "Patient.meta.security",
      "short" : "Etiqueta de seguridad",
      "definition" : "Las etiquetas de seguridad se pueden utilizar para proteger información sensible del paciente, como nombre y dirección. Se recomienda usar la etiqueta 'R' (Restricted) del vocabulario HL7 v3 ActCode cuando sea necesario proteger datos de pacientes.",
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://terminology.hl7.org/ValueSet/v3-Confidentiality|3.0.0"
      }
    },
    {
      "id" : "Patient.extension",
      "path" : "Patient.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Patient.extension:calculatedAge",
      "path" : "Patient.extension",
      "sliceName" : "calculatedAge",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-calculated-age|0.0.1-ballot"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.extension:religion",
      "path" : "Patient.extension",
      "sliceName" : "religion",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["https://hl7.or.cr/fhir/core/StructureDefinition/cr-patient-religion|0.0.1-ballot"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier",
      "path" : "Patient.identifier",
      "short" : "Identificadores oficiales y alternativos del paciente.",
      "definition" : "Lista de todos los documentos de identificación asociados a un paciente en Costa Rica. Incluye cédula de identidad, DIMEX, pasaporte u otros documentos válidos.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier.use",
      "path" : "Patient.identifier.use",
      "short" : "usual | official | temp | secondary | old",
      "definition" : "Indica el rol del identificador. Si el paciente posee una cédula de identidad costarricense, esta se recomienda como identificador 'official'.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier.type",
      "path" : "Patient.identifier.type",
      "short" : "Tipo de documento de identificación (Required)",
      "definition" : "Define el tipo de documento de identificación del paciente. Incluye cédula costarricense, DIMEX y pasaporte. Este perfil utiliza un conjunto de códigos nacionales para garantizar consistencia en la identificación.",
      "binding" : {
        "strength" : "required",
        "description" : "ValueSet de tipos de identificación oficiales y permitidos para pacientes en Costa Rica.",
        "valueSet" : "https://hl7.or.cr/fhir/terminology/ValueSet/cr-identifier-types"
      }
    },
    {
      "id" : "Patient.active",
      "path" : "Patient.active",
      "short" : "Si el registro del paciente está activo.",
      "definition" : "Indica si el paciente está activo en el sistema. Un valor 'true' significa que el paciente tiene un registro activo y es un paciente vigente. Un valor 'false' significa que el paciente es inactivo o ha sido desactivado del sistema.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.name",
      "path" : "Patient.name",
      "short" : "Nombre(s) y apellido(s) del paciente.",
      "definition" : "El nombre completo del paciente, incluyendo nombre(s) y apellido(s). Se recomienda utilizar el nombre oficial registrado en documentos de identidad.",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Patient.name.family",
      "path" : "Patient.name.family",
      "short" : "Primer apellido obligatorio; puede incluir el segundo apellido.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.name.given",
      "path" : "Patient.name.given",
      "short" : "Primer nombre obligatorio, segundo nombre opcional.",
      "min" : 1,
      "max" : "2",
      "mustSupport" : true
    },
    {
      "id" : "Patient.telecom",
      "path" : "Patient.telecom",
      "short" : "Información de contacto del paciente (teléfono, correo electrónico, etc.).",
      "definition" : "Teléfono, correo electrónico u otro medio de contacto para comunicarse con el paciente. Puede incluir múltiples números telefónicos y direcciones de correo.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.telecom.system",
      "path" : "Patient.telecom.system",
      "definition" : "Tipo de medio de comunicación: teléfono móvil, correo electrónico, etc.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.telecom.value",
      "path" : "Patient.telecom.value",
      "short" : "El número telefónico o dirección de correo electrónico.",
      "definition" : "El valor del punto de contacto, como un número telefónico o dirección de correo electrónico.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.telecom.use",
      "path" : "Patient.telecom.use",
      "short" : "home | work | temp | old | mobile",
      "definition" : "Propósito de este punto de contacto (principal, trabajo, móvil, etc.).",
      "mustSupport" : true
    },
    {
      "id" : "Patient.gender",
      "path" : "Patient.gender",
      "short" : "Sexo biológico del paciente.",
      "definition" : "Sexo biológico del paciente. Para Costa Rica se restringe a Hombre (male) o Mujer (female) en este perfil.",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://hl7.org/fhir/ValueSet/administrative-gender|5.0.0"
      }
    },
    {
      "id" : "Patient.birthDate",
      "path" : "Patient.birthDate",
      "short" : "Fecha de nacimiento del paciente.",
      "definition" : "Fecha de nacimiento del paciente. Este dato es obligatorio para el perfil CRCorePatient.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Patient.deceased[x]",
      "path" : "Patient.deceased[x]",
      "slicing" : {
        "discriminator" : [{
          "type" : "type",
          "path" : "$this"
        }],
        "ordered" : false,
        "rules" : "open"
      },
      "short" : "Información sobre el fallecimiento del paciente.",
      "definition" : "Indica si el paciente ha fallecido. Puede ser un indicador booleano (deceasedBoolean) o una fecha/hora específica del fallecimiento (deceasedDateTime). Es un campo opcional.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.deceased[x]:deceasedBoolean",
      "path" : "Patient.deceased[x]",
      "sliceName" : "deceasedBoolean",
      "short" : "Indica si el paciente ha fallecido (sí/no).",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "boolean"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.deceased[x]:deceasedDateTime",
      "path" : "Patient.deceased[x]",
      "sliceName" : "deceasedDateTime",
      "short" : "Fecha y hora exacta del fallecimiento.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "dateTime"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.address",
      "path" : "Patient.address",
      "short" : "Dirección(es) del paciente.",
      "definition" : "Una o más direcciones postales del paciente en Costa Rica. La dirección incluye provincia, cantón, distrito y detalles específicos de ubicación.",
      "type" : [{
        "code" : "Address",
        "profile" : ["https://hl7.or.cr/fhir/core/StructureDefinition/cr-address-base|0.0.1-ballot"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.use",
      "path" : "Patient.address.use",
      "short" : "home | work | temp | old | billing",
      "definition" : "Propósito de la dirección (principal, trabajo, temporal, etc.).",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.type",
      "path" : "Patient.address.type",
      "short" : "postal | physical | both",
      "definition" : "Tipo de dirección (postal, física o ambas).",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.line",
      "path" : "Patient.address.line",
      "short" : "Línea de dirección (calle, número, referencias).",
      "definition" : "Calle, número, apartamento y otras líneas de dirección específicas. Mínimo una línea requerida."
    },
    {
      "id" : "Patient.address.city",
      "path" : "Patient.address.city",
      "short" : "Cantón de Costa Rica.",
      "definition" : "Nombre del cantón (ciudad). Incluye una extensión con el código del cantón basado en el ZipCode de Costa Rica.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.district",
      "path" : "Patient.address.district",
      "short" : "Distrito de Costa Rica.",
      "definition" : "Nombre del distrito. Incluye una extensión con el código del distrito basado en el ZipCode de Costa Rica.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.state",
      "path" : "Patient.address.state",
      "short" : "Provincia de Costa Rica.",
      "definition" : "Nombre de la provincia. Incluye una extensión con el código de la provincia basado en el ZipCode de Costa Rica.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.postalCode",
      "path" : "Patient.address.postalCode",
      "definition" : "Código postal o código de localidad de Costa Rica (opcional).",
      "mustSupport" : true
    },
    {
      "id" : "Patient.address.country",
      "path" : "Patient.address.country",
      "short" : "Nombre del país (CR).",
      "definition" : "Nombre del país. Incluye una extensión con el código ISO 3166-1 alpha-3 (CR para Costa Rica)."
    },
    {
      "id" : "Patient.contact",
      "path" : "Patient.contact",
      "short" : "Contacto(s) del paciente (familiares, tutores, etc.).",
      "definition" : "Contacto personal o cuidador designado del paciente. Puede incluir familiares, tutores legales o personas de contacto de emergencia con relaciones específicas definidas en el CodeSystem de relaciones de Costa Rica.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.contact.relationship",
      "path" : "Patient.contact.relationship",
      "short" : "Tipo de relación (madre, padre, hermano, cónyuge, hijo/a, tutor, amigo, conviviente).",
      "definition" : "Tipo de relación entre el contacto y el paciente. Utiliza códigos SNOMED CT del CodeSystem de relaciones de Costa Rica.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "description" : "CodeSystem de relaciones: madre, padre, hermano, cónyuge, hijo, tutor legal, amigo, conviviente",
        "valueSet" : "https://hl7.or.cr/fhir/terminology/ValueSet/cr-relationships-set"
      }
    },
    {
      "id" : "Patient.contact.name",
      "path" : "Patient.contact.name",
      "short" : "Nombre del contacto.",
      "definition" : "Nombre completo del contacto del paciente.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.contact.telecom",
      "path" : "Patient.contact.telecom",
      "short" : "Información de contacto (teléfono, correo, etc.).",
      "definition" : "Teléfono, correo electrónico u otro dato para contactar al contacto del paciente.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.contact.address",
      "path" : "Patient.contact.address",
      "short" : "Dirección del contacto.",
      "definition" : "Dirección postal del contacto del paciente.",
      "mustSupport" : true
    },
    {
      "id" : "Patient.contact.gender",
      "path" : "Patient.contact.gender",
      "short" : "Sexo del contacto.",
      "definition" : "Sexo biológico del contacto.",
      "mustSupport" : true
    }]
  }
}

```
