====== 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 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. Det kunne f.eks. være lægesystemerne, som ønsker en dybere indsigt i patientens dispenserede medicin.

===== Indhold =====

Når et dispenseringskort hentes med [[fmk:1.6.0:services:hent_dispenseringskort|hent dispenseringskort]] indeholder det følgende elementer:
  * ''Identifier'' et unikt ID for det pågældende kort
  * ''Version'' dispenseringskortets version
  * ''Description'' et beskrivelse af kortet, angives ved oprettelse/opdatering af kortet
  * Optionelt ''IsInvalid'' en markering af at patientens **Medicinkort** er markeret ugyldig
  * Optionelt ''IsClosed'' en markering af at dette dispenseringskort er nedlagt
  * Optionelt ''Delivery'' en beskrivelse af hvordan dispenseringerne fra kortet forventes leveret til patienten.
  * En ansvarlig organisation. Se senere kapitel
  * Optionelt ''DispensingNotes'' en kort tekst omkring dispenseringen af kortet
  * Optionelt ''DeliveryNotes'' en kort tekst omkring leveringen af dispenseringer fra kortet.
  * Optionelt ''DispensingMachineIdentification'' element, forventes anvendt til dosisdispensering, mere i dedikeret afsnit
  * En eller flere ''Period'' elementer, alternativt et ''AdministrationOverview'' element.

==== 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 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 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 pakkeapotek i stedet angives direkte på dispenseringskortet. I så fald forekommer ''PackingGroupIdentifier'' og ''PackingGroupName'' ikke, når kortet hentes fra FMK.

<code xml>
<PackingGroupIdentifier>43186145</PackingGroupIdentifier>
<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>
</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>
</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 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 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'', som begge er tekster uden specificeret længde. Det er et ønske fra apotekssystemerne til kommunikationen mellem udleverings- og pakkeapotek.

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, 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 ===
Period elementet kan indeholde følgende elementer:
  * ''Identifier'', unikt ID for perioden
  * ''Version'', versionsnummer for perioden
  * ''Status'', Status for perioden, fx Ekspederet
  * ''StartDate'', Startdato for hvornår perioden påbegyndes
  * ''EndDate'', Slutdato for hvornår period afsluttes
  * Optionelt ''PackagedDateTime'' Et Timestamp på hvornår perioden er blevet pakket.
  * Optionelt ''EffectuationDateTime'' Et Timestamp på hvornår perioden blev effektueret.
  * Optionelt ''ExpectedDelivery'' Et Timestamp på hvornår perioden forventes leveret til patienten
  * Optionelt ''Discarded'' Et element som indholder et ''Reason'' og en Timestamp på hvorfor/hvornår en periode skal kasseres.
  * 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 ''PlannedAdministrationEntry''-elementer.

=== 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 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 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 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:
  * ''Identifier'', Unikt ID for den pågældende dispensering
  * ''Version'' Versionsnummeret for dispenseringen
  * Optionelt: ''ShortName'' kort navn for lægemidlet.
  * Optionelt: ''Description'' kort beskrivelse af lægemidlet
  * Optionelt: en række ''Warning'' element, advarsler omkring dispensering, fx omhandlende substitutionen.
  * 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 planlagte administration indeholder følgende elementer:
  * ''Identifier'', unikt ID for den planlagte administration
  * ''Version'', versionnummer for den planlagte administration.
  * ''DrugMedication'', Lægemiddelordinationen som den planlagte administration er tilknyttet. **Bemærk der kan være tale om en historisk version**
  * Optionelt: ''ValidWarrent''-element, som udpeger et udleveringsgrundlag som en dispensering kan foretages med. Det forventes kun dette element er nødvendigt for dosisdispensering ved apoteket.
  * Optionelt: En række ''Warning''-elementer, advarsler omkring den planlagte administration, fx forskel i administration og doseringen.
  * Optionelt: ''DosageUnit''-element, beskriver den doseringsenhed som dispenseringen forventes foretaget i.
  * Optionelt: ''AdministrationInstruction''-element, beskriver hvordan administration bør indtages.
  * Optionelt: ''PlannedAdministrationFixed''-element, beskriver den forventede administration af den faste del af medicinen. Er often magen til eller en mere specificeret udgave af lægemiddelordinationens dosering.
  * Optionelt: ''PlannedAdministrationPRN''-element, beskriver den forventede administration af PN-delen af medicinen. Ofte ikke benyttet.
  * 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 ======


