Datos demográficos y de identificación de la persona que recibe atención de salud, así como de sus contactos (familiares o tutores legales). Es la base sobre la que se referencian los demás artefactos clínicos de la IG core.

Identificador del paciente. Cada ocurrencia reúne un número y su tipo; un paciente puede tener varias (por ejemplo, cédula y pasaporte).

Regla de negocio: Todo paciente debe tener al menos un identificador. Se registra el número oficial (cédula, DIMEX, pasaporte) cuando exista, aunque la persona no presente el documento físico; si no tiene ninguno, se usa el número de expediente del establecimiento (expediente-local) como identificador provisional. La falta de documento no impide registrar ni atender al paciente.

Regla de validación: No puede haber dos ocurrencias con el mismo tipo y número. Debe haber al menos una ocurrencia vigente. Entre las ocurrencias vigentes (identificacion.vigente = verdadero): a lo sumo una cedula-nacional, una dimex y una ccss; cedula-nacional y dimex no pueden estar vigentes a la vez (al naturalizarse, el DIMEX pasa a old); puede haber varios pasaporte solo si su país emisor es distinto, y varios expediente-local solo si su establecimiento es distinto. Ver combinaciones admitidas. Invariantes del recurso: cr-identificador-unico (sin repetir system y número), cr-paciente-identificador-vigente (al menos uno vigente), cr-paciente-documento-unico (a lo sumo una cédula, un DIMEX y un número CCSS vigentes, y no cédula y DIMEX a la vez) y cr-paciente-pasaporte-expediente (pasaportes vigentes de países distintos y expedientes vigentes de establecimientos distintos).

Comentarios: Las personas menores de edad costarricenses tienen número de cédula desde la inscripción del nacimiento, tengan o no Tarjeta de Identidad de Menores (TIM); se registra como Cédula Nacional. Cuando se obtiene el número oficial de un paciente registrado con identificador provisional, se agrega una nueva ocurrencia y la provisional pasa a no vigente.

Sin un identificador no se puede encontrar al paciente en otro sistema ni unir sus registros en el MPI Nacional. Admite varios porque una misma persona puede tener cédula, DIMEX, pasaporte y expedientes en distintos establecimientos.

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

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.

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.

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).

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.

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.

Número de identificación tal cual se muestra en el documento oficial.

Regla de validación: Formato según tipo: Cédula nacional (9 dígitos numéricos sin guiones), DIMEX (11-12 dígitos numéricos; se aceptan ceros a la izquierda en la captura, pero se guardan y envían sin ellos), Pasaporte (alfanumérico de 6 a 15 caracteres), Expediente del establecimiento (lo define cada establecimiento). Invariantes cr-cedula-nacional-value y cr-dimex-value (sección 5 de tipos de identificación), cr-pasaporte-system y cr-expediente-system.

Es el valor con que los sistemas buscan al paciente. Sin él, el identificador no sirve.

Tipo de documento o identificador al que corresponde el número.

Regla de negocio: Se debe registrar el tipo de documento según el estatus legal y procedencia (Cédula nacional para nacionales, incluidas las personas menores de edad; DIMEX para extranjeros residentes; Pasaporte para extranjeros en tránsito; o carné CCSS).

Regla de validación: Debe pertenecer al catálogo tipos de identificación: Cédula Nacional, DIMEX, Número de Pasaporte, Número de Identificación CCSS, Número de Expediente del Establecimiento.

El mismo número puede existir en dos tipos distintos. El tipo dice quién asignó el número y cómo validarlo, y de él se arma el system del identificador.

País que emitió el pasaporte.

Regla de negocio: Obligatorio si identificacion.tipo es pasaporte; no se registra para los demás tipos. Es el país que emitió el documento, que puede no coincidir con la nacionalidad (por ejemplo, en personas con doble nacionalidad).

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países. No se usa el código de la zona de lectura mecánica (MRZ) del pasaporte cuando difiere del ISO (por ejemplo, Alemania es DEU, no D).

Un número de pasaporte solo es único dentro de su país. Sin el país emisor, dos pasaportes de países distintos se podrían confundir.

Establecimiento de salud que asignó el número de expediente.

Regla de negocio: Obligatorio si identificacion.tipo es expediente-local; no se registra para los demás tipos.

Regla de validación: Código con prefijo según quién asigna el expediente: cj- + cédula jurídica (la CCSS usa la suya, cj-4000042147, para todas sus unidades), cn- + cédula nacional del titular o dimex- + DIMEX del titular (ver código del establecimiento). Invariantes cr-expediente-system y cr-expediente-assigner (el expediente lleva assigner).

Comentarios: Mientras no exista un catálogo de establecimientos de salud, el código se arma con un identificador existente y un prefijo (decisión 14).

Cada establecimiento numera sus expedientes por su cuenta. El establecimiento hace único el número y dice a quién pedir el expediente.

Indica si el identificador está vigente o si se conserva solo como histórico.

Regla de negocio: Un identificador deja de estar vigente cuando es reemplazado: el expediente provisional al obtener el número oficial, el DIMEX al naturalizarse, el pasaporte anterior al renovarlo. Los identificadores no vigentes no se eliminan, porque permiten encontrar registros anteriores.

Regla de validación: Invariante cr-paciente-identificador-uso: un expediente vigente es temp, los demás tipos vigentes son official, y uno no vigente es old.

Permite cambiar de identificador (naturalización, renovación del pasaporte, paso del expediente provisional al número oficial) sin perder los registros que usaron el anterior.

Primer y segundo nombre.

Regla de negocio: Obligatorio el primer nombre; el segundo nombre es condicional si consta en el documento oficial de identidad.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Con los apellidos, la fecha de nacimiento y el sexo, el nombre permite buscar al paciente cuando no se conoce su identificador y confirmar su identidad en la atención.

Primer apellido del paciente, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. En Costa Rica cada persona lleva dos apellidos, por lo general uno de cada progenitor, en el orden que eligieron los progenitores al inscribir el nacimiento: el primero puede ser el de la madre o el del padre.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE.

En Costa Rica los dos apellidos forman parte del nombre legal y se buscan por separado. Es una estructura para registrar, junto al apellido, el progenitor del que proviene.

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

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.

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.

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).

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.

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.

Texto del primer apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene cada apellido: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE. El primer apellido puede ser el de la madre o el del padre. Si la persona cambia el orden ante el TSE, se actualiza el registro con el orden nuevo. En casos de filiación única, se registra el único apellido legal.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Es el apellido con que se busca y se muestra al paciente. Va aparte del segundo porque en FHIR family lleva los dos juntos.

Progenitor (madre o padre) del que proviene el primer apellido del paciente. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Opcional. Se registra solo cuando se conoce con certeza, preferiblemente a partir del Registro Civil del TSE: el documento de identidad no indica de qué progenitor viene cada apellido. No se deduce de la posición. Los dos apellidos pueden tener el mismo origen (filiación única, dos madres o dos padres). Solo se registra si existe el primer apellido.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

El documento de identidad no dice de qué progenitor viene cada apellido y la posición no lo indica. Cuando se conoce, sirve para la filiación y para comparar con registros de otros países.

Segundo apellido del paciente, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. Lo tienen todas las personas costarricenses; muchas personas extranjeras no tienen segundo apellido.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad oficial. Igual que el primero, el orden no indica de qué progenitor viene. Obligatorio para personas costarricenses; opcional para extranjeros cuyo país de origen no contempla segundo apellido.

Igual que el primer apellido, forma parte del nombre legal. Es opcional porque muchas personas extranjeras no tienen segundo apellido.

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

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.

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.

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).

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.

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.

Texto del segundo apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene cada apellido: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE. El primer apellido puede ser el de la madre o el del padre. Obligatorio para personas costarricenses; opcional para extranjeros cuyo país de origen no contempla segundo apellido.

Regla de validación: Si se registra: hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Permite buscar por el segundo apellido y distinguir a personas con el mismo nombre y el mismo primer apellido.

Progenitor (madre o padre) del que proviene el segundo apellido del paciente. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Opcional. Se registra solo cuando se conoce con certeza, preferiblemente a partir del Registro Civil del TSE: el documento de identidad no indica de qué progenitor viene cada apellido. No se deduce de la posición. Los dos apellidos pueden tener el mismo origen (filiación única, dos madres o dos padres). Solo se registra si existe el segundo apellido.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Por la misma razón que el origen del primer apellido: la posición no indica de qué progenitor viene.

