Inera Core Implementation Guide
0.2.0 - ci-build Sweden

Inera Core Implementation Guide - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: ConceptMap GetAlertInformation TKB to FHIR AllergyIntolerance/Flag - JSON Representation

Draft as of 2025-11-24

Raw json | Download

{
  "resourceType" : "ConceptMap",
  "id" : "ConceptMapGetAlertInformationTKBToAllergyIntolerance",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap ConceptMapGetAlertInformationTKBToAllergyIntolerance</b></p><a name=\"ConceptMapGetAlertInformationTKBToAllergyIntolerance\"> </a><a name=\"hcConceptMapGetAlertInformationTKBToAllergyIntolerance\"> </a><p>Mapping from https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2 to <a href=\"http://hl7.org/fhir/R4/allergyintolerance.html\">AllergyIntolerance</a></p><br/><p><b>Group 1 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/bundle.html\">Bundle</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>patientId (Query parameter: Patient ID filter)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Used as search parameter: GET /AllergyIntolerance?patient=Patient/191212121212</td></tr><tr><td>alertType (Query parameter: Filter by alert type)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Filter by alert type (pharmaceutical hypersensitivity, serious disease, etc.). Used to route to AllergyIntolerance vs Flag resources.</td></tr></table><hr/><p><b>Group 2 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/allergyintolerance.html\">AllergyIntolerance</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>alertInformation.alertInformationHeader.documentId (Alert ID (unique business identifier))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>identifier</td><td>Unique alert identifier within source system. System derived from sourceSystemHSAid.</td></tr><tr><td>alertInformation.alertInformationHeader.patientId (Patient ID (personnummer/samordningsnummer))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>patient</td><td>Reference to Patient with Swedish national identifier. OID 1.2.752.129.2.1.3.1 (personnummer), 1.2.752.129.2.1.3.3 (samordningsnummer)</td></tr><tr><td>alertInformation.alertInformationHeader.approvedForPatient (Approved for patient access (true/false))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>meta.security</td><td>If false, add security label NOPATIENT to restrict patient access (menprövningsflagga).</td></tr><tr><td>alertInformation.alertInformationBody.typeOfAlertInformation (Type of alert (Läkemedelsöverkänslighet))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>type</td><td>Swedish alert type → FHIR AllergyIntolerance.type (allergy|intolerance). Only pharmaceutical hypersensitivity maps here. Other types use Flag resource.</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.typeOfHypersensitivity (Type of hypersensitivity (medication, food, environment))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>category</td><td>Swedish hypersensitivity type (KV Typ av överkänslighet OID 1.2.752.129.2.2.3.10) → FHIR category: medication|food|environment|biologic. Requires ConceptMap.</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.degreeOfSeverity (Degree of severity)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>criticality</td><td>Swedish severity codes (KV Allvarlighetsgrad OID 1.2.752.129.2.2.3.3) → FHIR criticality: low|high|unable-to-assess. Lindrig/Måttlig→low, Svår/Livshotande→high.</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.degreeOfCertainty (Degree of certainty/verification)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>verificationStatus</td><td>Swedish certainty codes (KV Visshetsgrad OID 1.2.752.129.2.2.3.11) → FHIR verificationStatus: unconfirmed|presumed|confirmed|refuted. Requires ConceptMap.</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.atcSubstance (ATC substance code)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code</td><td>ATC code for pharmaceutical substance. System: http://www.whocc.no/atc or Swedish ATC (OID 1.2.752.129.2.2.3.1.1). code.coding.code + code.coding.display.</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.atcSubstance.code (ATC code value)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.coding.code</td><td>ATC code (e.g., N02BE01 for paracetamol). System: http://www.whocc.no/atc</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.atcSubstance.displayName (Substance name)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.coding.display</td><td>Substance display name (e.g., 'Paracetamol')</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.nonAtcSubstance (Non-ATC substance description)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.text</td><td>Free text description when ATC code not available. Use code.text.</td></tr><tr><td>alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.pharmaceuticalProductId (NPL product ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>code.coding</td><td>NPL (Nordic Pharmaceutical List) ID. System: OID 1.2.752.129.2.1.5.1. Add as additional coding alongside ATC.</td></tr><tr><td>alertInformation.alertInformationBody.alertInformationComment (Comment/description of reaction)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>reaction.description</td><td>Free text description of observed reaction. For coded reactions, use reaction.manifestation with SNOMED CT codes.</td></tr><tr><td>alertInformation.alertInformationBody.ascertainedDate (Date when hypersensitivity was ascertained)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>onsetDateTime</td><td>When the allergy/intolerance was first identified or occurred.</td></tr><tr><td>alertInformation.alertInformationBody.verifiedTime (Verification timestamp)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>recordedDate</td><td>When the allergy was verified/recorded in the system. Also in Provenance.recorded.</td></tr><tr><td>alertInformation.alertInformationBody.validityTimePeriod.start (Validity period start)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>onsetDateTime</td><td>Start of validity period for the alert.</td></tr><tr><td>alertInformation.alertInformationBody.validityTimePeriod.end (Validity period end)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>lastOccurrence</td><td>End of validity. If ended, may also set clinicalStatus=inactive or resolved.</td></tr><tr><td>alertInformation.alertInformationBody.obsoleteTime (Time when alert became obsolete)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>clinicalStatus</td><td>If obsoleteTime is set, clinicalStatus=inactive or resolved. Store actual obsolete timestamp in Provenance.recorded with activity=UPDATE describing status change.</td></tr><tr><td>alertInformation.alertInformationHeader.nullified (Alert nullified flag)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>verificationStatus</td><td>If nullified=true, set verificationStatus=entered-in-error. Store nullifiedReason in Provenance.</td></tr></table><hr/><p><b>Group 3 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/flag.html\">Flag</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>alertInformation.alertInformationHeader.documentId (Alert ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>identifier</td><td>Unique alert identifier for non-pharmaceutical alerts.</td></tr><tr><td>alertInformation.alertInformationHeader.patientId (Patient ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>subject</td><td>Reference to Patient resource.</td></tr><tr><td>alertInformation.alertInformationHeader.approvedForPatient (Approved for patient access)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>meta.security</td><td>If false, add security label NOPATIENT.</td></tr><tr><td>alertInformation.alertInformationBody.typeOfAlertInformation (Type of alert (Allvarlig sjukdom, Behandlingsvarning, etc.))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>category</td><td>Swedish alert type → Flag.category. Use Swedish CodeSystem or map to FHIR flag-category codes: safety|infection|drug|behavioral|etc.</td></tr><tr><td>alertInformation.alertInformationBody.seriousDisease (Serious disease information)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code</td><td>Coded serious disease (e.g., bleeding disorder, infectious disease). Use SNOMED CT or ICD-10-SE codes.</td></tr><tr><td>alertInformation.alertInformationBody.treatmentWarning (Treatment warning)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code</td><td>Treatment warning information. Code and text description.</td></tr><tr><td>alertInformation.alertInformationBody.communicableDisease (Communicable disease)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code</td><td>Communicable disease alert. Use infectious disease codes.</td></tr><tr><td>alertInformation.alertInformationBody.restrictionOfCare (Restriction of care)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code</td><td>Care restriction information (e.g., DNR, treatment limitations).</td></tr><tr><td>alertInformation.alertInformationBody.unstructuredAlertInformation (Unstructured alert information)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.text</td><td>Free text alert when structured data not available.</td></tr><tr><td>alertInformation.alertInformationBody.validityTimePeriod (Validity time period)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>period</td><td>When the flag/alert is valid. period.start and period.end.</td></tr><tr><td>alertInformation.alertInformationBody.obsoleteTime (Obsolete time)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider\" title=\"wider\">maps to wider concept</a></td><td>status</td><td>If obsoleteTime set, status=inactive. Otherwise status=active. FHIR status: active|inactive|entered-in-error.</td></tr><tr><td>alertInformation.alertInformationBody.alertInformationComment (Alert comment)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>code.text</td><td>Additional comment/description. Use code.text for brief comment or Flag.note for longer narrative.</td></tr></table><hr/><p><b>Group 4 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/provenance.html\">Provenance</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>alertInformation.alertInformationHeader.sourceSystemHSAid (Source system HSA-ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>entity.what</td><td>HSA-ID of source system. Also mapped to AllergyIntolerance/Flag.meta.source as https://hsaid.se/{HSA-ID}. Provenance.entity.role=source.</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.authorTime (Author time (registration timestamp))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>recorded</td><td>When alert was recorded. Also in AllergyIntolerance.recordedDate.</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalHSAid (Healthcare professional HSA-ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>agent.who</td><td>Reference to Practitioner with HSA-ID. Provenance.agent.type=author. Also in AllergyIntolerance.recorder.</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalName (Healthcare professional name)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>agent.who.display</td><td>Display name. Full Practitioner resource should have structured name.</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalRoleCode (Healthcare professional role/befattning)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>agent.role</td><td>Professional role (befattning). Use KV Befattning (OID 1.2.752.129.2.2.1.4).</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit (Organization unit)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>agent.onBehalfOf</td><td>Reference to Organization (organizational unit).</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid (Care unit HSA-ID (vårdenhet))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>entity.what</td><td>HSA-ID for care unit. Reference to Organization. Part of PDL hierarchy.</td></tr><tr><td>alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalCareGiverHSAid (Care provider HSA-ID (vårdgivare))</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>entity.what</td><td>HSA-ID for care provider. Top-level organization in PDL hierarchy.</td></tr><tr><td>alertInformation.alertInformationHeader.legalAuthenticator.signatureTime (Signature timestamp)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>signature.when</td><td>When alert was digitally signed (if applicable).</td></tr><tr><td>alertInformation.alertInformationHeader.legalAuthenticator.legalAuthenticatorHSAid (Legal authenticator HSA-ID)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>signature.who</td><td>Reference to Practitioner who signed alert. Provenance.agent.type=legal.</td></tr><tr><td>alertInformation.alertInformationHeader.nullifiedReason (Reason for nullification)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto\" title=\"relatedto\">is related to</a></td><td>reason</td><td>Why alert was nullified. Store in Provenance.reason when verificationStatus=entered-in-error.</td></tr></table><hr/><p><b>Group 5 </b>Mapping from <code>https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2</code> to <a href=\"http://hl7.org/fhir/R4/bundle.html\">Bundle</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>alertInformation.alertInformationHeader.documentTitle (Document title)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Cardinality 0..0 for GetAlertInformation.</td></tr><tr><td>alertInformation.alertInformationHeader.documentTime (Document time)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED. Cardinality 0..0 for GetAlertInformation. Use authorTime or verifiedTime instead.</td></tr><tr><td>result.resultCode (Result code (OK, INFO, ERROR))</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. HTTP status: OK→200, INFO→200 with warnings, ERROR→4xx/5xx.</td></tr><tr><td>result.errorCode (Error code)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. Use in OperationOutcome.issue.code when resultCode=ERROR.</td></tr><tr><td>result.logId (Log ID (UUID for troubleshooting))</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. Use in OperationOutcome.issue.diagnostics or X-Request-Id header.</td></tr><tr><td>result.message (Result message)</td><td colspan=\"2\" style=\"background-color: #efefef\">(not mapped)</td><td style=\"background-color: #efefef\">NOT MAPPED to resources. User-facing message in OperationOutcome.issue.diagnostics.</td></tr></table></div>"
  },
  "url" : "https://inera.se/fhir/core/ConceptMap/getalertinformation-tkb-to-allergyintolerance",
  "version" : "0.2.0",
  "name" : "ConceptMapGetAlertInformationTKBToAllergyIntolerance",
  "title" : "ConceptMap GetAlertInformation TKB to FHIR AllergyIntolerance/Flag",
  "status" : "draft",
  "experimental" : true,
  "date" : "2025-11-24",
  "publisher" : "Inera AB",
  "contact" : [
    {
      "name" : "Inera AB",
      "telecom" : [
        {
          "system" : "url",
          "value" : "https://www.inera.se"
        },
        {
          "system" : "email",
          "value" : "info@inera.se"
        }
      ]
    },
    {
      "name" : "Inera AB",
      "telecom" : [
        {
          "system" : "url",
          "value" : "https://www.inera.se"
        },
        {
          "system" : "email",
          "value" : "info@inera.se"
        }
      ]
    }
  ],
  "description" : "Complete mapping from GetAlertInformation TKB service to FHIR AllergyIntolerance and Flag resources",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "SE",
          "display" : "Sweden"
        }
      ]
    }
  ],
  "sourceUri" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2",
  "targetCanonical" : "http://hl7.org/fhir/StructureDefinition/AllergyIntolerance",
  "group" : [
    {
      "source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2",
      "target" : "http://hl7.org/fhir/StructureDefinition/Bundle",
      "element" : [
        {
          "code" : "patientId",
          "display" : "Query parameter: Patient ID filter",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED. Used as search parameter: GET /AllergyIntolerance?patient=Patient/191212121212"
            }
          ]
        },
        {
          "code" : "alertType",
          "display" : "Query parameter: Filter by alert type",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED. Filter by alert type (pharmaceutical hypersensitivity, serious disease, etc.). Used to route to AllergyIntolerance vs Flag resources."
            }
          ]
        }
      ]
    },
    {
      "source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2",
      "target" : "http://hl7.org/fhir/StructureDefinition/AllergyIntolerance",
      "element" : [
        {
          "code" : "alertInformation.alertInformationHeader.documentId",
          "display" : "Alert ID (unique business identifier)",
          "target" : [
            {
              "code" : "identifier",
              "equivalence" : "equivalent",
              "comment" : "Unique alert identifier within source system. System derived from sourceSystemHSAid."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.patientId",
          "display" : "Patient ID (personnummer/samordningsnummer)",
          "target" : [
            {
              "code" : "patient",
              "equivalence" : "equivalent",
              "comment" : "Reference to Patient with Swedish national identifier. OID 1.2.752.129.2.1.3.1 (personnummer), 1.2.752.129.2.1.3.3 (samordningsnummer)"
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.approvedForPatient",
          "display" : "Approved for patient access (true/false)",
          "target" : [
            {
              "code" : "meta.security",
              "equivalence" : "equivalent",
              "comment" : "If false, add security label NOPATIENT to restrict patient access (menprövningsflagga)."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.typeOfAlertInformation",
          "display" : "Type of alert (Läkemedelsöverkänslighet)",
          "target" : [
            {
              "code" : "type",
              "equivalence" : "wider",
              "comment" : "Swedish alert type → FHIR AllergyIntolerance.type (allergy|intolerance). Only pharmaceutical hypersensitivity maps here. Other types use Flag resource."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.typeOfHypersensitivity",
          "display" : "Type of hypersensitivity (medication, food, environment)",
          "target" : [
            {
              "code" : "category",
              "equivalence" : "wider",
              "comment" : "Swedish hypersensitivity type (KV Typ av överkänslighet OID 1.2.752.129.2.2.3.10) → FHIR category: medication|food|environment|biologic. Requires ConceptMap."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.degreeOfSeverity",
          "display" : "Degree of severity",
          "target" : [
            {
              "code" : "criticality",
              "equivalence" : "wider",
              "comment" : "Swedish severity codes (KV Allvarlighetsgrad OID 1.2.752.129.2.2.3.3) → FHIR criticality: low|high|unable-to-assess. Lindrig/Måttlig→low, Svår/Livshotande→high."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.degreeOfCertainty",
          "display" : "Degree of certainty/verification",
          "target" : [
            {
              "code" : "verificationStatus",
              "equivalence" : "wider",
              "comment" : "Swedish certainty codes (KV Visshetsgrad OID 1.2.752.129.2.2.3.11) → FHIR verificationStatus: unconfirmed|presumed|confirmed|refuted. Requires ConceptMap."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.atcSubstance",
          "display" : "ATC substance code",
          "target" : [
            {
              "code" : "code",
              "equivalence" : "equivalent",
              "comment" : "ATC code for pharmaceutical substance. System: http://www.whocc.no/atc or Swedish ATC (OID 1.2.752.129.2.2.3.1.1). code.coding.code + code.coding.display."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.atcSubstance.code",
          "display" : "ATC code value",
          "target" : [
            {
              "code" : "code.coding.code",
              "equivalence" : "equivalent",
              "comment" : "ATC code (e.g., N02BE01 for paracetamol). System: http://www.whocc.no/atc"
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.atcSubstance.displayName",
          "display" : "Substance name",
          "target" : [
            {
              "code" : "code.coding.display",
              "equivalence" : "equivalent",
              "comment" : "Substance display name (e.g., 'Paracetamol')"
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.nonAtcSubstance",
          "display" : "Non-ATC substance description",
          "target" : [
            {
              "code" : "code.text",
              "equivalence" : "equivalent",
              "comment" : "Free text description when ATC code not available. Use code.text."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.hypersensitivity.pharmaceuticalHypersensitivity.pharmaceuticalProductId",
          "display" : "NPL product ID",
          "target" : [
            {
              "code" : "code.coding",
              "equivalence" : "wider",
              "comment" : "NPL (Nordic Pharmaceutical List) ID. System: OID 1.2.752.129.2.1.5.1. Add as additional coding alongside ATC."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.alertInformationComment",
          "display" : "Comment/description of reaction",
          "target" : [
            {
              "code" : "reaction.description",
              "equivalence" : "equivalent",
              "comment" : "Free text description of observed reaction. For coded reactions, use reaction.manifestation with SNOMED CT codes."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.ascertainedDate",
          "display" : "Date when hypersensitivity was ascertained",
          "target" : [
            {
              "code" : "onsetDateTime",
              "equivalence" : "equivalent",
              "comment" : "When the allergy/intolerance was first identified or occurred."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.verifiedTime",
          "display" : "Verification timestamp",
          "target" : [
            {
              "code" : "recordedDate",
              "equivalence" : "equivalent",
              "comment" : "When the allergy was verified/recorded in the system. Also in Provenance.recorded."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.validityTimePeriod.start",
          "display" : "Validity period start",
          "target" : [
            {
              "code" : "onsetDateTime",
              "equivalence" : "equivalent",
              "comment" : "Start of validity period for the alert."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.validityTimePeriod.end",
          "display" : "Validity period end",
          "target" : [
            {
              "code" : "lastOccurrence",
              "equivalence" : "wider",
              "comment" : "End of validity. If ended, may also set clinicalStatus=inactive or resolved."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.obsoleteTime",
          "display" : "Time when alert became obsolete",
          "target" : [
            {
              "code" : "clinicalStatus",
              "equivalence" : "wider",
              "comment" : "If obsoleteTime is set, clinicalStatus=inactive or resolved. Store actual obsolete timestamp in Provenance.recorded with activity=UPDATE describing status change."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.nullified",
          "display" : "Alert nullified flag",
          "target" : [
            {
              "code" : "verificationStatus",
              "equivalence" : "equivalent",
              "comment" : "If nullified=true, set verificationStatus=entered-in-error. Store nullifiedReason in Provenance."
            }
          ]
        }
      ]
    },
    {
      "source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2",
      "target" : "http://hl7.org/fhir/StructureDefinition/Flag",
      "element" : [
        {
          "code" : "alertInformation.alertInformationHeader.documentId",
          "display" : "Alert ID",
          "target" : [
            {
              "code" : "identifier",
              "equivalence" : "equivalent",
              "comment" : "Unique alert identifier for non-pharmaceutical alerts."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.patientId",
          "display" : "Patient ID",
          "target" : [
            {
              "code" : "subject",
              "equivalence" : "equivalent",
              "comment" : "Reference to Patient resource."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.approvedForPatient",
          "display" : "Approved for patient access",
          "target" : [
            {
              "code" : "meta.security",
              "equivalence" : "equivalent",
              "comment" : "If false, add security label NOPATIENT."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.typeOfAlertInformation",
          "display" : "Type of alert (Allvarlig sjukdom, Behandlingsvarning, etc.)",
          "target" : [
            {
              "code" : "category",
              "equivalence" : "wider",
              "comment" : "Swedish alert type → Flag.category. Use Swedish CodeSystem or map to FHIR flag-category codes: safety|infection|drug|behavioral|etc."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.seriousDisease",
          "display" : "Serious disease information",
          "target" : [
            {
              "code" : "code",
              "equivalence" : "equivalent",
              "comment" : "Coded serious disease (e.g., bleeding disorder, infectious disease). Use SNOMED CT or ICD-10-SE codes."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.treatmentWarning",
          "display" : "Treatment warning",
          "target" : [
            {
              "code" : "code",
              "equivalence" : "equivalent",
              "comment" : "Treatment warning information. Code and text description."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.communicableDisease",
          "display" : "Communicable disease",
          "target" : [
            {
              "code" : "code",
              "equivalence" : "equivalent",
              "comment" : "Communicable disease alert. Use infectious disease codes."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.restrictionOfCare",
          "display" : "Restriction of care",
          "target" : [
            {
              "code" : "code",
              "equivalence" : "equivalent",
              "comment" : "Care restriction information (e.g., DNR, treatment limitations)."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.unstructuredAlertInformation",
          "display" : "Unstructured alert information",
          "target" : [
            {
              "code" : "code.text",
              "equivalence" : "equivalent",
              "comment" : "Free text alert when structured data not available."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.validityTimePeriod",
          "display" : "Validity time period",
          "target" : [
            {
              "code" : "period",
              "equivalence" : "equivalent",
              "comment" : "When the flag/alert is valid. period.start and period.end."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.obsoleteTime",
          "display" : "Obsolete time",
          "target" : [
            {
              "code" : "status",
              "equivalence" : "wider",
              "comment" : "If obsoleteTime set, status=inactive. Otherwise status=active. FHIR status: active|inactive|entered-in-error."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationBody.alertInformationComment",
          "display" : "Alert comment",
          "target" : [
            {
              "code" : "code.text",
              "equivalence" : "equivalent",
              "comment" : "Additional comment/description. Use code.text for brief comment or Flag.note for longer narrative."
            }
          ]
        }
      ]
    },
    {
      "source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2",
      "target" : "http://hl7.org/fhir/StructureDefinition/Provenance",
      "element" : [
        {
          "code" : "alertInformation.alertInformationHeader.sourceSystemHSAid",
          "display" : "Source system HSA-ID",
          "target" : [
            {
              "code" : "entity.what",
              "equivalence" : "equivalent",
              "comment" : "HSA-ID of source system. Also mapped to AllergyIntolerance/Flag.meta.source as https://hsaid.se/{HSA-ID}. Provenance.entity.role=source."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.authorTime",
          "display" : "Author time (registration timestamp)",
          "target" : [
            {
              "code" : "recorded",
              "equivalence" : "equivalent",
              "comment" : "When alert was recorded. Also in AllergyIntolerance.recordedDate."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalHSAid",
          "display" : "Healthcare professional HSA-ID",
          "target" : [
            {
              "code" : "agent.who",
              "equivalence" : "equivalent",
              "comment" : "Reference to Practitioner with HSA-ID. Provenance.agent.type=author. Also in AllergyIntolerance.recorder."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalName",
          "display" : "Healthcare professional name",
          "target" : [
            {
              "code" : "agent.who.display",
              "equivalence" : "equivalent",
              "comment" : "Display name. Full Practitioner resource should have structured name."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalRoleCode",
          "display" : "Healthcare professional role/befattning",
          "target" : [
            {
              "code" : "agent.role",
              "equivalence" : "relatedto",
              "comment" : "Professional role (befattning). Use KV Befattning (OID 1.2.752.129.2.2.1.4)."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalOrgUnit",
          "display" : "Organization unit",
          "target" : [
            {
              "code" : "agent.onBehalfOf",
              "equivalence" : "equivalent",
              "comment" : "Reference to Organization (organizational unit)."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalCareUnitHSAid",
          "display" : "Care unit HSA-ID (vårdenhet)",
          "target" : [
            {
              "code" : "entity.what",
              "equivalence" : "equivalent",
              "comment" : "HSA-ID for care unit. Reference to Organization. Part of PDL hierarchy."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.accountableHealthcareProfessional.healthcareProfessionalCareGiverHSAid",
          "display" : "Care provider HSA-ID (vårdgivare)",
          "target" : [
            {
              "code" : "entity.what",
              "equivalence" : "equivalent",
              "comment" : "HSA-ID for care provider. Top-level organization in PDL hierarchy."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.legalAuthenticator.signatureTime",
          "display" : "Signature timestamp",
          "target" : [
            {
              "code" : "signature.when",
              "equivalence" : "equivalent",
              "comment" : "When alert was digitally signed (if applicable)."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.legalAuthenticator.legalAuthenticatorHSAid",
          "display" : "Legal authenticator HSA-ID",
          "target" : [
            {
              "code" : "signature.who",
              "equivalence" : "equivalent",
              "comment" : "Reference to Practitioner who signed alert. Provenance.agent.type=legal."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.nullifiedReason",
          "display" : "Reason for nullification",
          "target" : [
            {
              "code" : "reason",
              "equivalence" : "relatedto",
              "comment" : "Why alert was nullified. Store in Provenance.reason when verificationStatus=entered-in-error."
            }
          ]
        }
      ]
    },
    {
      "source" : "https://rivta.se/domains/clinicalprocess/healthcond/description/GetAlertInformationResponder/2",
      "target" : "http://hl7.org/fhir/StructureDefinition/Bundle",
      "element" : [
        {
          "code" : "alertInformation.alertInformationHeader.documentTitle",
          "display" : "Document title",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED. Cardinality 0..0 for GetAlertInformation."
            }
          ]
        },
        {
          "code" : "alertInformation.alertInformationHeader.documentTime",
          "display" : "Document time",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED. Cardinality 0..0 for GetAlertInformation. Use authorTime or verifiedTime instead."
            }
          ]
        },
        {
          "code" : "result.resultCode",
          "display" : "Result code (OK, INFO, ERROR)",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED to resources. HTTP status: OK→200, INFO→200 with warnings, ERROR→4xx/5xx."
            }
          ]
        },
        {
          "code" : "result.errorCode",
          "display" : "Error code",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED to resources. Use in OperationOutcome.issue.code when resultCode=ERROR."
            }
          ]
        },
        {
          "code" : "result.logId",
          "display" : "Log ID (UUID for troubleshooting)",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED to resources. Use in OperationOutcome.issue.diagnostics or X-Request-Id header."
            }
          ]
        },
        {
          "code" : "result.message",
          "display" : "Result message",
          "target" : [
            {
              "equivalence" : "unmatched",
              "comment" : "NOT MAPPED to resources. User-facing message in OperationOutcome.issue.diagnostics."
            }
          ]
        }
      ]
    }
  ]
}