Skip to main content
Inspect devuelve códigos de error estables en el campo diagnostics.code del OperationOutcome. 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

PrefijoOrigen
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-*CoreEncounterCl
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": "error",
  "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.