Sexo asignado al nacer, con fines clínicos (excluye la interpretación de autopercepción).

Regla de negocio: Debe registrarse el sexo asignado al nacer con fines estrictamente clínicos, farmacológicos y de riesgo médico, sin sustituir la identidad de género. En esta versión es el único dato de sexo del modelo: no se registra un sexo administrativo aparte.

Regla de validación: Debe pertenecer al catálogo sexo asignado al nacer: mujer (female), hombre (male), desconocido (unknown).

Lo necesitan las decisiones clínicas (rangos de referencia, dosis, tamizajes) y el MPI para distinguir a dos personas. Se registra con fines clínicos, sin sustituir la identidad de género.

Fecha de nacimiento del paciente, tal como consta en su documento de identidad (cédula, DIMEX o pasaporte).

Regla de negocio: Fecha de nacimiento oficial que figura en el documento de identidad. Utilizada para el cálculo de la edad cronológica y grupo etario del paciente.

Regla de validación: Formato estándar ISO 8601 (AAAA-MM-DD). La fecha debe ser igual o anterior a la fecha actual y no mayor a 130 años en el pasado. Invariante cr-persona-fecha-nacimiento: $this {= today() and $this }= today() - 130 years.

Sirve para calcular la edad, que condiciona dosis, rangos de referencia y programas por grupo etario. Es además uno de los datos con que el MPI distingue a dos personas con el mismo nombre.

Estado civil del paciente, según los estados aceptados en Costa Rica: 1. Soltero(a) 2. Casado(a) 3. Divorciado(a) 4. Viudo(a) 5. Unión de hecho

Regla de negocio: Situación conyugal declarada por el paciente o validada ante el registro civil costarricense. No condiciona la atención médica.

Regla de validación: Si está presente, debe coincidir con el catálogo estado civil: Soltero(a), Casado(a), Divorciado(a), Viudo(a) o Unión de hecho.

Lo piden los formularios administrativos y las estadísticas de salud. Es opcional porque no condiciona la atención.

Teléfono para contacto.

Regla de negocio: Número telefónico para contacto directo, recordatorios y seguimiento ambulatorio. Se pueden registrar múltiples líneas (móvil, habitación, laboral).

Regla de validación: Formato E.164: +, el código de país y el número, sin espacios ni guiones; en Costa Rica, +506 y 8 dígitos (o un número 800 o 900 de 10 dígitos). La captura puede omitir el +506, pero el sistema lo agrega antes de guardar o enviar. Una extensión interna va después de ;ext= (RFC 3966). Invariante común cr-telefono.

Permite contactar al paciente desde cualquier establecimiento para citas, recordatorios, resultados y seguimiento.

Correo para contacto.

Regla de negocio: Dirección de correo electrónico para notificaciones digitales, entrega de resultados y portales de salud. Opcional pero recomendado.

Regla de validación: Estructura estándar de correo según RFC 5322 (usuario@dominio.extensión). Longitud máxima de 100 caracteres.

Es el canal para las notificaciones digitales, la entrega de resultados y el acceso a portales de salud.

País o países de los que el paciente es nacional.

Regla de negocio: País o países de nacionalidad legal del paciente. Permite registro múltiple en caso de doble ciudadanía. Si la nacionalidad no se conoce, se envía la extensión data-absent-reason con unknown en lugar del código. Si la persona es apátrida, se envía data-absent-reason con not-applicable y el texto "Apátrida"; en ese caso no puede haber otra nacionalidad.

Regla de validación: Debe corresponder al código ISO 3166-1 alfa-3 del país (ej. CRI), según el catálogo de nacionalidad. Invariante cr-persona-apatrida: si una nacionalidad lleva data-absent-reason = not-applicable, no hay otra.

La necesitan las estadísticas de salud, la atención de personas extranjeras (turismo médico, migración) y el intercambio con PH4H. Admite varias por la doble nacionalidad.

Dirección del paciente. Cada ocurrencia es una dirección completa.

Regla de negocio: Direcciones del paciente, en Costa Rica o en otro país. Un paciente puede tener varias: por ejemplo, un turista médico registra su residencia en el extranjero (uso residencia) y el lugar donde se aloja en Costa Rica (uso temporal), que sirve para el seguimiento. La dirección en Costa Rica se usa para zonificación de salud y adscripción a un centro de atención.

Regla de validación: Si direccion.pais es CRI, provincia, canton y distrito son obligatorios y deben ser concordantes entre sí. A lo sumo una dirección con uso residencia (invariante cr-persona-residencia).

Ubica al paciente para su adscripción al área de salud y al EBAIS, la vigilancia epidemiológica y las visitas domiciliares. Admite varias para quien reside en el extranjero y se aloja en Costa Rica.

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

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.

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.

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).

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.

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.

Indica si es la residencia habitual o una dirección temporal.

Regla de negocio: Residencia (home): donde vive habitualmente. Temporal (temp): donde se aloja por un tiempo, por ejemplo durante un tratamiento o una recuperación.

Regla de validación: Solo home o temp, del ValueSet HL7 address-use (invariante cr-direccion-uso-persona).

Distingue la residencia habitual, que define la adscripción, de una dirección temporal, que solo sirve para el seguimiento.

País de la dirección.

Regla de negocio: Obligatorio. Determina qué reglas aplican al resto de la dirección.

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países.

Decide si la dirección sigue la División Territorial Administrativa de Costa Rica o es texto libre de otro país.

Provincia (Costa Rica) o estado, región o departamento (otro país).

Regla de negocio: Obligatoria si el país es CRI. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de provincia de la División Territorial Administrativa del SNIT (1 a 7).

Obligatorio si el país es CRI, por invariante.

Es el primer nivel de la División Territorial Administrativa. Con códigos, los sistemas pueden agrupar y comparar los datos por territorio.

Cantón (Costa Rica) o ciudad (otro país).

Regla de negocio: Obligatorio si el país es CRI y debe pertenecer a la provincia indicada. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de cantón de la DTA del SNIT (3 dígitos), concordante con la provincia.

Obligatorio si el país es CRI, por invariante.

Es el segundo nivel de la División Territorial Administrativa, con el que se organizan muchas estadísticas de salud.

Distrito (Costa Rica).

Regla de negocio: Obligatorio si el país es CRI y debe pertenecer al cantón indicado. No aplica a otros países.

Regla de validación: Si el país es CRI: código de distrito de la DTA del SNIT (5 dígitos), concordante con el cantón.

Obligatorio si el país es CRI, por invariante.

Es el nivel más fino de la División Territorial Administrativa, el que usan la adscripción a un EBAIS y la vigilancia epidemiológica.

Barrio (zona urbana) o poblado (zona rural) dentro del distrito, en Costa Rica; barrio o colonia en otro país.

Regla de negocio: Opcional. En Costa Rica se registra el nombre del barrio o poblado tal como aparece en la División Territorial Administrativa publicada en La Gaceta, y debe estar dentro del distrito indicado.

Regla de validación: Texto de hasta 100 caracteres. No se valida contra un catálogo: el SNIT no publica barrios ni poblados con código.

Precisa la ubicación dentro del distrito para las visitas domiciliares y el estudio de brotes.

Código postal.

Regla de negocio: Opcional en cualquier país.

Lo usan las direcciones de otros países y algunos servicios de correspondencia. Es opcional porque en Costa Rica se usa poco.

Señas (Costa Rica) o calle y número (otro país).

Regla de negocio: Descripción para localizar el lugar: puntos de referencia en Costa Rica, o calle, número y apartamento en el extranjero.

Regla de validación: Longitud máxima de 250 caracteres.

En Costa Rica una dirección se da con puntos de referencia. Sin las señas no se puede llegar al lugar.

Dirección completa, tal como se muestra o se imprime.

Regla de negocio: Incluye los nombres (no los códigos) de provincia, cantón y distrito.

Regla de validación: Longitud mínima de 5 y máxima de 250 caracteres.

Permite mostrar o imprimir la dirección tal cual, sin que cada sistema la tenga que armar a partir de los códigos.

