Servicen ”Hent medicinkort” returnerer et eller flere medicinkort med tilknyttede aktive læge­middel­ordinationer, og - afhængigt at de medsendte parametre, også recepter og effektueringer.

Ved opslag med dato og til 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ørgselen.

Ved hjælp af en valgfri ConsentHeader angives at der også ønskes returneret lægemiddel­ordinationer markeret med privatmarkering. Årsagen hertil skal angives ved anvendelse af en af de to ConsentType værdier:

• PrivateDataConsentOverridden såfremt opslaget sker for nødvendig til varetagelse af en åbenbar almen interesse eller af væsentlige hensyn til patienten.

• PrivateDataConsentGiven såfremt opslaget sker efter mundtlig eller skriftlig samtykke.

Disse to typer af forespørgsler vil blive logget specielt. Såfremt opslaget sker efter patientens samtykke, skal der i kaldet angives i hvilket datointerval dette samtykke sker. Værdien kan evt. anvendes i forbindelse med opfølgning på logdata, men har i øvrigt ingen indvirkning på omfanget af de returnerede data.

I version 1.2.x af snitfladen var det kun nødvendigt at specificere samtykke én gang indenfor 24 timer. Efterfølgende kald, indenfor 24 timer, ville så også inkludere eventuelle privatmarkerede lægemiddelordinationer. Dette er ændret i version 1.4 af snitfladen. I version 1.4 skal samtykke specificeres hver gang eventuelle privatmarkerede lægemiddel­ordinationer ønskes inkluderet i responset.

Request-dokumentet indeholder en række felter til angivelse af, hvad der ønskes returneret i responset. Medicinkort-delen og lægemiddelordinationer returneres altid. Derover kan der angives:

• IncludePrescriptionMedications: Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordinationer. Dette uanset om receptordinationerne er knyttet til lægemiddelordinationer eller er aktuelle løse receptordinationer.

• IncludeEffectuations: Såfremt elementet sættes til true vil svaret indeholde eventuelle effektueringer. I så fald gælder dette både effektuereringer på lægemiddelordinationer og effektueringer på recept­ordinationer, dog vil effektueringer på receptordinationer ikke blive returneret hvis Include­Prescription­Medications er false.

• IncludeNonRelevantPrescriptionMedications: Sættes elementet til true vil løse receptordinationer blive returneret, uanset om de er markeret som uaktuelle eller ej. Sættes elementet til false vil løse recepter markeret som uaktuelle ikke blive returneret. Flaget har ingen mening, såfremt Include­Prescription­Medications er false.

Med “løse” receptordinationer menes receptordinationer der ikke er tilknyttet en lægemiddelordination, og som er oprettet uden om det fælles medicinkort på f.eks. EDIFACT-, papir- eller telefonrecepter. FMK henter receptordinationer fra Receptserveren.

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

<GetMedicineCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Version>133283328800420001</Version>
	<IncludePrescriptions>false</IncludePrescriptions>
	<IncludeEffectuations>false</IncludeEffectuations>
	<IncludeNonRelevantPrescriptions>false</IncludeNonRelevantPrescriptions>
</GetMedicineCardRequest>

Kombinationen af en versions- og en IncludeNonReviewedOnly-angivelse resulterer i løse receptordinationer, der beregnes som følger: Receptordinationerne skal være nyere end den seneste receptgennemgang der er tidligere end datoen for denne version, og ældre end medicinkortversions seneste gyldigheds­tidspunkt.

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

<GetMedicineCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<DateTime>2012-03-28T09:51:00Z</DateTime>
	<IncludePrescriptions>false</IncludePrescriptions>
	<IncludeEffectuations>false</IncludeEffectuations>
	<IncludeNonRelevantPrescriptions>false</IncludeNonRelevantPrescriptions>
</GetMedicineCardRequest>

De tre typer af forespørgsler kan kombineres i samme kald. Kombinationen af en versions- og en IncludeNonReviewedOnly-angivelse resulterer i løse recepter, der beregnes som følger: Recepterne skal være nyere end den seneste receptgennemgang, der er tidligere end datoen for denne version, og ældre end denne medicinkortversions seneste gyldighedstidspunkt.

GetMedicineCardRequest-header.xml

