====== Opret udleveringsgrundlag for lægemiddelordination ======

Denne service anvendes til at oprette et [[fmk:1.6.0:xml-elementer:udleveringsgrundlag]] for en eksisterende lægemiddelordination.

==== Forespørgsel ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createWarrantRequestType|Request]] 

I forespørgslen angives først ''PersonIdentifier'' eller ''Organisationidentifier'' samt medicinkortets versionsnummer. Herefter angives oplysninger om aktøren, der foretager oprettelsen (se også "Modifikator" herunder).
 
Herefter følger en eller flere Warrant-elementer, et for hvert af de udleveringsgrundlag, der skal oprettes. 


=== Lægemiddelordinationen som udgangspunkt  ===

Elementet Warrant indeholder en reference til den lægemiddelordination, som udleveringsgrundlaget skal gælde for. 

Udleveringsgrundlaget oprettes med en kombination af data fra lægemiddelordinationen og øvrige elementer i kaldet. 

=== Reference til anmodning ===

Hvis udleveringsgrundlaget oprettes på bagrund af en anmodning, angives id'et på denne anmodning.

=== Modifikator ===

Der kan eventuelt angives en modifikator for hvert udleveringsgrundlag i kaldet. Dette anvendes, hvis der optræder forskellige aktører for udleveringsgrundlagene i kaldet, se [[fmk:generel:aktorer_pa_fmk|også aktører på FMK]].

=== Lægens autorisationsdato === 

Der skal angives en dato og et tidspunkt, hvor udleveringsgrundlaget er godkendt af lægen (autorisationsdato).

=== Gyldighed ===

Der kan angives, hvornår udleveringsgrundlaget skal være gyldigt fra. 

Hvis intet angives, antages, at det skal være lig kaldtidspunktet, hvilket i så fald sættes af FMK. Der kan angives enten et specifikt gyldig fra tidspunkt i ''ValidFromDate'', som både kan være i fortiden eller fremtiden, eller der kan angives, at det er et endnu ukendt fremtidigt tidspunkt ved hjælp af ''UnspecifiedValidFrom''. Se [[fmk:1.6.0:services:aktiver ventende udleveringsgrundlag]].

I ValidToDate angives, hvortil udleveringsgrundlaget skal være gyldig. Afhængig af typen af udleveringsgrundlag, er der visse lovmæssige begrænsninger for, hvor længe det må være gyldigt. Det valideres at ValidToDate overholder disse regler. Hvis ValidTo udelades, sættes den til den længst mulige gyldighed i henhold til gældende regler.

=== Typen af udleveringsgrundlag ===

Der skal angives hvilken type udleveringsgrundlag der skal oprettes, samt de nødvendige informationer for denne type. Der kan oprettes udleveringsgrundlag af følgende typer:
  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#prescription|Recept]]
  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#dosedispensed|Dosisdispensering]]
  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#hospitalpharmacyhandover|Udlevering af medicin fra sygehusapotek]]

=== Bestilling ===

Det er muligt samtidigt at oprette en [[fmk:1.6.0:xml-elementer:bestilling]] til apoteket på udleveringsgrundlaget, hvis der er tale om et udleveringsgrundlag til udlevering på apotek (Recept eller Dosisdispensering).

=== Eksempel ===

<code xml>
    <CreateWarrantRequest>
         <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
         <MedicinecardVersion>54322135234542</MedicinecardVersion>
         <Created>
             <By>
       	      ....
             </By>
             <DateTime>2025-11-19T09:30:47.0Z</DateTime>
        </Created>
        <Warrant>
            <DrugMedicationIdentifier>1332830239</DrugMedicationIdentifier>
            <RequestForWarrantIdentifier>54321232345</RequestForWarrantIdentifier>
            <AuthorisationDateTime>2025-11-19T09:29:47.0Z</AuthorisationDateTime>
            <UnspecifiedValidFrom/>
            <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>
        </Warrant>
        <Warrant>
            <DrugMedicationIdentifier>123321123321</DrugMedicationIdentifier>
            <AuthorisationDateTime>2024-11-19T09:12:12.0Z</AuthorisationDateTime>
            <ValidFromDate>2024-12-01</ValidFromDate>
            <ValidToDate>2025-12-31</ValidToDate>
            <DoseDispensed/>
            <Order>
                <OrderedAtPharmacy>
                    <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                    <Type>Apotek</Type>
                    <Name>Kolind Apotek</Name>
                    <AddressLine>...</AddressLine>
                    <TelephoneNumber>...</TelephoneNumber>
                    <EmailAddress>...</EmailAddress>
                </OrderedAtPharmacy>
            </Order>   
        </Warrant>
    </CreateWarrantRequest>
</code>    

==== Svar ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createWarrantResponseType|Response]] 

Svaret indeholder identifier på den person eller organisation, som oprettelsen vedrører, samt medicinkortversion.

Derudover returneres id'erne på de oprettede udleveringsgrundlag sammen med id'erne på de lægemiddelordinationer, de er oprettet på.

=== Eksempel ===

<code xml>
    <CreateWarrantResponse>
         <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
         <MedicinecardVersion>54322135234542</MedicinecardVersion>
         <Warrant>
            <DrugMedicationIdentifier>1332830239</DrugMedicationIdentifier>
            <WarrantIdentifier>23412312321234</WarrantIdentifier>
         </Warrant>    
         <Warrant>
            <DrugMedicationIdentifier>124353211430239</DrugMedicationIdentifier>
            <WarrantIdentifier>234123123255555</WarrantIdentifier>
         </Warrant>    
    </CreateWarrantResponse>
</code>