Persona de contacto del paciente: familiar, cónyuge, tutor legal o una persona que actúa en nombre de una organización (por ejemplo, el PANI). Sigue la estructura del elemento Patient.contact de FHIR R5.

Regla de negocio: Contactos de emergencia, familiares a quienes avisar o contactos de una institución. El tutor legal, el progenitor de una persona menor de edad y quien firma un consentimiento no se registran aquí sino como persona relacionada, que tiene identificación; una misma persona no se registra en los dos.

Regla de validación: Cada contacto debe tener al menos nombre, teléfono o correo, dirección u organización (invariante pat-1 de FHIR R5); en este modelo el nombre ya es obligatorio.

Dice a quién avisar en una emergencia o a quién llamar si no se localiza al paciente, sin tener que identificar formalmente a esa persona.

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

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.

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.

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).

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.

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.

Indica el tipo de relación directa que tiene el contacto con el paciente: cónyuge, padre, madre, tutor legal, hijo(a), hermano(a) u otro familiar.

Regla de negocio: Vínculo legal, familiar o asistencial del contacto con el paciente.

Regla de validación: Debe corresponder a los valores del catálogo tipo de relación: Cónyuge (SPS), Padre (FTH), Madre (MTH), Tutor legal (GUARD), Hijo(a) (CHILD), Hermano(a) (SIB) u Otro familiar (FAMMEMB), de HL7 v3-RoleCode.

Dice qué vínculo tiene el contacto con el paciente, para saber a quién avisar primero.

Primer y segundo nombre.

Regla de negocio: Nombre(s) de pila del contacto registrado según su documento oficial de identidad. Obligatorio el primer nombre.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Permite dirigirse al contacto y reconocerlo cuando se comunica con el establecimiento.

Primer apellido del contacto, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. En Costa Rica cada persona lleva dos apellidos, por lo general uno de cada progenitor, en el orden que eligieron los progenitores al inscribir el nacimiento: el primero puede ser el de la madre o el del padre.

Regla de negocio: Igual que en el paciente.

Con los nombres, permite reconocer al contacto sin un documento. Usa la misma estructura que el apellido del paciente, para no tener dos formas de registrar un apellido.

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

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.

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.

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).

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.

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.

Texto del primer apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad del contacto. Igual que en el paciente, el orden no indica de qué progenitor viene.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Con los nombres, permite reconocer al contacto.

Progenitor (madre o padre) del que proviene el primer apellido del contacto. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Igual que en el paciente: opcional, solo cuando se conoce con certeza, sin deducirlo de la posición. Solo se registra si existe el primer apellido del contacto.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Se conserva para que el apellido del contacto tenga la misma estructura que el del paciente.

Segundo apellido del contacto, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. Lo tienen todas las personas costarricenses; muchas personas extranjeras no tienen segundo apellido.

Regla de negocio: Igual que en el paciente.

Igual que el primer apellido del contacto. Es opcional porque muchas personas extranjeras no tienen segundo apellido.

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

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.

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.

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).

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.

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.

Texto del segundo apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad del contacto. Igual que en el paciente, el orden no indica de qué progenitor viene. Requerido para costarricenses; opcional para extranjeros según su ordenamiento legal de origen.

Regla de validación: Si se registra: hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Ayuda a distinguir contactos con el mismo nombre y el mismo primer apellido.

Progenitor (madre o padre) del que proviene el segundo apellido del contacto. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Igual que en el paciente: opcional, solo cuando se conoce con certeza, sin deducirlo de la posición. Solo se registra si existe el segundo apellido del contacto.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Se conserva para que el apellido del contacto tenga la misma estructura que el del paciente.

Teléfono para contacto.

Regla de negocio: Medio de comunicación prioritario con el contacto para notificaciones médicas, emergencias y autorizaciones asistenciales.

Regla de validación: Formato E.164: +, el código de país y el número, sin espacios ni guiones; en Costa Rica, +506 y 8 dígitos (o un número 800 o 900 de 10 dígitos). La captura puede omitir el +506, pero el sistema lo agrega antes de guardar o enviar. Una extensión interna va después de ;ext= (RFC 3966). Invariante común cr-telefono.

Es el medio más rápido para avisar al contacto en una emergencia.

Correo para contacto.

Regla de negocio: Cuenta de correo electrónico del contacto para notificaciones formales y comunicaciones digitales. Opcional.

Regla de validación: Debe cumplir con la estructura estándar según RFC 5322 (usuario@dominio.extensión). Longitud máxima de 100 caracteres.

Sirve para las comunicaciones formales que no son urgentes.

Dirección del contacto. Cada ocurrencia es una dirección completa.

Regla de negocio: Dirección del contacto para localización, notificaciones presenciales o contingencias. Puede estar en Costa Rica o en otro país.

Regla de validación: Si contacto.direccion.pais es CRI, provincia, canton y distrito son obligatorios y deben ser concordantes entre sí.

Permite localizar al contacto o enviarle una notificación presencial cuando no responde por teléfono.

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

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.

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.

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).

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.

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.

Indica si es la residencia habitual o una dirección temporal.

Regla de negocio: Igual que en el paciente. Residencia (home): donde vive habitualmente. Temporal (temp): donde se aloja por un tiempo, por ejemplo durante un tratamiento o una recuperación.

Regla de validación: Solo home o temp, del ValueSet HL7 address-use (invariante cr-direccion-uso-persona).

Igual que en la dirección del paciente: distingue la residencia habitual de una dirección temporal.

País de la dirección.

Regla de negocio: Igual que en el paciente. Obligatorio. Determina qué reglas aplican al resto de la dirección.

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países.

Igual que en la dirección del paciente: decide si la dirección sigue la División Territorial Administrativa o es de otro país.

Provincia (Costa Rica) o estado, región o departamento (otro país).

Regla de negocio: Igual que en el paciente. Obligatoria si el país es CRI. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de provincia de la División Territorial Administrativa del SNIT (1 a 7).

Obligatorio si el país es CRI, por invariante.

Igual que en la dirección del paciente: primer nivel de la División Territorial Administrativa.

Cantón (Costa Rica) o ciudad (otro país).

Regla de negocio: Igual que en el paciente. Obligatorio si el país es CRI y debe pertenecer a la provincia indicada. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de cantón de la DTA del SNIT (3 dígitos), concordante con la provincia.

Obligatorio si el país es CRI, por invariante.

Igual que en la dirección del paciente: segundo nivel de la División Territorial Administrativa.

Distrito (Costa Rica).

Regla de negocio: Igual que en el paciente. Obligatorio si el país es CRI y debe pertenecer al cantón indicado. No aplica a otros países.

Regla de validación: Si el país es CRI: código de distrito de la DTA del SNIT (5 dígitos), concordante con el cantón.

Obligatorio si el país es CRI, por invariante.

Igual que en la dirección del paciente: nivel más fino de la División Territorial Administrativa.

Barrio (zona urbana) o poblado (zona rural) dentro del distrito, en Costa Rica; barrio o colonia en otro país.

Regla de negocio: Opcional. En Costa Rica se registra el nombre del barrio o poblado tal como aparece en la División Territorial Administrativa publicada en La Gaceta, y debe estar dentro del distrito indicado.

Regla de validación: Texto de hasta 100 caracteres. No se valida contra un catálogo: el SNIT no publica barrios ni poblados con código.

Igual que en la dirección del paciente: precisa la ubicación dentro del distrito.

Código postal.

Regla de negocio: Igual que en el paciente. Opcional en cualquier país.

Igual que en la dirección del paciente: lo usan las direcciones de otros países.

Señas (Costa Rica) o calle y número (otro país).

Regla de negocio: Igual que en el paciente. Descripción para localizar el lugar: puntos de referencia en Costa Rica, o calle, número y apartamento en el extranjero.

Regla de validación: Longitud máxima de 250 caracteres.

Igual que en la dirección del paciente: sin las señas no se puede llegar al lugar.

Dirección completa, tal como se muestra o se imprime.

Regla de negocio: Igual que en el paciente. Incluye los nombres (no los códigos) de provincia, cantón y distrito.

Regla de validación: Longitud mínima de 5 y máxima de 250 caracteres.

Igual que en la dirección del paciente: permite mostrar la dirección sin armarla a partir de los códigos.

Sexo asignado al nacer del contacto.

