Servicen ”Hent medicinkort” returnerer et eller flere medicinkort med tilknyttede aktive lægemiddelordinationer og afhængigt af de medsendte parametre også udleveringsgrundlag, udleveringer og 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.
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 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 typer af lægemiddelordinationer, der skal returneres. Her kan angives enten Borgervalgt, Lægeordineret eller begge.
Ø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> </GetMedicineCardRequest>
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> </GetMedicineCardRequest>
Detaljer om, hvad der returneres i historiske kald, findes på siden Historik.
<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>
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. CPR skift).
Elementet GetMedicineCardResponse 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> <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>