{
  "resourceType": "StructureDefinition",
  "url": "http://fhir.health.gov.il/StructureDefinition/linkageConfidence",
  "version": "0.1.0",
  "name": "LinkageConfidence",
  "title": "Linkage Confidence (per Linkage.item)",
  "status": "draft",
  "date": "2025-10-30",
  "publisher": "Israel Ministry of Health",
  "contact": [
    {
      "name": "Israel MOH FHIR",
      "telecom": [
        {
          "system": "url",
          "value": "https://fhir.health.gov.il"
        }
      ]
    }
  ],
  "description": "Provides confidence metadata for a Linkage.item, including a numeric score (0..1), the basis for the assessment, and an optional note.",
  "purpose": "Supports downstream consumers in interpreting how strongly two records are believed to represent the same real-world occurrence when using Linkage.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "IL",
          "display": "Israel"
        }
      ]
    }
  ],
  "fhirVersion": "4.0.1",
  "kind": "complex-type",
  "abstract": false,
  "type": "Extension",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Extension",
  "derivation": "constraint",
  "context": [
    {
      "type": "element",
      "expression": "Linkage.item"
    }
  ],
  "differential": {
    "element": [
      {
        "id": "Extension",
        "path": "Extension",
        "short": "Confidence that this Linkage.item represents the same real-world occurrence",
        "constraint": [
          {
            "key": "lc-1",
            "severity": "error",
            "human": "If score is present, it must be between 0 and 1 (inclusive).",
            "expression": "extension('score').exists() implies (extension('score').value.as(decimal) >= 0 and extension('score').value.as(decimal) <= 1)"
          },
          {
            "key": "lc-2",
            "severity": "error",
            "human": "At least one of score, basis, or note must be present.",
            "expression": "extension('score').exists() or extension('basis').exists() or extension('note').exists()"
          }
        ]
      },
      {
        "id": "Extension.extension",
        "path": "Extension.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "ordered": false,
          "rules": "open"
        }
      },
      {
        "id": "Extension.extension:score",
        "path": "Extension.extension",
        "sliceName": "score",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Extension.extension:score.url",
        "path": "Extension.extension.url",
        "fixedUri": "score"
      },
      {
        "id": "Extension.extension:score.value[x]",
        "path": "Extension.extension.value[x]",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "decimal"
          }
        ]
      },
      {
        "id": "Extension.extension:basis",
        "path": "Extension.extension",
        "sliceName": "basis",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Extension.extension:basis.url",
        "path": "Extension.extension.url",
        "fixedUri": "basis"
      },
      {
        "id": "Extension.extension:basis.value[x]",
        "path": "Extension.extension.value[x]",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "CodeableConcept"
          }
        ],
        "binding": {
          "strength": "preferred",
          "valueSet": "http://fhir.health.gov.il/ValueSet/linkage-basis"
        }
      },
      {
        "id": "Extension.extension:note",
        "path": "Extension.extension",
        "sliceName": "note",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Extension.extension:note.url",
        "path": "Extension.extension.url",
        "fixedUri": "note"
      },
      {
        "id": "Extension.extension:note.value[x]",
        "path": "Extension.extension.value[x]",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "Extension.url",
        "path": "Extension.url",
        "fixedUri": "http://fhir.health.gov.il/StructureDefinition/linkageConfidence"
      },
      {
        "id": "Extension.value[x]",
        "path": "Extension.value[x]",
        "max": "0"
      }
    ]
  }
}