Differences

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

--- fmk:1.6.0:xml-elementer:dispenseringskort [2025-10-29 15:09] – [Period og AdministrationOverview] lbdo
+++ fmk:1.6.0:xml-elementer:dispenseringskort [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Dispenseringskort i 1.6.0 ======
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DispensingCardType|Dispenseringskortet]] på 1.6.0 benyttes primært af apoteket og hjemmeplejen, når der skal arbejdes med en fysisk dispenserings af en patients medicin. Apoteket kan ligeledes foretage dosisdispensering til organisationer, ved at oprette et dispenseringskort til organisationer.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DispensingCardType|Dispenseringskortet]] på 1.6.0 benyttes primært af apoteket og hjemmeplejen, når der skal arbejdes med en fysisk dispensering af en patients medicin. Apoteket kan ligeledes foretage dosisdispensering til organisationer ved at oprette et dispenseringskort til organisationer.
-Dispenseringskortet kan også hentes af andre systemer som ønsker indsigt i de data som kortet indeholder. Dette kunne være læge-systemerne som ønsker en dybere indsigt i patientens dispenserede medicin.
+Dispenseringskortet kan også hentes af andre systemer, som ønsker indsigt i de data, som kortet indeholder. Det kunne f.eks. være lægesystemerne, som ønsker en dybere indsigt i patientens dispenserede medicin.
 ===== Indhold =====
@@ Line 20: / Line 20: @@
 ==== Ansvarlig organisation ====
-Et dispenseringskort skal altid have en ansvarlig organisation, det er muligt for en anden organisation at overtage et dispenseringskort, og dermed overtage ansvaret for dispenseringen af medicinen på kortet. Dette kan fx gøres ved overgang fra hjemmeplejens manuelle dispensering, til at apoteket pakker medicinen som dosisdispensering.
+Et dispenseringskort skal altid have en ansvarlig organisation. Det er muligt for en anden organisation at overtage et dispenseringskort, og dermed overtage ansvaret for dispenseringen af medicinen på kortet. Dette kan fx gøres ved overgang fra hjemmeplejens manuelle dispensering, til apotekets dosispakning af medicinen.
-Apoteket vil oftest benytte sig af pakkegrupper, hvor en eller flere dispenseringskort sættes i samme gruppe, og vil oftest blive behandlet og sendt til pakning omkring samme tid. På dispenseringskortet ses dette ved angivelsen af ''PackingGroupIdentifier'' og ''PackingGroupName'' ved kortets oprettelse. Hver pakkegruppe skal til enhver tid være tilknyttet både et udleverings- og pakke-apotek, så dette er også synligt når dispenseringskortet hentes som ''OrderedAtPharmacy'' og ''PackedAtOrganisation''.
+Apoteket vil oftest benytte sig af pakkegrupper, hvor en eller flere dispenseringskort sættes i samme gruppe og vil oftest blive behandlet og sendt til pakning omkring samme tid. På dispenseringskortet ses dette ved angivelsen af ''PackingGroupIdentifier'' og ''PackingGroupName'' ved kortets oprettelse. Hver pakkegruppe skal til enhver tid være tilknyttet både et udleverings- og pakkeapotek, så dette er også synligt, når dispenseringskortet hentes som ''OrderedAtPharmacy'' og ''PackedAtOrganisation''.
-Såfremt apoteket ikke har en pakkegruppe klar til det pågældende dispenseringskort, kan udleverings- og pakke-apotek i stedet angives direkte på dispenseringskortet. I så fald forekommer ''PackingGroupIdentifier'' og ''PackingGroupName'' ikke når kortet hentes fra FMK.
+Såfremt apoteket ikke har en pakkegruppe klar til det pågældende dispenseringskort, kan udleverings- og pakkeapotek i stedet angives direkte på dispenseringskortet. I så fald forekommer ''PackingGroupIdentifier'' og ''PackingGroupName'' ikke, når kortet hentes fra FMK.
-<code>
+<code xml>
 <PackingGroupIdentifier>43186145</PackingGroupIdentifier>
 <PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName>
 <OrderedAtPharmacy>
-	<Name>Haderslev Løve Apotek</Name>
+        <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
+        <Type>Apotek</Type>
+        <Name>Haderslev Løve Apotek</Name>
 	<AddressLine>Gravene 1</AddressLine>
 	<AddressLine>6100 Haderslev</AddressLine>
 	<TelephoneNumber>74522443</TelephoneNumber>
