====== Udlevering ======

I 1.6.0 er modellen for udleveringer blevet ændret væsentligt fra tidligere snitfladeversioner. Mere præcist dækker begrebet "udlevering" nu over både "[[fmk:1.4.6:effektuering|effektuering på recept]]" og "[[fmk:1.4.4:Opret effektuering|effektuering på lægemiddelordination]]" fra 1.4.x-snitfladen. I korte træk repræsenterer en udlevering, at patienten har sin medicin til rådighed.

Udleveringen er altid knyttet til et udleveringsgrundlag og kan være knyttet til en bestilling. Hvis der er tale om en apoteksudlevering, vil udleveringsgrundlaget typisk være enten en recept, en praksisrecept eller dosisrecept. Apoteket kan oprette en bestilling på udleveringsgrundlaget og oprette en udlevering knyttet til denne -- denne funktionalitet er uændret fra 1.4.6, blot med ny terminologi. Se evt. [[fmk:1.6.0:xml-elementer:bestilling|Bestilling]]. 

Medicin, der udleveres i forbindelse med behandling, registreres som en udlevering tilknyttet et udleveringsgrundlag af typen ‘Direkte udlevering i forbindelse med behandling’. Dette foregår via servicen [[fmk:1.6.0:services:Registrer udlevering]], som erstatter servicen [[fmk:1.4.4:Opret effektuering|Opret effektuering (1.4.4)]] på 1.4.x-snitfladen. 

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#HandoverType| skemadefinition på udlevering]]

==== UdleveringsID  (Identifier) ====

Udleveringselementet indeholder først et Identifier-element for udleveringen.

==== ID for bestilling ( OrderIdentifier) ====

En udlevering er typisk tilknyttet en bestilling, hvis der er tale om en apoteksudlevering. Handoverelementet indeholder derfor optionelt en OrderIdentifier.

==== Udleveringstidspunkt (DateTime) ====

DateTime-elementet indeholder tidspunktet for udleveringens oprettelse. Dette angives typisk når udleveringen registreres på FMK.

==== Oprettet af (Created) ====

Createdelementet indeholder information omkring aktøren, der har oprettet udleveringen. Dette element er obligatorisk. 
Se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. 


"Oprettet af" vil blive registreret ved oprettelse af udleveringen, og information omkring "oprettet af" person, organisation og tidspunkt vil blive returneret på samtlige efterfølgende versioner af effektueringen. 

==== Indrapporteret af (ReportedBy) ====

Elementet ReportedBy indeholder information omkring personen, der har indrapporteret versionen af udleveringen til FMK, dvs. "certifikatejer". 

==== Udlevering af en eller flere pakninger (Package) ====

Ved udlevering af en eller flere pakninger optræder et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#PackageHandoverType|Package]]  element. I Package angives der først antal pakninger i PackageQuantity. 

I PackageNumber angives pakningens varenummer. Ved angivelse af varenummer skal der i source-attributten angives, hvad kilden til varenummer er, se [[fmk:generel:varenumre|Varenumre]]:

  * Ved oprettelse af udleveringer af lægemidler i intervallet for Medicinpriser (dvs. for lægemidler i taksten) angives begge attributter source = "Medicinpriser" og date = dato for den aktuelle takst der refereres til. 
  * Ved oprettelse af udleveringer af frihandelsvarer angives source = "Frihandelsvare". Attributten date er her ikke krævet. 

Pakningsstørrelsen angives i PackageSize. Der angives en pakningsstørrelse som en numerisk værdi (Value), kode for enhed (UnitCode) og tekst for enhed (UnitText). For UnitCode angives source = "Medicinpriser" og date = dato for den aktuelle takst, der refereres til. 

Sidst kan der i ''BatchNumber''-elementet angives batchnummer for den udleverede pakning.


=== Angivelse af lægemiddel ved substitution (SubstitutedDrug) ===

Ved udlevering af pakninger kan der være substitueret til et andet lægemiddel end angivet af lægen. 
Dette fremgår, hvis der er tale om et takstlægemiddel, implicit via det varenummer, der er angivet, og det er derfor ikke tilladt at angive 'SubstitutedDrug'. Men hvis varenummeret ikke er fra "Medicinpriser", kan lægemidlet ikke nødvendigvist udledes derfra. 
I dette tilfælde angives det substituerede lægemiddel som et SubstitutedDrug element, se afsnittet [[fmk:1.6.0:xml-elementer:laegemiddel|Lægemiddel]].

==== Udlevering af enkelte enheder (SingleUnits) ====

Hvis udleveringen ikke består af pakninger, men blot en række løse enheder, kan der i stedet for ''Package'' angives et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#SingleUnitsHandoverType|SingleUnits]]-element .

Her angives medicinmængden i et ''DoseQuantity''-element. Enheden for dosismængden (for eksempel 'mg', 'stk', etc.) angives i et ''DosageQuantityUnitText''-element.

Ligesom i ''Package''-elementet, kan der angives et ''SubstitutedDrug''-element, hvis der er blevet substitueret til et andet lægemiddel.

==== Sekundær udlevering (UsesSecondaryHandover) ====

Hvis borgeren ikke får udleveret al medicin på én gang, men i stedet får udleveret i mindre portioner, kan disse mindre udleveringer registreres på FMK som //sekundære udleveringer//. 

Hvis udleveringen foregår via sekundær udlevering, er flaget ''UsesSecondaryHandover'' sat på udleveringselementet. Herefter kan en række ''SecondaryHandover''-elementer forekomme med informationer om de enkelte sekundære udleveringer. Se [[fmk:1.6.0:xml-elementer:sekundær udlevering|Sekundær udlevering]] for yderligere detaljer.

