Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:intro:relationer_struktur [2026-06-10 14:22] – [Eksempler på substitutions- og kombinationsordinationer] exttkn
+++ fmk:1.6.0:intro:relationer_struktur [2026-06-17 07:48] (current) – [Termer] bbk
@@ Line 8: / Line 8: @@
 Princippet for substitutionsordinationer tager udgangspunkt i, at en lægemiddelordination i et kortere eller længere tidsrum kan substitueres med en eller flere andre lægemidler angivet på selvstændige men relaterede lægemiddelordinationer. Ved anvendelse af substitutionsordinationer er det vigtigt at sikre, at borgeren ikke dobbeltmedicineres. Herunder at det skal være tydeligt, når to eller flere lægemiddelordinationer indeholder et sæt substituterbare lægemidler som ikke skal tages samtidigt. Dette gælder også i korte tidsrum hvor medicinkortet opdateres.
-Substitutionsordinationer håndteres via FMK’s almindelige services til at oprette, opdatere og hente  lægemiddelordinationer. Dette suppleres med en service til apoteket. Dvs. der skal ikke anvendes separat funktionalitet når substitutionsordinationer skal oprettes eller opdateres. Ved opslag på FMK vil der kunne returneres lægemiddelordinationer med substitutionsrelationer, også til systemer, hvor dette måske ofte ikke anvendes. Det er derfor et krav, at alle systemer kan håndtere substitutionsrelationer og vise disse, så det er tydeligt for brugeren at der er tale om lægemidler, der kan substitueres men ikke skal tages samtidigt.
+Substitutionsordinationer håndteres via FMK’s almindelige services til at oprette, opdatere og hente  lægemiddelordinationer. Dette suppleres med en service til apoteket. Dvs. der skal ikke anvendes separat funktionalitet når substitutionsordinationer skal oprettes eller opdateres. Ved opslag på FMK vil der kunne returneres lægemiddelordinationer med substitutionsordinationer, også til systemer, hvor dette måske ofte ikke anvendes. Det er derfor et krav, at alle systemer kan håndtere substitutionsordinationer og vise disse, så det er tydeligt for brugeren at der er tale om lægemidler, der kan substitueres men ikke skal tages samtidigt.
 Denne tekst har til formål at beskrive, hvordan FMK’s service anvendes til at oprette og vedligeholde substitutionsordinationer, og hvad der er vigtigt at være opmærksom på, når disse og tilhørende udleveringsgrundlag og udleveringer returneres fra FMK.
+==== Termer ====
+Med funktionaliteten beskrevet her introduceres der også en række nye termer.
+**Substitutionsordination** er to eller flere lægemiddelordinationer, hvor det er angivet på FMK at disse kan substitueres, og hvordan dette gøres.
+**Primær lægemiddelordination** er en (og kun en) lægemiddelordination, der indgår i en substitutionsordination, og er lægemidlet der oprindeligt eller fortrinsvis gives. Det forventes at Lægemiddelstyrelsen udarbejder retningslinjer herfor.
+**Substituerbar lægemiddelordination** en eller flere lægemiddelordinationer, som indgår i en substitutionsordination, men ikke er den primære lægemiddelordination.
+**Kombinationsordination** er to eller flere lægemiddelordinationer, som indgår i en substitutionsordination, ikke er den primære lægemiddelordination, men samlet udgør en substitutionsmulighed for den primære lægemiddelordination.
 ==== Substitutionsordinationer ====
@@ Line 146: / Line 162: @@
   * Alle lægemiddelordinationer i en substitionsordination skal findes i direkte relation til den primære lægemiddelordination. Det er ikke tilladt at oprette kæder af substituerbare lægemiddelordinationer.
