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/getactivities-tkb-to-procedure | Version: 0.2.0 | |||
| Draft as of 2025-11-25 | Computable Name: ConceptMapGetActivitiesTKBToProcedure | |||
Complete mapping from GetActivities TKB service to FHIR Procedure resource
Mapping from https://rivta.se/domains/clinicalprocess/activity/actions/GetActivitiesResponder/1 to Procedure
Group 1 Mapping from https://rivta.se/domains/clinicalprocess/activity/actions/GetActivitiesResponder/1 to Bundle
| Source Code | Relationship | Target Code | Comment |
| patientId (Query parameter: Patient ID filter) | (not mapped) | NOT MAPPED. Used as search parameter: GET /Procedure?patient=Patient/191212121212 | |
| time (Query parameter: Time period filter) | (not mapped) | NOT MAPPED. Used as search parameter: GET /Procedure?date=ge2024-01-01&date=le2024-12-31 | |
| activityCode (Query parameter: Activity code filter (KVÅ)) | (not mapped) | NOT MAPPED. Used as search parameter: GET /Procedure?code=http://www.socialstyrelsen.se/kva|ABC12 | |
| activityId (Query parameter: Activity ID filter) | (not mapped) | NOT MAPPED. Used as search parameter: GET /Procedure?identifier=hsaid|xyz123 | |
| sourceSystemId (Query parameter: Source system filter) | (not mapped) | NOT MAPPED. Filter by source system HSA-ID | |
| careGiverId (Query parameter: Care giver filter) | (not mapped) | NOT MAPPED. Used to filter by care giver organization | |
| careUnitId (Query parameter: Care unit filter) | (not mapped) | NOT MAPPED. Used to filter by care unit | |
| relation (Query parameter: Related information filter) | (not mapped) | NOT MAPPED. Filter by relationships to other clinical information | |
| interactionAgreementId (Query parameter: Interaction agreement (deprecated)) | (not mapped) | NOT MAPPED. Fixed UUID, not used: 2866a7c4-9c60-433f-9035-a4d779ffe7a1 | |
Group 2 Mapping from https://rivta.se/domains/clinicalprocess/activity/actions/GetActivitiesResponder/1 to Procedure
| Source Code | Relationship | Target Code | Comment |
| activityGroup.activity.id (Activity ID (unique business identifier)) | is equivalent to | identifier | Unique activity identifier within source system. id.root = source system HSA-ID, id.extension = local activity ID. |
| activityGroup.patient.id (Patient ID (personnummer/samordningsnummer)) | is equivalent to | subject | Reference to PatientBaseInera. Maps personnummer (1.2.752.129.2.1.3.1) or samordningsnummer (1.2.752.129.2.1.3.3). |
| activityGroup.activity.code (Activity code (KVÅ or other classification)) | is equivalent to | code | Activity code, typically KVÅ (OID 1.2.752.116.1.1.1.1.4). Maps to CodeableConcept with code.code, code.codeSystem, code.displayName. |
| activityGroup.activity.status (Activity status) | is related to | status | Maps to FHIR status values: preparation, in-progress, completed, not-done, stopped, unknown. TKB uses different code system, requires mapping. |
| activityGroup.activity.time (Activity time (point in time or period)) | is equivalent to | performedDateTime | If time.start == time.end, use performedDateTime. If time.start != time.end, use performedPeriod. |
| activityGroup.activity.time.start (Activity start time) | is equivalent to | performedPeriod.start | Start of activity period. Format: ÅÅÅÅMMDDttmmss. |
| activityGroup.activity.time.end (Activity end time) | is equivalent to | performedPeriod.end | End of activity period. Format: ÅÅÅÅMMDDttmmss. |
| activityGroup.performerRole (Performer (practitioner role)) | is equivalent to | performer | Person who performed the activity. Maps to performer.actor (PractitionerBaseInera). |
| activityGroup.performerRole.person.id (Performer person ID (HSA-ID)) | is equivalent to | performer.actor | Reference to PractitionerBaseInera. HSA-ID in id.extension (OID 1.2.752.129.2.1.4.1). |
| activityGroup.performerRole.code (Performer role code (KV Befattning)) | is equivalent to | performer.function | Role of performer, typically KV Befattning (OID 1.2.752.129.2.2.1.4). |
| activityGroup.performerRole.careUnit.id (Care unit (PDL vårdenhet)) | is related to | location | Care unit HSA-ID. Maps to Location resource reference, or use performer.onBehalfOf for organization. |
| activityGroup.performerRole.careUnit.careGiver.id (Care giver (vårdgivare organization)) | is equivalent to | performer.onBehalfOf | Reference to OrganizationBaseInera. Care giver HSA-ID (OID 1.2.752.129.2.1.4.1). |
| activityGroup.activity.targetSite (Target body site) | is equivalent to | bodySite | Anatomical location where procedure was performed. Maps to CodeableConcept (e.g., SNOMED CT body site codes). |
| activityGroup.activity.method (Activity method) | is equivalent to | extension:method | Method/technique used during the procedure. Uses standard HL7 procedure-method extension (http://hl7.org/fhir/StructureDefinition/procedure-method). |
| activityGroup.activity.description (Activity description (free text)) | is equivalent to | note | Free text description of the activity. |
| activityGroup.activity.registrationTime (Registration time) | is equivalent to | Provenance.recorded | When activity was registered in system. Use Provenance.recorded with activity=CREATE and target=Procedure. |
| activityGroup.activity.approvedForPatient (Approved for patient viewing (menprövningsflagga)) | is related to | meta.security | Menprövningsflagga - indicates patient viewing approval. Use meta.security labels or link to Consent resource for patient access control. |
| activityGroup.legalAuthenticator (Legal authenticator (signatory)) | is equivalent to | Provenance.agent | Person who signed/authenticated the activity. Map to Provenance resource with agent.role = legal authenticator (http://terminology.hl7.org/CodeSystem/v3-ParticipationType#LA). |
| activityGroup.sourceSystem.id (Source system (HSA-ID)) | is related to | identifier.system | Source system HSA-ID. Used as identifier.system prefix, or in meta.source. |
| activityGroup.careProcessId (Care process UUID (vårdprocess)) | is equivalent to | basedOn | UUID for individualized care process. Reference EpisodeOfCare resource with identifier.value = careProcessId UUID. Use basedOn since Procedure.partOf only allows Procedure|Observation|MedicationAdministration. |
| activityGroup.additionalParticipant (Additional participants) | is related to | performer | Other participants (persons, devices, locations) in the activity. Map persons to additional performer entries, devices to focalDevice, locations to location element. |
| activityGroup.additionalParticipant.type (Participant type) | is related to | performer.function | Type of participant involvement. |
| activityGroup.additionalParticipant.role (Participant role) | is related to | performer.function | Role code for participant. |
| activityGroup.additionalParticipant.device (Participating device) | is equivalent to | focalDevice | Device used in procedure. Maps to focalDevice with reference to Device resource. |
| activityGroup.additionalParticipant.location (Participating location) | is equivalent to | location | Location where procedure was performed. Reference to Location resource. |
| activityGroup.activity.relation (Relations to other clinical information) | is related to | basedOn | Relationships to observations (chb-o) or other activities (caa-ga). Use basedOn (fulfills order/request), partOf (part of larger activity), or reasonReference (justification) depending on relation type. |
| activityGroup.activity.relation.code (Relation type code) | is related to | basedOn | Type of relationship determines which element to use: basedOn (fulfills), partOf (component), reasonReference (justification). Relation.code context preserved in referenced resource identifier. |
| activityGroup.activity.relation.referredInformation.id (Related information ID) | is related to | basedOn | ID of related observation or activity. Maps to reference (Observation, Procedure, etc.). |
| activityGroup.activity.additionalInformation (Additional information (key-value pairs)) | is related to | note | Additional structured information as key-value pairs. Store as formatted text in Procedure.note (Annotation type). For structured data, create referenced Observation resources. |
Group 3 Mapping from https://rivta.se/domains/clinicalprocess/activity/actions/GetActivitiesResponder/1 to Provenance
| Source Code | Relationship | Target Code | Comment |
| activityGroup.legalAuthenticator.id (Legal authenticator ID) | is equivalent to | agent.who | Reference to PractitionerBaseInera who signed/authenticated the activity. |
| activityGroup.legalAuthenticator.time (Authentication time) | is equivalent to | occurredDateTime | When the activity was authenticated/signed. |
| activityGroup.legalAuthenticator.name (Authenticator name) | is equivalent to | agent.who.display | Name of legal authenticator. |
| activityGroup.patient.dateOfBirth (Patient date of birth) | is related to | target | Patient demographics echoed in response. Not mapped separately; available in referenced Patient resource. |
| activityGroup.patient.gender (Patient gender (KV Kön)) | is related to | target | Patient demographics. Available in referenced Patient resource with KV Kön code (OID 1.2.752.129.2.2.1.1). |
Group 4 Mapping from https://rivta.se/domains/clinicalprocess/activity/actions/GetActivitiesResponder/1 to Bundle
| Source Code | Relationship | Target Code | Comment |
| activityGroup (Activity group (container)) | (not mapped) | NOT MAPPED. Container/grouping structure for optimization. In FHIR, each activity becomes separate Procedure resource in Bundle. | |
| activityGroup.device (Device (deprecated - use additionalParticipant)) | (not mapped) | NOT MAPPED. Deprecated in TKB v1.3. Use activityGroup.additionalParticipant.device instead. | |
| activityGroup.location (Location (deprecated - use additionalParticipant)) | (not mapped) | NOT MAPPED. Deprecated in TKB v1.3. Use activityGroup.additionalParticipant.location instead. | |