Errores de Perfiles

Los errores de perfiles ocurren cuando el validador no puede cargar, parsear o aplicar un StructureDefinition (perfil) a un recurso. Los perfiles son la base de la validación FHIR – definen cómo luce un recurso válido. Si un perfil no puede resolverse o no coincide con el tipo de recurso, la validación no puede proceder correctamente.

Códigos de Error

PROFILE_NOT_FOUND

La URL del perfil especificada para la validación no se pudo resolver. El validador buscó un StructureDefinition con esa URL canónica en el registro cargado pero no pudo encontrarlo.

Causas comunes:

• La Implementation Guide que contiene el perfil no está cargada
• La URL del perfil tiene un error tipográfico
• La URL del perfil incluye un fragmento de versión que no coincide con la versión cargada
• El perfil no ha sido publicado o no está disponible en los registros configurados

Ejemplo – CLI:

gofhir-validator -ig http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient patient.json

Si la Implementation Guide de US Core no está cargada, el validador no puede encontrar el perfil.

Salida de validación:

ERROR: Profile 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient' could not be resolved
  MessageID: PROFILE_NOT_FOUND

Corrección: Carga la Implementation Guide que contiene el perfil:

gofhir-validator -ig hl7.fhir.us.core -ig http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient patient.json

O programáticamente, asegúrate de que el perfil esté registrado:

v, err := validator.New(
    validator.WithProfiles(usCorePatientProfile),
)

PROFILE_INVALID

El StructureDefinition se encontró pero no es un perfil válido o utilizable. Esto puede ocurrir cuando:

• El JSON del StructureDefinition está malformado
• Faltan campos requeridos (ej., no tiene snapshot ni differential)
• El kind no es resource, complex-type ni logical
• El StructureDefinition referencia una definición base que no puede resolverse
• El snapshot no se pudo generar desde el differential

Ejemplo de salida:

ERROR: Profile 'http://example.org/fhir/StructureDefinition/broken-profile' is not a valid StructureDefinition
  MessageID: PROFILE_INVALID

Corrección: Verifica que el StructureDefinition sea completo y esté bien formado. Usa el propio validador FHIR para validar el recurso StructureDefinition:

gofhir-validator profile.json

Asegúrate de que el perfil tenga un elemento snapshot o un elemento differential con un baseDefinition resoluble.

PROFILE_WRONG_TYPE

El resourceType del recurso no coincide con el tipo declarado en el campo StructureDefinition.type del perfil. Por ejemplo, intentar validar un recurso Patient contra un perfil de Observation.

Ejemplo – uso inválido:

gofhir-validator -ig http://hl7.org/fhir/StructureDefinition/bp observation.json

Donde observation.json contiene:

{
  "resourceType": "Patient",
  "name": [{ "family": "Smith" }]
}

Y el perfil de presión arterial declara "type": "Observation".

Salida de validación:

ERROR: Resource type 'Patient' does not match profile type 'Observation'
  Path: Patient
  MessageID: PROFILE_WRONG_TYPE

Corrección: Valida el recurso contra un perfil que coincida con su tipo de recurso:

gofhir-validator -ig http://hl7.org/fhir/StructureDefinition/Patient patient.json

Perfil Declarado en meta.profile

Los recursos pueden declarar a qué perfiles afirman conformar a través de meta.profile. El validador usa estas declaraciones para seleccionar contra qué perfiles validar:

{
  "resourceType": "Patient",
  "meta": {
    "profile": [
      "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"
    ]
  },
  "name": [{ "family": "Smith" }]
}

Si un perfil listado en meta.profile no se puede encontrar, el validador produce un error PROFILE_NOT_FOUND. Si no coincide con el tipo de recurso, produce un error PROFILE_WRONG_TYPE.

Cadena de Resolución de Perfiles

El validador resuelve perfiles siguiendo la cadena de derivación:

Perfil Personalizado
  -> baseDefinition: US Core Patient
    -> baseDefinition: Patient
      -> baseDefinition: DomainResource
        -> baseDefinition: Resource

En cada nivel, el validador combina las restricciones del perfil con su base. Si algún perfil en la cadena no puede resolverse, el validador reporta PROFILE_NOT_FOUND para el eslabón faltante.