Regla de negocio: Obligatorio. Igual que en el paciente, es el único dato de sexo del contacto en esta versión.

Regla de validación: Debe pertenecer al catálogo sexo asignado al nacer: mujer (female), hombre (male), desconocido (unknown).

Completa los datos con que se reconoce al contacto y permite distinguir a dos contactos con el mismo nombre.

Cédula jurídica de la organización en nombre de la cual actúa el contacto o para la que trabaja (por ejemplo, el PANI cuando tiene la tutela de una persona menor de edad).

Regla de negocio: Opcional. Se registra cuando el contacto actúa en representación de una institución.

Regla de validación: Cédula jurídica de 10 dígitos sin guiones (ver tipos de identificación de organizaciones). Invariante cr-referencia-cedula-juridica.

Cuando el contacto actúa en nombre de una institución (por ejemplo, el PANI), quien responde es la institución y no la persona.

Periodo en que el contacto es válido para el paciente.

Regla de negocio: Opcional. Se usa cuando la relación tiene vigencia limitada, por ejemplo una tutela temporal.

Regla de validación: Si hay fecha de inicio y de fin, el inicio no puede ser posterior al fin.

Algunas relaciones son temporales, como una tutela o un cuidador durante una hospitalización. El periodo evita avisar a quien ya no es contacto.

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

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.

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.

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).

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.

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.

Fecha desde la que el contacto es válido.

Marca desde cuándo se puede recurrir al contacto.

Fecha hasta la que el contacto es válido.

Marca hasta cuándo es válido el contacto; después ya no se le avisa.

Datos demográficos y de identificación de la persona que recibe atención de salud, así como de sus contactos (familiares o tutores legales). Es la base sobre la que se referencian los demás artefactos clínicos de la IG core.

Identificador del paciente. Cada ocurrencia reúne un número y su tipo; un paciente puede tener varias (por ejemplo, cédula y pasaporte).

Regla de negocio: Todo paciente debe tener al menos un identificador. Se registra el número oficial (cédula, DIMEX, pasaporte) cuando exista, aunque la persona no presente el documento físico; si no tiene ninguno, se usa el número de expediente del establecimiento (expediente-local) como identificador provisional. La falta de documento no impide registrar ni atender al paciente.

Regla de validación: No puede haber dos ocurrencias con el mismo tipo y número. Debe haber al menos una ocurrencia vigente. Entre las ocurrencias vigentes (identificacion.vigente = verdadero): a lo sumo una cedula-nacional, una dimex y una ccss; cedula-nacional y dimex no pueden estar vigentes a la vez (al naturalizarse, el DIMEX pasa a old); puede haber varios pasaporte solo si su país emisor es distinto, y varios expediente-local solo si su establecimiento es distinto. Ver combinaciones admitidas. Invariantes del recurso: cr-identificador-unico (sin repetir system y número), cr-paciente-identificador-vigente (al menos uno vigente), cr-paciente-documento-unico (a lo sumo una cédula, un DIMEX y un número CCSS vigentes, y no cédula y DIMEX a la vez) y cr-paciente-pasaporte-expediente (pasaportes vigentes de países distintos y expedientes vigentes de establecimientos distintos).

Comentarios: Las personas menores de edad costarricenses tienen número de cédula desde la inscripción del nacimiento, tengan o no Tarjeta de Identidad de Menores (TIM); se registra como Cédula Nacional. Cuando se obtiene el número oficial de un paciente registrado con identificador provisional, se agrega una nueva ocurrencia y la provisional pasa a no vigente.

Sin un identificador no se puede encontrar al paciente en otro sistema ni unir sus registros en el MPI Nacional. Admite varios porque una misma persona puede tener cédula, DIMEX, pasaporte y expedientes en distintos establecimientos.

Número de identificación tal cual se muestra en el documento oficial.

Regla de validación: Formato según tipo: Cédula nacional (9 dígitos numéricos sin guiones), DIMEX (11-12 dígitos numéricos; se aceptan ceros a la izquierda en la captura, pero se guardan y envían sin ellos), Pasaporte (alfanumérico de 6 a 15 caracteres), Expediente del establecimiento (lo define cada establecimiento). Invariantes cr-cedula-nacional-value y cr-dimex-value (sección 5 de tipos de identificación), cr-pasaporte-system y cr-expediente-system.

Es el valor con que los sistemas buscan al paciente. Sin él, el identificador no sirve.

Tipo de documento o identificador al que corresponde el número.

Regla de negocio: Se debe registrar el tipo de documento según el estatus legal y procedencia (Cédula nacional para nacionales, incluidas las personas menores de edad; DIMEX para extranjeros residentes; Pasaporte para extranjeros en tránsito; o carné CCSS).

Regla de validación: Debe pertenecer al catálogo tipos de identificación: Cédula Nacional, DIMEX, Número de Pasaporte, Número de Identificación CCSS, Número de Expediente del Establecimiento.

El mismo número puede existir en dos tipos distintos. El tipo dice quién asignó el número y cómo validarlo, y de él se arma el system del identificador.

País que emitió el pasaporte.

Regla de negocio: Obligatorio si identificacion.tipo es pasaporte; no se registra para los demás tipos. Es el país que emitió el documento, que puede no coincidir con la nacionalidad (por ejemplo, en personas con doble nacionalidad).

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países. No se usa el código de la zona de lectura mecánica (MRZ) del pasaporte cuando difiere del ISO (por ejemplo, Alemania es DEU, no D).

Un número de pasaporte solo es único dentro de su país. Sin el país emisor, dos pasaportes de países distintos se podrían confundir.

Establecimiento de salud que asignó el número de expediente.

Regla de negocio: Obligatorio si identificacion.tipo es expediente-local; no se registra para los demás tipos.

Regla de validación: Código con prefijo según quién asigna el expediente: cj- + cédula jurídica (la CCSS usa la suya, cj-4000042147, para todas sus unidades), cn- + cédula nacional del titular o dimex- + DIMEX del titular (ver código del establecimiento). Invariantes cr-expediente-system y cr-expediente-assigner (el expediente lleva assigner).

Comentarios: Mientras no exista un catálogo de establecimientos de salud, el código se arma con un identificador existente y un prefijo (decisión 14).

Cada establecimiento numera sus expedientes por su cuenta. El establecimiento hace único el número y dice a quién pedir el expediente.

Indica si el identificador está vigente o si se conserva solo como histórico.

Regla de negocio: Un identificador deja de estar vigente cuando es reemplazado: el expediente provisional al obtener el número oficial, el DIMEX al naturalizarse, el pasaporte anterior al renovarlo. Los identificadores no vigentes no se eliminan, porque permiten encontrar registros anteriores.

Regla de validación: Invariante cr-paciente-identificador-uso: un expediente vigente es temp, los demás tipos vigentes son official, y uno no vigente es old.

Permite cambiar de identificador (naturalización, renovación del pasaporte, paso del expediente provisional al número oficial) sin perder los registros que usaron el anterior.

Primer y segundo nombre.

Regla de negocio: Obligatorio el primer nombre; el segundo nombre es condicional si consta en el documento oficial de identidad.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Con los apellidos, la fecha de nacimiento y el sexo, el nombre permite buscar al paciente cuando no se conoce su identificador y confirmar su identidad en la atención.

Primer apellido del paciente, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. En Costa Rica cada persona lleva dos apellidos, por lo general uno de cada progenitor, en el orden que eligieron los progenitores al inscribir el nacimiento: el primero puede ser el de la madre o el del padre.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE.

En Costa Rica los dos apellidos forman parte del nombre legal y se buscan por separado. Es una estructura para registrar, junto al apellido, el progenitor del que proviene.

Texto del primer apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene cada apellido: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE. El primer apellido puede ser el de la madre o el del padre. Si la persona cambia el orden ante el TSE, se actualiza el registro con el orden nuevo. En casos de filiación única, se registra el único apellido legal.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Es el apellido con que se busca y se muestra al paciente. Va aparte del segundo porque en FHIR family lleva los dos juntos.

Progenitor (madre o padre) del que proviene el primer apellido del paciente. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Opcional. Se registra solo cuando se conoce con certeza, preferiblemente a partir del Registro Civil del TSE: el documento de identidad no indica de qué progenitor viene cada apellido. No se deduce de la posición. Los dos apellidos pueden tener el mismo origen (filiación única, dos madres o dos padres). Solo se registra si existe el primer apellido.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

