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

Indhold

Når et dispenseringskort hentes med 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 at apoteket pakker medicinen som dosisdispensering.

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.

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.

<PackingGroupIdentifier>43186145</PackingGroupIdentifier>
<PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName>
<OrderedAtPharmacy>
	<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>
	<AddressLine>Humlebæk Center 23</AddressLine>
	<AddressLine>3050 Humlebæk</AddressLine>
	<TelephoneNumber>49191979</TelephoneNumber>
	<Type>Apotek</Type>
	<Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
</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 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”.

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.

DispensingMachineIdentification

Elementet indeholder Brand og Identifier begge er tekster uden specificeret længde. Er ønsket 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 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.

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 PlannedAdministration-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 realiten 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.

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.

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

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:

Identifier unikt ID for den planlagte administration
Version version-nummer 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.

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>
               <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>
         <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>
         <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>
         <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>
         <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>
                        <Value>500</Value>
                        <UnitCode date="2025-5-19" source="Medicinpriser">MG</UnitCode>
                        <UnitText>500 mg</UnitText>
                     </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>

Fælles Medicinkort - Dokumentation

Table of Contents