====== Hent effektueringer ======

Når et apotek udleverer på baggrund af en recept, vil effektueringer blive knyttet til recept­ordinationen. 

Hvis en læge opdaterer lægemiddelordinationen og recepten (ved at annullere + oprette en ny) så bevares effektueringer på de recepter hvorpå de blev lavet. For at få den komplette udleveringshistorik på lægemidlet kan det derfor være nødvendigt at sammenstille effektueringer fra flere forskellige recepter under samme lægemiddelordination.

Servicen til at hente effektueringer gør det muligt at hente i et tidsinterval, dvs. der kan hentes effektueringer der er oprettet siden sidste kald på et CPR-nummer. 

==== Forespørgsel ====

Forespørgslen indeholder først patientens CPR-nummer. Herefter to felter til angivelse af et dato- og tidsinterval. Udelades et eller begge dato- og tidsfelterne anvendes i stedet ”uendeligt” i begge retninger. Dvs. en forespørgsel hvor både FromDateTime og ToDateTime er udeladt vil returnere samtlige effektueringer kendt af FMK, dog kan FMK begrænse antallet af effektueringer der returneres, som senere beskrevet. 

Der er mulighed for at angive hvorvidt følgende typer af effektueringer der ønskes returneret: 

  * Angives IncludeEffectuationsOnDrugMedications til true vil effektueringer direkte på læge­middelordinationer blive returneret. 
  * Angives IncludeEffectuationsOnPrescriptionsOnDrugMedications til true vil effektueringer på recepter knyttet til lægemiddelordinationer blive returneret. 
  * Angives IncludeEffectuationsNotOnDrugMedications til true vil effektueringer på ”løse” recepter, dvs. på recepter der ikke er knyttet til en lægemiddelordination, blive returneret.

Endeligt kan der for de første to typer af effektueringer være tilfælde hvor effektueringen er knyttet til en lægemiddelordination hvor der er angivet privatmarkering. Er dette tilfældet, og er læge­middel­ordinationen kendt og hentet af en tilsvarende årsag, kan det [[soap_header_--_specifikt_omkring_samtykke|via en ConsentHeader]] angives, at der også ønskes returneret effektueringer med privatmarkering. 

<code xml SearchEffectuationsRequest.xml>
<SearchEffectuationsRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<FromDateTime>2012-01-01T00:00:00Z</FromDateTime>
	<ToDateTime>2012-04-10T09:30:00Z</ToDateTime>
	<IncludeEffectuationsOnDrugMedications>true</IncludeEffectuationsOnDrugMedications>
	<IncludeEffectuationsOnPrescriptionsOnDrugMedications>true</IncludeEffectuationsOnPrescriptionsOnDrugMedications>
	<IncludeEffectuationsNotOnDrugMedications>true</IncludeEffectuationsNotOnDrugMedications>
</SearchEffectuationsRequest>
</code>

==== Svar ====

Svaret fra FMK indeholder først patientens CPR-nummer. Herefter returneres effektueringerne i en struktur der afspejler deres sammenhæng med en lægemiddelordination (i DrugMedication elementet), med en recept og dens bestilling på en lægemiddelordination (i Order elementet under Prescription elementet under DrugMedication elementet) eller som en løs recept (i Order elementet under Prescription elementet uden for en DrugMedication). 
Nyeste effektueringer returneres først. Om nødvendigt kan FMK begrænse antallet af returnerede effektueringer i et enkelt response. I så fald markeres dette i responset med More­Available-elementet. Der kan efterfølgende spørges med tidspunktet for oprettelsen af den ældste effektuering i responset, dvs. med tidsintervallet [oprindelig fradato – ældste dato i responset]

=== Eksempel ===


	Første Request udføres på tidspunktet 2009-12-25 14:43:51
		Request: 	CPR = 1111111118; tidsinterval = [2007-02-25 14:43:51; 2009-02-25 14:43:51]
		Response: 	Effektuering oprettet 2009-01-12 11:52:32
						Effektuering oprettet 2009-01-09 14:13:21
								...					
						Effektuering oprettet 2008-06-29 09:11:44
						MoreAvailable
	
	Næste request udføres umiddelbart herefter, idet der er modtaget et MoreAvailable-flag
		Request: 	CPR = 1111111118; tidsinterval = [2007-02-25 14:43:51; 2008-06-29 09:11:44]
		Response: 	Effektuering oprettet 2008-04-12 15:55:01
						Effektuering oprettet 2008-03-24 14:31:13
	
	Der foretages herefter ikke flere forespørgsler, idet der her ikke er modtaget et MoreAvailable-flag.


<code xml SearchEffectuationsResponse.xml>

<SearchEffectuationsResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DrugMedication>
        <Identifier>1332830239001</Identifier>
        <Effectuation>
            <Identifier>21298478</Identifier>
            <DateTime>2013-11-20T15:59:12.0Z</DateTime>
            <Created>
                <By>
                   <AuthorisedHealthcareProfessional>
                        <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                        <Name>Tess Christoffersen</Name>
                        <SpecialityCode source="Medicinpriser" date="2014-11-18">PSYK</SpecialityCode>
                    </AuthorisedHealthcareProfessional>
                    <Organisation>
                        <Name>Lægerne Vestergade</Name>
                        <AddressLine>Vestergade 2</AddressLine>
                        <AddressLine>8660 Skanderborg</AddressLine>
                        <TelephoneNumber>86521348</TelephoneNumber>
                        <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                        <Type>Yder</Type>
                        <Identifier source="Yder">66974</Identifier>
                    </Organisation>
                </By>
                <DateTime>2013-11-20T15:59:12.0Z</DateTime>
            </Created>
            <IsEffectuatedAccordingToDrugMedication/>
        </Effectuation>
        <Prescription>
            <Identifier>2132131</Identifier>
            <Order>
                <Identifier>2132134</Identifier>
                <Created>
                    <By>
                        <AuthorisedHealthcareProfessional>
                            <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                            <Name>Tess Christoffersen</Name>
                            <SpecialityCode source="Medicinpriser" date="2014-07-02">PSYK</SpecialityCode>
                        </AuthorisedHealthcareProfessional>
                        <Organisation>
                            <Name>Lægerne Vestergade</Name>
                            <AddressLine>Vestergade 2</AddressLine>
                            <AddressLine>8660 Skanderborg</AddressLine>
                            <TelephoneNumber>86521348</TelephoneNumber>
                            <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                            <Type>Yder</Type>
                            <Identifier source="Yder">66974</Identifier>
                        </Organisation>
                    </By>
                    <DateTime>2014-07-02T09:30:47.0Z</DateTime>
                </Created>
                <OrderedAtPharmacy>
                    <Name>Skanderborg Apotek</Name>
                    <AddressLine>Adelgade 27</AddressLine>
                    <AddressLine>8660 Skanderborg</AddressLine>
                    <Type>Apotek</Type>
                    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
                </OrderedAtPharmacy>
                <Status>Udført</Status>
                <Effectuation>
                    <Identifier>21298478</Identifier>
                    <DateTime>2013-11-20T15:59:12.0Z</DateTime>
                    <CreatedWithoutPerson>
                        <By>
                            <Organisation>
                                <Name>Skanderborg Apotek</Name>
                                <AddressLine>Adelgade 27</AddressLine>
                                <AddressLine>8660 Skanderborg</AddressLine>
                                <Type>Apotek</Type>
		  		<Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
                            </Organisation>
                        </By>
                        <DateTime>2013-11-20T15:59:12.0Z</DateTime>
                    </CreatedWithoutPerson>
                    <PackageDispensed>
                        <PackageQuantity>1</PackageQuantity>
                        <PackageNumber source="Medicinpriser" date="2012-02-06">84194</PackageNumber>
                        <PackageSize>
                            <Value>20</Value>
                            <UnitCode source="Medicinpriser" date="2012-02-06">ST</UnitCode>
                            <UnitText>stk</UnitText>
                        </PackageSize>
                    </PackageDispensed>
                </Effectuation>
            </Order>
        </Prescription>
    </DrugMedication>
    <Prescription>
        <Identifier>2142912</Identifier>
        <Order>
            <Identifier>2142914</Identifier>
            <Created>
                <By>
                    <AuthorisedHealthcareProfessional>
                        <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                        <Name>Tess Christoffersen</Name>
                        <SpecialityCode source="Medicinpriser" date="2014-07-02">PSYK</SpecialityCode>
                    </AuthorisedHealthcareProfessional>
                    <Organisation>
                        <Name>Lægerne Vestergade</Name>
                        <AddressLine>Vestergade 2</AddressLine>
                        <AddressLine>8660 Skanderborg</AddressLine>
                        <TelephoneNumber>86521348</TelephoneNumber>
                        <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                        <Type>Yder</Type>
                        <Identifier source="Yder">66974</Identifier>
                    </Organisation>
                </By>
                <DateTime>2014-07-02T09:30:47.0Z</DateTime>
            </Created>
            <OrderedAtPharmacy>
                <Name>Skanderborg Apotek</Name>
                <AddressLine>Adelgade 27</AddressLine>
                <AddressLine>8660 Skanderborg</AddressLine>
                <Type>Apotek</Type>
                <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
            </OrderedAtPharmacy>
            <Status>Udført</Status>
            <Effectuation>
                    <Identifier>21298478</Identifier>
                    <DateTime>2013-11-20T15:59:12.0Z</DateTime>
                    <CreatedWithoutPerson>
                        <By>
                            <Organisation>
                                <Name>Skanderborg Apotek</Name>
                                <AddressLine>Adelgade 27</AddressLine>
                                <AddressLine>8660 Skanderborg</AddressLine>
                                <Type>Apotek</Type>
				<Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
                            </Organisation>
                        </By>
                        <DateTime>2013-11-20T15:59:12.0Z</DateTime>
                    </CreatedWithoutPerson>
                    <PackageDispensed>
                        <PackageQuantity>1</PackageQuantity>
                        <PackageNumber source="Medicinpriser" date="2012-02-06">84194</PackageNumber>
                        <PackageSize>
                            <Value>20</Value>
                            <UnitCode source="Medicinpriser" date="2012-02-06">ST</UnitCode>
                            <UnitText>stk</UnitText>
                        </PackageSize>
                    </PackageDispensed>
            </Effectuation>
        </Order>
    </Prescription>
    <MoreAvailable/>
</SearchEffectuationsResponse>

</code>