El documento de identidad no dice de qué progenitor viene cada apellido y la posición no lo indica. Cuando se conoce, sirve para la filiación y para comparar con registros de otros países.

Segundo apellido del paciente, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. Lo tienen todas las personas costarricenses; muchas personas extranjeras no tienen segundo apellido.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad oficial. Igual que el primero, el orden no indica de qué progenitor viene. Obligatorio para personas costarricenses; opcional para extranjeros cuyo país de origen no contempla segundo apellido.

Igual que el primer apellido, forma parte del nombre legal. Es opcional porque muchas personas extranjeras no tienen segundo apellido.

Texto del segundo apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene cada apellido: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE. El primer apellido puede ser el de la madre o el del padre. Obligatorio para personas costarricenses; opcional para extranjeros cuyo país de origen no contempla segundo apellido.

Regla de validación: Si se registra: hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Permite buscar por el segundo apellido y distinguir a personas con el mismo nombre y el mismo primer apellido.

Progenitor (madre o padre) del que proviene el segundo apellido del paciente. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Opcional. Se registra solo cuando se conoce con certeza, preferiblemente a partir del Registro Civil del TSE: el documento de identidad no indica de qué progenitor viene cada apellido. No se deduce de la posición. Los dos apellidos pueden tener el mismo origen (filiación única, dos madres o dos padres). Solo se registra si existe el segundo apellido.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Por la misma razón que el origen del primer apellido: la posición no indica de qué progenitor viene.

Sexo asignado al nacer, con fines clínicos (excluye la interpretación de autopercepción).

Regla de negocio: Debe registrarse el sexo asignado al nacer con fines estrictamente clínicos, farmacológicos y de riesgo médico, sin sustituir la identidad de género. En esta versión es el único dato de sexo del modelo: no se registra un sexo administrativo aparte.

Regla de validación: Debe pertenecer al catálogo sexo asignado al nacer: mujer (female), hombre (male), desconocido (unknown).

Lo necesitan las decisiones clínicas (rangos de referencia, dosis, tamizajes) y el MPI para distinguir a dos personas. Se registra con fines clínicos, sin sustituir la identidad de género.

Fecha de nacimiento del paciente, tal como consta en su documento de identidad (cédula, DIMEX o pasaporte).

Regla de negocio: Fecha de nacimiento oficial que figura en el documento de identidad. Utilizada para el cálculo de la edad cronológica y grupo etario del paciente.

Regla de validación: Formato estándar ISO 8601 (AAAA-MM-DD). La fecha debe ser igual o anterior a la fecha actual y no mayor a 130 años en el pasado. Invariante cr-persona-fecha-nacimiento: $this {= today() and $this }= today() - 130 years.

Sirve para calcular la edad, que condiciona dosis, rangos de referencia y programas por grupo etario. Es además uno de los datos con que el MPI distingue a dos personas con el mismo nombre.

Estado civil del paciente, según los estados aceptados en Costa Rica: 1. Soltero(a) 2. Casado(a) 3. Divorciado(a) 4. Viudo(a) 5. Unión de hecho

Regla de negocio: Situación conyugal declarada por el paciente o validada ante el registro civil costarricense. No condiciona la atención médica.

Regla de validación: Si está presente, debe coincidir con el catálogo estado civil: Soltero(a), Casado(a), Divorciado(a), Viudo(a) o Unión de hecho.

Lo piden los formularios administrativos y las estadísticas de salud. Es opcional porque no condiciona la atención.

Teléfono para contacto.

Regla de negocio: Número telefónico para contacto directo, recordatorios y seguimiento ambulatorio. Se pueden registrar múltiples líneas (móvil, habitación, laboral).

Regla de validación: Formato E.164: +, el código de país y el número, sin espacios ni guiones; en Costa Rica, +506 y 8 dígitos (o un número 800 o 900 de 10 dígitos). La captura puede omitir el +506, pero el sistema lo agrega antes de guardar o enviar. Una extensión interna va después de ;ext= (RFC 3966). Invariante común cr-telefono.

Permite contactar al paciente desde cualquier establecimiento para citas, recordatorios, resultados y seguimiento.

Correo para contacto.

Regla de negocio: Dirección de correo electrónico para notificaciones digitales, entrega de resultados y portales de salud. Opcional pero recomendado.

Regla de validación: Estructura estándar de correo según RFC 5322 (usuario@dominio.extensión). Longitud máxima de 100 caracteres.

Es el canal para las notificaciones digitales, la entrega de resultados y el acceso a portales de salud.

País o países de los que el paciente es nacional.

Regla de negocio: País o países de nacionalidad legal del paciente. Permite registro múltiple en caso de doble ciudadanía. Si la nacionalidad no se conoce, se envía la extensión data-absent-reason con unknown en lugar del código. Si la persona es apátrida, se envía data-absent-reason con not-applicable y el texto "Apátrida"; en ese caso no puede haber otra nacionalidad.

Regla de validación: Debe corresponder al código ISO 3166-1 alfa-3 del país (ej. CRI), según el catálogo de nacionalidad. Invariante cr-persona-apatrida: si una nacionalidad lleva data-absent-reason = not-applicable, no hay otra.

La necesitan las estadísticas de salud, la atención de personas extranjeras (turismo médico, migración) y el intercambio con PH4H. Admite varias por la doble nacionalidad.

Dirección del paciente. Cada ocurrencia es una dirección completa.

Regla de negocio: Direcciones del paciente, en Costa Rica o en otro país. Un paciente puede tener varias: por ejemplo, un turista médico registra su residencia en el extranjero (uso residencia) y el lugar donde se aloja en Costa Rica (uso temporal), que sirve para el seguimiento. La dirección en Costa Rica se usa para zonificación de salud y adscripción a un centro de atención.

Regla de validación: Si direccion.pais es CRI, provincia, canton y distrito son obligatorios y deben ser concordantes entre sí. A lo sumo una dirección con uso residencia (invariante cr-persona-residencia).

Ubica al paciente para su adscripción al área de salud y al EBAIS, la vigilancia epidemiológica y las visitas domiciliares. Admite varias para quien reside en el extranjero y se aloja en Costa Rica.

Indica si es la residencia habitual o una dirección temporal.

Regla de negocio: Residencia (home): donde vive habitualmente. Temporal (temp): donde se aloja por un tiempo, por ejemplo durante un tratamiento o una recuperación.

Regla de validación: Solo home o temp, del ValueSet HL7 address-use (invariante cr-direccion-uso-persona).

Distingue la residencia habitual, que define la adscripción, de una dirección temporal, que solo sirve para el seguimiento.

País de la dirección.

Regla de negocio: Obligatorio. Determina qué reglas aplican al resto de la dirección.

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países.

Decide si la dirección sigue la División Territorial Administrativa de Costa Rica o es texto libre de otro país.

Provincia (Costa Rica) o estado, región o departamento (otro país).

Regla de negocio: Obligatoria si el país es CRI. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de provincia de la División Territorial Administrativa del SNIT (1 a 7).

Obligatorio si el país es CRI, por invariante.

Es el primer nivel de la División Territorial Administrativa. Con códigos, los sistemas pueden agrupar y comparar los datos por territorio.

Cantón (Costa Rica) o ciudad (otro país).

Regla de negocio: Obligatorio si el país es CRI y debe pertenecer a la provincia indicada. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de cantón de la DTA del SNIT (3 dígitos), concordante con la provincia.

Obligatorio si el país es CRI, por invariante.

Es el segundo nivel de la División Territorial Administrativa, con el que se organizan muchas estadísticas de salud.

Distrito (Costa Rica).

Regla de negocio: Obligatorio si el país es CRI y debe pertenecer al cantón indicado. No aplica a otros países.

Regla de validación: Si el país es CRI: código de distrito de la DTA del SNIT (5 dígitos), concordante con el cantón.

Obligatorio si el país es CRI, por invariante.

Es el nivel más fino de la División Territorial Administrativa, el que usan la adscripción a un EBAIS y la vigilancia epidemiológica.

Barrio (zona urbana) o poblado (zona rural) dentro del distrito, en Costa Rica; barrio o colonia en otro país.

