Catálogo de errores

Inspect devuelve códigos estables en ValidateResponse.issues[].code. Esta página los enumera por categoría. Para reglas locales por recurso ver MCP → Reglas locales.

Estructura común

Cada código tiene:

code, identificador estable, ej: cl-enc-04.
severity, error o warning.
path, FHIRPath donde está el problema.
message, descripción en español apta para mostrar al usuario.
why, razón de la regla, con referencia al perfil CL Core.
profileUrl, URL canónica del perfil oficial.
suggestion, qué hacer para resolverlo.
example, fragmento JSON con el formato correcto.
quickFix (opcional), solución mecánica con jsonPointer (RFC 6901) y replacement.

Categorías

Prefijo	Origen
`cl-json-*`	Formato y estructura del JSON
`cl-run-*`	Identificador nacional dentro de `CorePacienteCl`
`cl-patient-*`	CorePacienteCl
`cl-practitioner-*`	CorePrestadorCl
`cl-obs-*`	Observation
`cl-med-*`	CoreMedicamentoCl
`cl-medreq-*`	MedicationRequest
`cl-enc-*`	EncounterCL
`cl-cond-*`	Condition
`cl-allergy-*`	AllergyIntolerance
`cl-proc-*`	Procedure
`cl-cov-*`	Coverage
`cl-org-*`	Organization
`cl-imm-*`	Immunization
`cl-dr-*`	DiagnosticReport
`cl-bundle-*`	Bundle
`hapi-*`	Validación contra HAPI con IG cargado
`mcp-*`	Errores del connector MCP (red, cuota, autenticación)

Ejemplo: `cl-enc-05`

Encounter clasificado con un CodeSystem propio en vez del canónico v3-ActCode. El recurso es JSON válido, pero ningún consumidor que valide terminología lo va a aceptar.

{
  "code": "cl-enc-05",
  "severity": "warning",
  "path": "Encounter.class.system",
  "message": "Encounter.class.system debería ser canónico v3-ActCode (http://terminology.hl7.org/CodeSystem/v3-ActCode). Códigos esperados: AMB · IMP · EMER · HH.",
  "why": "FHIR R4 + HL7 v3: Encounter.class usa el CodeSystem v3-ActCode con códigos AMB (ambulatorio), IMP (internado), EMER (urgencia), HH (domiciliario). Usar un system propio rompe interoperabilidad con bus MINSAL.",
  "profileUrl": "http://hl7.org/fhir/StructureDefinition/Encounter",
  "suggestion": "Reemplazar `class.system` por `http://terminology.hl7.org/CodeSystem/v3-ActCode` y mapear el código local al equivalente AMB/IMP/EMER/HH.",
  "example": {
    "class": {
      "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      "code": "AMB"
    }
  },
  "quickFix": {
    "title": "Cambiar a v3-ActCode (AMB)",
    "jsonPointer": "/class",
    "replacement": {
      "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
      "code": "AMB"
    }
  }
}

Ejemplo: `cl-medreq-02`

MedicationRequest sin intent. Cardinalidad 1..1 en FHIR® R4. La prescripción no se puede interpretar sin saber si es order, plan, proposal, etc. Es uno de los campos que más se omite al migrar prescripciones desde un sistema legacy.

{
  "code": "cl-medreq-02",
  "severity": "error",
  "path": "MedicationRequest.intent",
  "message": "MedicationRequest.intent es obligatorio. Códigos válidos: proposal · plan · order · original-order · reflex-order · filler-order · instance-order · option.",
  "why": "FHIR R4: MedicationRequest.intent cardinalidad 1..1 con binding required. Sin intent, el consumidor no puede distinguir una receta firmada (order) de una sugerencia de IA (proposal) o un protocolo precargado (plan).",
  "profileUrl": "http://hl7.org/fhir/StructureDefinition/MedicationRequest",
  "suggestion": "Para una prescripción dispensable usar `order`. Para un draft que aún no se ha firmado, `proposal` o `plan`.",
  "example": { "intent": "order" },
  "quickFix": {
    "title": "Setear intent = order",
    "jsonPointer": "/intent",
    "replacement": "order"
  }
}

Ver listado completo en runtime

Desde el MCP:

fhiron_explain_code(code: "cl-enc-05")

O leyendo el resource MCP:

fhiron://errors

El catálogo completo se consulta desde el conector MCP con fhiron_explain_code o leyendo el recurso fhiron://errors. Ambos devuelven la versión vigente. Esta página puede atrasarse entre releases.

Empezar

IA + MCP

Recetas

Inspect — Validación FHIR

CLI — Línea de comandos

SDK — Validación embebida

Insight — FHIR Score

Sandbox

Conceptos

Seguridad

Legal

Catálogo de errores

Estructura común

Categorías

Ejemplo: `cl-enc-05`

Ejemplo: `cl-medreq-02`

Ver listado completo en runtime

​Estructura común

​Categorías

​Ejemplo: cl-enc-05

​Ejemplo: cl-medreq-02

​Ver listado completo en runtime

Estructura común

Categorías

Ejemplo: `cl-enc-05`

Ejemplo: `cl-medreq-02`

Ver listado completo en runtime