====== Anmodning om udleveringsgrundlag ======

En anmodning om udleveringsgrundlag kan oprettes på en lægemiddelordination og er en indikation til lægen om, at der ønskes oprettet et nyt udleveringsgrundlag på lægemiddelordinationen.

Anmodninger om udleveringsgrundlag blev i 1.4.x kaldt for [[fmk:bestil_udlevering:1.4.4:recept-_og_udleveringsanmodning_1.4.4_snitflade|receptanmodninger]].

Service-beskrivelse af oprettelse af anmodninger kan findes [[fmk:1.6.0:services:Opret anmodning om udleveringsgrundlag | her]]. 

Skemadefinition for anmodninger om udleveringsgrundlag kan findes [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#requestforwarranttype|her]]

==== Anmodning om udleveringsgrundlag ID og version ====

Anmodninger er defineret i ''RequestForWarrant''-elementet. Dette indeholder en ''Identifier'', der entydigt identificerer an samt et versionsnummer. Disse dannes og returneres ved oprettelse. Versionsnummeret opdateres desuden ved alle statusændringer på annmodninger.

==== Lægemiddelordinations-ID  ====

Ved oprettelse af en anmodning angives altid ''DrugMedicationIdentifier'' på den pågældende lægemiddelordination.

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

''Created''-elementet indeholder information omkring aktøren, der har oprettet anmodningen. Dette element er obligatorisk. Se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. 
''Created/DateTime''-elementet indeholder tidspunktet for anmodningens oprettelse i FMK.

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

Elementet ReportedBy indeholder information omkring personen, der har indrapporteret anmodningen til FMK, dvs. “certifikatejer”.

==== Modtager(e) af anmodning ====

Ved oprettelse af en anmodning om udlveringsgrundlag angives ét til flere ''IssuerOrganisation''-elementer. Disse indeholder data om den eller de organisationer, som anmodningen sendes til.

==== Typer af udleveringsgrundlag ====

Det er muligt ved oprettelse af en anmodning at angive en type af udleveringsgrundlag, som der ønskes oprettet. Anmodningen kan indeholde et ''Prescription''-element, et ''HospitalPharmacyHandover''-element eller et ''DoseDispensed''-element.

Se [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#typer_af_udleveringsgrundlag | typer af udleveringsgrundlag]] for yderligere beskrivelse af disse elementer.

==== Bestilling på udleveringsgrundlag (Order eller WithoutOrder) ====

En anmodning om udleveringsgrundlag kan indeholde et ''Order''-element med information om en tilhørende bestilling. Dette element indikerer, at der ønskes oprettet en bestilling sammen med oprettelsen af udleveringsgrundlaget.

Alternativt kan anmodningen indeholde et ''WithoutOrder'' -flag, som indikerer at der ikke ønskes oprettet en bestilling.


==== Status ====

Elementet ''Status'' beriges fra FMK og indikerer anmodningens tilstand. Denne vil være enten "unhandled","prescribed" eller "cancelled". 

Ved oprettelse får anmodningen status "unhandled". Hvis anmodningen godkendes af lægen og resulterer i oprettelse af et udleveringsgrundlag, skifter anmodningen status til "prescribed". Hvis anmodningen alternativt annulleres (enten af borgeren selv eller af modtageren af anmodningen), får den status "cancelled".

==== Optionelt: ID på udleveringsgrundlag (WarrantIdentifier) ====

Hvis anmodningen er blevet færdigbehandlet og et udleveringsgrundlag er blevet oprettet, vil udleveringsgrundlagets ID stå i ''WarrantIdentifier''-elementet på anmodningen.

==== Annulleringsårsag og modifikator (CancellationReason + CancelledBy) ====

Hvis en anmodning er blevet annulleret, vil den indeholde en ''CancellationReason'' samt en ''CancelledBy''-modifikator. Annullering kan både foretages af borgeren, som oprettede anmodningen, samt af modtagerorganisationerne og deres brugere.

Se evt. service-beskrivelse af [[fmk:1.6.0:services:Annuller anmodning om udleveringsgrundlag]].

===== Eksempler =====

Eksempel 1: En ubehandlet anmodning om udleveringsgrundlag. Der anmodes om et udleveringsgrundlag af typen DD-recept med en tilhørende bestilling.

<file xml RequestForWarrant-unhandled.xml>
<RequestForWarrant>
    <Identifier>2313581031</Identifier>
    <Version>3251358135138138</Version>
    <DrugMedicationIdentifier>1231831313</DrugMedicationIdentifier>
    <Created>
        <By>
            <Person>
                <Patient/>
            </Person>
            <Role>Borger</Role>
        </By>
        <DateTime>2013-10-01T00:00:00Z</DateTime>
    </Created>
    <IssuerOrganisation>
        <Organisation>
            <Identifier source="Yder">123456</Identifier>
            <Type>Yder</Type>
            <Name>Allé lægerne</Name>
            <AddressLine>...</AddressLine>
            <TelephoneNumber>...</TelephoneNumber>
            <EmailAddress>...</EmailAddress>
        </Organisation>
    </IssuerOrganisation>
    <DoseDispensed/>
    <Order>
        <OrderedAtPharmacy>
            <Organisation>
                <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                <Type>Apotek</Type>
                <Name>Kolind Apotek</Name>
                <AddressLine>...</AddressLine>
                <TelephoneNumber>...</TelephoneNumber>
                <EmailAddress>...</EmailAddress>
           </Organisation>
        </OrderedAtPharmacy>     
    </Order>
    <Status>unhandled</Status>
</RequestForWarrant>
</file>


Eksempel 2: En behandlet anmodning om udleveringsgrundlag. Der anmodes om et udleveringsgrundlag af typen recept med ingen tilhørende bestilling.

<file xml RequestForWarrant-unhandled.xml>
<RequestForWarrant>
    <Identifier>2313581031</Identifier>
    <Version>3251358135138138</Version>
    <DrugMedicationIdentifier>1231831313</DrugMedicationIdentifier>
    <Created>
        <By>
            <Person>
                <Patient/>
            </Person>
            <Role>Borger</Role>
        </By>
        <DateTime>2013-10-01T00:00:00Z</DateTime>
    </Created>
    <Modified>
        <By>                
            <HealthcareProfessional>
                <Identifier source="Autorisation">12345</Identifier>
                <Name>Karl Karlsen</Name>
                <Information type="SpecialityCode">7170</Information>
            </HealthcareProfessional>
            <Role>Læge</Role>
        </By>
        <DateTime>2025-11-19T09:30:47.0Z</DateTime>
    </Modified>
    <IssuerOrganisation>
        <Organisation>
            <Identifier source="Yder">123456</Identifier>
            <Type>Yder</Type>
            <Name>Allé lægerne</Name>
            <AddressLine>...</AddressLine>
            <TelephoneNumber>...</TelephoneNumber>
            <EmailAddress>...</EmailAddress>
        </Organisation>
    </IssuerOrganisation>
    <Prescription>
        <PackageNumber source="Medicinpriser">409632</PackageNumber>
        <PackageSize>
            <Value>100</Value>
            <UnitCode source=""Medicinpriser"">ST</UnitCode>
            <UnitText>stk</UnitText>
            <PackageSizeText>100 stk</PackageSizeText>
        </PackageSize>
        <PackageQuantity>1</PackageQuantity>
        <IterationNumber>10</IterationNumber>
        <IterationInterval>2</IterationInterval>
        <IterationIntervalUnit>uger</IterationIntervalUnit>
    </Prescription>
    <WithoutOrder/>
    <Status>prescribed</Status>
    <WarrantIdentifier>77821203123123</WarrantIdentifier>
</RequestForWarrant>
</file>