Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fhiron.cl/llms.txt

Use this file to discover all available pages before exploring further.

Bridge valida cualquier recurso FHIR R4 contra el perfil correspondiente de CL Core v1.9.3 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.3 — 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 tenant_id. 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": "El RUN no debe incluir puntos. Formato esperado: 12345678-5 (perfil RUNcl · CL Core v1.9.3)."
      },
      "expression": ["Patient.identifier[0].value"],
      "diagnostics": "{\"code\":\"cl-run-01\",\"why\":\"...\",\"profileUrl\":\"...\",\"quickFix\":{...}}"
    }
  ]
}
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.

​
Siguiente

API reference

Endpoint, headers, request/response, ejemplos.

Errores

Códigos cl-* y quickFix.