HL7 FHIR Costa Rica - Core, published by Iniciativa HL7 Costa Rica. This guide is not an authorized publication; it is the continuous build for version 0.0.1-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7-cr/core/ and changes regularly. See the Directory of published versions

Extensiones

Extensiones

Esta sección documenta las 6 extensiones FHIR definidas en la Guía de Implementación Core de HL7 FHIR Costa Rica. Las extensiones añaden información adicional que no está disponible en los recursos base de FHIR.

Extensiones Demográficas

extension-cr-residency-status

Estado de Residencia

Indica el estado de residencia de una persona en Costa Rica (residente, no residente, residente temporal, etc.).

Contexto de Uso:

• Patient
• Practitioner
• RelatedPerson

Tipo de Dato:

• CodeableConcept

Valores Válidos:

• resident (Residente)
• non-resident (No Residente)
• temporary-resident (Residente Temporal)
• refugee (Refugiado)
• undocumented (Indocumentado)

Ejemplo:

{
  "extension": [
    {
      "url": "https://hl7.or.cr/fhir/core/StructureDefinition/extension-cr-residency-status",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "https://hl7.or.cr/fhir/core/CodeSystem/residency-status",
            "code": "resident",
            "display": "Residente"
          }
        ]
      }
    }
  ]
}

extension-cr-ethnic-group

Grupo Étnico

Permite documentar la etnia o grupo étnico de una persona según clasificaciones locales.

Contexto de Uso:

• Patient
• RelatedPerson

Tipo de Dato:

• CodeableConcept

Valores Válidos:

• hispanic (Hispano)
• indigenous (Indígena)
• afro-caribbean (Afrocaribeño)
• white (Blanco)
• asian (Asiático)
• other (Otro)

Documentación Clínica: Importante para investigación epidemiológica y análisis de disparidades en salud.

Extensiones de Identificadores

extension-cr-document-type

Tipo de Documento de Identificación

Especifica el tipo de documento de identificación utilizado (cédula, pasaporte, permiso de residencia, etc.).

Contexto de Uso:

• Patient.identifier
• Practitioner.identifier
• Organization.identifier

Tipo de Dato:

• CodeableConcept

Valores Válidos:

• cedula (Cédula de Identidad)
• cedula-extrangera (Cédula de Extranjería)
• pasaporte (Pasaporte)
• carnet-migracion (Carnet de Migración)
• permiso-residencia (Permiso de Residencia)
• dimex (DIMEX - Documento Identificación Migrante Extranjero)

Ejemplo:

{
  "identifier": [
    {
      "extension": [
        {
          "url": "https://hl7.or.cr/fhir/core/StructureDefinition/extension-cr-document-type",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "https://hl7.or.cr/fhir/core/CodeSystem/document-type",
                "code": "cedula",
                "display": "Cédula de Identidad"
              }
            ]
          }
        }
      ],
      "system": "https://hl7.or.cr/fhir/core/NameSystem/cedula",
      "value": "123456789"
    }
  ]
}

Extensiones Clínicas

extension-cr-clinical-specialty

Especialidad Clínica

Define la especialidad médica o de enfermería de un profesional de salud.

Contexto de Uso:

• Practitioner
• PractitionerRole

Tipo de Dato:

• CodeableConcept

Valores Válidos: Clasificación basada en estándares locales e internacionales:

• internal-medicine (Medicina Interna)
• pediatrics (Pediatría)
• surgery (Cirugía)
• obstetrics-gynecology (Ginecología y Obstetricia)
• cardiology (Cardiología)
• neurology (Neurología)
• orthopedics (Ortopedia)
• psychiatry (Psiquiatría)
• nursing (Enfermería)
• dental (Odontología)
• pharmacy (Farmacia)
• other (Otra)

extension-cr-emergency-contact-preference

Preferencia de Contacto de Emergencia

Especifica el método preferido para contactar a una persona en caso de emergencia.

Contexto de Uso:

• Patient
• RelatedPerson

Tipo de Dato:

• CodeableConcept

Valores Válidos:

• phone (Teléfono)
• email (Correo Electrónico)
• sms (SMS/Mensaje de Texto)
• whatsapp (WhatsApp)
• signal (Signal)
• telegram (Telegram)

Atributos Relacionados:

• Orden de preferencia
• Disponibilidad horaria
• Notas especiales

Extensiones de Contacto

extension-cr-communication-channel

Canal de Comunicación Preferido

Define el canal de comunicación preferido para un paciente o profesional (teléfono, email, mensajería, etc.).

Contexto de Uso:

• Patient
• Practitioner
• Organization

Tipo de Dato:

• CodeableConcept

Valores Válidos:

• voice-call (Llamada Telefónica)
• sms (Mensaje de Texto)
• email (Correo Electrónico)
• whatsapp (WhatsApp)
• messaging-app (Aplicación de Mensajería)
• video-call (Videollamada)
• in-person (Presencial)

Ejemplo de Uso: Facilita comunicación preferida para recordatorios, consultas de seguimiento, y cambios en tratamiento.

Extensiones de Configuración

extension-cr-language-preference-order

Orden de Preferencia de Idioma

Define el orden de preferencia cuando un paciente o profesional habla múltiples idiomas.

Contexto de Uso:

• Patient
• Practitioner
• RelatedPerson

Tipo de Dato:

• Sequence (integer)

Valores Válidos:

1. Spanish (Español)
2. English (Inglés)
3. Portuguese (Portugués)
4. Indigenous Languages (Lenguas Indígenas)

Ejemplo:

{
  "extension": [
    {
      "url": "https://hl7.or.cr/fhir/core/StructureDefinition/extension-cr-language-preference-order",
      "extension": [
        {
          "url": "language",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "urn:ietf:bcp:47",
                "code": "es",
                "display": "Spanish"
              }
            ]
          }
        },
        {
          "url": "order",
          "valueInteger": 1
        }
      ]
    }
  ]
}

Uso de Extensiones

Consideraciones Importantes

1. Cuando Usar Extensiones
   • No hay elemento base en FHIR que capture la información
   • La información es específica del contexto costarricense
   • Es necesario para conformidad regulatoria local
2. Validación
   • Todas las extensiones están definidas en StructureDefinition
   • Son validables mediante herramientas FHIR estándar
   • Algunos elementos pueden ser obligatorios en ciertos perfiles
3. Compatibilidad
   • Las extensiones no deben afectar la compatibilidad con sistemas externos
   • Los sistemas que no reconocen extensiones pueden ignorarlas
   • El contenido crítico debe estar en elementos base de FHIR

Mejores Prácticas

✅ Hacer:

• Usar extensiones para información realmente adicional
• Documentar claramente el propósito y uso
• Incluir ejemplos en implementaciones
• Mantener versionamiento compatible

❌ No Hacer:

• Duplicar información que ya existe en elementos base
• Crear extensiones para cada variación de datos
• Ignorar validación de extensiones
• Cambiar significado de extensiones sin versionado

Referencia Rápida

Última actualización: Enero 2026