-	<Type>Apotek</Type>
-	<Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
 </OrderedAtPharmacy>
 <PackedAtOrganisation>
-	<Name>Humlebæk Apotek</Name>
+        <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
+        <Type>Apotek</Type>
+        <Name>Humlebæk Apotek</Name>
 	<AddressLine>Humlebæk Center 23</AddressLine>
 	<AddressLine>3050 Humlebæk</AddressLine>
 	<TelephoneNumber>49191979</TelephoneNumber>
-	<Type>Apotek</Type>
-	<Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
 </PackedAtOrganisation>
 </code>
 ==== Dispensing & Delivery-Notes ====
-Dispensing og Delivery-notes elementerne er indført som en erstatning til ''DoseDispensableUnitLabel'' fra 1.4.6 snitfladen. ''DoseDispensableUnitLabel'' var tiltænkt at Pakke-apoteket skulle skrive værdien fra dette felt øverst på poserne, men det virker aldrig til at dette blev en realitet. Derimod så viser vores undersøgelser at feltet ofte blev brugt som en hurtig "notes" til leveringer, såsom "Sendes med bud".
+Dispensing og Delivery-notes elementerne er indført som en erstatning til ''DoseDispensableUnitLabel'' fra 1.4.6 snitfladen. ''DoseDispensableUnitLabel'' var tiltænkt til brug på Pakkeapoteket, som skulle skrive værdien fra dette felt øverst på poserne. Undersøgelser viser dog, at feltet ofte er blevet anvendt som en hurtig "note" til leveringer, såsom "Sendes med bud".
-Derfor vælger FMK-teamet at indføre 2 nye værdier som kan benyttes til disse noter. ''DispensingNotes'' bør benyttes til noter til selve dispenseringen og tiltænkes primært hjemmeplejen (eksempel "Ophældes hver anden mandag"), men det bliver ikke begrænset hertil. ''DeliveryNotes'' er til noter omkring leveringen af den fysiske dispensering, denne er primært tiltænkt apoteket (Eksempel "Leveres med bud"), men vi forventer ikke at begrænse det.
+Derfor vælger FMK-teamet at indføre 2 nye værdier, som kan benyttes til disse noter. ''DispensingNotes'' bør benyttes til noter til selve dispenseringen og er primært tiltænkt hjemmeplejen (eksempel "Ophældes hver anden mandag"), men det bliver ikke begrænset hertil. ''DeliveryNotes'' er til noter omkring leveringen af den fysiske dispensering. Denne er primært tiltænkt apoteket (Eksempel "Leveres med bud"), men det forventes ikke, at det begrænses.
 ==== DispensingMachineIdentification ====
-Elementet indeholder ''Brand'' og ''Identifier'' begge er tekster uden specificeret længde. Er ønsket fra apotekssystemerne, til kommunikationen mellem udleverings og pakkeapotek.
+Elementet indeholder ''Brand'' og ''Identifier'', som begge er tekster uden specificeret længde. Det er et ønske fra apotekssystemerne til kommunikationen mellem udleverings- og pakkeapotek.
-Benyttes til at identificere den maskine som er udleveret til patienten, og som ved hjælpe af data uploaded fra pakkeapoteket omkring den dispenserede periode, kan foretage "udlevering" af de fysiske poser til patienten på de rigtige tidspunkter. FMK har intet med denne funktionalitet at gøre, ønsket har kun været at FMK kan gemme på informationerne omkring maskinen, således pakkeapoteket nemt kan finde dette når der skal videresendes data til firmaet bag maskinen.
+Det skal benyttes til at identificere den maskine, som er udleveret til patienten, og som ved hjælp af data uploaded fra pakkeapoteket omkring den dispenserede periode, kan foretage "udlevering" af de fysiske poser til patienten på de rigtige tidspunkter. FMK har intet med denne funktionalitet at gøre, ønsket har kun været, at FMK kan gemme på informationerne omkring maskinen, således pakkeapoteket nemt kan finde dette, når der skal videresendes data til firmaet bag maskinen.
-Det forventes ikke at dette element benyttes ved hjemmeplejen o.lign organisationers fysiske ophældning. FMK forventer dog ikke at blokere for at disse udfyldes, skulle det i fremtiden blive relevant.
+Det forventes ikke, at dette element benyttes ved hjemmeplejen o.lign organisationers fysiske ophældning. FMK forventer dog ikke at blokere for at disse udfyldes, hvis det i fremtiden skulle blive relevant.
 ==== Period og AdministrationOverview ====