Regla de negocio: Opcional. En Costa Rica se registra el nombre del barrio o poblado tal como aparece en la División Territorial Administrativa publicada en La Gaceta, y debe estar dentro del distrito indicado.

Regla de validación: Texto de hasta 100 caracteres. No se valida contra un catálogo: el SNIT no publica barrios ni poblados con código.

Precisa la ubicación dentro del distrito para las visitas domiciliares y el estudio de brotes.

Código postal.

Regla de negocio: Opcional en cualquier país.

Lo usan las direcciones de otros países y algunos servicios de correspondencia. Es opcional porque en Costa Rica se usa poco.

Señas (Costa Rica) o calle y número (otro país).

Regla de negocio: Descripción para localizar el lugar: puntos de referencia en Costa Rica, o calle, número y apartamento en el extranjero.

Regla de validación: Longitud máxima de 250 caracteres.

En Costa Rica una dirección se da con puntos de referencia. Sin las señas no se puede llegar al lugar.

Dirección completa, tal como se muestra o se imprime.

Regla de negocio: Incluye los nombres (no los códigos) de provincia, cantón y distrito.

Regla de validación: Longitud mínima de 5 y máxima de 250 caracteres.

Permite mostrar o imprimir la dirección tal cual, sin que cada sistema la tenga que armar a partir de los códigos.

Persona de contacto del paciente: familiar, cónyuge, tutor legal o una persona que actúa en nombre de una organización (por ejemplo, el PANI). Sigue la estructura del elemento Patient.contact de FHIR R5.

Regla de negocio: Contactos de emergencia, familiares a quienes avisar o contactos de una institución. El tutor legal, el progenitor de una persona menor de edad y quien firma un consentimiento no se registran aquí sino como persona relacionada, que tiene identificación; una misma persona no se registra en los dos.

Regla de validación: Cada contacto debe tener al menos nombre, teléfono o correo, dirección u organización (invariante pat-1 de FHIR R5); en este modelo el nombre ya es obligatorio.

Dice a quién avisar en una emergencia o a quién llamar si no se localiza al paciente, sin tener que identificar formalmente a esa persona.

Indica el tipo de relación directa que tiene el contacto con el paciente: cónyuge, padre, madre, tutor legal, hijo(a), hermano(a) u otro familiar.

Regla de negocio: Vínculo legal, familiar o asistencial del contacto con el paciente.

Regla de validación: Debe corresponder a los valores del catálogo tipo de relación: Cónyuge (SPS), Padre (FTH), Madre (MTH), Tutor legal (GUARD), Hijo(a) (CHILD), Hermano(a) (SIB) u Otro familiar (FAMMEMB), de HL7 v3-RoleCode.

Dice qué vínculo tiene el contacto con el paciente, para saber a quién avisar primero.

Primer y segundo nombre.

Regla de negocio: Nombre(s) de pila del contacto registrado según su documento oficial de identidad. Obligatorio el primer nombre.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Permite dirigirse al contacto y reconocerlo cuando se comunica con el establecimiento.

Primer apellido del contacto, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. En Costa Rica cada persona lleva dos apellidos, por lo general uno de cada progenitor, en el orden que eligieron los progenitores al inscribir el nacimiento: el primero puede ser el de la madre o el del padre.

Regla de negocio: Igual que en el paciente.

Con los nombres, permite reconocer al contacto sin un documento. Usa la misma estructura que el apellido del paciente, para no tener dos formas de registrar un apellido.

Texto del primer apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad del contacto. Igual que en el paciente, el orden no indica de qué progenitor viene.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Con los nombres, permite reconocer al contacto.

Progenitor (madre o padre) del que proviene el primer apellido del contacto. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Igual que en el paciente: opcional, solo cuando se conoce con certeza, sin deducirlo de la posición. Solo se registra si existe el primer apellido del contacto.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Se conserva para que el apellido del contacto tenga la misma estructura que el del paciente.

Segundo apellido del contacto, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. Lo tienen todas las personas costarricenses; muchas personas extranjeras no tienen segundo apellido.

Regla de negocio: Igual que en el paciente.

Igual que el primer apellido del contacto. Es opcional porque muchas personas extranjeras no tienen segundo apellido.

Texto del segundo apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad del contacto. Igual que en el paciente, el orden no indica de qué progenitor viene. Requerido para costarricenses; opcional para extranjeros según su ordenamiento legal de origen.

Regla de validación: Si se registra: hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Ayuda a distinguir contactos con el mismo nombre y el mismo primer apellido.

Progenitor (madre o padre) del que proviene el segundo apellido del contacto. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Igual que en el paciente: opcional, solo cuando se conoce con certeza, sin deducirlo de la posición. Solo se registra si existe el segundo apellido del contacto.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Se conserva para que el apellido del contacto tenga la misma estructura que el del paciente.

Teléfono para contacto.

Regla de negocio: Medio de comunicación prioritario con el contacto para notificaciones médicas, emergencias y autorizaciones asistenciales.

Regla de validación: Formato E.164: +, el código de país y el número, sin espacios ni guiones; en Costa Rica, +506 y 8 dígitos (o un número 800 o 900 de 10 dígitos). La captura puede omitir el +506, pero el sistema lo agrega antes de guardar o enviar. Una extensión interna va después de ;ext= (RFC 3966). Invariante común cr-telefono.

Es el medio más rápido para avisar al contacto en una emergencia.

Correo para contacto.

Regla de negocio: Cuenta de correo electrónico del contacto para notificaciones formales y comunicaciones digitales. Opcional.

Regla de validación: Debe cumplir con la estructura estándar según RFC 5322 (usuario@dominio.extensión). Longitud máxima de 100 caracteres.

Sirve para las comunicaciones formales que no son urgentes.

Dirección del contacto. Cada ocurrencia es una dirección completa.

Regla de negocio: Dirección del contacto para localización, notificaciones presenciales o contingencias. Puede estar en Costa Rica o en otro país.

Regla de validación: Si contacto.direccion.pais es CRI, provincia, canton y distrito son obligatorios y deben ser concordantes entre sí.

Permite localizar al contacto o enviarle una notificación presencial cuando no responde por teléfono.

Indica si es la residencia habitual o una dirección temporal.

Regla de negocio: Igual que en el paciente. Residencia (home): donde vive habitualmente. Temporal (temp): donde se aloja por un tiempo, por ejemplo durante un tratamiento o una recuperación.

Regla de validación: Solo home o temp, del ValueSet HL7 address-use (invariante cr-direccion-uso-persona).

Igual que en la dirección del paciente: distingue la residencia habitual de una dirección temporal.

País de la dirección.

Regla de negocio: Igual que en el paciente. Obligatorio. Determina qué reglas aplican al resto de la dirección.

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países.

Igual que en la dirección del paciente: decide si la dirección sigue la División Territorial Administrativa o es de otro país.

Provincia (Costa Rica) o estado, región o departamento (otro país).

Regla de negocio: Igual que en el paciente. Obligatoria si el país es CRI. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de provincia de la División Territorial Administrativa del SNIT (1 a 7).

Obligatorio si el país es CRI, por invariante.

Igual que en la dirección del paciente: primer nivel de la División Territorial Administrativa.

Cantón (Costa Rica) o ciudad (otro país).

Regla de negocio: Igual que en el paciente. Obligatorio si el país es CRI y debe pertenecer a la provincia indicada. En otros países es texto libre y opcional.

Regla de validación: Si el país es CRI: código de cantón de la DTA del SNIT (3 dígitos), concordante con la provincia.

Obligatorio si el país es CRI, por invariante.

Igual que en la dirección del paciente: segundo nivel de la División Territorial Administrativa.

Distrito (Costa Rica).

Regla de negocio: Igual que en el paciente. Obligatorio si el país es CRI y debe pertenecer al cantón indicado. No aplica a otros países.

Regla de validación: Si el país es CRI: código de distrito de la DTA del SNIT (5 dígitos), concordante con el cantón.

Obligatorio si el país es CRI, por invariante.

Igual que en la dirección del paciente: nivel más fino de la División Territorial Administrativa.

Barrio (zona urbana) o poblado (zona rural) dentro del distrito, en Costa Rica; barrio o colonia en otro país.

Regla de negocio: Opcional. En Costa Rica se registra el nombre del barrio o poblado tal como aparece en la División Territorial Administrativa publicada en La Gaceta, y debe estar dentro del distrito indicado.

