====== Ekspeder dosisdispenseringsperiode ======

Servicen anvendes i forbindelse med at at der afsluttes en DD ekspedition på apoteket. 

Servicen har samme funktion som [[fmk:1.4.4:opret_effektuering]]. Forskellen er at der automatisk oprettes effektueringer af alle lægemidler der er pakket i den pågældende DD periode.

Servicen må kun kaldes på perioder som har status 'Pakning afsluttet' og denne service sætter efterfølgende periodens status til 'Ekspederet'.


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

I request-dokumentet skal der medsendes et [[fmk:1.4.4:cpr-nummer|CPR-nummmer]] på den patient som kaldet vedrører.

I elementet CreatedBy medsendes information omkring organisationen (typisk udleveringsapoteket) og brugeren som har foretaget oprettelsen, Er elementet oprettet af en anden aktør end personen der foretager kaldet mod FMK medsendes både et ReportedBy-element, og CreatedBy. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].

Ved ekspedering af en dosisdispenseringsperiode medsendes blot en reference til periodens identifier. Desuden kan det forventede leveringstidspunkt hos patienten opdateres (den eksisterende værdi i systemet bibeholdes såfremt elementet udelades).

Ekspedering vil så ske for alle de planlagte dispenseringer, der indgår i den pågældende periode, og vil medføre oprettelse af effektueringer på de lægemiddelordinationer der henvises til.

Der skal angives et ekspeditionstidspunkt som ikke må være før tidsfrist for ændringer og må højest være 2 timer fremskrevet i forhold til aktuel dato/tid.

Bemærk: Det er muligt at ekspederer flere perioder for samme borger i samme kald. 

<code xml EffectuateDoseDispensingPeriodRequest.xml>

<EffectuateDoseDispensingPeriodRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Århus Jernbane Apotek</Name>
            <AddressLine>Banegårdsplads 8</AddressLine>
            <AddressLine>8000 Århus</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
        </Organisation>
    </CreatedBy>
    <DoseDispensingPeriod>
        <DateTime>2017-11-15T15:51:12Z</DateTime>
        <DoseDispensingPeriodIdentifier>34236234523452345</DoseDispensingPeriodIdentifier>
        <ExpectedDelivery>2016-06-05T13:30:00Z</ExpectedDelivery>
    </DoseDispensingPeriod>
</EffectuateDoseDispensingPeriodRequest>

</code>

===== Svar =====

Svaret returnerer patientens cpr samt komplette effektueringsstrukturer på hvad der reelt er blevet oprettet. Periodeekspedition kan have medført at samme lægemiddelordination er blevet effektueret flere gange, hvorfor der i dette tilfælde vil være flere <Effectuation> elementer under pgl. DrugMedication.

<code xml EffectuateDoseDispensingPeriodResponse.xml>

<EffectuateDoseDispensingPeriodResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
        <DrugMedication>
            <Identifier>1341404077656004004</Identifier>
            <Effectuation>
		<Identifier>1341404078102001010</Identifier>
		<DateTime>2017-11-15T15:51:12Z</DateTime>
		<EffectuationMethod>dosisdispenseret apoteksudlevering</EffectuationMethod>
		<Created>...</Created>
		<DoseQuantity>42</DoseQuantity>
		<DosageQuantityUnitText>tabletter<DosageQuantityUnitText>
		<Drug>
		    <ATC>
		        <Code>M01AE01</Code>
		        <Text>Ibuprofen</Text>
		    </ATC>
		    <Identifier>28101062281</Identifier>
		    <Name>Ibuprofen "Actavis"</Name>
		    <Form>
		        <Code>TABFILM</Code>
		        <Text>filmovertrukne tabletter</Text>
                    </Form>
		    <Strength>
		        <Value>400</Value>
		        <UnitCode>MG</UnitCode>
		        <UnitText>mg<UnitText>
		        <Text>400 mg</Text>
                    </Strength>
		</Drug>
	    </Effectuation>
        </DrugMedication>
        <DrugMedication>
            ...
        </DrugMedication>
</EffectuateDoseDispensingPeriodResponse>

</code>