Hent effektueringer

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

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ægemiddelordinationer 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ægemiddelordinationen kendt og hentet af en tilsvarende årsag, kan der via en ConsentHeader angives, at der også ønskes returneret effektueringer med privatmarkering.

SearchEffectuationsRequest-header.xml

<ConsentHeader>
    <Consent source="User">
        <ConsentType>PrivateDataConsentOverridden</ConsentType>
        <Content>MedicineCard</Content>
    </Consent>
</ConsentHeader>

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>

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 MoreAvailable-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.

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>

Fælles Medicinkort - Dokumentation

Table of Contents

Hent effektueringer

Forespørgsel

Svar

Eksempel