====== 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. Det vil typisk være den eller de lægehuse eller hospitaler, der forventes at kunne tage stilling til, om der bør udleveres mere af medicinen.

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

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

Hvis en anmodning er blevet annulleret/afvist, 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.

Afvisningsårsager er defineret som en udvidbar liste i skemaet med følgende værdier:

  * Behandlingen er afsluttet
  * Receptfornyelsen kræver konsultation
  * Kontakt egen læge hvis recept ønskes
  * Recepten skal fornys der, hvor du går til kontrol
  * Recepten skal fornys af den læge, der sidst udskrev medicinen
  * Receptanmodning fortrudt (//Forbeholdt patienten eller hjemmesygeplejen//)
  * Fornyes ikke. Der findes allerede en gyldig recept
  * Det er for tidligt at få en ny recept
  * Medicinen udleveres fra hospital
  * Medicinen kan købes i håndkøb

Hvis "//Kontakt egen læge hvis recept ønskes//" angives som afvisningsårsag, vil FMK forsøge at automatisk viderestille anmodningen til patientens egen læge. 

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>