<ConsentHeader>
    <Consent source="User">
        <FromDate>2012-10-05</FromDate>
        <ToDate>2012-10-05</ToDate>
        <ConsentType>PrivateDataConsentGiven</ConsentType>
        <Content>MedicineCard</Content>
    </Consent>
</ConsentHeader>

GetMedicineCardRequest.xml

<GetMedicineCardRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <IncludePrescriptions>true</IncludePrescriptions>
    <IncludeEffectuations>true</IncludeEffectuations>
    <IncludeNonRelevantPrescriptions>false</IncludeNonRelevantPrescriptions>
</GetMedicineCardRequest>

Apoteker kan foretage opslag på medicinkort med samtlige aktuelle lægemiddelordination + evt. recepter og bestillinger, også hvor der ikke aktuelt kan ekspederes på apoteket. Dette skal i så fald ske med markering i samtykkeheaderen af, at borgeren har givet samtykke til at se hele medicinkortet.

Borgeren kan give samtykke til dette eksempelvis i forbindelse med vejledning eller interaktionskontrol på hele medicinkortet.

GetMedicineCardRequest-Complete-header.xml

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

GetMedicineCardRequest-Complete.xml

<GetMedicineCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
        <IncludePrescriptions>true</IncludePrescriptions>
        <IncludeEffectuations>true</IncludeEffectuations>
        <IncludeNonRelevantPrescriptions>true</IncludeNonRelevantPrescriptions>
</GetMedicineCardRequest>
 

Det er kun apoteker-rollen, som skal inkludere MedicineReviewConsent i samtykkeheaderen, da andre roller pr. default har adgang til at se det fulde medicinkort. Denne type af opslag kan også kombineres med at borgeren har givet samtykke til at se privatmarkerede data også (hvilket ikke er vist i eksemplet). Her angives et ekstra <Consent> element under <ConsentHeader> elementet med eksempelvis et <ConsentType>PrivateDataConsentGiven</ConsentType> element samt et datointerval.

Der returneres et medicinkort uden effektueringer, 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 medicinkort-oversigt med versionsnummer 0 og uden elementet ModifiedStructure. Det returnerede dokument vil indeholde personinformation.

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 Medicinkort og Lægemiddelordination.

Eksemplet herunder viser et tomt medicinkort. For et udfyldt eksempel se Medicinkort.

GetMedicineCardResponse-Minimal.xml

<GetMedicineCardResponse>
    <MedicineCard>
        <Patient>
            <Person>
                <Name>
                    <GivenName>Rob</GivenName>
                    <Surname>Müller</Surname>
                </Name>
                <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
                <BirthDate>1973-02-01</BirthDate>
		<Gender>male</Gender>
            </Person>
            <Address>
                <StreetName>Magnolievej</StreetName>
                <StreetBuildingIdentifier>842</StreetBuildingIdentifier>
                <FloorIdentifier>4</FloorIdentifier>
                <PostCodeIdentifier>8653</PostCodeIdentifier>
                <DistrictName>Them</DistrictName>
            </Address>
        </Patient>
        <Version>0</Version>
        <HasOpenDosageDispensingPrescriptions>true</HasOpenDosageDispensingPrescriptions>
        <OrderedPrescriptionsExist>true</OrderedPrescriptionsExist>
    </MedicineCard>
</GetMedicineCardResponse>

Medicinkortet kan være markeret som ugyldigt, se Medicinkort med ugyldig-markering.

Medicnkortet kan desuden indeholde en eller flere administrativt slettede lægemiddelordinationer og recepter, se Administrativt slettet lægemiddelordination eller recept.

Det er muligt at angive, at ordinationer seponeret fra en given dato ønskes inkluderet i medicinkortet. Hvis angivet i opslaget, vil recepter og effektueringer for de seponerede ordinationer også blive fremsøgt.

GetMedicineCardRequest-IncludeWithdrawn.xml

<GetMedicineCardRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <IncludePrescriptions>false</IncludePrescriptions>
    <IncludeEffectuations>false</IncludeEffectuations>
    <IncludeNonRelevantPrescriptions>false</IncludeNonRelevantPrescriptions>
    <IncludeWithdrawnDrugMedications>
        <WithdrawnAfterDateTime>2013-11-19T09:30:47.0Z</WithdrawnAfterDateTime>
    </IncludeWithdrawnDrugMedications>    
</GetMedicineCardRequest>