-  * Desuden, også som en konsekvens af ovenstående, kan lægemiddelordinationer der indgår i en kombinationsordination ikke enkeltvis have sustitutionsmuligheder. Der kan i stedet oprettes to (eller flere) kombinationsordinationer, hvor et af lægemidlerne indgår i begge (alle).
+  * Desuden, også som en konsekvens af ovenstående, kan lægemiddelordinationer der indgår i en kombinationsordination ikke enkeltvis have substitutionsmuligheder. Der kan i stedet oprettes f.eks. to kombinationsordinationer, hvor et af lægemidlerne indgår i begge.
 Se også [[..:xml-elementer:lmo-relationer#kombinationsrelationer|dokumentation af XML-objekter for kombinationsrelationer]] :!: Link til den oprindelige model, og ikke modellen der beskrives her
@@ Line 152: / Line 168: @@
 ==== Visning af substitutionsmuligheder ====
-FMK’s services til at [[..:services:hent_medicinkort|hente medicinkortet]] og [[..:services:hent_laegemiddelordinationer|hente lægemiddelordinationer]] returnerer begge lægemiddelordinationer inklusiv eventuel information om substitutionsmuligheder.
+FMK’s services til at [[..:services:hent_medicinkort|hente medicinkortet]] og [[..:services:hent_laegemiddelordinationer|hente lægemiddelordinationer]] returnerer begge lægemiddelordinationer inklusiv eventuel information om substitutionsmuligheder. :!: Link beskriver den oprindelige model.
 For systemer som anvendes af ordinerende sundhedspersoner (læger mm), vil det oftest være den primære ordination i relationen som umiddelbart bør vises i oversigten. Det skal tydeligt fremgå at der er en eller flere substituerbare lægemidler på relaterede lægemiddelordinationer, f.eks. med ikonet herunder. Desuden skal det være muligt at se og ændre relaterede lægemiddelordinationer.
@@ Line 162: / Line 178: @@
 //Ikon for substitution//
-Ved opslag på medicinkortet på FMK vises følgende:
+Ved opslag på medicinkortet på FMK returneres et Substitutions-element for hver substitutionsordination der findes på medicinkortet, dvs. hvor der findes en aktiv substiuerbar lægemiddelordination. Substitutions-elementer returneres før lægemiddelordinationerne. F.eks. som herunder.
 <code>
 MedicineCard
+   ...
+   Substitutions
+      PrimarySubstitution
+         DrugMedicationIdentfier
+         Version
+      Substitution
+         DrugMedicationIdentfier
+         Version
    ...
    DrugMedication
       DrugMedicationIdentifier
+      Version
       ...
-      Relation
+   DrugMedication
-         Primary (optionelt)
+      DrugMedicationIdentifier
-         DrugMedicationIdentifier
+      Version
-         RelationType (Substitution eller Kombination)
+      ...
 </code>
-Elementet ''Primary'' returneres, hvis lægemiddelordinationen som relationen returneres i er den primære lægemiddelordination. Feltet er derfor optionelt i XML-skemaet.
+Ved opslag på en lægemiddelordination på FMK returneres, og hvor lægemiddelordinationen indgår i en aktiv substitutionsordination, returneres et Substitutions-element og alle lægemiddelordinationer, som indgår i substitutionsordinationen.
-Elementet ''DrugMedicationIdentifier'' kan forekomme én eller flere gange, og indeholder referencen til den eller de andre lægemiddeordinationer, som udgør substitutionsmuligheder.
-Elementet ''RelationType'' angiver enten “Substitution” for en substitutionsrelation eller “Kombination”, dvs. en kombinationsbehandling med to eller flere lægemidler. Findes der mere end ét DrugMedicationIdentifier er der altid tale om en kombinationsrelation.
-Ved opslag på en lægemiddelordination, der indgår i en substitutionsrelation, evt. som en kombinationsrelation, returneres alle lægemiddelordinationer der indgår i relationerne.
 ==== Oprettelse af substitutionsmuligheder ====
@@ Line 188: / Line 207: @@
 Ved oprettelse af substitutionsmuligheder, er det vigtigt at der ikke på FMK på noget tidspunkt kan fremgå, at begge (eller alle) substituerbare lægemiddelordinationer findes og kan tages samtidig. Dvs. at det er et krav at substituerbare lægemiddelordinationer og de tilhørende substitutionsrelationer oprettes på FMK i samme kald.
-Ved oprettelse anvendes FMK’s almindelige [[..:services:opret_laegemiddelordination|opret lægemiddelordination-service]]. Der anvendes samme struktur som ved opslag. Dog er har alle lægemiddelordinationerne der indgår endnu ikke id’er (DrugMedicationIdentifier), hvorfor der kan anvendes DrugMedicationReferenceNumber og ReferenceNumberForRelatedDrugMedication til at oprette relationerne. F.eks som herunder, hvor begge lægemiddelordinationer oprettes samtidigt. Findes den ene (primære) lægemiddelordination allerede på FMK anvendes dennes id.
+Ved oprettelse anvendes FMK’s almindelige [[..:services:opret_laegemiddelordination|opret lægemiddelordination-service]]. Der anvendes samme struktur som ved opslag. Dog er har alle lægemiddelordinationerne der indgår endnu ikke id’er (DrugMedicationIdentifier), hvorfor der kan anvendes DrugMedicationReferenceNumber og ReferenceNumberForRelatedDrugMedication til at oprette relationerne.
+Eksemplet herunder viser, et eksempel hvor den primære lægemiddelordination allerede findes på FMK, og der oprettes en substituerbar lægemiddelordination.
 <code>
 CreateDrugMedication
-   ...
+   Substitutions
-   DrugMedication
+      PrimarySubstitution
-      DrugMedicationReferenceNumber (i stedet for DrugMedicationIdentifier)
+         DrugMedicationIdentfier
-      ...
+         Version
-      Relation
+      Substitution
-         Primary (denne er den primære lægemiddelordination)
          ReferenceNumberForRelatedDrugMedication (reference til nedenstående)
-         RelationType  (i dette tilfælde Substitution)
    ...
    DrugMedication
       DrugMedicationReferenceNumber (i stedet for DrugMedicationIdentifier)
       ...
-      Relation
-         ReferenceNumberForRelatedDrugMedication (reference til ovenstående)
-         RelationType (i dette tilfælde Substitution)
 </code>
+For eksisterende lægemiddelordinationer skal DrugMedicationIdentfier og Version angives i kaldet. Version skal angives, for at sikre mod at den eksisterendelægemiddelordination opdateres umiddelbart inden kaldet foretages.
 ==== Opdatering og seponering ====
-Substitutions- og kombinationsrelationer oprettes på de lægemiddelordinationer der indgår, og relationerne vedligeholdes ved at opdatere disse lægemiddelordinationer.
+Substitutionsordinationer og kombinationsordination oprettes på versioner af lægemiddelordinationer, og skal vedligeholdes sammen med lægemiddelordinationerne. Der gælder en række regler:
-Seponeres en ikke-primær lægemiddelordinationer bortfalder substiutionsmuligheden derved.
+**Seponeres en substituerbar lægemiddelordination**, vil denne ikke længere indgå i en substitutionsordination som substitutionsmulighed for den primære lægemiddelordination. Den substituerbare lægemiddelordination kan [[..:services:seponer_laegemiddelordination|seponeres]] eller lægemiddelordinationen kan [[..:services:opdater_laegemiddelordination|opdateres]] med en ny slutdato. I seponer-kaldet kan der ikke angives noget Substitutions-element. Tilsvarende er der i opdater-kaldet ikke krav om at substutitionsordinationen opdateres eller ophæves.
-En primær lægemiddelordination kan derimod ikke seponeres, med mindre dette sker sammen med den eller de relaterede lægemiddelordinationer. Ønskes det, at behandlingen med en ikke-primær lægemiddelordination helt skal erstatte den primære, vil det være nødvendigt at gøre den anden substitutionsmulighed primær, eller at opdatere begge lægemiddelordinationer i samme kald.
+**Den primære lægemiddelordination i en substitutionsordination kan ikke seponeres**, forsøg herpå vil medføre en fejl.
+Ønskes det at en primær lægemiddelordination skal seponeres, og behandlingen med en substituerbar lægemiddelordination skal fortsætte, kan det gøres på de to følgende måder:
+**Skift mellem primær og substituerbar lægemiddelordination** gøres via et [[..:services:opdater_laegemiddelordination|opdater lægemiddelordination-kald]] med et Substitutions-element, hvor de to lægemiddelordinationer byttes rundt. Er der ikke behov for andre ændringer i lægemiddelordinationerne, er det ikke nødvendigt at angive disse. Der skal i så fald angives et  ModifiedBy-element.
+**Ophævelse af en substitutionsordination**, sådan at begge (eller alle) lægemiddelordinationer gives samtidigt, er en teknisk mulighed, men har klinisk risiko for at være en fejltagelse. Dette gøres via et [[..:services:opdater_laegemiddelordination|opdater lægemiddelordination-kald]] med to Substitutions-elementer, hvor begge lægemiddelordinationer angives som primære.
+**Kombinationsordinationer** kan ikke være primære.
+Ønskes det at en primær lægemiddelordination skal seponeres, og behandlingen med en kombinationsordination skal fortsætte, er der ingen sikker måde at gøre dette på, hvor der ikke et kort øjeblik vil fremgå at samtlige lægemiddelordinationer skal tages samtidigt. Det anbefales derfor at seponere alle lægemiddelordinationer i substitutionsordinationen, også de der indgår i kombinationsordinationen, og herefter anvende servicen [[..:services:afseponer_laegemiddelordination|Fortryd seponering af lægemiddelordination]] for de lægemiddelordinationer der skal fortsætte. Alternativt oprettes nye  lægemiddelordinationer.
+==== Oprettet af / ændret af og versionering ====
+Substitutionsordinationer versioneres ikke selvstændigt, men følger versionen af lægemiddelordinationer de oprettes på, teknisk som relationer til lægemiddelordinations-id og version. Oprettes eller ændres en substitutionsordination, opdateres versionsnummeret på de lægemiddelordinationer der indgår.
+Ved oprettelse eller opdatering af lægemiddelordinationer skal der angives et CreatedBy- og evt. et ReportedBy-element. Dette kan angives enten yderst i kaldet, fælles for de lægemiddelordinationer der oprettes eller opdateres, eller for hvert DrugMedication-element i kaldet, dvs. individuelt for hver lægemiddelordination.
+Er der angivet et CreatedBy- og evt. et ReportedBy-element yderst i kaldet, anvendes dette til i de lægemiddelordinationer hvor versionen opdateres som konsekvens af at de indgår i substitutionsordinationen.
+Er der //ikke// angivet et CreatedBy- og evt. et ReportedBy-element yderst i kaldet, og er alle lægemiddelordinationer som indgår i substitutionsordinationen ikke medsendt i kaldet, vil der mange information om hvem der opretter eller opdaterer, og kaldet vil derfor fejle.
-For kombinationsrelationer er der ikke tilsvarende krav, ud over hvad gælder idet de indgår i substitutionsrelationer. En lægemiddelordination som indgår i en kombinationsrelation kan seponeres, og den eller de øvrige kan fortsætte uændret.
 ==== Øvrige valideringer ====
@@ Line 222: / Line 261: @@
 :!: Bemærk at nedenstående valideringer ikke er besluttet endnu, og foreløbigt kun skal betragtes som et forslag. Desuden af listen af hvad der ikke valideres langt fra er endelig.
-Idet lægemidler på relaterede lægemiddelordinationer kan være analogt substituerbare, være generisk substituerbare men have forskellige styrker, eller relatere til en kombination af flere lægemidler, kan FMK kun have få valideringer ved oprettelse af relationer eller ved opdateringer af lægemiddelordinationer som indgår i en relation.
+Idet lægemidler i substitutionsordinationer kan være analogt substituerbare, være generisk substituerbare men have forskellige styrker, eller relatere til en kombination af flere lægemidler, kan FMK kun have få valideringer ved oprettelse af substitutionsordinationer, eller ved opdatering af lægemiddelordinationer som indgår substitutionsordinationer.
-**Indikation valideres** skal være ens på lægemidler som indgår i en substitutionsrelation. Det gælder også for kombinationsrelationen, idet indikationen angives for den samlede kombination.
+**Indikation valideres** skal være ens på lægemidler som indgår i en substitutionsordination. Det gælder også for kombinationsrelationen, idet indikationen angives for den samlede kombination.
-**Lægemiddelordinationernes gyldighedsperioder valideres**. Den primære lægemiddelordinations gyldighedsperiode skal være den længste, eller eventuelt kan gyldighedsperioder være ens. En kortere gyldighed på den ikke-primære lægemiddelordination kan anvendes til at lade substitutionsmuligheden bortfalde, når det vurderes at denne ikke længere er relevant. Se også seponering herunder.
+**Lægemiddelordinationernes gyldighedsperioder valideres**. Den primære lægemiddelordinations gyldighedsperiode skal være den længste, eller eventuelt kan gyldighedsperioder være ens. En kortere gyldighed på den substituerbare lægemiddelordinationer kan anvendes til at lade substitutionsmuligheden bortfalde, når det vurderes at denne ikke længere er relevant. Se også seponering herunder.
-** Doseringsperioder valideres **, sådan at doseringsperioder som findes i den det sammenfaldende gyldighedsperioder skal have samme periodelængde.
+**Doseringsperioder valideres**, sådan at doseringsperioder som findes i den det sammenfaldende gyldighedsperioder skal have samme periodelængde.
 **Pausering valideres** og skal generelt være ens for lægemiddelordinationer der indgår i relationer, se herunder.
@@ Line 243: / Line 282: @@
-==== Seponering og pausering ====
+==== Seponering, pausering og privatmarkering ====
-Seponering af den primære lægemiddelordination, uden også at seponere den eller de øvrige relationer, vil FMK betragte som en fejl og afvise. Er det reelt ønsket at den primære lægemiddelordination reelt skal seponeres og den ikke-primær lægemiddelordination skal fortsætte, skal dette f.eks. gøres ved at lægemiddelordinationerne opdateres så den tidligere ikke-primære gøres primær.
+Seponering af den primære lægemiddelordination, uden også at seponere den eller de øvrige lægemiddelordinaitoner i en substitutionsordination, vil FMK betragte som en fejl og afvise. Er det reelt ønsket at den primære lægemiddelordination skal seponeres og den eller de øvrige lægemiddelordinationer i substitutinsordinationen skal fortsætte, skal dette gøres som beskrevet under [[relationer_struktur#opdatering_og_seponering|Opdatering og seponering]].
-Pausering af relaterede lægemiddelordinationer kræver at relaterede lægemiddelordinationer pauseres samtidigt, både for substitutionsrelationer og kombinationsrelationer, og at pauseringen ophæves samtidigt. I servicekald til [[..:services:pauser_laegemiddelordination|pauser]] og [[..:services:genoptag_laegemiddelordination|ophæv pausering]] angives alle id på alle lægemiddelordinationer som indgår i relationerne.
-==== Erstat udleveringsgrundlag ====
+Pausering af relaterede lægemiddelordinationer kræver lægemiddelordinationer i en substitutionsordination pauseres samtidigt, og at pauseringen igen ophæves samtidigt. I servicekald til [[..:services:pauser_laegemiddelordination|Pauser lægemiddelordination]] og [[..:services:genoptag_laegemiddelordination|Ophæv pausering]] angives alle id på alle lægemiddelordinationer som indgår.
-Formålet med substitutionsrelationer er at give mulighed for substitution mellem lægemidler, f.eks. analog substitution, substitution til andre styrker og doseringer m.v. Hvis der udstedes et udleveringsgrundlag til én ordination i en substitutionsrelation, må apoteket udlevere lægemidlet fra den relaterede ordination i stedet.
+Tilsvarende gælder for privatmarkering:
+Privatmarkering af relaterede lægemiddelordinationer kræver kræver lægemiddelordinationer i en substitutionsordination privatmarkeres samtidigt, og at privatmarkeringen ophæves samtidigt. I servicekald til [[..:services:privatmarker_laegemiddelordination|Foretag privatmarkering af lægemiddelordination]] og [[..:services:ophaev_privatmarkering_af_laegemiddelordination|Ophæv privatmarkering af lægemiddelordination]] angives alle id på alle lægemiddelordinationer som indgår.
+==== Erstat udleveringsgrundlag ====
-Apoteket kan udlevere et substituerbart lægemiddel fra en lægemiddelordination der indgår i en substitutionsrelation. Findes der et udleveringsgrundlag af typen recept eller dosisrecept, oftest på den primære lægemiddelordination, og skal apoteket i stedet udlevere fra en anden lægemiddelordination via en substitutionsrelation, kan apoteket anvende [[..:services:erstat_udleveringsgrundlag|Erstat udleveringsgrundlag-servicen]]. Det  oprindelige udleveringsgrundlag markeres afsluttet eller ugyldigt, hvilket angives i kaldet. Af det nye grundlag vil det fremgå, at det erstatter det gamle. Skal der udleveres lægemidler med kombinationsrelationer i stedet, oprettes udleveringsgrundlag på begge.
+:!: Beskrivelse følger