Validación FHIR contra CL Core v1.9.3: La Guía Completa para Desarrolladores en Chile

¿Qué es HL7 FHIR R4 y por qué importa en Chile?

HL7 FHIR (Fast Healthcare Interoperability Resources) R4 es el estándar internacional para intercambiar información clínica en sistemas de salud. En Chile, el Ministerio de Salud (MINSAL) adoptó FHIR R4 como el estándar sintáctico oficial para la interoperabilidad del sistema de salud, lo que lo convierte en un requisito obligatorio para hospitales, clínicas, ISAPREs y proveedores de sistemas HIS.

Un recurso FHIR es una unidad de información clínica con estructura JSON o XML definida: un Paciente, un Profesional, un Diagnóstico, una Prescripción. Cada recurso tiene campos obligatorios, opcionales y reglas de terminología que deben cumplirse para que el dato sea válido e interoperable.

¿Qué es CL Core v1.9.3?

CL Core es la Guía de Implementación FHIR oficial de Chile, publicada por HL7 Chile con validación del MINSAL. La versión actual es la 1.9.3. Esta guía define los perfiles (restricciones y extensiones) que adaptan los recursos FHIR internacionales al contexto chileno: el RUT como identificador de paciente, las comunas por decreto 817, los códigos TFC para medicamentos, los profesionales con registro DEIS, y las terminologías SNOMED CT Edición Español.

Perfiles más importantes de CL Core v1.9.3

Cómo funciona la validación FHIR

Validar un recurso FHIR contra CL Core significa verificar que el recurso cumple todas las reglas definidas en los perfiles correspondientes. Esto incluye: campos obligatorios presentes, terminologías válidas (el código de la comuna existe en el ValueSet decreto 817), cardinalidades correctas (exactamente un identificador RUT, no cero ni dos), y extensiones requeridas presentes.

1. El motor de validación carga los perfiles CL Core v1.9.3.
2. Se identifica el recurso a validar (por su resourceType y meta.profile).
3. Se aplican las reglas del perfil: cardinalidad, bindings de terminología, invariantes FHIRPath.
4. Se generan mensajes OperationOutcome con severity error, warning o information.
5. El integrador recibe la respuesta y corrige los errores antes de enviar al EHR destino.

Validación con la API Fhiron Bridge

La API Bridge de Fhiron permite validar cualquier recurso FHIR contra CL Core v1.9.3 con una llamada HTTP. La respuesta incluye los errores en español con referencia exacta al perfil que falla.

curl -X POST https://fhiron.cl/api/validate \
  -H "Content-Type: application/fhir+json" \
  -H "X-API-Key: <tu-api-key>" \
  -d '{
    "resourceType": "Patient",
    "meta": {
      "profile": ["https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/CorePacienteCl"]
    },
    "identifier": [{
      "system": "https://rnpi.superdesalud.gob.cl/",
      "value": "15.654.738-7"
    }],
    "name": [{ "family": "Soto", "given": ["María"] }],
    "gender": "female",
    "birthDate": "1985-03-12",
    "address": [{
      "extension": [{
        "url": "https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/ComunasCl",
        "valueCoding": {
          "system": "https://hl7chile.cl/fhir/ig/clcore/CodeSystem/CSCodComunasCL",
          "code": "13101",
          "display": "Santiago"
        }
      }],
      "country": "CL"
    }]
  }'

Si el recurso es válido, la respuesta es un OperationOutcome con issue severity "information" y código "informational". Si hay errores, recibes una lista de issues con la descripción del error en español y la ruta FHIRPath del campo que falla.

Integración en CI/CD

Puedes integrar la validación FHIR en tu pipeline de CI/CD para detectar errores antes de que lleguen a producción. Fhiron Bridge soporta webhooks y responde en menos de 200ms por recurso.

# GitHub Actions — validación FHIR en CI
- name: Validar recursos FHIR contra CL Core
  run: |
    for file in fhir/resources/*.json; do
      response=$(curl -s -X POST https://fhiron.cl/api/validate \
        -H "X-API-Key: $FHIRON_API_KEY" \
        -H "Content-Type: application/fhir+json" \
        --data-binary "@$file")
      if echo "$response" | grep -q '"severity":"error"'; then
        echo "FALLO: $file tiene errores de validación FHIR"
        echo "$response" | jq '.issue[] | select(.severity=="error") | .diagnostics'
        exit 1
      fi
    done

Recursos de aprendizaje

• HL7 Chile (hl7chile.cl): publicación oficial de CL Core v1.9.3 y changelog de versiones.
• MINSAL Interoperabilidad (interoperabilidad.minsal.cl): Guías de Implementación NID, SNRE, EIS, IPS-CL.
• HL7 FHIR R4 (hl7.org/fhir/R4/): especificación internacional de referencia.
• Fhiron Docs (/docs): documentación completa de la API Bridge con ejemplos y respuestas OperationOutcome.