Mapear comuna (CL Core y EIS)

Escenario

Las comunas chilenas tienen dos canonicals oficiales que conviven: CSCodComunasCL (CL Core, basado en el decreto 817) y eis-comunas-cs (EIS MINSAL, 346 comunas DEIS). Un integrador que mueve datos entre el bus MINSAL y un EHR clínico típicamente recibe uno y debe poder emitir el otro. Inspect acepta ambos sistemas en Patient.address.extension y mapea contra el decreto 817.

Payload válido: variante CL Core

Patient con comuna CSCodComunasCL

{
  "resourceType": "Patient",
  "identifier": [
    {
      "type": {
        "coding": [
          {
            "system": "https://hl7chile.cl/fhir/ig/clcore/CodeSystem/CSTipoIdentificador",
            "code": "01"
          }
        ]
      },
      "system": "http://www.registrocivil.cl/run",
      "value": "15420097-5"
    }
  ],
  "name": [{ "family": "Soto", "given": ["Diego"] }],
  "gender": "male",
  "birthDate": "1990-03-22",
  "address": [
    {
      "use": "home",
      "line": ["Av. Providencia 1234, depto 502"],
      "city": "Providencia",
      "_city": {
        "extension": [
          {
            "url": "https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/ComunasCl",
            "valueCodeableConcept": {
              "coding": [
                {
                  "system": "https://hl7chile.cl/fhir/ig/clcore/CodeSystem/CSCodComunasCL",
                  "code": "13123",
                  "display": "Providencia"
                }
              ]
            }
          }
        ]
      },
      "country": "CL"
    }
  ]
}

Payload válido: variante EIS

Misma comuna, expresada con el CodeSystem EIS:

fragmento Patient.address.city

"_city": {
  "extension": [
    {
      "url": "https://interoperabilidad.minsal.cl/fhir/ig/eis/StructureDefinition/eis-comunas",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "https://interoperabilidad.minsal.cl/fhir/ig/eis/CodeSystem/eis-comunas-cs",
            "code": "13123",
            "display": "Providencia"
          }
        ]
      }
    }
  ]
}

Cómo validarlo

curl -X POST https://fhiron.cl/api/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $FHIRON_API_KEY" \
  -d @patient-comuna.json

const response = await fetch("https://fhiron.cl/api/validate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.FHIRON_API_KEY,
  },
  body: JSON.stringify(patient),
});
const outcome = await response.json();

import os, requests
response = requests.post(
    "https://fhiron.cl/api/validate",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["FHIRON_API_KEY"],
    },
    json=patient,
)
outcome = response.json()

Resultado esperado

Ambos canonicals pasan la validación. valid es true e issues[] viene vacío. Errores típicos:

cl-comuna-01: address.city no aparece en el decreto 817 (probable error de grafía: "Ñuñoa" vs "Nunoa").
cl-eis-comuna-01: eis-comunas-cs con código que no corresponde al display (ej: 13123 enviado como "Las Condes").
cl-patient-*: falta country: "CL" cuando hay dirección con comuna chilena.

Tips

Decreto 817 vigente: 346 comunas + 1 administrativa (Antártica). Si el integrador envía comunas obsoletas (anteriores al decreto), Inspect marca cl-comuna-01 warning.

Los códigos de CSCodComunasCL y eis-comunas-cs coinciden numéricamente (13101 Santiago, 13123 Providencia, 5101 Valparaíso). Ojo con los ceros a la izquierda: en eis-comunas-cs v0.2.0 el código de Valparaíso es 5101, no 05101 (formato inconsistente entre comunas, verifica siempre contra el CodeSystem en vez de asumir 5 dígitos fijos). El que cambia entre canonicals es el system.

Caracteres especiales: Ñuñoa, Peñalolén, Concepción van con tilde y eñe en address.city. UTF-8, no Latin-1.

Para tests de integración hacia el bus MINSAL, preferir la variante EIS (eis-comunas-cs). Para integraciones internas chilenas alineadas con el IG oficial CL Core, la variante CSCodComunasCL es la canónica.

Inspect acepta los dos canonicals y los considera equivalentes a efectos de validación. El payload no necesita migrar: si tu EHR emite EIS, Inspect lo valida con cl-eis-comuna-01; si emite CL Core, lo valida con cl-comuna-01.

Empezar

IA + MCP

Recetas

Inspect — Validación FHIR

CLI — Línea de comandos

SDK — Validación embebida

Insight — FHIR Score

Sandbox

Conceptos

Seguridad

Legal

Mapear comuna (CL Core y EIS)

Escenario

Payload válido: variante CL Core

Payload válido: variante EIS

Cómo validarlo

Resultado esperado

Tips

​Escenario

​Payload válido: variante CL Core

​Payload válido: variante EIS

​Cómo validarlo

​Resultado esperado

​Tips

Escenario

Payload válido: variante CL Core

Payload válido: variante EIS

Cómo validarlo

Resultado esperado

Tips