==== Kommentar fra den udleverende organisation (HandoverComment) ====

Kan udfyldes, hvis den udleverende organisation har en kommentar til udleveringen.

==== Printet tekst (LabelText) ====

Optionelt element, som indeholder den tekst, der er printet på pakningen.

==== Ansvarlig organisation (ResponsibleOrganisation) ====

Et optionelt element af typen [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#OrganisationType| OrganisationType]], som beskriver den udleverende organisation. Det kan f.eks. angives, hvis den udleverende organisation er anden apoteksfilial end den, som er angivet på [[fmk:1.6.0:xml-elementer:bestilling|bestillingen]].

===== Eksempler =====

== Eksempel 1 ==

Nedenstående er et eksempel på en apoteksudlevering af 2 pakker af et substitueret lægemiddel. Da der er tale om en apoteksudlevering, er der angivet en ''OrderIdentifier''. Der er blevet udleveret med henblik på sekundær udlevering, deraf flaget ''UsesSecondaryHandover''. 

<code xml "Handover-pharmacy.xml">

<Handover>
    <Identifier>324123074823974</Identifier>
    <OrderIdentifier>132423478342</OrderIdentifier>
    <DateTime>2025-04-22T11:16:56Z
    <Created>
        <By>
            <HealthcareProfessional>
                <Indentifier source="CPR">2012850101</Indentifier>
                <Name>Hanne Jensen</Name>
            </HealthcareProfessional>
            <Role>Apoteksansat</Role>
            <Organisation>
                <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                <Type>Apotek</Type>
                <Name>Aarhus Kobbergade Apotek</Name>
                <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
                <TelephoneNumber>00000000</TelephoneNumber>
                <EmailAddress>ABC@XYZ.com</EmailAddress>
            </Organisation>
        </By>
        <DateTime>2025-04-24T17:01:09Z</DateTime>
    </Created>
    <Package>
        <PackageQuantity>2</PackageQuantity>
        <PackageNumber source="Medicinpriser" date="2025-03-10">789</PackageNumber>
        <PackageSize>
            <Value>40</Value>
            <UnitCode source="Medicinpriser" date="2025-03-10">stk</UnitCode>
            <UnitText>stk</UnitText>
        </PackageSize>
        <SubstitutedDrug>
            <Identifier source="Medicinpriser" date="2025-03-10">28101234504</Identifier>
            <Name>Eksemplificin</Name>
            <Form>
                <Code source="Medicinpriser" date="2025-03-10">TAB</Code>
                <Text>tabletter</Text>
            </Form>
            <Strength>
                <StrengthItem>
                    <Value>50</Value>
                   <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode>
                   <UnitText>mg</UnitText>
                </StrengthItem>
            </Strength>
        </SubstitutedDrug>
        <BatchNumber>3423W</BatchNumber>
     </Package>
     <UsesSecondaryHandover/>
     <SecondaryHandover>
         <Identifier>2131230918231</Identifier>
         <DateTime>2025-04-25T10:36:27Z</DateTime>
         <Created>
             <By>
                 <HealthcareProfessional>
                     <Indentifier source="CPR">1208911078</Indentifier>
                     <Name>Mikkel Smed Hansen</Name>
                 </HealthcareProfessional>
                 <Role>Kommunal ansat til medicinhåndtering</Role>
                 <Organisation>
                     <Identifier source="SOR">987654321</Identifier>
                     <Type>kommune</Type>
                     <Name>Nordfyns Kommune</Name>
                     <AddressLine>Østergade 23, 5400 Bogense</AddressLine>
                     <TelephoneNumber>99999999</TelephoneNumber>
                     <EmailAddress>XYZ@ABC.com</EmailAddress>
                 </Organisation>
             </By>
             <DateTime>2025-04-25T10:45:27Z</DateTime>
         </Created>
         <SingleUnits>
             <DoseQuantity>5</DoseQuantity>
             <DosageQuantityUnitText>stk</DosageQuantityUnitText>
         </SingleUnits>
     </SecondaryHandover> 
     <HandoverComment>Substitueret grundet restordre</HandoverComment>
     <ResponsibleOrganisation>
         <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
         <Type>Apotek</Type>
         <Name>Aarhus Kobbergade Apotek</Name>
         <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
         <TelephoneNumber>00000000</TelephoneNumber>
         <EmailAddress>ABC@XYZ.com</EmailAddress>
     </ResponsibleOrganisation
</Handover>

</code>

== Eksempel 2 ==

Hvis der er blevet udleveret medicin ved behandling, kan udleveringen se ud som nedenfor.


<code xml "Handover-treatment.xml">

<Handover>
    <Identifier>324123074823974</Identifier>
    <DateTime>2025-04-22T11:16:56Z
    <Created>
        <By>
            <HealthcareProfessional>
                <Identifier source="Autorisation">2Q5TK</Identifier>
                <Name>Tess Christoffersen</Name>
                <Information type="SpecialityCode">7170</Information>
            </HealthcareProfessional>
            <Role>Læge</Role>
            <Organisation>
                <Identifier source="Yder">66974</Identifier>
                <Type>Yder</Type>
                <Name>Lægerne Vestergade</Name>
                <AddressLine>Vestergade 2</AddressLine>
                <AddressLine>8660 Skanderborg</AddressLine>
                <TelephoneNumber>86521348</TelephoneNumber>
                <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
            </Organisation>
        </By>
        <DateTime>2026-08-02T09:58:05Z</DateTime>
    </Created>
    <SingleUnits>
        <DoseQuantity>12</DoseQuantity>
        <DosageQuantityUnitText>stk</DosageQuantityUnitText>
    </SingleUnits>
    <HandoverComment>Udleveret til patienten</HandoverComment>
</Handover>

</code>