Errores de Terminología

Los errores de terminología ocurren cuando los valores codificados no se ajustan a los bindings de terminología declarados en el StructureDefinition. El validador verifica que los códigos, sistemas y displays sean válidos de acuerdo con los ValueSets y CodeSystems referenciados. La severidad de los errores de terminología depende de la fuerza del binding.

Códigos de Error

CODING_NO_CODE

Se encontró un elemento Coding que tiene un system pero no tiene code. Un Coding solo es significativo cuando contiene un valor de código.

Ejemplo – recurso inválido:

{
  "resourceType": "Observation",
  "status": "final",
  "code": {
    "coding": [
      {
        "system": "http://loinc.org"
      }
    ]
  }
}

Corrección: Agrega la propiedad code:

{
  "resourceType": "Observation",
  "status": "final",
  "code": {
    "coding": [
      {
        "system": "http://loinc.org",
        "code": "85354-9"
      }
    ]
  }
}

CODING_NO_SYSTEM

Un elemento Coding tiene un code pero no tiene system. Aunque no siempre es un error (de ahí la severidad warning), un código sin sistema es ambiguo porque la misma cadena de código puede significar cosas diferentes en distintos sistemas de códigos.

Ejemplo:

{
  "resourceType": "Observation",
  "status": "final",
  "code": {
    "coding": [
      {
        "code": "85354-9"
      }
    ]
  }
}

Corrección: Agrega la propiedad system:

{
  "resourceType": "Observation",
  "status": "final",
  "code": {
    "coding": [
      {
        "system": "http://loinc.org",
        "code": "85354-9"
      }
    ]
  }
}

CODING_INVALID_SYSTEM

El valor system en un Coding no es un URI válido. Los identificadores de sistemas de códigos en FHIR deben ser URIs válidos.

Ejemplo:

{
  "coding": [
    {
      "system": "not a valid uri",
      "code": "12345"
    }
  ]
}

BINDING_REQUIRED_MISSING

El valor codificado no es miembro del ValueSet especificado en un binding required. Los bindings required son los más estrictos – el código debe estar en el ValueSet.

Ejemplo – recurso inválido:

{
  "resourceType": "Patient",
  "gender": "m"
}

Patient.gender tiene un binding required a http://hl7.org/fhir/ValueSet/administrative-gender, que solo acepta male, female, other y unknown. El valor m no está en ese ValueSet.

Corrección:

{
  "resourceType": "Patient",
  "gender": "male"
}

BINDING_EXTENSIBLE_MISSING

El valor codificado no es miembro del ValueSet especificado en un binding extensible. Esto produce un warning en lugar de un error, porque los bindings extensible permiten códigos de otros sistemas cuando no existe un código apropiado en el ValueSet vinculado.

Ejemplo:

{
  "resourceType": "Condition",
  "code": {
    "coding": [
      {
        "system": "http://example.org/custom-codes",
        "code": "custom-condition"
      }
    ]
  }
}

Si el perfil tiene un binding extensible a un ValueSet estándar y el código personalizado no es miembro, el validador produce un warning.

BINDING_UNKNOWN_SYSTEM

El sistema de códigos referenciado en un Coding no se pudo encontrar en los recursos de terminología cargados. El validador no puede determinar si el código es válido sin acceso al CodeSystem.

BINDING_INVALID_CODE

El código se encontró en un CodeSystem conocido, pero no es un código válido dentro de ese sistema. Esto indica que el sistema de códigos fue cargado, pero el código específico no existe.

Ejemplo:

{
  "resourceType": "Patient",
  "gender": "m"
}

El sistema de códigos http://hl7.org/fhir/administrative-gender es conocido y está cargado, pero m no es un código válido en él.

BINDING_VALUESET_NOT_FOUND

El ValueSet referenciado por un binding no se pudo resolver. El validador no puede validar el código contra el binding porque el ValueSet no está disponible.

Esto es un warning porque la imposibilidad de resolver un ValueSet es un problema del entorno (recursos de terminología faltantes) en lugar de un problema con el recurso validado en sí.

Corrección: Asegúrate de que los recursos ValueSet requeridos estén cargados en el validador. Al usar el CLI, carga la Implementation Guide apropiada:

gofhir-validator -ig hl7.fhir.us.core patient.json

O programáticamente:

v, err := validator.New(
    validator.WithValueSets(myValueSets...),
)

Fuerza de Binding y Severidad

La severidad de los errores de terminología depende de la fuerza de binding declarada en el ElementDefinition:

Cuando la validación de terminología está deshabilitada (usando -tx n/a en el CLI o WithTerminologyDisabled() en la API), todos los errores relacionados con terminología se suprimen.