Regla de validación: Texto de hasta 100 caracteres. No se valida contra un catálogo: el SNIT no publica barrios ni poblados con código.

Igual que en la dirección del paciente: precisa la ubicación dentro del distrito.

Código postal.

Regla de negocio: Igual que en el paciente. Opcional en cualquier país.

Igual que en la dirección del paciente: lo usan las direcciones de otros países.

Señas (Costa Rica) o calle y número (otro país).

Regla de negocio: Igual que en el paciente. Descripción para localizar el lugar: puntos de referencia en Costa Rica, o calle, número y apartamento en el extranjero.

Regla de validación: Longitud máxima de 250 caracteres.

Igual que en la dirección del paciente: sin las señas no se puede llegar al lugar.

Dirección completa, tal como se muestra o se imprime.

Regla de negocio: Igual que en el paciente. Incluye los nombres (no los códigos) de provincia, cantón y distrito.

Regla de validación: Longitud mínima de 5 y máxima de 250 caracteres.

Igual que en la dirección del paciente: permite mostrar la dirección sin armarla a partir de los códigos.

Sexo asignado al nacer del contacto.

Regla de negocio: Obligatorio. Igual que en el paciente, es el único dato de sexo del contacto en esta versión.

Regla de validación: Debe pertenecer al catálogo sexo asignado al nacer: mujer (female), hombre (male), desconocido (unknown).

Completa los datos con que se reconoce al contacto y permite distinguir a dos contactos con el mismo nombre.

Cédula jurídica de la organización en nombre de la cual actúa el contacto o para la que trabaja (por ejemplo, el PANI cuando tiene la tutela de una persona menor de edad).

Regla de negocio: Opcional. Se registra cuando el contacto actúa en representación de una institución.

Regla de validación: Cédula jurídica de 10 dígitos sin guiones (ver tipos de identificación de organizaciones). Invariante cr-referencia-cedula-juridica.

Cuando el contacto actúa en nombre de una institución (por ejemplo, el PANI), quien responde es la institución y no la persona.

Periodo en que el contacto es válido para el paciente.

Regla de negocio: Opcional. Se usa cuando la relación tiene vigencia limitada, por ejemplo una tutela temporal.

Regla de validación: Si hay fecha de inicio y de fin, el inicio no puede ser posterior al fin.

Algunas relaciones son temporales, como una tutela o un cuidador durante una hospitalización. El periodo evita avisar a quien ya no es contacto.

Fecha desde la que el contacto es válido.

Marca desde cuándo se puede recurrir al contacto.

Fecha hasta la que el contacto es válido.

Marca hasta cuándo es válido el contacto; después ya no se le avisa.

Datos demográficos y de identificación de la persona que recibe atención de salud, así como de sus contactos (familiares o tutores legales). Es la base sobre la que se referencian los demás artefactos clínicos de la IG core.

Identificador del paciente. Cada ocurrencia reúne un número y su tipo; un paciente puede tener varias (por ejemplo, cédula y pasaporte).

Regla de negocio: Todo paciente debe tener al menos un identificador. Se registra el número oficial (cédula, DIMEX, pasaporte) cuando exista, aunque la persona no presente el documento físico; si no tiene ninguno, se usa el número de expediente del establecimiento (expediente-local) como identificador provisional. La falta de documento no impide registrar ni atender al paciente.

Regla de validación: No puede haber dos ocurrencias con el mismo tipo y número. Debe haber al menos una ocurrencia vigente. Entre las ocurrencias vigentes (identificacion.vigente = verdadero): a lo sumo una cedula-nacional, una dimex y una ccss; cedula-nacional y dimex no pueden estar vigentes a la vez (al naturalizarse, el DIMEX pasa a old); puede haber varios pasaporte solo si su país emisor es distinto, y varios expediente-local solo si su establecimiento es distinto. Ver combinaciones admitidas. Invariantes del recurso: cr-identificador-unico (sin repetir system y número), cr-paciente-identificador-vigente (al menos uno vigente), cr-paciente-documento-unico (a lo sumo una cédula, un DIMEX y un número CCSS vigentes, y no cédula y DIMEX a la vez) y cr-paciente-pasaporte-expediente (pasaportes vigentes de países distintos y expedientes vigentes de establecimientos distintos).

Comentarios: Las personas menores de edad costarricenses tienen número de cédula desde la inscripción del nacimiento, tengan o no Tarjeta de Identidad de Menores (TIM); se registra como Cédula Nacional. Cuando se obtiene el número oficial de un paciente registrado con identificador provisional, se agrega una nueva ocurrencia y la provisional pasa a no vigente.

Sin un identificador no se puede encontrar al paciente en otro sistema ni unir sus registros en el MPI Nacional. Admite varios porque una misma persona puede tener cédula, DIMEX, pasaporte y expedientes en distintos establecimientos.

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

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.

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.

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).

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.

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.

Número de identificación tal cual se muestra en el documento oficial.

Regla de validación: Formato según tipo: Cédula nacional (9 dígitos numéricos sin guiones), DIMEX (11-12 dígitos numéricos; se aceptan ceros a la izquierda en la captura, pero se guardan y envían sin ellos), Pasaporte (alfanumérico de 6 a 15 caracteres), Expediente del establecimiento (lo define cada establecimiento). Invariantes cr-cedula-nacional-value y cr-dimex-value (sección 5 de tipos de identificación), cr-pasaporte-system y cr-expediente-system.

Es el valor con que los sistemas buscan al paciente. Sin él, el identificador no sirve.

Tipo de documento o identificador al que corresponde el número.

Regla de negocio: Se debe registrar el tipo de documento según el estatus legal y procedencia (Cédula nacional para nacionales, incluidas las personas menores de edad; DIMEX para extranjeros residentes; Pasaporte para extranjeros en tránsito; o carné CCSS).

Regla de validación: Debe pertenecer al catálogo tipos de identificación: Cédula Nacional, DIMEX, Número de Pasaporte, Número de Identificación CCSS, Número de Expediente del Establecimiento.

El mismo número puede existir en dos tipos distintos. El tipo dice quién asignó el número y cómo validarlo, y de él se arma el system del identificador.

País que emitió el pasaporte.

Regla de negocio: Obligatorio si identificacion.tipo es pasaporte; no se registra para los demás tipos. Es el país que emitió el documento, que puede no coincidir con la nacionalidad (por ejemplo, en personas con doble nacionalidad).

Regla de validación: Código ISO 3166-1 alfa-3 en mayúsculas, del catálogo de países. No se usa el código de la zona de lectura mecánica (MRZ) del pasaporte cuando difiere del ISO (por ejemplo, Alemania es DEU, no D).

Un número de pasaporte solo es único dentro de su país. Sin el país emisor, dos pasaportes de países distintos se podrían confundir.

Establecimiento de salud que asignó el número de expediente.

Regla de negocio: Obligatorio si identificacion.tipo es expediente-local; no se registra para los demás tipos.

Regla de validación: Código con prefijo según quién asigna el expediente: cj- + cédula jurídica (la CCSS usa la suya, cj-4000042147, para todas sus unidades), cn- + cédula nacional del titular o dimex- + DIMEX del titular (ver código del establecimiento). Invariantes cr-expediente-system y cr-expediente-assigner (el expediente lleva assigner).

Comentarios: Mientras no exista un catálogo de establecimientos de salud, el código se arma con un identificador existente y un prefijo (decisión 14).

Cada establecimiento numera sus expedientes por su cuenta. El establecimiento hace único el número y dice a quién pedir el expediente.

Indica si el identificador está vigente o si se conserva solo como histórico.

Regla de negocio: Un identificador deja de estar vigente cuando es reemplazado: el expediente provisional al obtener el número oficial, el DIMEX al naturalizarse, el pasaporte anterior al renovarlo. Los identificadores no vigentes no se eliminan, porque permiten encontrar registros anteriores.

Regla de validación: Invariante cr-paciente-identificador-uso: un expediente vigente es temp, los demás tipos vigentes son official, y uno no vigente es old.

Permite cambiar de identificador (naturalización, renovación del pasaporte, paso del expediente provisional al número oficial) sin perder los registros que usaron el anterior.

Primer y segundo nombre.

