Table of Contents

Dispenseringskort i 1.6.0

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 hent dispenseringskort indeholder det følgende elementer:

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.

<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>

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:

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:

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 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:

SubstitutionTemplate

Substitutions kladder har form som et lægemiddel. Der kan læses mere om denne funktionalitet her

XML Eksempel

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>