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