-''Period'' elementet indeholder information omkring en given dispenseringsperiode, ''AdministrationOverview'' er alternativet hertil, og indeholder kun en liste med de planlagte administrationer som er tilknyttet dispenseringskortet.
+''Period'' elementet indeholder information omkring en given dispenseringsperiode, ''AdministrationOverview'' er alternativet hertil, og indeholder kun en liste med de planlagte administrationer, som er tilknyttet dispenseringskortet.
 === Period ===
@@ Line 75: / Line 75: @@
   * Optionelt ''ProductionIdentifier'' et element som indeholder stregkoden for perioden, forventes kun benyttet af apoteket.
   * Optionelt ''AcutePacking'' et element som markere at denne periode er blevet pakke akut, og grunden hertil.
-  * Optionelt: En række ''Dispensing''- eller en række ''PlannedAdministration''-elementer.
+  * Optionelt: En række ''Dispensing''- eller en række ''PlannedAdministrationEntry''-elementer.
-== Dispensing ==
+=== Dispensing ===
-Når en periode hentes, vil der enten forekomme en række ''Dispensing''- eller ''PlannedAdministration''-elementer. Dispenserings-elementerne forekommer såfremt perioden er i et stadie hvor dispenseringen enten er foretaget, eller igangsat. I realiten betyder dette at i alle statusser for perioden, udover "Planlagt", forekommer ''Dispensing'' og ikke ''PlannedAdministration''.
+Når en periode hentes, vil der enten forekomme en række ''Dispensing''- eller ''PlannedAdministration''-elementer. Dispenserings-elementerne forekommer, såfremt perioden er i et stadie, hvor dispenseringen enten er foretaget, eller igangsat. I realiteten betyder dette, at i alle statusser for perioden, udover "Planlagt", forekommer ''Dispensing'' og ikke ''PlannedAdministration''.
-Dispenseringer oprettes i FMK fra apoteket når perioden sættes "Klar til pakning", og ikke før, da hver dispenseringen anses som værende en "realisering" af den planlagte administration for en given periode. Og hver dispensering er derfor hårdt knyttet til den enkelte dispensering og den pågældende periode.
+Dispenseringer oprettes i FMK fra apoteket, når perioden sættes "Klar til pakning", og ikke før, da hver dispensering anses som værende en "realisering" af den planlagte administration for en given periode. Hver dispensering er derfor hårdt knyttet til den enkelte dispensering og den pågældende periode.
-For hjemmeplejen er realiteten en anden, fordi deres perioder ikke eksistere før dispenseringen registeres på FMK. Dette benytter at såfremt hjemmeplejen henter en periode frem som de selv har registeret, så vil de altid blive mødt med ''Dispensing'' elementer. Henter de derimod dispenseringskortet fra apoteket ind i eget system, skal de være forberedt på at kunne blive mødt med ''PlannedAdministration'' elementer.
+For hjemmeplejen er realiteten en anden, fordi deres perioder ikke eksisterer, før dispenseringen registreres på FMK. Dette bevirker, at såfremt hjemmeplejen henter en periode frem, som de selv har registeret, så vil de altid blive mødt med ''Dispensing'' elementer. Henter de derimod dispenseringskortet fra apoteket ind i eget system, skal de være forberedt på at kunne blive mødt med ''PlannedAdministration'' elementer.
-Når ''Dispensing'' elementerne hentes indeholder de følgende elementer:
+Når ''Dispensing'' elementerne hentes, indeholder de følgende elementer:
   * ''Identifier'', Unikt ID for den pågældende dispensering
   * ''Version'' Versionsnummeret for dispenseringen
@@ Line 92: / Line 92: @@
   * Optionelt: ''Substitution'' element, indholder den substitution som blev foretaget af Udleveringsapoteket eller hjemmeplejen da perioden blev henholdsvis sendt til pakkeapotek eller registeret som ophældt.
   * Optionelt: ''SubstitutionAtPacking'' Substitution som blev foretaget ved pakkeapoteket, ikke relevant for perioder registeret af hjemmeplejen.
+  * Optionelt: en række ''HandoverIdentifier'' elementer, forekommer hvis hjemmeplejen udpeger hvilken udlevering deres ophældning er taget fra.
   * ''PlannedAdministration''-element. Se **dedikeret afsnit**.
   * Optionelt: ''TotalDispensedQuantity''-element indeholdende et tal på mængden af lægemidlet som blev dispenseret i perioden. **Bemærk** Denne værdi kan mangle, dette forventes dog kun i fejlsituationer hvor mængden >= 1 mia. enheder.
