====== Søg planlagt dispensering ======

Denne service anvendes til at fremsøge planlagte dispenseringer på tværs af borgere ud fra et drugid.
Dette kan eksempelvis anvendes i forbindelse med takst- eller sortimentsændringer, der nødvendiggør udskiftning af et lægemiddel for et antal patienter.


===== Forespørgsel =====

I request-dokumentet skal der medsendes id på enten udleveringsapotektet eller pakkeapoteket. Desuden medsendes det DrugID, der søges efter og der kan også medsende elementet IncludePatientDetails, hvilket vil gøre at svaret på requesten vil indeholde flere detailjer omkring patienten.

**1.4.6.E6** forespøgslen er udvidet således der kan søges på flere lokationsnumre og lægemidler på samme tid. 
**Bemærk** Skemaet har indtil videre ingen begrænsning på hvor mange af de enkelte man kan angive på en gang. Det kan dog vise sig nødvendigt i fremtiden at sætte en begrænsning hvis det viser sig at der søges på så store mængder data at det giver problemer med performance.

Her er et eksempel, hvor der fremsøges ud fra udleveringsapoteket og beder om patient detaljer:

<file xml SearchPlannedDispensingRequest.xml>
<SearchPlannedDispensingRequest>
    <OrderedAtPharmacyIdentifier source="EAN-Lokationsnummer">5790000170609</OrderedAtPharmacyIdentifier>
    <DrugIdentifier source="Medicinpriser" date="2017-11-18">28100902676</DrugIdentifier>
    <IncludePatientDetails />
</SearchPlannedDispensingRequest>
</file>
               
Her er et eksempel, hvor der fremsøges ud fra pakkeapoteket:

<file xml SearchPlannedDispensingRequest.xml>
<SearchPlannedDispensingRequest>
    <PackedAtOrganisationIdentifier source="EAN-Lokationsnummer">5790000170609</PackedAtOrganisationIdentifier>
    <DrugIdentifier source="Medicinpriser" date="2017-11-18">28100902676</DrugIdentifier>
</SearchPlannedDispensingRequest>
</file>

===== Svar =====    
I svaret returneres et antal patienter hvis medicin håndteres af det angivne udleverings- eller pakkeapotek. For hver patient returneres en liste af planlagte dispenseringer, der henviser til pågældende lægemiddel via en reference til lægemiddelordinationen, eller via en substitution foretaget af apoteket. Det fremgår endvidere om lægemidlet må substitueres, og om substitutionen sker efter borgerens eget ønske.

**Bemærk** 

Når der søges ud fra udleveringsapotek, så vil der i svaret blive returneret de planned dispensings, tilhørende dosiskort hvor apoteket står som udleveringsapotek, hvori drugget indgår på lægemiddelordinatione, eller evt. som det substituerede drug. 

Hvis der bliver søgt ud fra pakkeapotek, vil der i svaret være identifiers på de planned dispensings tilhørende dosiskort hvor apoteket står som pakkeapotek, hvor planned dispensing indgår i en aktiv periode med status 'Klar til pakning', og hvor det pågældne drug er det der i øjeblikket er valgt til pakning, dvs. enten det som stod på ordinationen eller planned dispensing da den blev sat 'Klar til pakning' eller det som pakkeapoteket har valgt med servicen [[Subtitution ved den pakkende organisation]].
          
Her ses et eksempel på et svar hvor IncludePatientDetails ikke er sat.

<code xml SearchPlannedDispensingResponse.xml>
<SearchPlannedDispensingResponse>
    <PersonWithPlannedDispensing>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
        <PlannedDispensingSummary>
            <Identifier>121814002</Identifier>
            <Version>32415221</Version>
            <DoseDispensingCardIdentifier>7231715378</DoseDispensingCardIdentifier>
            <DrugMedication>
                <Identifier>2141521</Identifier>
                <Version>1234123</Version>
            </DrugMedication>
            <AdministrationInstruction>Synkes hele</AdministrationInstruction>
            <Substitution>
                <SubstitutionChosenByPatient />
                <Drug>
                    <Identifier source="Medicinpriser">915378089</Identifier>
                    <Name>Panodil</Name>
                </Drug>
            </Substitution>
            <SubstitutionAllowed>false</SubstitutionAllowed>
        </PlannedDispensingSummary>
    </PersonWithPlannedDispensing>
    <PersonWithPlannedDispensing>
        .....
    </PersonWithPlannedDispensing>
</SearchPlannedDispensingResponse>
</code>         

Her ses et eksempel på et svar hvor IncludePatientDetails er sat.


<code xml SearchPlannedDispensingResponse.xml>
<SearchPlannedDispensingResponse>
    <PersonWithPlannedDispensing>
	<Patient>
            <Person>
                <Name>
                    <GivenName>Mads</GivenName>
                    <MiddleName>Gudendahl</MiddleName>
                    <Surname>Larsen</Surname>
                </Name>
                <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
                <BirthDate>1996-18-05</BirthDate>
                <Gender>male</Gender>
            </Person>
            <Address>
                <StreetName>Stjerneplads</StreetName>
                <StreetBuildingIdentifier>15B</StreetBuildingIdentifier>
                <PostCodeIdentifier>8550</PostCodeIdentifier>
                <DistrictName>Ryomgård</DistrictName>
            </Address>
        </Patient>
        <PlannedDispensingSummary>
            <Identifier>121814002</Identifier>
            <Version>32415221</Version>
            <DoseDispensingCardIdentifier>7231715378</DoseDispensingCardIdentifier>
            <DrugMedication>
                <Identifier>2141521</Identifier>
                <Version>1234123</Version>
            </DrugMedication>
            <AdministrationInstruction>Synkes hele</AdministrationInstruction>
            <Substitution>
                <SubstitutionChosenByPatient />
                <Drug>
                    <Identifier source="Medicinpriser">915378089</Identifier>
                    <Name>Panodil</Name>
                </Drug>
            </Substitution>
            <SubstitutionAllowed>false</SubstitutionAllowed>
        </PlannedDispensingSummary>
    </PersonWithPlannedDispensing>
    <PersonWithPlannedDispensing>
        .....
    </PersonWithPlannedDispensing>
</SearchPlannedDispensingResponse>
</code>