====== Hent Medicinkort ======

Servicen ”Hent medicinkort” returnerer et eller flere medicinkort med tilknyttede aktive [[fmk:1.6.0:xml-elementer:Lægemiddelordinationer|lægemiddelordinationer]] og afhængigt af de medsendte parametre også [[fmk:1.6.0:xml-elementer:Udleveringsgrundlag|udleveringsgrundlag]], 
[[fmk:1.6.0:xml-elementer:Udlevering|udleveringer]] og [[fmk:1.6.0:xml-elementer:laegemiddelordinationer#medicinadministrationer_drugadministration|medicinadministrationer]]. 

Ved opslag med dato og tid eller med et specifikt versionsnummer returneres medicinkortet, som det så ud på dette tidspunkt (ved opslag med versionsnummer svarende til tidspunktet versionen blev oprettet). Der kan derved returneres lægemiddelordinationer, der aktuelt ikke længere er aktive, men er seponerede eller udløbne. 
Ved opslag på det aktuelle medicinkort angives hverken versionsnummer eller tidspunkt i forespørgslen.

==== Valg af indhold i response ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getmedicinecardrequesttype|Request-dokumentet]] indeholder en række felter til angivelse af, hvad der ønskes returneret i responset. Medicinkortdelen og lægemiddelordinationer returneres altid. Derover kan der angives: 

  * ''IncludeWarrants'': Såfremt elementet er tilstede, vil svaret indeholde eventuelle udleveringsgrundlag. Dette uanset om udleveringsgrundlagene er knyttet til lægemiddelordinationer eller er aktuelle løse udleveringsgrundlag. 
    * ''IncludeHandovers'': Såfremt ''IncludeWarrants'' er tilstede, kan ''IncludeHandovers'' sættes. Såfremt ''IncludeHandovers'' er tilstede, vil svaret indeholde eventuelle udleveringer. 
      * ''IncludeSecondaryHandovers'': Såfremt ''IncludeHandovers'' er tilstede, kan ''IncludeSecondaryHandovers'' sættes. Såfremt ''IncludeSecondaryHandovers'' er tilstede, vil svaret indeholde eventuelle [[fmk:1.6.0:xml-elementer:Sekundær udlevering|sekundære udleveringer]].
  * ''IncludeAdministrations'': Såfremt elementet er tilstede, vil svaret indeholde eventuelle medicinadministrationer. Det er muligt at blive whitelisted til kun at modtage 30 medicinadministrationer. Hvis flere medicinadministrationer ønskes, kan dedikeret service anvendes. Hvis der findes flere end 30 medicinadministrationer, og begrænsning er valgt, bliver der ikke informeret om, at der er flere medicinadministrationer til rådighed.
  * ''IncludeNonRelevantWarrants'': Såfremt elementet er tilstede, vil løse udleveringsgrundlag blive returneret, uanset om de er markeret som uaktuelle eller ej. Såfremt elementet ikke er tilstede, vil løse udleveringsgrundlag, der er markeret som uaktuelle, ikke blive returneret.
  * ''IncludeEndedDrugMedications'': Giver mulighed for at hente seponerede lægemiddelordinationer og dermed de udleveringsgrundlag og udleveringer, der er knyttet til den seponerede lægemiddelordination.
  * ''IncludeDrugMedicationType'': Giver mulighed for at vælge, hvilke [[fmk:extensions:e2#Borgervalgt medicin / Ikke-lægeordinerede lægemiddelordinationer|typer af lægemiddelordinationer]], der skal returneres. Her kan angives enten Borgervalgt, Lægeordineret eller begge.

==== Forespørgsel på tidligere versioner ====

Ønskes der en tidligere [[fmk:generel:versionsnummerering|version]] af medicinkortet, kan der forespørges ud fra [[fmk:generel:versionsnummerering|versionsnummer]]. Forespørges der på en version, der ikke findes (dvs. med en højere værdi en den aktuelle version), vil kaldet fejle. 

<file xml GetMedicineCardRequest.xml>
<GetMedicineCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Version>133283328800420001</Version>
</GetMedicineCardRequest>
</file>

Endelig kan der forespørges efter medicinkortet, som det så ud på et givent tidspunkt, dvs. med et tidsstempel.

<file xml GetMedicineCardRequest.xml>
<GetMedicineCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<DateTime>2012-03-28T09:51:00Z</DateTime>
</GetMedicineCardRequest>
</file>

Detaljer om, hvad der returneres i historiske kald, findes på siden [[fmk:generel:historik|Historik]].
==== Forespørgsel ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetMedicineCardRequestType|Request]]
 
<file xml GetMedicineCardRequest.xml>

<GetMedicineCardRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <IncludeWarrants>
        <IncludeHandovers/>
    </IncludeWarrants>
    <IncludeAdministrations/>
    <IncludeEndedDrugMedications>
        <EndedAfterDateTime>2023-05-09T12:00:00Z</EndedAfterDateTime>
    </IncludeEndedDrugMedications>
    <IncludeDrugMedicationType>Lægeordineret</IncludeDrugMedicationType>
    <IncludeDrugMedicationType>Borgervalgt</IncludeDrugMedicationType>
</GetMedicineCardRequest>

</file>

==== Svar ====

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

Der returneres et medicinkort, eller eventuelt flere versioner af samme medicinkort. 
Såfremt der endnu ikke er oprettet data på medicinkortet, men patienten findes, vil der blive returneret en medicinkortoversigt med versionsnummer 0 og uden elementet ''Modified''. Det returnerede dokument vil indeholde personinformation for den pågældende persons aktive CPR-nummer (se evt. [[fmk:CPR skift]]).

Elementet GetMedicineCard­Response vi indeholde et eller flere MedicineCard-elementer. Responset kan indeholde flere medicinkort som svar, idet der kan forespørges på f.eks. flere versioner eller flere tidspunkter. En nærmere gennemgang af indholdet i MedicineCard-elementet findes i [[fmk:1.6.0:xml-elementer:medicinkort|Medicinkort]] og [[fmk:1.6.0:xml-elementer:laegemiddelordinationer|Lægemiddelordination]].

Eksemplet herunder viser et tomt medicinkort. For et udfyldt eksempel se [[fmk:1.6.0:xml-elementer:medicinkort|Medicinkort]].

<file xml GetMedicineCardResponse-Minimal.xml>

<GetMedicineCardResponse>
    <MedicineCard>
        <Patient>
            <Person>
                <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
                <Name>
                    <GivenName>Rob</GivenName>
                    <Surname>Müller</Surname>
                </Name>
                <BirthDate>1983-03-14</BirthDate>
                <Gender>male</Gender>
            </Person>
            <AddressLine>Magnolievej 842</AddressLine>
            <AddressLine>8653 Them</AddressLine>
        </Patient>
        <Version>0</Version>
    </MedicineCard>
</GetMedicineCardResponse>
</file>