====== Hent hospitalsapoteks-udleveringsgrundlag ======

Servicen henter et eller flere udleveringsgrundlag, som er knyttet til den samme person/organisation.
Udleveringsgrundlag til organisationer dækker både over udleveringsgrundlag til brug i praksis og udleveringsgrundlag til dosisdispensering til instututioner.

Denne service er en begrænset version af [[fmk:1.6.0:services:Hent udleveringsgrundlag|Hent udleveringsgrundlag]] som anvendes generelt af sundhedsfaglige hvor alle former for udleveringsgrundlag er relevante. I denne service vil FMK frasortere typer af udleveringsgrundlag som ikke er relevante for hospitalsapoteker såsom "Recept" eller "Dosisdispensering". Svaret fra servicen har dog samme form.  

==== Forespørgsel ====

Forespørgslen indeholder overordnet 3 elementer:
  * Identifier på den person eller organisation, der skal hentes for. 
  * Angivelse af hvilke udleveringsgrundlag, der skal hentes for vedkommende. Angives enten som en liste af ''Identifier'', angivelse af alle udleveringsgrundlag med ''IncludeAllWarrants'' eller alle åbne udleveringsgrundlag ''IncludeOpenWarrants''
  * Evt. ønske om også at få returneret udleveringer på de pågældende udleveringsgrundlag angives med flaget ''IncludeAllWarrants''.


=== Eksempel ===

Hent to specifikke udleveringsgrundlag for en patient og returner også eventuelle udleveringer på disse.

<code xml>
    <GetHospitalPharmacyWarrantRequest>
    	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    	<Identifier>2129345438478</Identifier>
    	<Identifier>2231433445678</Identifier>
    	<IncludeHandovers/>
    </GetHospitalPharmacyWarrantRequest>
</code>

=== Eksempel ===

Hent alle patientens udleveringsgrundlag uden udleveringer.

<code xml>
    <GetHospitalPharmacyWarrantRequest>
    	<PersonIdentifier source="X-eCPR">2811891ABC</PersonIdentifier>
    	<IncludeAllWarrants/>
    </GetHospitalPharmacyWarrantRequest>
</code>

=== Eksempel ===

Hent alle åbne udleveringsgrundlag for en organisation uden eventuelle udleveringer.

<code xml>
    <GetHospitalPharmacyWarrantRequest>
    	<OrganisationIdentifier source="SOR">2892345621123</OrganisationIdentifier>
    	<IncludeOpenWarrants/>
    </GetHospitalPharmacyWarrantRequest>
</code>

   
==== Svar ====   

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

**Bemærk** Service giver samme response dokument som [[fmk:1.6.0:services:hent udleveringsgrundlag]], også i rodelementet GetWarrantResponse, da indhold er ens, og blot er filtreret på hvilke typer af udleveringsgrundlag som hentes  
   
I svaret returneres først den person eller organisation der hentes udleveringsgrundlag for.

Derefter en liste med selve [[fmk:1.6.0:xml-elementer:udleveringsgrundlag]].

Endelig kan svaret indeholde en liste af id'er på udleveringsgrundlag, der er blevet administrativt slettet. Dette sker for at klient-systemet kan foretage en oprydning i eventuelle lokale kopier af udleveringsgrundlag.

**Bemærk** Listen indeholder kun typer af udleveringsgrundlag som er relevante for hospitalsapoteket, andre typer vil være blevet frasorteret af FMK. Disse ville kunne findes ved at hente medicinkortet eller anvendelse af [[fmk:1.6.0:services:Hent udleveringsgrundlag]]-servicen i stedet, hvilket kan kræve samtykke borgerens samtykke og evt. andre rettigheder.

=== Eksempel ===

<code xml>
    <GetWarrantResponse>
        <Patient>
            <Person>
                <Name>
                    <GivenName>Rob</GivenName>
                    <Surname>Müller</Surname>
                </Name>
                <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
                <BirthDate>1983-03-14</BirthDate>
                <Gender>male</Gender>
            </Person>
            <AddressLine>Magnolievej 842</AddressLine>
            <AddressLine>8653 Them</AddressLine>
        </Patient>
        <Warrant>
            <Identifier>21298478</Identifier>
            <Version>1231231</Version>
            <AttachedToDrugMedicationIdentifier>1332830239</AttachedToDrugMedicationIdentifier>
            <CreatedFromDrugMedicationVersion>14040690</CreatedFromDrugMedicationVersion>
            <AuthorisationDateTime>2024-11-19T09:29:47.0Z</AuthorisationDateTime>
            <Created>
               <By>                
                    <HealthcareProfessional>
                        <Identifier source="Autorisation">12345</Identifier>
                        <Name>Karl Karlsen</Name>
                        <Information type="SpecialityCode">7170</Information>
                    </HealthcareProfessional>
                    <Role>Læge</Role>
                    <Organisation>
                        <Name>Psykiatrien, Region Nordjylland - afdeling Thy/Mors</Name>
                        <AddressLine>Niels Bohrs Vej 30</AddressLine>
                        <AddressLine>9220 Aalborg Øst</AddressLine>
                        <TelephoneNumber>00000000</TelephoneNumber>
                        <Type>Sygehus</Type>
                        <Identifier source="SKS">7690</Identifier>
                    </Organisation>
        	</By>
                <DateTime>2024-11-19T09:30:47.0Z</DateTime>
            </Created>
            <ValidFromDate>2024-11-19</ValidFromDate>
            <ValidToDate>2026-11-19</ValidToDate>
            <TreatmentHandOver/>
        </Warrant>
    </GetWarrantResponse>
</code>