Skip to main content
Inspect valida cualquier recurso FHIR R4 contra el perfil correspondiente de CL Core v1.9.4 y devuelve un OperationOutcome con errores en español, referencia al perfil que falla y quickFix cuando la corrección es mecánica.

​
Superficies

API REST

POST /api/validate con header X-API-Key.

Dashboard

Workspace web con editor JSON y resultado en tiempo real.

MCP

Conector npm para editores con soporte Model Context Protocol.

​
Cobertura

  • CL Core v1.9.4: paquete oficial hl7.fhir.cl.clcore de HL7® Chile.
  • 35+ reglas locales cl-* para los 13 recursos más usados. Corren offline.
  • Validación completa contra el servidor con el IG cargado: invariantes FHIRPath, bindings a ValueSets, terminologías, slicing, extensions.
  • Catálogos chilenos indexados: comunas DEIS, establecimientos DEIS, TFC, CIE-10, CSIdentificadores.

​
Flujo

Los logs registran código de error, ruta del recurso y el identificador de tu organización. No incluyen el cuerpo del recurso ni datos identificables de pacientes.

​
Anatomía de la respuesta

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invalid",
      "details": {
        "text": "Encounter.status='complete' no pertenece al ValueSet EncounterStatus (binding required). Códigos válidos: planned · arrived · triaged · in-progress · onleave · finished · cancelled · entered-in-error · unknown."
      },
      "expression": ["Encounter.status"],
      "diagnostics": "{\"code\":\"cl-enc-04\",\"why\":\"FHIR R4 — required binding al ValueSet encounter-status. 'complete' es un código que devuelven varios HIS legacy, pero no es FHIR.\",\"quickFix\":{\"jsonPointer\":\"/status\",\"replacement\":\"finished\"}}"
    }
  ]
}
El campo diagnostics contiene el JSON enriquecido con code, why, profileUrl, suggestion, example y quickFix. Los clientes que conocen el formato Fhiron lo parsean para mostrar contexto adicional; el resto sigue viendo details.text.

​
Latencia

Las reglas locales se ejecutan en menos de 5 ms sobre recursos de tamaño típico. La validación completa tiene un objetivo de p95 < 3 s. Estado en fhiron.cl/status.

​
Cómo consumirlo

Tres canales sobre el mismo motor: elige el que calce mejor con tu flujo.

API REST

POST /api/validate desde cualquier backend o cliente HTTP.

CLI

fhiron validate en terminal, CI/CD, pre-commit hooks.

MCP

Tool fhiron_validate dentro de Claude Code, Cursor, Continue.dev.

​
Siguiente

API reference

Endpoint, headers, request/response, ejemplos.

Errores

Códigos cl-* y quickFix.