Regla de negocio: Obligatorio el primer nombre; el segundo nombre es condicional si consta en el documento oficial de identidad.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Con los apellidos, la fecha de nacimiento y el sexo, el nombre permite buscar al paciente cuando no se conoce su identificador y confirmar su identidad en la atención.

Primer apellido del paciente, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. En Costa Rica cada persona lleva dos apellidos, por lo general uno de cada progenitor, en el orden que eligieron los progenitores al inscribir el nacimiento: el primero puede ser el de la madre o el del padre.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE.

En Costa Rica los dos apellidos forman parte del nombre legal y se buscan por separado. Es una estructura para registrar, junto al apellido, el progenitor del que proviene.

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

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.

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.

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).

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.

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.

Texto del primer apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Obligatorio. Es el apellido que aparece en primer lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene cada apellido: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE. El primer apellido puede ser el de la madre o el del padre. Si la persona cambia el orden ante el TSE, se actualiza el registro con el orden nuevo. En casos de filiación única, se registra el único apellido legal.

Regla de validación: Hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Es el apellido con que se busca y se muestra al paciente. Va aparte del segundo porque en FHIR family lleva los dos juntos.

Progenitor (madre o padre) del que proviene el primer apellido del paciente. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Opcional. Se registra solo cuando se conoce con certeza, preferiblemente a partir del Registro Civil del TSE: el documento de identidad no indica de qué progenitor viene cada apellido. No se deduce de la posición. Los dos apellidos pueden tener el mismo origen (filiación única, dos madres o dos padres). Solo se registra si existe el primer apellido.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

El documento de identidad no dice de qué progenitor viene cada apellido y la posición no lo indica. Cuando se conoce, sirve para la filiación y para comparar con registros de otros países.

Segundo apellido del paciente, en el orden de su documento de identidad, con el progenitor del que proviene cuando se conoce. Lo tienen todas las personas costarricenses; muchas personas extranjeras no tienen segundo apellido.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad oficial. Igual que el primero, el orden no indica de qué progenitor viene. Obligatorio para personas costarricenses; opcional para extranjeros cuyo país de origen no contempla segundo apellido.

Igual que el primer apellido, forma parte del nombre legal. Es opcional porque muchas personas extranjeras no tienen segundo apellido.

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

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.

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.

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).

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.

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.

Texto del segundo apellido, tal como consta en el documento de identidad. No dice de qué progenitor viene: eso es el origen.

Regla de negocio: Es el apellido que aparece en segundo lugar en el documento de identidad oficial. El orden no indica de qué progenitor viene cada apellido: al inscribir el nacimiento, los progenitores pueden elegir el orden, y después la persona puede invertirlo ante el TSE. El primer apellido puede ser el de la madre o el del padre. Obligatorio para personas costarricenses; opcional para extranjeros cuyo país de origen no contempla segundo apellido.

Regla de validación: Si se registra: hasta 50 caracteres. Letras de cualquier alfabeto, con sus signos diacríticos (tildes, diéresis y otros), espacios, apóstrofes, guiones y puntos; empieza con una letra y no admite dígitos ni otros símbolos, para admitir nombres de personas de cualquier país (invariante cr-nombre-caracteres de cr-human-name).

Permite buscar por el segundo apellido y distinguir a personas con el mismo nombre y el mismo primer apellido.

Progenitor (madre o padre) del que proviene el segundo apellido del paciente. Se registra solo si se conoce con certeza, porque la posición del apellido no lo indica.

Regla de negocio: Opcional. Se registra solo cuando se conoce con certeza, preferiblemente a partir del Registro Civil del TSE: el documento de identidad no indica de qué progenitor viene cada apellido. No se deduce de la posición. Los dos apellidos pueden tener el mismo origen (filiación única, dos madres o dos padres). Solo se registra si existe el segundo apellido.

Regla de validación: Debe pertenecer al catálogo origen del apellido: Madre (MTH), Padre (FTH). Si no se conoce el origen, no se registra.

Por la misma razón que el origen del primer apellido: la posición no indica de qué progenitor viene.

Sexo asignado al nacer, con fines clínicos (excluye la interpretación de autopercepción).

Regla de negocio: Debe registrarse el sexo asignado al nacer con fines estrictamente clínicos, farmacológicos y de riesgo médico, sin sustituir la identidad de género. En esta versión es el único dato de sexo del modelo: no se registra un sexo administrativo aparte.

Regla de validación: Debe pertenecer al catálogo sexo asignado al nacer: mujer (female), hombre (male), desconocido (unknown).

Lo necesitan las decisiones clínicas (rangos de referencia, dosis, tamizajes) y el MPI para distinguir a dos personas. Se registra con fines clínicos, sin sustituir la identidad de género.

Fecha de nacimiento del paciente, tal como consta en su documento de identidad (cédula, DIMEX o pasaporte).

Regla de negocio: Fecha de nacimiento oficial que figura en el documento de identidad. Utilizada para el cálculo de la edad cronológica y grupo etario del paciente.

Regla de validación: Formato estándar ISO 8601 (AAAA-MM-DD). La fecha debe ser igual o anterior a la fecha actual y no mayor a 130 años en el pasado. Invariante cr-persona-fecha-nacimiento: $this {= today() and $this }= today() - 130 years.

Sirve para calcular la edad, que condiciona dosis, rangos de referencia y programas por grupo etario. Es además uno de los datos con que el MPI distingue a dos personas con el mismo nombre.

Estado civil del paciente, según los estados aceptados en Costa Rica: 1. Soltero(a) 2. Casado(a) 3. Divorciado(a) 4. Viudo(a) 5. Unión de hecho

Regla de negocio: Situación conyugal declarada por el paciente o validada ante el registro civil costarricense. No condiciona la atención médica.

Regla de validación: Si está presente, debe coincidir con el catálogo estado civil: Soltero(a), Casado(a), Divorciado(a), Viudo(a) o Unión de hecho.

Lo piden los formularios administrativos y las estadísticas de salud. Es opcional porque no condiciona la atención.

Teléfono para contacto.

Regla de negocio: Número telefónico para contacto directo, recordatorios y seguimiento ambulatorio. Se pueden registrar múltiples líneas (móvil, habitación, laboral).

Regla de validación: Formato E.164: +, el código de país y el número, sin espacios ni guiones; en Costa Rica, +506 y 8 dígitos (o un número 800 o 900 de 10 dígitos). La captura puede omitir el +506, pero el sistema lo agrega antes de guardar o enviar. Una extensión interna va después de ;ext= (RFC 3966). Invariante común cr-telefono.

Permite contactar al paciente desde cualquier establecimiento para citas, recordatorios, resultados y seguimiento.

Correo para contacto.

Regla de negocio: Dirección de correo electrónico para notificaciones digitales, entrega de resultados y portales de salud. Opcional pero recomendado.

Regla de validación: Estructura estándar de correo según RFC 5322 (usuario@dominio.extensión). Longitud máxima de 100 caracteres.

Es el canal para las notificaciones digitales, la entrega de resultados y el acceso a portales de salud.

País o países de los que el paciente es nacional.

Regla de negocio: País o países de nacionalidad legal del paciente. Permite registro múltiple en caso de doble ciudadanía. Si la nacionalidad no se conoce, se envía la extensión data-absent-reason con unknown en lugar del código. Si la persona es apátrida, se envía data-absent-reason con not-applicable y el texto "Apátrida"; en ese caso no puede haber otra nacionalidad.

Regla de validación: Debe corresponder al código ISO 3166-1 alfa-3 del país (ej. CRI), según el catálogo de nacionalidad. Invariante cr-persona-apatrida: si una nacionalidad lleva data-absent-reason = not-applicable, no hay otra.

La necesitan las estadísticas de salud, la atención de personas extranjeras (turismo médico, migración) y el intercambio con PH4H. Admite varias por la doble nacionalidad.

Dirección del paciente. Cada ocurrencia es una dirección completa.

Regla de negocio: Direcciones del paciente, en Costa Rica o en otro país. Un paciente puede tener varias: por ejemplo, un turista médico registra su residencia en el extranjero (uso residencia) y el lugar donde se aloja en Costa Rica (uso temporal), que sirve para el seguimiento. La dirección en Costa Rica se usa para zonificación de salud y adscripción a un centro de atención.