+**Bemærk** ''HandoverIdentifier'' kan kun forekomme, hvis dispenseringen er foretaget af hjemmeplejen, hvorimod ''ShortName'', ''Description'', ''Substitution'' og ''SubstitutionAtPacking'' kun forekommer, hvis dispenseringen er sket som dosisdispensering ved apoteket.
+=== PlannedAdministrationEntry ===
+''PlannedAdministrationEntry'' indeholder [[#PlannedAdministration]] og optionelt også en [[#SubstitutionTemplate]]
 === PlannedAdministration ===
-Den [[fmk:1.6.0:xml-elementer:PlanlagtAdministration|planlagte administration]] for et givent lægemiddel. Dette element vil oftest være en specifik version af den planlagte administration, såfremt den findes som underelement til ''Dispensing''. Da der vil være tale om den version af den planlagte administration som var aktiv da dispenseringen blev registeret. Såfremt den planlagte administration ikke er underlagt en ''Dispensing''-element, vil der være tale om den seneste version af den planlagte administration.
+Den [[fmk:1.6.0:xml-elementer:PlanlagtAdministration|planlagte administration]] for et givent lægemiddel. Dette element vil oftest være en specifik version af den planlagte administration, såfremt den findes som underelement til ''Dispensing''. Da der vil være tale om den version af den planlagte administration, som var aktiv, da dispenseringen blev registeret. Såfremt den planlagte administration ikke er underlagt en ''Dispensing''-element, vil der være tale om den seneste version af den planlagte administration.
 Den planlagte administration indeholder følgende elementer:
@@ Line 110: / Line 116: @@
   * Optionelt: ''DispensingEndDate'', en beregnet slutdato for medicinen, ofte fundet ud fra CalculatedDosageEndDate eller TreatmentEndDate fra DrugMedication, eller EndDate fra ''PlannedAdministrationFixed'' eller ''PlannedAdministrationPRN''.
+=== SubstitutionTemplate ===
+Substitutions kladder har form som et [[fmk:1.6.0:xml-elementer:laegemiddel:generelt|lægemiddel]]. Der kan læses mere om denne funktionalitet [[fmk:1.6.0:services:registrer_substitutions_kladde#registrer_substitutions_kladde|her]]
 ====== XML Eksempel ======
@@ Line 136: / Line 144: @@
             <Role>Læge</Role>
             <Organisation>
+               <Identifier source="Yder">12345</Identifier>
+               <Type>kommune</Type>
                <Name>Lægerne Blikkersgade</Name>
                <AddressLine>Tusindfrydvej 17</AddressLine>
                <TelephoneNumber>99999999</TelephoneNumber>
                <EmailAddress>LMO@PLO.com</EmailAddress>
-               <Type>kommune</Type>
-               <Identifier source="Yder">12345</Identifier>
             </Organisation>
          </By>
@@ Line 164: / Line 172: @@
       <PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName>
       <OrderedAtPharmacy>
+         <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
+         <Type>Apotek</Type>
          <Name>Haderslev Løve Apotek</Name>
          <AddressLine>Gravene 1</AddressLine>
          <AddressLine>6100 Haderslev</AddressLine>
          <TelephoneNumber>74522443</TelephoneNumber>
-         <Type>Apotek</Type>
-         <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
       </OrderedAtPharmacy>
       <PackedAtOrganisation>
+         <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
+         <Type>Apotek</Type>
          <Name>Humlebæk Apotek</Name>
          <AddressLine>Humlebæk Center 23</AddressLine>
          <AddressLine>3050 Humlebæk</AddressLine>
          <TelephoneNumber>49191979</TelephoneNumber>
-         <Type>Apotek</Type>
-         <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
       </PackedAtOrganisation>
-      <DispensingNotes/>
-      <DeliveryNotes/>
       <Period>
          <Identifier>79816138</Identifier>
@@ Line 247: / Line 253: @@
                      </Form>
                      <Strength>
-                        <Value>500</Value>
+                        <StrengthItem>
-                        <UnitCode date="2025-5-19" source="Medicinpriser">MG</UnitCode>
+                            <Value>500</Value>
-                        <UnitText>500 mg</UnitText>
+                            <UnitCode date="2025-5-19" source="Medicinpriser">MG</UnitCode>
+                            <UnitText>500 mg</UnitText>
+                        </StrengthItem>
                      </Strength>
                   </Drug>