<file xml DispensingCardExample.xml>
<GetDispensingCardResponse>
   <Patient>
      <Person>
         <Name>
            <GivenName>Hans</GivenName>
            <Surname>Jensen</Surname>
         </Name>
         <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
         <Gender>male</Gender>
      </Person>
   </Patient>
   <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime>
   <PatientRegistration>
      <Identifier>1538864468</Identifier>
      <Created>
         <By>
            <HealthcareProfessional>
               <Indentifier source="Autorisation">8AH23</Indentifier>
               <Name>Niels Madsen</Name>
            </HealthcareProfessional>
            <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>
            </Organisation>
         </By>
         <DateTime>2025-03-017T09:38:12Z</DateTime>
      </Created>
      <Type>SetDoseDispensingOnHold</Type>
      <ValidityPeriod>
         <From>2025-03-017T09:38:12Z</From>
         <To>2025-05-017T12:00:00Z</To>
      </ValidityPeriod>
      <Reason>Patienten er indlagt</Reason>
   </PatientRegistration>
   <DispensingCard>
      <Identifier>386168168</Identifier>
      <Description>Et lille dispenseringskort</Description>
      <Delivery>
         <DeliveryPriority>send til anden adresse samme dag</DeliveryPriority>
         <AddressLine>Jernbrogade 5</AddressLine>
         <AddressLine>8382 Hinnerup</AddressLine>
      </Delivery>
      <PackingGroupIdentifier>43186145</PackingGroupIdentifier>
      <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>
      </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>
      </PackedAtOrganisation>
      <Period>
         <Identifier>79816138</Identifier>
         <Status>Pakning afsluttet</Status>
         <StartDate>2025-04-29</StartDate>
         <EndDate>2025-05-12</EndDate>
         <PackagedDateTime>2025-04-24T17:01:09Z</PackagedDateTime>
         <Dispensing>
            <Identifier>988413138</Identifier>
            <Version>787848468</Version>
            <ShortName>Panodil</ShortName>
            <Description>Hvid med lige kærv</Description>
            <Warning>...</Warning>
            <Warning>...</Warning>
            <Substitution>
               <SubstitutionChosenByPatient/>
               <Drug>
                  <Identifier source="Medicinpriser" sourceDate="2025-04-09">
                     28101317587
                  </Identifier>
                  <Name>Pamol</Name>...</Drug>
            </Substitution>
            <SubstitutionAtPacking>
               <Drug>
                  <Identifier source="Medicinpriser" sourceDate="2025-04-09">
                     28100636073
                  </Identifier>
                  <Name>Panodil</Name>...</Drug>
            </SubstitutionAtPacking>
            <PlannedAdministration>
               <Identifier>891353188</Identifier>
               <Version>8978641385</Version>
               <DrugMedication>
                  <Identifier>18198135989486</Identifier>
                  <Version>151831135318381</Version>
                  <Created>
                     <By>...</By>
                     <DateTime>...</DateTime>
                  </Created>
                  <Modified>...</Modified>
                  <Type>Lægeordineret</Type>
                  <BeginEndDates>
                     <TreatmentStartDate>2023-05-24</TreatmentStartDate>
                     <TreatmentEndingUndetermined/>
                  </BeginEndDates>
                  <Indication>
                     <Code>145</Code>
                     <Text>mod smerter</Text>
                  </Indication>
                  <RouteOfAdministration>
                     <Code>OR</Code>
                     <Text>Oral anvendelse</Text>
                  </RouteOfAdministration>
                  <Drug>
                     <Identifier source="Medicinpriser" date="2025-5-19">
                        28103888005
                     </Identifier>
                     <Name>Pinex</Name>
                     <ATC>
                        <Code source="Medicinpriser" date="2025-5-19">N02BE01</Code>
                        <Text>Paracetamol</Text>
                     </ATC>
                     <Form>
                        <Code source="Medicinpriser" date="2025-5-19">TABFILM</Code>
                        <Text>filmovertrukne tabletter</Text>
                     </Form>
                     <Strength>
                        <StrengthItem>
                            <Value>500</Value>
                            <UnitCode date="2025-5-19" source="Medicinpriser">MG</UnitCode>
                            <UnitText>500 mg</UnitText>
                        </StrengthItem>
                     </Strength>
                  </Drug>
                  <Dosage>
                     ...
                  </Dosage>
                  <SubstitutionAllowed>true</SubstitutionAllowed>
                  <Effectuation>
                     ...
                  </Effectuation>
                  <Warrant>
                     ...
                  </Warrant>
               </DrugMedication>
               <ValidWarrent>
                  <Identifer>135153834689</Identifer>
                  <ValidFromDate>2024-01-01</ValidFromDate>
                  <ValidToDate>2026-01-01</ValidToDate>
               </ValidWarrent>
               <Warning>...</Warning>
               <DosageUnit>
                  <DosageUnitText>stk</DosageUnitText>
               </DosageUnit>
               <AdministrationInstruction>Synkes hele</AdministrationInstruction>
               <PlannedAdministrationFixed>
                  <PlannedAdministrationStructure>
                     <IterationInterval>1</IterationInterval>
                     <StartDate>2024-05-01</StartDate>
                     <Day>
                        <Number>1</Number>
                        <Dose>
                           <Time>morning</Time>
                           <SequenceNumber>699999</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                           <Time>evening</Time>
                           <SequenceNumber>1899999</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                     </Day>
                  </PlannedAdministrationStructure>
               </PlannedAdministrationFixed>
            </PlannedAdministration>
            <TotalDispensedQuantity>24</TotalDispensedQuantity>
         </Dispensing>
         <Dispensing>...</Dispensing>
         <Dispensing>...</Dispensing>
      </Period>
   </DispensingCard>
</GetDispensingCardResponse>
</file>