> ## 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.

# CL Core v1.9.4

> El IG oficial de HL7® Chile y los recursos cubiertos por Fhiron.

**CL Core** es el Implementation Guide oficial de HL7 Chile que define cómo se estructuran los recursos FHIR® para el ecosistema chileno: identificadores nacionales, perfiles de paciente y prestador, terminologías locales (DEIS, TFC) y reglas de cardinalidad ajustadas al contexto.

Fhiron integra **`hl7.fhir.cl.clcore` versión 1.9.4** (el paquete NPM publicado por HL7 Chile) como Implementation Guide canónico. Los recursos FHIR que envíes a la API de Inspect se validan contra los perfiles, CodeSystems y ValueSets definidos en ese paquete.

<Tip>
  La spec completa está en [hl7chile.cl/fhir/ig/clcore](https://hl7chile.cl/fhir/ig/clcore/). Fhiron no reemplaza la spec, la implementa.
</Tip>

## Recursos cubiertos por Fhiron Inspect

Fhiron implementa reglas locales (offline, gratuitas) para los 13 recursos más usados de CL Core. La validación contra HAPI con el IG cargado cubre el resto del IG. El MCP además expone una skill con operating contract, routing por intent y playbooks por flujo. Ver [Skill CL Core (agent behavior)](/mcp/skill-cl-core).

| Recurso            | Perfil CL Core      | Reglas locales `cl-*`                      |
| ------------------ | ------------------- | ------------------------------------------ |
| Patient            | `CorePacienteCl`    | `cl-patient-01` … `cl-patient-04`          |
| Practitioner       | `CorePrestadorCl`   | `cl-practitioner-01`, `cl-practitioner-02` |
| Observation        | (R4 core)           | `cl-obs-01` … `cl-obs-03`                  |
| Medication         | `CoreMedicamentoCl` | `cl-med-01`, `cl-med-02`                   |
| MedicationRequest  | (R4 core)           | `cl-medreq-01` … `cl-medreq-04`            |
| Encounter          | `CoreEncounterCl`   | `cl-enc-01` … `cl-enc-03`                  |
| Condition          | (R4 core)           | `cl-cond-*`                                |
| AllergyIntolerance | (R4 core)           | `cl-allergy-*`                             |
| Procedure          | (R4 core)           | `cl-proc-*`                                |
| Coverage           | (R4 core)           | `cl-cov-*`                                 |
| Organization       | (R4 core)           | `cl-org-*`                                 |
| Immunization       | (R4 core)           | `cl-imm-*`                                 |
| DiagnosticReport   | (R4 core)           | `cl-dr-*`                                  |

Las reglas transversales cubren bindings y estructuras que cruzan todos los recursos: `cl-system-02` (URI absoluta en `identifier.system`), `cl-meta-01` (canonical HTTPS en `meta.profile`), `cl-ref-01` (formato `ResourceType/id` en references), `cl-date-01` (ISO-8601), `cl-narrative-01` (status narrativo). El identificador nacional dentro de `CorePacienteCl` se chequea con `cl-run-01` … `cl-run-04` (formato, dígito verificador módulo 11, system canónico del Registro Civil).

## Catálogos chilenos

Fhiron indexa los catálogos oficiales como recursos consultables:

* **Comunas DEIS** (decreto 817): código, nombre y región.
* **Establecimientos DEIS**: código, razón social y tipo.
* **TFC**: terapéutico farmacológico chileno.
* **CIE-10**: clasificación de diagnósticos.
* **ATC**: clasificación anatómico-terapéutico-química (WHOCC), terminología internacional para fármacos.
* **CSTipoIdentificador**: RUN, pasaporte, DNI extranjero, identificador interno.

Disponibles desde el MCP vía `fhiron_search_terminology` y como resources `fhiron://catalogs/{system}`.

## MINSAL EIS v0.1.0: terminología paralela

Además de CL Core, Fhiron soporta el **Estándar de Interoperabilidad de Salud (EIS) v0.1.0** publicado por la Unidad de Interoperabilidad del MINSAL. Es un IG paralelo (no reemplaza CL Core) que aporta terminología oficial bajo el namespace `https://interoperabilidad.minsal.cl/fhir/ig/eis/`:

* **CSComunas** (347 comunas oficiales DEIS)
* **CSPrevision** (Fonasa A/B/C/D, ISAPRE, PRAIS, ley 21.418)
* **CSEspecialidadMedica / Odontologica / Farma / Bioquimica**
* **CSPueblosOriginarios**, **CSEstadoCivil**, **CSReligion**
* **CSNivelAtencion**, **CSNivelComplejidad**
* **CSOcupaciones** + **CSOcupacionesDetalladas** (DEIS)
* 49 CodeSystems + 49 ValueSets en total

### Cuándo usar CL Core vs EIS

Cuando un concepto tiene cobertura en ambos (ej. comunas), recomendamos **CL Core como default** y EIS para conceptos no cubiertos en CL Core (previsión, estado civil, pueblos originarios, nivel atención).

| Concepto            | CL Core canonical                                      | EIS canonical                                                             |
| ------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- |
| Comunas             | `hl7chile.cl/fhir/ig/clcore/CodeSystem/CSCodComunasCL` | `interoperabilidad.minsal.cl/fhir/ig/eis/CodeSystem/CSComunas`            |
| Previsión           | (no cubierto)                                          | `interoperabilidad.minsal.cl/fhir/ig/eis/CodeSystem/CSPrevision`          |
| Estado civil        | (no cubierto)                                          | `interoperabilidad.minsal.cl/fhir/ig/eis/CodeSystem/CSEstadoCivil`        |
| Pueblos originarios | (extension solo)                                       | `interoperabilidad.minsal.cl/fhir/ig/eis/CodeSystem/CSPueblosOriginarios` |

Ambas canonicals coexisten sin colisión. Inspect acepta payloads con cualquiera de las dos.

## Política canónica

<Warning>
  Solo se aplican definiciones provenientes literalmente de fuentes oficiales:

  * `hl7.fhir.cl.clcore` (HL7 Chile)
  * `hl7.fhir.r4.core` (HL7 internacional)
  * `hl7.terminology.r4`
  * IGs publicados por organismos chilenos (MINSAL, CENS, ISP) con paquete NPM oficial
  * Estándares internacionales con URI canónica documentada: ISO 3166, SNOMED CT, LOINC, ATC, UCUM, HL7 v3

  Cuando una definición no está disponible en estas fuentes, se reporta como ausente. No se sustituye por una versión derivada ni se publica bajo el namespace canónico de HL7 Chile contenido que no sea oficial.
</Warning>